Purchase Invoice Webhooks Overview
Purchase invoice webhooks allow your system to receive real-time notifications when purchase invoices are stored or fail validation in the Complyance platform. Instead of polling for status updates, your application can react immediately when an event is delivered to your endpoint.
How the Flow Works
The purchase invoice webhook flow is designed for incoming invoices received by your organization through the Peppol network.
- A seller sends an invoice to your Peppol ID
- The invoice is received and processed by the Complyance receiving flow
- The document is stored as a purchase invoice in the platform
- Complyance emits a webhook event to your configured endpoint
Important Clarification
Purchase invoice webhooks are intended for buyer-side incoming invoice events. They are not emitted when a seller submits an invoice through the Unify API. Seller-side invoice submissions follow a different event path.
When a Webhook Is Triggered
A purchase invoice webhook is emitted after the invoice has been successfully processed by the receiving flow and written to the purchases collection.
The currently documented trigger points are:
purchase.invoice.storedpurchase.invoice.validation_failed
Supported Environments
| Environment | Description | Typical use case |
|---|---|---|
sandbox | Test environment with simulated invoice events | Development and integration testing |
production | Live environment with real invoice events | Production processing |
Supported Countries
Purchase invoice webhooks are currently documented for the following countries:
| Code | Country |
|---|---|
AE | United Arab Emirates |
SA | Saudi Arabia |
MY | Malaysia |
DE | Germany |
BE | Belgium |
Event Types
| Event | Description |
|---|---|
purchase.invoice.stored | Fired when a purchase invoice is stored successfully, including cases with warnings |
purchase.invoice.validation_failed | Fired when the incoming purchase invoice fails validation |
Where This Fits in the Platform
Complyance supports multiple webhook categories across the platform, including invoice, masters, documents, onboarding, credits, reports, workspace, and support-related flows. This guide focuses only on the two purchase invoice webhook events above.
Best Use Cases
- Automatically create AP review tasks when a supplier invoice arrives
- Trigger downstream validation or enrichment in your ERP
- Notify finance operations when incoming invoices fail validation
- Maintain a near-real-time mirror of inbound purchase invoice activity