Importeer CODA bestanden
Je kunt lokale CODA-bestanden uploaden naar één of meerdere accounts op EenvoudigFactureren, wat het beheer van je bankafschriften vereenvoudigt.
Om te beginnen dient u eerst de tool te downloaden.
API
Een API-sleutel is vereist om toegang te krijgen tot het account op EenvoudigFactureren. Haal de API-sleutel op de pagina "Toegangsbeheer" in het account.
Instellen voor één account:
Stel het script in om CODA-bestanden voor een enkel account te uploaden.
Voorbeeld importcoda.yml voor 1 account:
domain: eenvoudigfactureren.be
paths:
in: c:\path\to_process
out: c:\path\done
apikey: MY-APIKEY-1
Instellen voor meerdere accounts in één directory:
Upload CODA-bestanden voor meerdere accounts. Alle CODA-bestanden worden toegevoegd aan een enkele directory. CODA-bestanden worden gefilterd op basis van het IBAN van het account.
Opmerkingen:
- Voor elk account op EenvoudigFactureren voeg je een account toe in het YAML-bestand.
- De naam van het account wordt alleen gebruikt voor duidelijkheid.
- Een account met meerdere IBAN’s kan meerdere keren worden toegevoegd met dezelfde naam en API-sleutel.
- CODA-bestanden met een IBAN die niet is vermeld, worden overgeslagen en naar de "out"-pad verplaatst.
Voorbeeld importcoda.yml voor meerdere accounts:
domain: eenvoudigfactureren.be
paths:
in: c:\pad\naar_verwerken
out: c:\pad\gedaan
accounts
-
name: Bedrijf 1
apikey: MY-APIKEY-1
iban: BE1111111111111
-
name: Bedrijf 2
apikey: MY-APIKEY-2
iban: BE222222222222
-
Met dit script kun je eenvoudig CODA-bestanden uploaden voor meerdere accounts, afhankelijk van de IBAN’s die zijn opgegeven.
Instellen met een aparte directory per account:
Upload CODA-bestanden voor meerdere accounts. Per account wordt een aparte directory gebruikt voor de nieuwe CODA-bestanden.
Opmerkingen:
- Voeg voor elk account op EenvoudigFactureren een account toe in het YAML-bestand.
- De naam van het account wordt alleen gebruikt voor duidelijkheid.
Voorbeeld importcoda.yml:
domain: eenvoudigfactureren.be accounts: - name: Bedrijf 1 apikey: MY-APIKEY-1 paths: in: c:\pad\bedrijf1\te_verwerken out: c:\pad\bedrijf1\gedaan - name: Bedrijf 2 apikey: MY-APIKEY-2 paths: in: c:\pad\bedrijf2\te_verwerken out: c:\pad\bedrijf2\gedaan
Uitvoering:
- Voer de volgende opdracht uit in de opdrachtprompt:
ruby importcoda.rb
- Zodra een CODA-bestand is verwerkt, wordt het naar de "out"-pad verplaatst.
Automatisch uitvoeren in Windows (Taakplanner)
Je kunt het script ook in een taakplanner instellen om bestanden automatisch te downloaden.
Maak een batchbestand
Maak een nieuw bestand, bijvoorbeeld run_importcoda.bat
, en voeg deze inhoud toe:
Pas C:\pad\naar\eenvoudigfactureren-tools-master
aan naar de werkelijke locatie.
Voeg een taak toe in de Windows Taakplanner
- Open Taakplanner (zoek naar Task Scheduler in het startmenu).
- Klik op Taak maken... en geef het een naam zoals Import CODA.
- Ga naar het tabblad Triggers en klik op Nieuw... om een planning in te stellen (bijv. dagelijks om 02:00 uur).
- Ga naar Acties, klik op Nieuw..., en kies Een programma starten.
- Vul bij Programma/script de locatie in van het batchbestand (
run_importcoda.bat
). - Klik op OK en test de taak