Create a UAE Invoice with the buyer and items inline

post

https://api.digitax.tech/ae/v1/detailed-invoices

Creates a PINT-AE compliant e-invoice in one request, without creating the buyer or the items first, and submits it to the Peppol network. The buyer is matched on tax_identification_number and each line's item on item_code, both within the authenticated branch — whatever already exists is reused unchanged, whatever is missing is created. Every rule that POST /invoices applies also applies here. Note that the parties and items are created before the invoice is validated, so a rejected invoice can leave them behind.

Omit peppol_id for a buyer who isn't on Peppol — the right predefined endpoint is substituted at submission and the document is reported to the FTA instead of delivered (9900000099 for an export, 9900000098 for any other buyer outside the UAE or not yet onboarded to UAE e-invoicing). The invoice then reports submission_skipped: true.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The invoice itself. Identical to the POST /invoices body except that the buyer is supplied inline as customer_party and each line carries its item's details.

trader_invoice_number

string

required

An invoice number assigned by the supplier to uniquely identify the invoice in their system

transaction_types

array of strings

The list of applicable PINT-AE transaction types

transaction_types

invoice_type_code

string

required

The UN/CEFACT document type code. See GET /resources/invoice-types for available values.

issue_date

date

required

The date on which the invoice was issued (YYYY-MM-DD). Must not be in the future and must not be more than 30 days in the past.

issue_time

string

The invoice issue time (HH:MM:SS)

due_date

date

The payment due date (YYYY-MM-DD)

document_currency_code

string

required

A code that specifies the currency in which the invoice is issued. See GET /resources/currencies for available values.

tax_currency_exchange_rate

double

The exchange rate between document and tax currencies. Required and must be > 0 when document_currency_code is not AED. When document_currency_code is AED, must be 1 or omitted. Maximum 6 decimal places.

payee_party

object

The payee (IBG-10), when payment is collected by someone other than the seller.
PINT AE binds only a name, an optional identifier and an optional legal
registration identifier here — a payee has no address, electronic address or tax
registration number.

tax_representative_party

object

The seller's tax representative (IBG-11). PINT AE binds a name, a postal address
and a VAT registration number here — no electronic address and no legal
registration identifier. The tax registration number is mandatory, so a
representative identified only by a TIN cannot be expressed.

tax_point_date

date

The VAT point date (YYYY-MM-DD). Must be strictly before the issue_date.

buyer_reference

string

An identifier assigned by the Buyer used for internal routing purposes.

accounting_cost

string

A textual value that specifies where to book the relevant data into the Buyer's financial accounts

project_reference

string

A project reference

note

string

A free-text note on the invoice

invoice_period

object

The period to which the invoice relates

order_reference

object

A reference to a purchase and/or sales order

billing_reference

array of objects

References to preceding invoices

billing_reference

despatch_document_reference

object

A reference to another document (e.g. despatch advice, receipt advice, contract)

receipt_document_reference

object

A reference to another document (e.g. despatch advice, receipt advice, contract)

originator_document_reference

object

A reference to another document (e.g. despatch advice, receipt advice, contract)

contract_document_reference

object

A reference to another document (e.g. despatch advice, receipt advice, contract)

additional_documents

array of objects

Additional supporting document references

additional_documents

delivery

object

Delivery information for the items in the invoice. When transaction_types includes EXPORTS, delivery is required and delivery_address.country_code must not be AE.

payment_terms_note

string

Textual payment terms

allowance_charges

array of objects

Invoice-level allowances and charges

allowance_charges

payments

array of objects

required

Payment details for this invoice

payments*

items

array of objects

required

The invoice line items

items*

prepaid_amount

double

The amount already paid, to be deducted from the payable amount

payable_rounding_amount

double

The rounding amount

beneficiary_tax_number

string

The TRN or TIN of the beneficiary for Free Trade Zone supplies. Required when transaction_types includes FREE_TRADE_ZONE.

principle_trn

string

The TRN of the principal for Disclosed Agent billing. Required when transaction_types includes AGENT_BILLING. Must differ from the business's own TRN.

customer_party

object

required

Responses

201Invoice created

defaultError response