Statusberichten via Peppol

Hoe de ontvanger automatisch de factuurstatus terugkoppelt: ontvangen, goedgekeurd, betaald.

Statusberichten vormen het mechanisme waarmee de ontvanger van een factuur automatisch de verwerkingsstatus terugkoppelt aan de verzender. Via het Peppol-netwerk ontvangt de leverancier een statusbericht (Invoice Response) dat aangeeft of de factuur is ontvangen, in verwerking is, goedgekeurd of betaald. eConnect ondersteunt statusberichten al sinds 2015 en rekent ze niet apart af binnen de documentprijs.

Hoe werken statusberichten?

Het principe is eenvoudig: na het ontvangen van een e-factuur stuurt de ontvangende organisatie een Invoice Response terug naar de verzender. Dit bericht bevat een statuscode die aangeeft in welke fase van verwerking de factuur zich bevindt.

Het Invoice Response-bericht loopt via hetzelfde Peppol-netwerk als de originele factuur, maar dan in omgekeerde richting. De verzender ontvangt het bericht automatisch in zijn eConnect-omgeving en ziet de status bij de betreffende factuur verschijnen.

Tip: om Invoice Response-berichten te kunnen ontvangen als verzender, moet je organisatie zijn geregistreerd voor het ontvangen van Invoice Responses. Dit vereist een SMP-configuratie met de capability invoiceResponse op on.

Statuscodes

Elke Invoice Response bevat een statuscode die de fase van verwerking aangeeft. De statussen vormen een logische volgorde, van eerste ontvangst tot volledige betaling.

CodeStatusBetekenisABAcknowledgedDe factuur is ontvangen en leesbaar. Dit is de eerste bevestiging dat de factuur goed is aangekomen.IPIn ProcessDe factuur wordt verwerkt door de ontvanger. De beoordeling loopt nog.UQUnder QueryEr is een vraag over de factuur. De ontvanger heeft aanvullende informatie nodig van de leverancier voordat de verwerking verder kan.CAConditionally AcceptedDe factuur is voorwaardelijk geaccepteerd. Er zijn kleine aandachtspunten, maar de factuur wordt in principe goedgekeurd.RERejectedDe factuur is afgewezen. Dit is een eindstatus. De ontvanger geeft aan dat de factuur niet wordt verwerkt. De leverancier moet actie ondernemen, bijvoorbeeld een nieuwe factuur sturen.APApprovedDe factuur is goedgekeurd en de volgende stap is betaling.PDFully PaidDe factuur is volledig betaald. Dit is een eindstatus.

De statuscodes RE (Rejected) en PD (Fully Paid) zijn eindstatussen: na deze status volgen geen verdere updates meer. De overige statussen kunnen elkaar opvolgen naarmate de verwerking vordert.

Het volgende diagram toont hoe de statussen elkaar opvolgen, van eerste ontvangst tot de eindstatussen.

Clarification Reasons

Bij bepaalde statussen (vooral UQ en RE) kan de ontvanger een reden meegeven die aangeeft waarom de factuur wordt tegengehouden of afgewezen.

CodeRedenREFReferenties onjuist (ordernummer, contractnummer)LEGJuridisch onjuistRECOntvanger onbekendQUAKwaliteitsprobleem met geleverde goederen of dienstenDELLeveringsprobleemPRIPrijzen kloppen nietQTYHoeveelheid klopt nietITMArtikelen kloppen nietPAYBetaalvoorwaarden onjuistUNRFactuur niet herkendFINFinancieel probleemOTHOverige reden
Clarification Actions

Naast de reden kan de ontvanger ook aangeven welke actie hij van de leverancier verwacht:

CodeActieNOAGeen actie nodigPINAanvullende informatie verstrekkenNINNieuwe factuur sturenCNFFactuur volledig crediterenCNPFactuur gedeeltelijk crediterenCNABedrag terugbetalenOTHOverige actie
Statusberichten ontvangen op het platform

Wanneer een ontvanger een Invoice Response stuurt, verschijnt de status bij de betreffende factuur in je eConnect-omgeving. De statuswijziging wordt normaal gesproken binnen drie dagen na aanpassing door de ontvanger gecommuniceerd.

Je ontvangt de statusberichten automatisch, mits:

  • Je organisatie is geregistreerd voor het ontvangen van Invoice Responses via de SMP
  • De ontvanger van je factuur het Invoice Response-proces ondersteunt

Niet alle ontvangers ondersteunen statusberichten. Het is een functionaliteit die steeds breder wordt geadopteerd, maar op dit moment nog niet universeel is.

Het verschil met MLS

Naast Invoice Response bestaat er ook Message Level Status (MLS). Het verschil is belangrijk:

  • Invoice Response (statusberichten) is een business-level bericht. Het wordt gestuurd door de ontvangende organisatie (Corner 4) en gaat over de inhoudelijke verwerking van de factuur: is hij goedgekeurd, afgewezen, betaald?
  • MLS is een transport-level bericht. Het wordt gestuurd door het ontvangende Access Point (Corner 3) en gaat over de technische aflevering: is het document succesvol afgeleverd bij de ontvanger?

Beide berichttypen vullen elkaar aan. MLS vertelt je of de factuur technisch is aangekomen, Invoice Response vertelt je wat de ontvanger ermee doet.

MLS in de PSB: webhooks en afwijzingen

De PSB publiceert MLS-statusinformatie via twee webhook-topics. Bij een ontvangen MLS (van de tegenpartij of het andere Access Point) krijg je een MessageLevelStatusReceived-event. Zodra de PSB namens jou als ontvangende SP zelf een MLS uitstuurt naar de verzendende SP, volgt het topic MessageLevelStatusSent. Dit is bruikbaar voor monitoring van zelf-uitgegeven MLS-responses. Beide payloads bevatten de gebruikte statusCode, een description, het refToDocumentId van het oorspronkelijke document en het documentId van het MLS-bericht zelf.

Bij een handmatige MLS-afwijzing kan per fout een specifieke reden worden meegestuurd. De PSB accepteert in dat geval een lines-array met per regel een statusReasonCode en aanvullende beschrijving. Veelgebruikte codes zijn FD (failure of delivery, document permanent niet doorstuurbaar), SV (XML-schema-validatiefout), BV (business rule violation, fatale Schematron-fout) en BW (business rule warning, alleen samen met fatale fouten). Deze regels mappen één-op-één op de Status Reason Codes in de UBL ApplicationResponse die over Peppol wordt verstuurd, zodat de afzender precies kan zien welke fout op welke locatie is opgetreden.

Veelgestelde vragen
Wat als de ontvanger geen statusberichten stuurt?

Niet alle ontvangers ondersteunen Invoice Response-berichten. Het is een functionaliteit die steeds breder wordt geadopteerd, maar nog niet universeel is. Je kunt dan geen verwerkingsstatus inzien voor die specifieke factuur.

Wat is het verschil tussen Invoice Response en MLS?

Invoice Response is een business-level bericht dat de inhoudelijke verwerkingsstatus aangeeft (goedgekeurd, afgewezen, betaald). MLS (Message Level Status) is een transport-level bericht dat bevestigt of het document technisch is afgeleverd bij de ontvanger. Beide vullen elkaar aan.

Hoe schakel ik statusberichten in voor mijn organisatie?

Om Invoice Response-berichten te ontvangen als verzender, moet je organisatie zijn geregistreerd voor het ontvangen van Invoice Responses. Dit vereist een SMP-configuratie met de capability "invoiceResponse" op "on". Neem contact op met support voor hulp bij het configureren.


Wil je statusberichten inschakelen voor je organisatie? Neem contact op met support voor hulp bij het configureren van de Invoice Response-capability.

Meer weten over Peppol?

Gerelateerd