Je kan facturen verzenden via e-mail, Peppol of via de post. Per verzendwijze heb je een afzonderlijke API aanroep. Echter is het ook mogelijk om meerdere aanroepen te combineren door bijvoorbeeld eerst te verzenden via Peppol en indien niet beschikbaar de verzending via e-mail uit te voeren.

Gebruik hiervoor de POST-methode met als URL bijvoorbeeld /api/v1/invoices/1001?send .

Deze optie is enkel beschikbaar voor facturen !

Geef bij de aanroep het gegeven "method" mee met een lijst van de gewenste verzendwijzes (op volgorde van uitvoering).

Een voorbeeld in JSON om jouw gegevens door te geven:

{
  "methods": {
    "peppol": {},
    "email": {
      "recipients": "12348",
      "message": "Beste,\nIn bijlage vindt u uw factuur terug."
    },
    "postalmail": {}
  }
}

Onmiddellijk verzenden tijdens aanmaak factuur

Tijdens aanmaak van een factuur kan je ook meegeven dat de verzending onmiddellijk moet worden uitgevoerd. Zo hoef je geen afzonderlijk aanroep uit te voeren.

Voeg de verzendopties toe via het veld "send".

Voorbeeld om de factuur aan te maken en te verzenden via Peppol met als fallback e-mail:

POST /api/v1/invoices

{
  "client_id": 101,
  "items": [{ "description": "Product X", "amount": 20 }],
  "send": {
    "peppol": {},
    "email": {
      "recipients": "first_contact"
    }
  }
}