Common Errors
Use this page to quickly identify frequent UAE PINT AE validation failures and apply the recommended fix.
Quick Checklist
Before resubmitting an invoice, confirm these common points:
Use
0235+ 10-digit TIN for UAE participant identifiers.Use
YYYY-MM-DDdate 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).
Validation Errors and Fixes
| 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 |
| SBDH Envelope | 1360 / 1363 | Discrepancy between the Receiver/Identifier in the envelope and the EndpointID in the document. | Update the SBDH mapping to ensure the recipient identifiers are identical across all document layers. |
| Standards | ibr-cl-23 | Unit codes (ibt-130, ibt-150) must be coded according to UN/ECE Recommendation 20. | Map internal units to approved codes (e.g., H87 for pieces, LTR for liters). |
| Standards | ibr-cl-14 | Country codes must use ISO 3166-1 Alpha-2 list. | Use two-letter codes (e.g., AE for UAE, SA for Saudi Arabia) instead of full names. |
| Formatting | ibr-079 | Document must not contain empty elements. | Remove XML tags that do not contain data values. |
| Addressing | ibr-009 | Seller postal address (ibg-05) must contain a Seller country code (ibt-040). | Ensure the <cac:Country><cbc:IdentificationCode> is populated for the seller address. |
| Tax Logic | ibr-116-ae | Margin scheme flag requires tax category 'Standard rate additional VAT'. | If the Margin Scheme flag is set, ensure the tax category code is explicitly mapped to the additional VAT category. |
| Buyer Data | ibr-135-ae | Buyer identifier or Buyer VAT identifier must be present (except for Exports). | Provide the Buyer's TRN or Participant ID for domestic transactions. |
| Legal Details | ibr-172-ae | Authority name must be present when registration type is Commercial/Trade license. | Populate the AuthorityName field (BTAE-12) with the relevant licensing body (e.g., DED). |
| Calculation | ibr-147-ae | Line net amount must equal: (Quantity * Net Price) + Charges - Allowances. | Verify line-item arithmetic; ensure discounts and charges are correctly factored into the LineExtensionAmount. |
| Tax Rate | ibr-190-ae | Standard rated VAT must have a rate of 5.00. | Update the tax rate field to exactly 5.00 for all standard-rated categories. |
| Tax Logic | ibr-102-ae | VAT category taxable amount must equal the sum of line net amounts for 'Standard rate additional VAT'. | Ensure the breakdown taxable amount matches the aggregate of all lines using that specific tax category. |
| Tax Logic | ibr-108-ae | VAT category tax amount must be 0 for 'Standard rate additional VAT'. | Correct the breakdown so the tax amount for this specific category reflects the zero-reporting requirement. |
| Validation | ibr-151-ae | Commercial invoices/Credit notes should not only contain Exempt/Not subject to VAT items. | Ensure the document contains at least one taxable line or use the appropriate document type code. |
| Structural | XSD Error | Invalid content starting with CommodityClassification. Expected elements: ClassifiedTaxCategory, etc. | Correct the XML sequence; ClassifiedTaxCategory must appear before CommodityClassification in the Item block. |
| Tax Logic | ibr-114-ae | Document level charge cannot be 'Standard rate additional VAT'. | Reclassify document-level charges to a standard VAT category. |
| Tax Logic | ibr-122-ae | 'Out of scope' or 'Credit note' types must use Exempt, Not subject, or Zero rated categories. | Map the line-item VAT categories to match the restricted list allowed for these document types. |
| Identification | ibr-sr-57 | Company identifier must exist in the party tax scheme class. | Ensure the <cac:PartyTaxScheme><cbc:CompanyID> is populated for both parties. |
| Logic | ibr-105-ae | Exactly one VAT breakdown group for 'Standard rate additional VAT' is allowed. | Consolidate lines under a single breakdown group for this specific category. |
| Tax Rate | ibr-111-ae | VAT rate for 'Standard rate additional VAT' should not be zero. | Apply the correct non-zero rate for lines categorized as additional VAT. |
| Tax Logic | ibr-115-ae | Document level allowance cannot be 'Standard rate additional VAT'. | Reclassify allowances to standard tax categories. |
| Currency | ibr-126 | All currencyID attributes must match the Invoice currency code (except tax accounting currency). | Ensure attributes like currencyID="AED" match the document-level currency code. |
| Reverse Charge | ibr-166-ae | Type of goods or services (BTAE-09) must be present for Reverse Charge. | Provide the mandatory classification for reverse charge transactions. |
| Reverse Charge | ibr-174-ae | Item Standard Identifier (0160 scheme) must be present for Reverse Charge. | Include the GPC or relevant standard ID using scheme 0160. |
| Structural | XSD Error | Invalid content found starting with DespatchDocumentReference. | Adjust element order; reference elements must follow the strict UBL 2.1 sequence (e.g., after OrderReference). |
| Structural | XSD Error | Attribute 'schemeId' is not allowed in element cbc:CompanyID. | Remove the schemeId attribute from CompanyID; it is only permitted on EndpointID or PartyIdentification. |
| Reference | ibr-055-ae | Preceding invoice reference is mandatory for Credit Notes (except 'VD' reason). | Include the original invoice ID in <cac:BillingReference>. |
| Temporal | ibr-124-ae | VAT point date MUST NOT be present for Credit Notes. | Remove the <cbc:TaxPointDate> field from credit note documents. |
| Temporal | ibr-127-ae | Payment due date mandatory for non-zero amounts (except for Credit Notes or Deemed Supply). | Ensure <cbc:DueDate> is populated for all standard tax invoices. |
| Logic | ibr-157-ae | Transaction-type cannot be Summary, Deemed, or Margin for 'Out of scope' invoices. | Correct the 8-digit transaction flag to ensure it is compatible with the 'Out of scope' status. |
| Calculation | ibr-co-10 | Sum of Invoice line net amounts must equal total net amount. | Reconcile the LineExtensionAmount sum with the TaxableAmount in the legal monetary total. |