Aflevering van facturen controleren

Overzicht

Na het versturen van een factuur kunt u de afleverstatus controleren om zeker te weten dat de factuur bij de ontvanger is aangekomen. faktoora houdt afleverpogingen bij voor verzending per e-mail, via Peppol en handmatige aflevering.

Afleverstatus controleren in de webinterface

1. Open de factuurdetails in uw faktoora-omgeving
2. Scrol naar het onderdeel "Afleveringen" (Delivery)
3. U ziet een lijst van alle afleverpogingen met de volgende gegevens:
   • Type: soort aflevering (e-mail, Peppol, handmatig)
   • Ontvanger: e-mailadres of Peppol-ID
   • Status: huidige afleverstatus
   • Bijgewerkt op: tijdstip van de laatste statuswijziging

Afleverstatus opvragen via de API

Gebruik het API-endpoint GET /invoices/{faktooraId}/status om de afleverstatus op te vragen:

GET https://api.faktoora.com/api/v1/invoices/{faktooraId}/status

De response bevat het veld delivery, een array met alle afleverpogingen:

{
  "delivery": [
    {
      "type": "email",
      "recipient": "rechnung@beispielkunde.de",
      "carbonCopy": "cc1@example.com",
      "blindCarbonCopy": "bcc@example.com"
    }
  ]
}

Waarden van de afleverstatus

Aflevering per e-mail

Bij aflevering per e-mail worden de adressen van de ontvangers opgeslagen, zonder dat een doorlopende afleverstatus wordt bijgehouden. U kunt de aflevering beoordelen aan de hand van het uitblijven van foutrapporten of bouncemeldingen.

Aflevering via Peppol

Afleveringen via Peppol hebben een doorlopende afleverstatus:

• PENDING_GENERATION: de factuur-XML wordt nog gegenereerd; de aflevering via Peppol is nog niet aangevraagd.
• ACTIVE: de verzending loopt.
• READY: wacht op de volgende herhaalpoging (treedt op na een fout bij een herhaalpoging).
• DELIVERED: aflevering bevestigd door het ontvangende toegangspunt.
• REJECTED: geweigerd door het ontvangende toegangspunt.
• FAILED: definitief mislukt (bijv. door een validatiefout).
• SUSPENDED: opgegeven nadat alle herhaalpogingen zijn gebruikt, of gepauzeerd; kan opnieuw worden gestart via POST /invoices/{faktooraId}/dispatch/peppol/resend.

Foutrapporten

Bij mislukte afleveringen via Peppol (status FAILED, REJECTED, SUSPENDED) bevat de response mogelijk een veld messages met fout- of waarschuwingsmeldingen:

{
  "type": "peppol",
  "recipient": "9930:DE123456789",
  "state": "REJECTED",
  "attempts": 3,
  "messages": [
    {
      "level": "ERROR",
      "code": "BR-S-02",
      "text": "Een fout bij de validatie van de bedrijfsregels"
    }
  ]
}

Veelvoorkomende problemen

Geen afleverbevestiging

Bij aflevering per e-mail worden standaard geen afleverbevestigingen van mailservers opgeslagen. Als u wilt controleren of een e-mail met succes is afgeleverd:

1. Controleer de aflevergeschiedenis in de webinterface
2. Controleer de logs van uw mailserver (als u een eigen SMTP-server gebruikt)
3. Vraag de ontvanger te bevestigen dat de factuur is ontvangen
4. Controleer of er bouncemeldingen van uw maildienst zijn

Aflevering via Peppol mislukt

Als een aflevering via Peppol mislukt:

1. Controleer de foutmeldingen in het veld messages
2. Los het probleem op (bijv. ongeldige gegevens, ontbrekende informatie)
3. Gebruik POST /invoices/{faktooraId}/dispatch/peppol/resend om de verzending te herhalen
4. Neem contact op met de support van faktoora als het probleem blijft bestaan

Geen afleverpogingen zichtbaar

Als de delivery-array leeg is:

1. De factuur is mogelijk nog niet verstuurd
2. Controleer of de factuur nog een concept is (draftOnly: true)
3. Controleer of u de verzending correct hebt aangevraagd

Aflevergeschiedenis bewaken

Voor geautomatiseerde bewaking of integratie met uw systeem kunt u de afleverstatus regelmatig opvragen:

1. Sla de faktooraId op na het aanmaken van de factuur
2. Vraag GET /invoices/{faktooraId}/status op
3. Controleer de delivery-array op statuswijzigingen
4. Implementeer foutafhandeling voor de statussen REJECTED, FAILED of SUSPENDED