Overview
QBM includes a legacy Accqrate/ZATCA integration for Saudi e-invoicing workflows. It is separate from PintAE e-invoicing. Use this guide only when the company is specifically configured for Accqrate or ZATCA.
Do not mix integrations: If the company is using PintAE, follow the PintAE guide. If it is using Accqrate/ZATCA, follow this guide and avoid changing PintAE settings unless support instructs you.
Accqrate Settings
Open Options, then go to the integrations area and select the Accqrate settings.
| Setting | Purpose |
|---|---|
| Enable Accqrate | Turns Accqrate submission on or off. |
| URL Address | The Accqrate transmission endpoint. |
| App Key | The application key supplied by the integration provider. |
| Secret Key | The private secret used for authentication. Handle this carefully. |
ZATCA Settings
The ZATCA tab includes certificate, authorization, and environment settings used for submission.
| Setting | Purpose |
|---|---|
| Enable ZATCA | Turns the ZATCA workflow on or off. |
| Developer / Simulation / Production | Selects the ZATCA environment. Production should be used only after testing and approval. |
| Reporting URL / Clearance URL | Service addresses used for reporting or clearance. |
| Certificate content | Certificate data required for e-invoicing communication. |
| Private key content | Private key data paired with the certificate. |
| Authorization | Authorization or secret content required by the integration. |
| Onboarding | Opens the onboarding workflow when the company must register or renew the ZATCA setup. |
Submitting Documents
- Open the supported invoice or transaction.
- Review customer, VAT number, tax, date, totals, and invoice type.
- Use Submit to ZATCA only when the document is ready.
- Review the returned response and keep any required reference.
- If submission fails, do not keep retrying blindly. Read the message and correct the document or settings first.
Troubleshooting
- If the button is not visible, confirm the integration is enabled and the document supports ZATCA posting.
- If authentication fails, check URL, app key, secret key, certificate, private key, and authorization content.
- If the document is rejected, review VAT number, customer details, invoice type, tax code, currency, and totals.
- If production fails after testing worked, confirm the environment is set to Production and production credentials are loaded.