Download facturen of andere documenten als PDF- of UBL-bestand voor één of meerdere accounts op EenvoudigFactureren via Ruby.

Om te beginnen dient u eerst de tool te downloaden.

Instellen

Er zijn verschillende scenario's voor het instellen van het script. Werk het YAML-bestand download.yml bij volgens jouw scenario.

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.

Je kunt bestanden downloaden voor facturen, ontvangsten, offertes, bestellingen, leveringen, betalingsverzoeken.

• Het formaat is standaard pdf. Voor facturen kun je ook ubl of peppol als formaat instellen.

• De paden kunnen de variabelen {yyyy}, {mm}, {dd} en {q} gebruiken om de huidige datum in te stellen.

        Optioneel kun je de documenten filteren op datum (van en tot) en of een tag is ingesteld voor het document.

• De tag wordt voornamelijk gebruikt om facturen die nog niet naar de accountant zijn gestuurd te filteren
  tag: not:accountant. 

• Voor datums kun je de volgende wildcards gebruiken:
  MONTH, PREVMONTH, NEXTMONTH, QUARTER, PREVQUARTER, NEXTQUARTER, YEAR, PREVYEAR, NEXTYEAR.

• Voor facturen kun je de actie "mark as sent to accountant" uitvoeren. Dit markeert de facturen als verstuurd naar de accountant. In combinatie met "tag: not:accountant" kun je de factuur slechts eenmaal downloaden.

Instellen voor één account:

Stel het script in om bestanden voor één account te downloaden.

Voorbeeld download.yml:

domain: eenvoudigfactureren.be
path: c:\pad\{yyyy}\{mm}
apikey: MY-APIKEY-1
type: invoices
format: pdf
filter:
  from: PREVMONTH
  until: MONTH
  tag: not:accountant
action: mark-sent-accountant

Instellen voor meerdere accounts:

Download bestanden voor meerdere accounts.

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.
• Pad, filters en actie kunnen globaal of per account worden ingesteld.

Voorbeeld download.yml voor meerdere accounts:

domain: eenvoudigfactureren.be
type: invoices
format: ubl
filter:
  from: PREVQUARTER
  tag: not:accountant
action: mark-sent-accountant
accounts:
  - 
    name: Bedrijf 1
    apikey: MY-APIKEY-1
    path: c:\pad\bedrijf1\{yyyy}\{mm}
    filter:
      from: 2024-01-01
  - 
    name: Bedrijf 2
    apikey: MY-APIKEY-2
    path: c:\pad\bedrijf2\{yyyy}\{mm}

batch
KopiërenBewerken
@echo off cd "C:\pad\naar\eenvoudigfactureren-tools-master" ruby importcoda.rb