Go live in Saudi Arabia

Onboard the company in production

A company onboarded in sandbox is not registered in production.

1. In the Invoice Portal, select Saudi Arabia and Production.
2. Follow Onboard a Saudi Arabian company with the company’s real details.
3. At Enter OTP, enter a code the company generates on the FATOORA portal.

You should see the screen that confirms the registration. This registers the company’s e-invoicing identity with ZATCA.

Create a production API key

In Developer portal › API keys, create a key under Production API keys. Give it Write access if it sends invoices. See Create an API key.

Link the production source

With Production selected, open Source management and link the source you added during onboarding to your integration mapping and the company’s branch. See Manage sources and their links.

Pass the required test cases

Check that the test cases for Saudi Arabia show Passed in Test your mapping. If your workspace uses the Default GETS Mapping, production documents are refused with 412 until they do.

Switch your requests to production

• Load the production key in place of the sandbox key.
• Send "environment": "production" in every Unify request.
• Set source to the production source’s name:version.
• If you use an SDK, change its environment setting to production. Each SDK guide shows where.

Check credits and webhooks

• In the Invoice Portal, open Credits with Production selected and check the balance. See Check your credit balance and usage.
• If you receive purchase invoices through webhooks, create a separate webhook for Production that points to your live endpoint. See Set up a webhook.

Send the first production invoice

Send one real invoice and follow it with its documentId until isTerminal is true. See Submit and retrieve. final_valid means ZATCA accepted it. rejected or final_invalid means it did not: read errors and government for the reason.