Go live in Belgium

Onboard the company in production

A company onboarded in sandbox is not registered in production.

1. In the Invoice Portal, select Belgium and Production.
2. Follow Onboard a Belgian company with the company’s real details.
3. In the Peppol setup, register a participant or use the company’s existing participant ID. Never use a test ID in production.

Open Onboard and wait until the company’s registration is complete. A Pending registration is not ready to send invoices.

Move your integration to production

• Create a key under Production API keys with Write access. See Create an API key.
• With Production selected, link the source you added during onboarding to your mapping and the company’s branch. See Manage sources and their links.
• Send "environment": "production" and the production source’s name:version in every Unify request. If you use an SDK, change its environment setting; each SDK guide shows where.
• Check the production credit balance in Credits. To receive purchase invoices from your suppliers through webhooks, create a separate production webhook. See Credits and Set up a webhook.

Check the required test cases

If your workspace uses the Default GETS Mapping, the test cases for Belgium must show Passed in Test your mapping. Until they do, Unify refuses invoices with 412 and failed_precondition, in sandbox and in production.

Send the first production invoice

Send one real invoice to a buyer and follow it with its documentId. See Submit and retrieve. For Belgium, Complyance’s last step is delivering the invoice to the buyer’s Peppol access point: the Invoice Portal then shows it as Submitted, with delivery Delivered. The API does not report final_valid for a Belgian invoice, and isTerminal stays false after delivery. Stop checking when state is delivery_success or delivery_failed. rejected means it failed validation: read errors for the reason. Confirm with the buyer that the invoice arrived.