Common integration problems and solutions

Solutions for common problems when integrating with the PEPPOL United Arab Emirates (UAE) e-invoicing API.

422 validation error: missing CustomizationID

Symptom

First test submission returns a 422 response with a CustomizationID error.

Solution

Set Invoice.CustomizationID to the exact PINT-AE URN:

urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0#conformant#urn:fdc:ae.gov.mof:2025:pint-ae:billing:1.0

Symptom: The document passes Sovosvalidation but returns INVALID_RECEIVER from the ASP.
Cause: The buyer's TIN is not found in the PEPPOL network. Either the buyer has not appointed an ASP, or the TIN is incorrect.
Solution: Verify the buyer TIN directly with the buyer. Confirm they have completed EmaraTax onboarding with an ASP. During the transition period before mandatory go-live, some buyers may not yet be registered. incorrect.

Symptom

Submitting returns 409 Conflict.

Cause

Your system submitted the same SenderDocumentId twice, for example, after retrying a timed-out request.

Solution

Before retrying, poll the notifications endpoint using the original transactionId to check whether the first submission succeeded.

If it did, don't resubmit. If it didn't, resubmit with a new SenderDocumentId.

Symptom: Validation error on TaxTotal or a line-level tax field.
Cause: The invoice is in a foreign currency without AED-equivalent tax amounts.
Solution: Calculate the AED equivalent of all tax amounts and include them at both the header (TaxTotal.TaxAmount) and each invoice line.

Symptom: Status reaches PROCESSING but no further updates arrive.
Cause: N/A
Solution: Wait up to 30 minutes and poll again. If the status has not advanced after two hours, contact Sovos support with the transactionId.

Symptom

N/A

Cause

N/A

Solution

Record the affected invoices and the outage time range.
When your system recovers, resubmit the queued invoices.
Report the outage to the Federal Tax Authority (FTA) through EmaraTax within two business days if it prevented timely submission.