Skip to content
Open
Show file tree
Hide file tree
Changes from 19 commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
fc7d7a6
Require taxes on document-level charges (BR-37)
miguelalvarezd Nov 10, 2026
0ae0f23
Cite BR-38 and BR-42 in the EN 16931 reason rules
miguelalvarezd Nov 10, 2026
776758a
Add UAE identity keys to the AE regime
miguelalvarezd Nov 11, 2026
ccfa53a
Set the scope of UAE identities from their key
miguelalvarezd Nov 11, 2026
2c776d5
Add the profit margin scheme VAT key to the AE regime
miguelalvarezd Nov 12, 2026
c678da2
Leave the scope of UAE identities to the PINT addon
miguelalvarezd Nov 12, 2026
2a09680
Declare the EN 16931 charge rules in order and list BR-37 as a change
miguelalvarezd Nov 12, 2026
d9bcf84
Drop the AE identity normalization
miguelalvarezd Nov 12, 2026
2555817
Check the UAE TIN check digit, in TRNs too, and the Emirates ID prefix
miguelalvarezd Nov 12, 2026
711d4de
Use identity types for the UAE identities and simplify their checks
miguelalvarezd Nov 16, 2026
22d2000
Reject UAE TINs whose business identifier is all zeros
miguelalvarezd Nov 16, 2026
71ee2d6
Leave informative charges out of BR-37
miguelalvarezd Nov 16, 2026
cd707d6
Model the AE margin scheme as a tag with exempt lines
miguelalvarezd Nov 17, 2026
97fa379
Drop the all-zeros check on UAE TINs
miguelalvarezd Nov 17, 2026
1b63efc
Revert "Leave informative charges out of BR-37"
miguelalvarezd Nov 17, 2026
3bdbc47
Cite official sources for the UAE TRN and identity checks
miguelalvarezd Nov 17, 2026
547ed01
Merge branch 'address-street-third' into en16931-pint-ae-preparation
miguelalvarezd Nov 17, 2026
f9a54f3
Merge branch 'en16931-charge-taxes' into en16931-pint-ae-preparation
miguelalvarezd Nov 17, 2026
1f6494a
Move the EN 16931 changelog entries to the BR-37 PR
miguelalvarezd Nov 17, 2026
3575f3c
Merge branch 'en16931-charge-taxes' into en16931-pint-ae-preparation
miguelalvarezd Nov 17, 2026
68f893e
Merge branch 'en16931-charge-taxes' into en16931-pint-ae-preparation
miguelalvarezd Nov 18, 2026
343790e
Export the UAE TIN pattern
miguelalvarezd Nov 18, 2026
d4f67d2
Explain the exempt key on AE margin scheme lines
miguelalvarezd Nov 18, 2026
5964f65
Export the UAE TRN pattern
miguelalvarezd Nov 18, 2026
0061d26
Export the UAE TIN scheme
miguelalvarezd Nov 18, 2026
6991a0b
Merge branch 'en16931-charge-taxes' into en16931-pint-ae-preparation
miguelalvarezd Nov 19, 2026
a26856f
Trim the AE regime comments, description and tests
miguelalvarezd Nov 19, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions changes/unreleased/en16931-pint-ae-preparation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
## Added

- `ae`: identity types for the Tax Identification Number (`TIN`), trade licence (`TL`), Emirates ID (`EID`) and Cabinet Decision (`CD`). TINs must be 10 digits starting with 1 (`GOBL-AE-ORG-IDENTITY-01`) and end in a Luhn check digit (`GOBL-AE-ORG-IDENTITY-02`), as the Federal Tax Authority registered them under ISO 6523. Emirates ID numbers must be 15 digits starting with 784 (`GOBL-AE-ORG-IDENTITY-03`).
- `ae`: `margin-scheme` tag for supplies under the profit margin scheme, with a scenario that adds the statement the invoice must carry ("VAT charged under the Profit Margin Scheme") as a VAT note. Lines use the `exempt` key, so the invoice shows no VAT amount. Shown in the new `invoice-ae-margin-scheme` example.

## Changed

- `ae`: **breaking**: the tax ID code (TRN) must be 15 digits starting with 1 (`GOBL-AE-TAX-IDENTITY-01`), and its first 10 digits, the TIN, must end in a Luhn check digit (`GOBL-AE-TAX-IDENTITY-02`). Made-up numbers such as `123456789012345` now fail.
118 changes: 117 additions & 1 deletion data/regimes/ae.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,20 +5,123 @@
"en": "United Arab Emirates"
},
"description": {
"en": "The UAE tax system is administered by the Federal Tax Authority (FTA).\nVAT was introduced on January 1, 2018, with standard, zero, and\nexempt rate categories.\n\nBusinesses must register for VAT if taxable supplies and imports\nexceed AED 375,000 in a 12-month period, with voluntary registration\navailable above AED 187,500. Registered businesses receive a Tax\nRegistration Number (TRN) which must be included on all tax invoices.\n\nSimplified VAT invoices may be used when the recipient is not VAT\nregistered, or when the transaction value does not exceed AED 10,000\nfor VAT-registered recipients. Credit notes are supported for\ncorrecting invoices."
"en": "The UAE tax system is administered by the Federal Tax Authority (FTA).\nVAT was introduced on January 1, 2018, with standard, zero, and\nexempt rate categories.\n\nBusinesses must register for VAT if taxable supplies and imports\nexceed AED 375,000 in a 12-month period, with voluntary registration\navailable above AED 187,500. Registered businesses receive a Tax\nRegistration Number (TRN) which must be included on all tax invoices.\n\nSimplified VAT invoices may be used when the recipient is not VAT\nregistered, or when the transaction value does not exceed AED 10,000\nfor VAT-registered recipients. Credit notes are supported for\ncorrecting invoices.\n\nSupplies of eligible goods under the profit margin scheme use the\n\"margin-scheme\" tag, with the \"exempt\" VAT key on their lines. VAT\nis due on the margin and reported in the VAT return, so the invoice\nshows no VAT amount, only a statement that the scheme applies.\n\nElectronic invoicing is mandatory for any person conducting\nbusiness in the UAE, unless excluded by Ministerial Decision No. 243\nof 2025, following the phased timeline of Ministerial Decision\nNo. 244 of 2025. Electronic invoices follow PINT AE, the UAE's\nPeppol specification, and identify the parties by their 10-digit\nTax Identification Number (TIN)."
},
"sources": [
{
"title": {
"en": "Federal Tax Authority - VAT"
},
"url": "https://tax.gov.ae/en/taxes/Vat/vat.topics/registration.for.vat.aspx"
},
{
"title": {
"en": "Ministry of Finance - UAE Electronic Invoice Mandatory Field Requirements"
},
"url": "https://mof.gov.ae/wp-content/uploads/2026/10/UAE-Electronic-Invoice-Mandatory-Field-Requirements.pdf"
}
],
"time_zone": "Asia/Dubai",
"country": "AE",
"currency": "AED",
"tax_scheme": "VAT",
"tags": [
{
"schema": "bill/invoice",
"list": [
{
"key": "margin-scheme",
"name": {
"ar": "آلية هامش الربح",
"en": "Profit Margin Scheme"
},
"desc": {
"en": "Supply of eligible goods, such as second-hand goods, antiques or\ncollectors' items, under the profit margin scheme. Use the\n\"exempt\" VAT key on those lines. VAT is due on the margin and\nreported in the VAT return, so the invoice shows no VAT amount."
}
}
]
}
],
"identities": [
{
"code": "TIN",
"name": {
"ar": "رقم التعريف الضريبي",
"en": "Tax Identification Number"
},
"desc": {
"en": "10-digit number issued by the Federal Tax Authority, starting with 1 and ending in a Luhn check digit. Not the 15-digit VAT number (TRN), which starts with it and goes in the party's tax ID."
},
"sources": [
{
"title": {
"en": "Ministry of Finance - UAE Electronic Invoice Mandatory Field Requirements"
},
"url": "https://mof.gov.ae/wp-content/uploads/2026/10/UAE-Electronic-Invoice-Mandatory-Field-Requirements.pdf"
},
{
"title": {
"en": "Peppol Code Lists v9.7 - Participant Identifier Schemes - AE:TIN (ISO 6523 ICD 0235)"
},
"url": "https://docs.peppol.eu/edelivery/codelists/v9.7/Peppol%20Code%20Lists%20-%20Participant%20identifier%20schemes%20v9.7.json"
}
]
},
{
"code": "TL",
"name": {
"ar": "رقم الرخصة التجارية",
"en": "Trade License Number"
},
"sources": [
{
"title": {
"en": "Ministry of Finance - UAE Electronic Invoice Mandatory Field Requirements"
},
"url": "https://mof.gov.ae/wp-content/uploads/2026/10/UAE-Electronic-Invoice-Mandatory-Field-Requirements.pdf"
}
]
},
{
"code": "EID",
"name": {
"ar": "رقم الهوية الإماراتية",
"en": "Emirates ID Number"
},
"desc": {
"en": "15-digit number of the Emirates ID card, starting with 784, unique to its holder and kept for life."
},
"sources": [
{
"title": {
"en": "Ministry of Finance - UAE Electronic Invoice Mandatory Field Requirements"
},
"url": "https://mof.gov.ae/wp-content/uploads/2026/10/UAE-Electronic-Invoice-Mandatory-Field-Requirements.pdf"
},
{
"title": {
"en": "UAE Government Portal - Emirates ID"
},
"url": "https://u.ae/en/information-and-services/visa-and-emirates-id/emirates-id"
}
]
},
{
"code": "CD",
"name": {
"ar": "رقم قرار مجلس الوزراء",
"en": "Cabinet Decision Number"
},
"sources": [
{
"title": {
"en": "Ministry of Finance - UAE Electronic Invoice Mandatory Field Requirements"
},
"url": "https://mof.gov.ae/wp-content/uploads/2026/10/UAE-Electronic-Invoice-Mandatory-Field-Requirements.pdf"
}
]
}
],
"scenarios": [
{
"schema": "bill/invoice",
Expand Down Expand Up @@ -48,6 +151,19 @@
"key": "simplified",
"text": "Simplified Tax Invoice"
}
},
{
"tags": [
"margin-scheme"
],
"cat": [
"VAT"
],
"note": {
"cat": "VAT",
"key": "margin-scheme",
"text": "VAT charged under the Profit Margin Scheme"
}
}
]
}
Expand Down
77 changes: 75 additions & 2 deletions data/rules/ae.json
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,81 @@
"assert": [
{
"id": "GOBL-AE-TAX-IDENTITY-01",
"desc": "invalid UAE tax identity code",
"tests": "matches ^\\d{15}$"
"desc": "UAE tax identity code must be 15 digits starting with 1",
"tests": "matches ^1\\d{14}$"
}
]
},
{
"guard": "matches ^1\\d{14}$",
"subsets": [
{
"guard": "present",
"assert": [
{
"id": "GOBL-AE-TAX-IDENTITY-02",
"desc": "UAE tax identity code must start with a TIN with a valid check digit",
"tests": "valid TIN check digit"
}
]
}
]
}
]
}
]
}
]
},
{
"id": "GOBL-AE-ORG-IDENTITY",
"object": "org.Identity",
"subsets": [
{
"guard": "context: regime in [AE]",
"subsets": [
{
"guard": "type in [TIN]",
"subsets": [
{
"field": "code",
"assert": [
{
"id": "GOBL-AE-ORG-IDENTITY-01",
"desc": "UAE TIN must be 10 digits starting with 1",
"tests": "matches ^1\\d{9}$"
}
],
"subsets": [
{
"guard": "matches ^1\\d{9}$",
"subsets": [
{
"guard": "present",
"assert": [
{
"id": "GOBL-AE-ORG-IDENTITY-02",
"desc": "UAE TIN must end in a valid check digit",
"tests": "valid TIN check digit"
}
]
}
]
}
]
}
]
},
{
"guard": "type in [EID]",
"subsets": [
{
"field": "code",
"assert": [
{
"id": "GOBL-AE-ORG-IDENTITY-03",
"desc": "Emirates ID number must be 15 digits starting with 784",
"tests": "matches ^784\\d{12}$"
}
]
}
Expand Down
4 changes: 2 additions & 2 deletions examples/ae/invoice-ae-ae-stnr.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ code: "001"
supplier:
tax_id:
country: "AE"
code: "123456789012346"
code: "187654321400003"
name: "Provide One LLC"
emails:
- addr: "billing@example.ae"
Expand All @@ -22,7 +22,7 @@ supplier:
customer:
tax_id:
country: "AE"
code: "123456789012345"
code: "123456789700003"
name: "Sample Consumer"
emails:
- addr: "email@sample.ae"
Expand Down
46 changes: 46 additions & 0 deletions examples/ae/invoice-ae-margin-scheme.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
$schema: "https://gobl.org/draft-0/bill/invoice"
uuid: "0195ce71-dc9c-72c8-bf2c-9890a4a9f0b3"
currency: "AED"
issue_date: "2026-02-11"
series: "SAMPLE"
code: "002"
$tags:
- "margin-scheme"

supplier:
tax_id:
country: "AE"
code: "187654321400003"
name: "Provide One LLC"
emails:
- addr: "billing@example.ae"
addresses:
- num: "16"
street: "Sheikh Zayed Road"
locality: "Dubai"
code: "00000"
country: "AE"

customer:
tax_id:
country: "AE"
code: "123456789700003"
name: "Sample Consumer"
emails:
- addr: "email@sample.ae"
addresses:
- num: "25"
street: "Al Maryah Island"
locality: "Abu Dhabi"
code: "00000"
country: "AE"

lines:
- quantity: 1
item:
name: "Second-hand watch"
price: "1000.00"
taxes:
- cat: VAT
key: "exempt"

2 changes: 1 addition & 1 deletion examples/ae/invoice-ae-simplified.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ tax:
supplier:
tax_id:
country: "AE"
code: "123456789012346"
code: "187654321400003"
name: "Provide One LLC"
emails:
- addr: "billing@example.ae"
Expand Down
6 changes: 3 additions & 3 deletions examples/ae/out/invoice-ae-ae-stnr.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"uuid": "8a51fd30-2a27-11ee-be56-0242ac120002",
"dig": {
"alg": "sha256",
"val": "2451e6346ee3714e680cb65a239e5a8a09a284fed0ca941ed7fdc1e6eaa8309f"
"val": "3949e99e75b2e36c4da577b6444893396140b66bb1491fc7b9fd3881747b85c7"
}
},
"doc": {
Expand All @@ -20,7 +20,7 @@
"name": "Provide One LLC",
"tax_id": {
"country": "AE",
"code": "123456789012346"
"code": "187654321400003"
},
"addresses": [
{
Expand All @@ -41,7 +41,7 @@
"name": "Sample Consumer",
"tax_id": {
"country": "AE",
"code": "123456789012345"
"code": "123456789700003"
},
"addresses": [
{
Expand Down
Loading
Loading