MarminDeveloper Docs
BusinessesPartnersProduct Wiki

What is a Sales Invoice?

A Sales Invoice records a completed sale of goods or services from a seller to a buyer and is the official tax document used for VAT reporting in the UAE.

A sales invoice represents the occurrence of a taxable supply. Payment may occur before or after the invoice, depending on the business arrangement.

When to Use This API

Use the Sales Invoice API when:

  • A sale of goods or services has taken place

  • You need to record the transaction for VAT and accounting purposes

  • The invoice must be issued in a UAE-compliant electronic format

How the Sales Invoice API Works

When a sales invoice is created through the API:

  • Supplier and customer party data is validated

  • Line items and VAT treatments are processed

  • The invoice is recorded as a tax-relevant document

  • An electronic representation is generated automatically for e-invoicing and reporting

The invoice becomes part of the system’s official VAT records.

Invoice Type Code

All sales invoices created through this API are issued as Standard Tax Invoices or Invoice out of scope of tax.

Invoice Type Code: 380 (Commercial invoice) , 480 (Invoice out of scope of tax)

  • This code is mandatory under invoicing standards

  • It is assigned automatically and must not be provided or modified by the client

The invoicing system also supports related document types for adjustments and special billing scenarios:

CodeDocument typeDescription
381Credit NoteUsed to reduce or cancel an issued sales Commercial invoice (380)
81Credit note related to goods or servicesUsed to reduce or cancel an issued sales Invoice out of scope of tax (480)
389Self-billed InvoiceUsed when the buyer issues the invoice on behalf of the seller

Each document type has its own API endpoint and lifecycle.

Next