Lifecycles and use cases

Understand how invoices move through the United Arab Emirates (UAE) e-invoicing network, when a transaction is complete, and how to handle corrections, self-billing, system failures, and archiving.

Transaction lifecycle

After you submit an invoice, Sovos tracks its status through multiple stages. An HTTP 200 response means Sovos accepted the document for processing, but delivery and reporting may still be in progress.

Submitted → Validated (106) → Passed to ASP → Sent to buyer ASP
         → Delivered (DELIVERED) → TDD reported to FTA (REPORTED) → Complete

Errors can occur at any stage. Check the error code and the next steps in the status tables in Send invoices.

When is a transaction complete?

A transaction is complete when both of the following conditions are met:

Sovos has delivered the invoice to the buyer's Access Service Provider (ASP) (DELIVERED).
Sovos has reported the Tax Data Document (TDD) to the Federal Tax Authority (FTA) and received confirmation (REPORTED).

A DELIVERED status doesn't mean the transaction is complete. Keep polling until you see REPORTED. FTA reporting is a separate step. Sovos has to complete the transaction before the transaction is compliant.

Polling for status

Poll the notifications endpoint to check progress. Poll every 30 seconds for the first two minutes, then every two minutes.

GET /v1/{proxyName}/ae/{transactionId}/notifications
Authorization: Bearer {token}

Tip:

Sovos updates invoice status at regular intervals, not immediately. If you poll continuously without a delay, you'll get the same status repeatedly and put unnecessary load on your system.

Response examples

Example 1: Document validated, processing

{ 
    "status": 202, 
    "message": "Accepted", 
    "success": true, 
    "timestamp": 1781177419607, 
    "data": { 
        "transactionId": "1fdeaaab-426a-413a-a5f0-20171210afd8", 
        "documentId": "80b281cbcdd9872bc57a32018b111cc5" 
    } 
}

Example 2: Transaction complete


{ 
    "notificationId": "56609bad-fc33-42bc-9a2b-1124e1a9ec9f", 
    "correlationId": "85ac4412-16aa-4d44-835a-487c334dfd67", 
    "appPrefix": "DLT", 
    "metadata": { 
        "productId": "ae_pint__1.0", 
        "transactionId": "02480f25-fabd-461f-ab15-708393c0f785", 
        "documentId": "109739f89e416a83652e87309d870496", 
        "erpDocumentId": "INV-2026-314", 
        "erpSystemId": "DefaultSystemERP", 
        "processType": "0", 
        "taxId": "198765432102003", 
        "sciCloudStatusCode": "207", 
        "sciResponseCode": "AP", 
        "sciStatusAction": "NOA" 
        }, 
    "content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPEFwcGxpY2F0aW9uUmVzcG9uc2UgeG1sbnM9InVybjpvYXNpczpuYW1lczpzcGVjaWZpY2F0aW9uOnVibDpzY2hlbWE6eHNkOkFwcGxpY2F0aW9uUmVzcG9uc2UtMiIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSIgeG1sbnM6Y2FjPSJ1cm46b2FzaXM6bmFtZXM6c3BlY2lmaWNhdGlvbjp1Ymw6c2NoZW1hOnhzZDpDb21tb25BZ2dyZWdhdGVDb21wb25lbnRzLTIiIHhtbG5zOmNiYz0idXJuOm9hc2lzOm5hbWVzOnNwZWNpZmljYXRpb246dWJsOnNjaGVtYTp4c2Q6Q29tbW9uQmFzaWNDb21wb25lbnRzLTIiIHhtbG5zOmV4dD0idXJuOm9hc2lzOm5hbWVzOnNwZWNpZmljYXRpb246dWJsOnNjaGVtYTp4c2Q6Q29tbW9uRXh0ZW5zaW9uQ29tcG9uZW50cy0yIiB4bWxuczphZD0iaHR0cDovL3d3dy5zb3Zvcy5jb20vbmFtZXNwYWNlcy9hZGRpdGlvbmFsRGF0YSI+CiAgPGNiYzpVQkxWZXJzaW9uSUQ+Mi4xPC9jYmM6VUJMVmVyc2lvbklEPgogIDxjYmM6Q3VzdG9taXphdGlvbklEPnVybjpzb3ZvczpuYW1lczpzcGVjaWZpY2F0aW9uOnNjaTpzY2hlbWE6eHNkOlRyYW5zYWN0aW9uLTM8L2NiYzpDdXN0b21pemF0aW9uSUQ+CiAgPGNiYzpQcm9maWxlSUQ+dXJuOnNvdm9zOm5hbWVzOnNwZWNpZmljYXRpb246c2NpOnNjaGVtYTp4c2Q6VHJhbnNhY3Rpb24tMzwvY2JjOlByb2ZpbGVJRD4KICA8Y2JjOklEPjU2NjA5YmFkLWZjMzMtNDJiYy05YTJiLTExMjRlMWE5ZWM5ZjwvY2JjOklEPgogIDxjYmM6SXNzdWVEYXRlPjIwMjYtMDYtMDg8L2NiYzpJc3N1ZURhdGU+CiAgPGNiYzpJc3N1ZVRpbWU+MTE6MDI6MTc8L2NiYzpJc3N1ZVRpbWU+CiAgPGNhYzpTZW5kZXJQYXJ0eT4KICAgIDxjYWM6UGFydHlJZGVudGlmaWNhdGlvbj4KICAgICAgPGNiYzpJRD5iYmZlYmZmNy1jMzAxLTQxZWQtYjAxNC1lNTRiZGI0ZDU0M2I8L2NiYzpJRD4KICAgIDwvY2FjOlBhcnR5SWRlbnRpZmljYXRpb24+CiAgICA8Y2FjOlBhcnR5TmFtZT4KICAgICAgPGNiYzpOYW1lPlNvdm9zIENvbXBsaWFuY2U8L2NiYzpOYW1lPgogICAgPC9jYWM6UGFydHlOYW1lPgogICAgPGNhYzpDb250YWN0PgogICAgICA8Y2JjOk5hbWU+U292b3MgQ29udGFjdCBOYW1lPC9jYmM6TmFtZT4KICAgICAgPGNiYzpUZWxlcGhvbmU+KzU1MTE5ODc2NTQzMjE8L2NiYzpUZWxlcGhvbmU+CiAgICAgIDxjYmM6RWxlY3Ryb25pY01haWw+Y29udGFjdEBzb3Zvcy5jb208L2NiYzpFbGVjdHJvbmljTWFpbD4KICAgIDwvY2FjOkNvbnRhY3Q+CiAgPC9jYWM6U2VuZGVyUGFydHk+CiAgPGNhYzpSZWNlaXZlclBhcnR5IC8+CiAgPGNhYzpEb2N1bWVudFJlc3BvbnNlPgogICAgPGNhYzpSZXNwb25zZT4KICAgICAgPGNiYzpSZWZlcmVuY2VJRD48L2NiYzpSZWZlcmVuY2VJRD4KICAgICAgPGNiYzpSZXNwb25zZUNvZGUgbGlzdElEPSJTQ0lSZXNwb25zZUNvZGUiPkFQPC9jYmM6UmVzcG9uc2VDb2RlPgogICAgICA8Y2FjOlN0YXR1cz4KICAgICAgICA8Y2JjOlN0YXR1c1JlYXNvbkNvZGUgbGlzdElEPSJTQ0lDbG91ZFN0YXR1c0NvZGUiPjIwNzwvY2JjOlN0YXR1c1JlYXNvbkNvZGU+CiAgICAgICAgPGNiYzpTdGF0dXNSZWFzb24+UGRmIGNyZWF0ZWQgc3VjY2Vzc2Z1bGx5PC9jYmM6U3RhdHVzUmVhc29uPgogICAgICA8L2NhYzpTdGF0dXM+CiAgICAgIDxjYWM6U3RhdHVzPgogICAgICAgIDxjYmM6U3RhdHVzUmVhc29uQ29kZSBsaXN0SUQ9IlNDSVN0YXR1c0FjdGlvbiI+Tk9BPC9jYmM6U3RhdHVzUmVhc29uQ29kZT4KICAgICAgICA8Y2JjOlN0YXR1c1JlYXNvbj5ObyBhY3Rpb24gcmVxdWlyZWQ8L2NiYzpTdGF0dXNSZWFzb24+CiAgICAgIDwvY2FjOlN0YXR1cz4KICAgICAgPGNhYzpTdGF0dXM+CiAgICAgICAgPGNiYzpTdGF0dXNSZWFzb25Db2RlIGxpc3RJRD0iU0NJRVJQU3RhdHVzQ29kZSI+PC9jYmM6U3RhdHVzUmVhc29uQ29kZT4KICAgICAgICA8Y2JjOlN0YXR1c1JlYXNvbj5QZGYgY3JlYXRlZCBzdWNjZXNzZnVsbHk8L2NiYzpTdGF0dXNSZWFzb24+CiAgICAgIDwvY2FjOlN0YXR1cz4KICAgIDwvY2FjOlJlc3BvbnNlPgogICAgPGNhYzpEb2N1bWVudFJlZmVyZW5jZT4KICAgICAgPGNiYzpJRD44cEJkc3NGM3Z6MExtemg5NFg0NjUtc2NOUEpsa1MyUmc4bDYxa09ublcxVXJoZEF3SE4xVEVDWnFEdUNEcGpxOFlxck55Nk5wc0FNM3FEZVN6RkFyZ3EwdF9EYUZWcGdkdVlZREJzSy1la2hDaDFSTWRZSERfemdJNnpTQXAySVdENk84ekdtMGRTS0djWjFOcVIwd19HUnFDcDJLYS1iZE1BWTZ4T1A1MXRBdGRHR2QtZVNNZE1NWThZaUZWODU8L2NiYzpJRD4KICAgICAgPGNiYzpEb2N1bWVudFR5cGVDb2RlPkxlZ2FsQ2xlYXJlZDwvY2JjOkRvY3VtZW50VHlwZUNvZGU+CiAgICAgIDxjYWM6QXR0YWNobWVudD4KICAgICAgICA8Y2FjOkV4dGVybmFsUmVmZXJlbmNlPgogICAgICAgICAgPGNiYzpVUkkgc2NoZW1lSUQ9IkxlZ2FsQ2xlYXJlZCI+aHR0cHM6Ly9xYS1yZWdpb25hbC1laW52b2ljaW5nLWFwaS1lbWVhLnNvdm9zLmNvbS9kb3dubG9hZC9hcGkvdjEvZG93bmxvYWQvOHBCZHNzRjN2ejBMbXpoOTRYNDY1LXNjTlBKbGtTMlJnOGw2MWtPbm5XMVVyaGRBd0hOMVRFQ1pxRHVDRHBqcThZcXJOeTZOcHNBTTNxRGVTekZBcmdxMHRfRGFGVnBnZHVZWURCc0stZWtoQ2gxUk1kWUhEX3pnSTZ6U0FwMklXRDZPOHpHbTBkU0tHY1oxTnFSMHdfR1JxQ3AyS2EtYmRNQVk2eE9QNTF0QXRkR0dkLWVTTWRNTVk4WWlGVjg1L3BsYWluPC9jYmM6VVJJPgogICAgICAgICAgPGNiYzpNaW1lQ29kZT5hcHBsaWNhdGlvbi94bWw8L2NiYzpNaW1lQ29kZT4KICAgICAgICAgIDxjYmM6RmlsZU5hbWU+Q2xlYXJlZEludm9pY2UueG1sPC9jYmM6RmlsZU5hbWU+CiAgICAgICAgPC9jYWM6RXh0ZXJuYWxSZWZlcmVuY2U+CiAgICAgIDwvY2FjOkF0dGFjaG1lbnQ+CiAgICA8L2NhYzpEb2N1bWVudFJlZmVyZW5jZT4KICAgIDxjYWM6RG9jdW1lbnRSZWZlcmVuY2U+CiAgICAgIDxjYmM6SUQ+OHBCZHNzRjN2ejBMbXpoOTRYNDY1LXNjTlBKbGtTMlJnOGw2MWtPbm5XMVVyaGRBd0hOMVRFQ1pxRHVDRHBqcThZcXJOeTZOcHNBTTNxRGVTekZBcmdxMHRfRGFGVnBnZHVZWURCc0stZWtoQ2gxUk1kWUhEX3pnSTZ6U0FwMklXclFvS2Njd2czb2E5U200aUo5czlmOUFWRDA4U3MwNlRXMEJhMDhwdWdVPC9jYmM6SUQ+CiAgICAgIDxjYmM6RG9jdW1lbnRUeXBlQ29kZT5MZWdhbDwvY2JjOkRvY3VtZW50VHlwZUNvZGU+CiAgICAgIDxjYWM6QXR0YWNobWVudD4KICAgICAgICA8Y2FjOkV4dGVybmFsUmVmZXJlbmNlPgogICAgICAgICAgPGNiYzpVUkkgc2NoZW1lSUQ9IkxlZ2FsIj5odHRwczovL3FhLXJlZ2lvbmFsLWVpbnZvaWNpbmctYXBpLWVtZWEuc292b3MuY29tL2Rvd25sb2FkL2FwaS92MS9kb3dubG9hZC84cEJkc3NGM3Z6MExtemg5NFg0NjUtc2NOUEpsa1MyUmc4bDYxa09ublcxVXJoZEF3SE4xVEVDWnFEdUNEcGpxOFlxck55Nk5wc0FNM3FEZVN6RkFyZ3EwdF9EYUZWcGdkdVlZREJzSy1la2hDaDFSTWRZSERfemdJNnpTQXAySVdyUW9LY2N3ZzNvYTlTbTRpSjlzOWY5QVZEMDhTczA2VFcwQmEwOHB1Z1UvcGxhaW48L2NiYzpVUkk+CiAgICAgICAgICA8Y2JjOk1pbWVDb2RlPmFwcGxpY2F0aW9uL3htbDwvY2JjOk1pbWVDb2RlPgogICAgICAgICAgPGNiYzpGaWxlTmFtZT5JbnZvaWNlLnhtbDwvY2JjOkZpbGVOYW1lPgogICAgICAgIDwvY2FjOkV4dGVybmFsUmVmZXJlbmNlPgogICAgICA8L2NhYzpBdHRhY2htZW50PgogICAgPC9jYWM6RG9jdW1lbnRSZWZlcmVuY2U+CiAgICA8Y2FjOkRvY3VtZW50UmVmZXJlbmNlPgogICAgICA8Y2JjOklEPjhwQmRzc0YzdnowTG16aDk0WDQ2NS1zY05QSmxrUzJSZzhsNjFrT25uVzFVcmhkQXdITjFURUNacUR1Q0RwanE4WXFyTnk2TnBzQU0zcURlU3pGQXJncTB0X0RhRlZwZ2R1WVlEQnNLLWVraENoMVJNZFlIRF96Z0k2elNBcDJJdHhRRmRHZkNYUXNDUlFJQnl0dWVIRTJGcEFTVWwzM01rX0NfZUJzQllyYzwvY2JjOklEPgogICAgICA8Y2JjOkRvY3VtZW50VHlwZUNvZGU+UERGPC9jYmM6RG9jdW1lbnRUeXBlQ29kZT4KICAgICAgPGNhYzpBdHRhY2htZW50PgogICAgICAgIDxjYWM6RXh0ZXJuYWxSZWZlcmVuY2U+CiAgICAgICAgICA8Y2JjOlVSSSBzY2hlbWVJRD0iUERGIj5odHRwczovL3FhLXJlZ2lvbmFsLWVpbnZvaWNpbmctYXBpLWVtZWEuc292b3MuY29tL2Rvd25sb2FkL2FwaS92MS9kb3dubG9hZC84cEJkc3NGM3Z6MExtemg5NFg0NjUtc2NOUEpsa1MyUmc4bDYxa09ublcxVXJoZEF3SE4xVEVDWnFEdUNEcGpxOFlxck55Nk5wc0FNM3FEZVN6RkFyZ3EwdF9EYUZWcGdkdVlZREJzSy1la2hDaDFSTWRZSERfemdJNnpTQXAySXR4UUZkR2ZDWFFzQ1JRSUJ5dHVlSEUyRnBBU1VsMzNNa19DX2VCc0JZcmMvcGxhaW48L2NiYzpVUkk+CiAgICAgICAgICA8Y2JjOk1pbWVDb2RlPmFwcGxpY2F0aW9uL3BkZjwvY2JjOk1pbWVDb2RlPgogICAgICAgICAgPGNiYzpGaWxlTmFtZT5QZGYucGRmPC9jYmM6RmlsZU5hbWU+CiAgICAgICAgPC9jYWM6RXh0ZXJuYWxSZWZlcmVuY2U+CiAgICAgIDwvY2FjOkF0dGFjaG1lbnQ+CiAgICA8L2NhYzpEb2N1bWVudFJlZmVyZW5jZT4KICAgIDxjYWM6SXNzdWVyUGFydHk+CiAgICAgIDxjYWM6UGFydHlJZGVudGlmaWNhdGlvbj4KICAgICAgICA8Y2JjOklEPkNvbnRhY3QgTmFtZTwvY2JjOklEPgogICAgICA8L2NhYzpQYXJ0eUlkZW50aWZpY2F0aW9uPgogICAgICA8Y2FjOlBhcnR5TmFtZT4KICAgICAgICA8Y2JjOk5hbWU+Q29udGFjdCBOYW1lPC9jYmM6TmFtZT4KICAgICAgPC9jYWM6UGFydHlOYW1lPgogICAgICA8Y2FjOkNvbnRhY3Q+CiAgICAgICAgPGNiYzpOYW1lPlN1cHBvcnQ8L2NiYzpOYW1lPgogICAgICAgIDxjYmM6VGVsZXBob25lPlRlbGVwaG9uZSBudW1iZXI8L2NiYzpUZWxlcGhvbmU+CiAgICAgICAgPGNiYzpFbGVjdHJvbmljTWFpbD5FbWFpbCBhZGRyZXNzPC9jYmM6RWxlY3Ryb25pY01haWw+CiAgICAgIDwvY2FjOkNvbnRhY3Q+CiAgICA8L2NhYzpJc3N1ZXJQYXJ0eT4KICAgIDxjYWM6UmVjaXBpZW50UGFydHkgLz4KICA8L2NhYzpEb2N1bWVudFJlc3BvbnNlPgo8L0FwcGxpY2F0aW9uUmVzcG9uc2U+", 
    "createdDate": 1780916537801, 
    "orgId": "40cd9c06-f8a2-42e9-8878-d07653fc5894" 
}

Example 3: Validation failure


{ 
    "notificationId": "5c18318a-0dfa-483b-af54-2b779a6ea585", 
    "correlationId": "4c11b0be-0a74-45fd-880b-e33f666f36a0", 
    "appPrefix": "DLT", 
    "metadata": { 
        "productId": "ae_pint__1.0", 
        "transactionId": "2331f7e9-e0fb-4052-a178-517df971bbd5", 
        "documentId": "80b281cbcdd9872bc57a32018b111cc5", 
        "erpDocumentId": "42fd81e6-27cd-422e-b93e-760f6c47c82a", 
        "erpSystemId": "DefaultSystemERP", 
        "processType": "0", 
        "taxId": "100825145400003", 
        "sciCloudStatusCode": "401", 
        "sciResponseCode": "RE", 
        "sciStatusAction": "NIN" 
        }, 
    "content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPEFwcGxpY2F0aW9uUmVzcG9uc2UgeG1sbnM9InVybjpvYXNpczpuYW1lczpzcGVjaWZpY2F0aW9uOnVibDpzY2hlbWE6eHNkOkFwcGxpY2F0aW9uUmVzcG9uc2UtMiIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSIgeG1sbnM6Y2FjPSJ1cm46b2FzaXM6bmFtZXM6c3BlY2lmaWNhdGlvbjp1Ymw6c2NoZW1hOnhzZDpDb21tb25BZ2dyZWdhdGVDb21wb25lbnRzLTIiIHhtbG5zOmNiYz0idXJuOm9hc2lzOm5hbWVzOnNwZWNpZmljYXRpb246dWJsOnNjaGVtYTp4c2Q6Q29tbW9uQmFzaWNDb21wb25lbnRzLTIiIHhtbG5zOmV4dD0idXJuOm9hc2lzOm5hbWVzOnNwZWNpZmljYXRpb246dWJsOnNjaGVtYTp4c2Q6Q29tbW9uRXh0ZW5zaW9uQ29tcG9uZW50cy0yIiB4bWxuczphZD0iaHR0cDovL3d3dy5zb3Zvcy5jb20vbmFtZXNwYWNlcy9hZGRpdGlvbmFsRGF0YSI+CiAgPGNiYzpVQkxWZXJzaW9uSUQ+Mi4xPC9jYmM6VUJMVmVyc2lvbklEPgogIDxjYmM6Q3VzdG9taXphdGlvbklEPnVybjpzb3ZvczpuYW1lczpzcGVjaWZpY2F0aW9uOnNjaTpzY2hlbWE6eHNkOlRyYW5zYWN0aW9uLTM8L2NiYzpDdXN0b21pemF0aW9uSUQ+CiAgPGNiYzpQcm9maWxlSUQ+dXJuOnNvdm9zOm5hbWVzOnNwZWNpZmljYXRpb246c2NpOnNjaGVtYTp4c2Q6VHJhbnNhY3Rpb24tMzwvY2JjOlByb2ZpbGVJRD4KICA8Y2JjOklEPjVjMTgzMThhLTBkZmEtNDgzYi1hZjU0LTJiNzc5YTZlYTU4NTwvY2JjOklEPgogIDxjYmM6SXNzdWVEYXRlPjIwMjYtMDYtMTI8L2NiYzpJc3N1ZURhdGU+CiAgPGNiYzpJc3N1ZVRpbWU+MTM6MTY6MDc8L2NiYzpJc3N1ZVRpbWU+CiAgPGNhYzpTZW5kZXJQYXJ0eT4KICAgIDxjYWM6UGFydHlJZGVudGlmaWNhdGlvbj4KICAgICAgPGNiYzpJRD5iYmZlYmZmNy1jMzAxLTQxZWQtYjAxNC1lNTRiZGI0ZDU0M2I8L2NiYzpJRD4KICAgIDwvY2FjOlBhcnR5SWRlbnRpZmljYXRpb24+CiAgICA8Y2FjOlBhcnR5TmFtZT4KICAgICAgPGNiYzpOYW1lPlNvdm9zIENvbXBsaWFuY2U8L2NiYzpOYW1lPgogICAgPC9jYWM6UGFydHlOYW1lPgogICAgPGNhYzpDb250YWN0PgogICAgICA8Y2JjOk5hbWU+U292b3MgQ29udGFjdCBOYW1lPC9jYmM6TmFtZT4KICAgICAgPGNiYzpUZWxlcGhvbmU+KzU1MTE5ODc2NTQzMjE8L2NiYzpUZWxlcGhvbmU+CiAgICAgIDxjYmM6RWxlY3Ryb25pY01haWw+Y29udGFjdEBzb3Zvcy5jb208L2NiYzpFbGVjdHJvbmljTWFpbD4KICAgIDwvY2FjOkNvbnRhY3Q+CiAgPC9jYWM6U2VuZGVyUGFydHk+CiAgPGNhYzpSZWNlaXZlclBhcnR5IC8+CiAgPGNhYzpEb2N1bWVudFJlc3BvbnNlPgogICAgPGNhYzpSZXNwb25zZT4KICAgICAgPGNiYzpSZWZlcmVuY2VJRD48L2NiYzpSZWZlcmVuY2VJRD4KICAgICAgPGNiYzpSZXNwb25zZUNvZGUgbGlzdElEPSJTQ0lSZXNwb25zZUNvZGUiPlJFPC9jYmM6UmVzcG9uc2VDb2RlPgogICAgICA8Y2FjOlN0YXR1cz4KICAgICAgICA8Y2JjOlN0YXR1c1JlYXNvbkNvZGUgbGlzdElEPSJTQ0lDbG91ZFN0YXR1c0NvZGUiPjQwMTwvY2JjOlN0YXR1c1JlYXNvbkNvZGU+CiAgICAgICAgPGNiYzpTdGF0dXNSZWFzb24+RXJyb3IgcHJvY2Vzc2luZyBkb2N1bWVudDwvY2JjOlN0YXR1c1JlYXNvbj4KICAgICAgPC9jYWM6U3RhdHVzPgogICAgICA8Y2FjOlN0YXR1cz4KICAgICAgICA8Y2JjOlN0YXR1c1JlYXNvbkNvZGUgbGlzdElEPSJTQ0lTdGF0dXNBY3Rpb24iPk5JTjwvY2JjOlN0YXR1c1JlYXNvbkNvZGU+CiAgICAgICAgPGNiYzpTdGF0dXNSZWFzb24+UmVxdWVzdCB0byByZS1pc3N1ZSBhIGNvcnJlY3RlZCBuZXcgaW52b2ljZSAob3Igb3RoZXIgZG9jdW1lbnQpIG9yIGZpeCB0aGUgZXJyb3IgYW5kIHJlc2VuZCB0aGUgZG9jdW1lbnQ8L2NiYzpTdGF0dXNSZWFzb24+CiAgICAgIDwvY2FjOlN0YXR1cz4KICAgICAgPGNhYzpTdGF0dXM+CiAgICAgICAgPGNiYzpTdGF0dXNSZWFzb25Db2RlIGxpc3RJRD0iU0NJRVJQU3RhdHVzQ29kZSI+PC9jYmM6U3RhdHVzUmVhc29uQ29kZT4KICAgICAgICA8Y2JjOlN0YXR1c1JlYXNvbj5FcnJvciBwcm9jZXNzaW5nIGRvY3VtZW50PC9jYmM6U3RhdHVzUmVhc29uPgogICAgICA8L2NhYzpTdGF0dXM+CiAgICAgIDxjYWM6U3RhdHVzPgogICAgICAgIDxjYmM6U3RhdHVzUmVhc29uQ29kZSBsaXN0SUQ9IlNDSUludGVybmFsVmFsaWRhdGlvblN0YXR1c0NvZGUiPjQwMTwvY2JjOlN0YXR1c1JlYXNvbkNvZGU+CiAgICAgICAgPGNiYzpTdGF0dXNSZWFzb24+aWJyLWNvLTEwIFtpYnItY28tMTBdLVN1bSBvZiBJbnZvaWNlIGxpbmUgbmV0IGFtb3VudCAoaWJ0LTEwNikgPSDOoyBJbnZvaWNlIGxpbmUgbmV0IGFtb3VudCAoaWJ0LTEzMSkuPC9jYmM6U3RhdHVzUmVhc29uPgogICAgICA8L2NhYzpTdGF0dXM+CiAgICAgIDxjYWM6U3RhdHVzPgogICAgICAgIDxjYmM6U3RhdHVzUmVhc29uQ29kZSBsaXN0SUQ9IlNDSUludGVybmFsVmFsaWRhdGlvblN0YXR1c0NvZGUiPjQwMTwvY2JjOlN0YXR1c1JlYXNvbkNvZGU+CiAgICAgICAgPGNiYzpTdGF0dXNSZWFzb24+aWJyLWNvLTEzIFtpYnItY28tMTNdLUludm9pY2UgdG90YWwgYW1vdW50IHdpdGhvdXQgVGF4IChpYnQtMTA5KSA9IM6jIEludm9pY2UgbGluZSBuZXQgYW1vdW50IChpYnQtMTMxKSAtIFN1bSBvZiBhbGxvd2FuY2VzIG9uIGRvY3VtZW50IGxldmVsIChpYnQtMTA3KSArIFN1bSBvZiBjaGFyZ2VzIG9uIGRvY3VtZW50IGxldmVsIChpYnQtMTA4KS48L2NiYzpTdGF0dXNSZWFzb24+CiAgICAgIDwvY2FjOlN0YXR1cz4KICAgIDwvY2FjOlJlc3BvbnNlPgogICAgPGNhYzpEb2N1bWVudFJlZmVyZW5jZT4KICAgICAgPGNiYzpJRD48L2NiYzpJRD4KICAgIDwvY2FjOkRvY3VtZW50UmVmZXJlbmNlPgogICAgPGNhYzpJc3N1ZXJQYXJ0eSAvPgogICAgPGNhYzpSZWNpcGllbnRQYXJ0eSAvPgogIDwvY2FjOkRvY3VtZW50UmVzcG9uc2U+CjwvQXBwbGljYXRpb25SZXNwb25zZT4=", 
    "createdDate": 1781270167004, 
    "orgId": "40cd9c06-f8a2-42e9-8878-d07653fc5894" 
}

Correct or cancel an invoice

The UAE mandate doesn't include a direct cancellation message. To correct or cancel an invoice, issue an Electronic Tax Credit Note (type code 381). See Special processes for more details.

After Sovos sends and confirms the credit note, issue a corrected invoice to replace the original.

Self-billing

Self-billing is supported after meeting a set of conditions. The buyer sends the self-billing invoice through their own ASP. The supplier receives it as an inbound document through Sovos. See Invoice samples for field mapping.

Report a system failure

If a system outage stops you from submitting your e-invoices, report the failure to the FTA within two business days through EmaraTax.

Record the affected invoice date range and the steps you took to resolve the outage.

Archive your invoices

Keep all invoice data for the following periods depending on the scenario:

Taxable persons: Retention period: Five years from the end of the relevant tax period.
All other persons: Retention period: Five years from the end of the calendar year the document was created.
Real estate records: Retention period: Seven years from the end of the calendar year the document was created.
During FTA dispute or audit: Retention period: Add four years to the applicable base period.
After voluntary disclosure (within fifth years): Retention period: Add one more year.

You can store data inside or outside the UAE. Store records so you can retrieve and send them to the FTA on request in a complete and readable format.

Sovos retains your invoice data for seven years. This covers the standard five-year requirement for taxable persons. For scenarios that require longer retention, such as real estate records or active audits, you're responsible for maintaining your own copies.

Important:

The voluntary disclosure extension is a requirement under UAE tax regulations, not a Sovos interpretation.

Special processes

Correct or cancel an invoice

The United Arab Emirates (UAE) mandate doesn't include a direct cancellation message. To correct or cancel an invoice, issue an Electronic Tax Credit Note (type code 381). The credit note has to:

Reference the original invoice's UUID and number in BillingReference.
Set the credit note reason code to DL8.61.1.A. This is the only valid reason code defined by the UAE PINT-AE specification. See the full AE-CreditReason code list.

After Sovos sends and confirms the credit note, issue a corrected invoice to replace the original.

Pre-defined endpoints

Some buyer types do not have a PEPPOL Participant ID. In these cases, the supplier must use one of the following pre-defined fallback endpoints in place of the buyer's 0235:TIN. Sovos handles routing automatically when you use these endpoints, but you must classify each buyer correctly before sending.

These are the pre-defined endpoints:

0235:9900000098: The buyer is a UAE entity not yet onboarded on the e-invoicing system
0235:9900000097: eemed supply has no actual buyer. It requires FTA reporting only
0235:9900000099: Export to a buyer outside the UAE with no PEPPOL ID

Some buyer identifiers work differently in the exchange process:

If your buyer uses identifier 0235:9900000098 or 0235:9900000099, the invoice goes directly to the FTA for reporting. It doesn't pass through the buyer's ASP.
If you're handling a deemed supply (identifier 0235:9900000097), no invoice exchange happens at all. Your ASP reports the transaction directly to the FTA.

Negative response from the buyer's ASP

If the buyer's ASP returns a validation failure or a recipient-unreachable message, Sovos withdraws the invoice from the tax authority and updates the document status to rejected. The supplier must correct the identified issue and resubmit.

Common causes include an invalid buyer endpoint, a schema validation failure in the buyer's ASP, or the buyer's ASP being temporarily unreachable. Check the statusReason field in the application response for the specific reason, then correct and resubmit. See Application responses and status codes for the relevant error codes (408, 409, and 405).

Advance payments

When you receive an advance payment, issue a tax invoice (type code 380) at the time of receipt for the advance amount. When issuing the final invoice, cover only the remaining balance, not the full contract value.

Key field rules for the final invoice:

Include a reference to the advance payment invoice in BillingReference (IBT-025, IBT-026) or as a note in IBT-022.
The cbc:PrepaidAmount field may be left blank. The final invoice reflects the outstanding amount only and doesn't require adjustment for the advance.
The PayableAmount has to be equal to the remaining balance after deducting the advance.

For example: Contract value AED 10,000 + 5% VAT. Advance of AED 1,000 received.

Invoice 1 (advance): PayableAmount = AED 1,050 (AED 1,000 + AED 50 VAT)
Invoice 2 (final): PayableAmount = AED 9,450 (AED 9,000 + AED 450 VAT)

Retention handling

For contracts with retention clauses, you may follow your existing commercial and accounting practices, provided they remain compliant with UAE's VAT and e-invoicing requirements. Following the V1.1 Guidelines, this is the accepted approach:

Issue an e-invoice for the amount payable after deducting the retained amount.
Issue a separate e-invoice for the retained amount at the point when the buyer becomes liable to release and settle the e-invoice.

Both invoices are standard tax invoices (type code 380). The contractual arrangement and payment obligations should be clearly reflected in the invoices issued.

Self-billing

Self-billing is supported when all of the following conditions are met:

Both supplier and buyer are UAE VAT-registered.
Both supplier and buyer have a valid Tax Identification Number (TIN).
The supplier and the buyer have a written self-billing agreement under which the supplier doesn't issue tax invoices for the covered transactions.

The buyer sends the self-billing invoice through their own ASP. The supplier receives it as an inbound document through Sovos. For field mapping, see Sample 6: Self-billing invoice.

Important:

Sovos doesn't validate the written agreement. This is an obligation that business has to manage.

Report a system failure

If a system outage stops you from submitting your e-invoices, report the failure to the FTA within two business days through EmaraTax.

Record the affected invoice date range and the steps you took to resolve the outage.

How can we help?

Lifecycles and use cases

Transaction lifecycle

Response examples

Correct or cancel an invoice

Self-billing

Report a system failure

Archive your invoices

Special processes

Correct or cancel an invoice

Pre-defined endpoints

Negative response from the buyer's ASP

Advance payments

Retention handling

Self-billing

Report a system failure

sovos-footer