Purchase invoice events
Two events tell you when a purchase invoice is stored. Use the event type to decide whether to process the invoice or send it for review.
These events describe purchase documents, including supplier invoices received through Peppol, the network used to exchange electronic invoices. They also cover invoices submitted as purchases through the API.
| Event | Fires when |
|---|---|
purchase.invoice.stored | The invoice was stored successfully. This includes invoices stored with warnings. |
purchase.invoice.validation_failed | The invoice failed validation. It is still stored, so you can see it in Documents, but it needs attention. |
Read the fields below from data.data in the delivery body. Fields such as supplier name, issue date and totals may be absent if they are unavailable.
| Field | Meaning |
|---|---|
documentId | The document’s ID in Complyance. Use it to open the document or fetch it through the Purchases API. |
documentNumber | The supplier’s invoice number |
documentType | For example tax_invoice or credit_note |
country | AE, SA, MY, BE or DE |
totalAmount | The invoice total including tax |
currency | ISO 4217 code, for example AED |
sellerName | The supplier |
issueDate | The date on the invoice |
submittedAt | When the invoice entered Complyance |
errors | Validation errors, when available: each has code, message and an optional path |
attribution | Company, branch and source details, when available |
attribution.companyId | The company the purchase belongs to. Use it to select the company in your integration. |
attribution.branchId | The branch, when identified. Do not assume every event includes it. |
What to do with them
- stored: create the invoice in your accounts-payable system, or start your approval flow.
- validation_failed: route the invoice to someone for review. Open it in Documents to see the errors in full.
These events are only for invoices you receive. Sales invoices you send to customers do not raise these purchase events.
To register for them, see Set up a webhook.
Last updated