APIUse this page to quickly identify frequent UAE PINT AE validation failures and apply the recommended fix.
Before resubmitting an invoice, confirm these common points:
Use 0235 + 10-digit TIN for UAE participant identifiers.
Use YYYY-MM-DD date format for all date fields.
Keep TaxPointDate <= InvoiceIssueDate.
Ensure tax totals reconcile from line to document level with correct rounding.
Use 8-digit ProfileExecutionID (00000000).
| Error Category | Type Code(s) | What Causes It | How to Fix It |
|---|---|---|---|
| Participant Identification | IBR-148-AE | Full 15-digit TRN is used in EndpointID instead of the required 10-digit TIN. | Use only the first 10 digits (TIN) when constructing EndpointID. |
| VAT Identifier | IBR-132-AE | TRN isn't following the correct rule | TRN should be 15 digit, start with 1 and end with 03 |
| Unit of Measure | IBR-CL-23 | Invalid unit_code code is used. | Use valid unit_code codes from /supporting-resources/codelists/get-unit-of-measure-codes. |
| Date Formatting | IBT-002 | Dates are sent in regional formats such as DD/MM/YYYY. | Send all dates in ISO 8601 format: YYYY-MM-DD. |
| Tax Point Logic | IBR-141-AE | TaxPointDate (date of supply) is later than invoice issue date. | Ensure the captured supply date is less than or equal to the invoice issue date. |
| Currency Conversion | IBR-159-AE, BTAE-04 | VAT amounts in AED are missing for invoices issued in foreign currency. | Convert and report mandatory VAT amounts in AED using the UAE Central Bank exchange rate. |
| Emirate Subdivision | IBR-078-AE | Free-text emirate names (for example Dubai) are used in CountrySubentity. | Use approved codes: AUH, DXB, SHJ, AJM, UAQ, RAK, FUJ. |
| Postal Code Gaps | IBR-143-AE, IBR-144-AE | Postal code is missing in systems that enforce ZIP/postal validation. | Use 00000 as a workaround, or supply the recipient P.O. Box when appropriate. |
| Invoice Classification | IBT-003, IBR-122-AE | Simplified tax invoice is issued for B2B transactions that require a full tax invoice. | Configure ERP rules to issue full tax invoices for B2B; keep simplified invoices for eligible B2C cases. |
| Transaction Flags | IBT-024, X1XXXXXX | 8-digit transaction type flag is set incorrectly for special scenarios (for example free zones or exports). | Populate transaction metadata according to supply type; for exports, use FTA endpoint 0235:9900000099 where required. |
| Mathematical Precision | IBR-146-AE, ALIGNED-IBRP-004 | Line and document totals do not reconcile due to rounding or calculation sequence. | Sum line totals first, then apply document allowances/charges, and round monetary totals to 2 decimal places. |
| Technical Metadata | IBR-154-AE | ProfileExecutionID is not 8 digits (for example a single 0). | Use exactly 8 digits: 00000000 |