Sovos Docs

Standard Business Document structure

The Standard Business Document (SBD) is the required container for every invoice you submit to Sovos.

The Standard Business Document carries the routing metadata and invoice payload that Sovos needs to process and deliver your document. It has two parts: the Standard Business Document Header (SBDH) and the Sovos Canonical Invoice (SCI). The SBDH holds the routing metadata. The Sovos Canonical Invoice carries your invoice data in Universal Business Language (UBL) 2.1 format. Sovos validates and transforms the SCI into PINT-AE XML, then sends it to the PEPPOL Access Point.

For a full description of the Standard Business Document and SBDH, see About the Standard Business Document.

UAE-specific SBDH fields

The following fields require UAE-specific values. All other SBDH fields follow the standard structure described in common content.

Sender identifier
Set the Authority attribute to AE. Use your 10-digit TIN as the identifier. No separators, no country prefix.
<sbd:Sender>
  <sbd:Identifier Authority="AE">1234567890</sbd:Identifier>
</sbd:Sender>
Receiver identifier
Set the Authority attribute to AE. Use the buyer's 10-digit TIN.
<sbd:Receiver>
  <sbd:Identifier Authority="AE">0987654321</sbd:Identifier>
</sbd:Receiver>
Business scope
<sbd:BusinessScope>
  <sbd:Scope>
    <sbd:Type>PRODUCTID</sbd:Type>
    <sbd:InstanceIdentifier>ae_invoice_1.0</sbd:InstanceIdentifier>
  </sbd:Scope>
  <sbd:Scope>
    <sbd:Type>Country</sbd:Type>
    <sbd:InstanceIdentifier/>
    <sbd:Identifier>AE</sbd:Identifier>
  </sbd:Scope>
  <sbd:Scope>
    <sbd:Type>CompanyCode</sbd:Type>
    <sbd:InstanceIdentifier/>
    <sbd:Identifier>1234567890</sbd:Identifier>
  </sbd:Scope>
  <sbd:Scope>
    <sbd:Type>Mapping.OutputSchema</sbd:Type>
    <sbd:InstanceIdentifier/>
    <sbd:Identifier>PINTAE</sbd:Identifier>
  </sbd:Scope>
  <sbd:Scope>
    <sbd:Type>Mapping.TransformDocument</sbd:Type>
    <sbd:InstanceIdentifier/>
    <sbd:Identifier>SCI-TO-LEGAL_INVOICE</sbd:Identifier>
  </sbd:Scope>
</sbd:BusinessScope>

Key SCI fields for UAE

Set the following fields within the UBL invoice to control PINT-AE output:

SCI fieldRequired valuePurpose
Invoice.CustomizationIDurn: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.0Mandatory PINT-AE specification identifier
Invoice.ProfileIDurn:fdc:peppol.eu:2017:poacc:billing:01:1.0PEPPOL billing process identifier
AccountingSupplierParty.Party.EndpointID (schemeID=0235)Your TINYour PEPPOL endpoint
AccountingCustomerParty.Party.EndpointID (schemeID=0235)Buyer's TINBuyer PEPPOL endpoint, required for routing
Invoice.InvoiceTypeCode380 (invoice) or 381 (credit note)Document type
TaxTotal.TaxAmount (currency=AED)AED-equivalent tax totalRequired at header level regardless of invoice currency

Transaction type flags

A transaction type flag is a set of binary digits used to identify the special transaction type an invoice represents. Every United Arab Emirates (UAE) e-invoice must include an Invoice Transaction Type Code. This field tells the Federal Tax Authority (FTA) what kind of transaction the invoice represents.

This matters because the UAE VAT regime includes several special transaction types, each with different tax rules. The transaction type code makes those distinctions machine-readable. Validators reject invoices that omit or misconfigure this field. You can set their values in the SovosExtension block.

The following table shows complete information about the eight positions that determine each transaction in order:

FlagSet to true when
FreeTradeZoneSupplyEither party is in a UAE Free Trade Zone
MarginSchemeThe transaction uses the VAT margin scheme
DeemedSupplyThe supply is a deemed supply
SummaryInvoiceThe seller makes more than one supply of goods or services to the same buyer in the same calendar month
ContinuousSupplyThe supply of goods or services made on recurring basis
AgentBillingA registered agent makes the supply on behalf of a principal
ECommerceSupplyThe supply of goods or services through e-commerce
ExportsThe supply of goods or services is made outside the UAE