API Docs

Basic sale invoice

Standard UAE taxable invoice with no special transaction flags.

Business scenario

You issue a routine domestic B2B invoice: one customer, one or more taxable lines, and standard VAT.

Transaction type

profile_execution_id: 00000000 (no special flags)
invoice_type_code: 380 (commercial / tax invoice)

Fields that differ from other types

Field	Rule
`payment_means`	Optional — may be omitted or `null`
`buyer_customer_party`	Not used
`delivery`	Not required
`invoice_period`	Not required

Minimal payload

See the right panel for the smallest valid request without payment_means (optional for a standard invoice). For a variant that includes card payment details, see Minimal sale invoice.

Request fields (core)

Field	Type	Required	Description	Validation
`issue_date`	string	Required	Invoice issue date.	`yyyy-MM-dd`
`invoice_type_code`	string	Required	Document type.	`380`
`profile_execution_id`	string	Required	Transaction flags.	`00000000`
`due_date`	string	Required	Payment due date.	`yyyy-MM-dd`
`document_currency_code`	string	Required	Currency.	e.g. `AED`
`accounting_customer_party`	object	Required	Buyer details.	See Customer party
`document_lines`	array	Required	Line items.	At least one line

Example payload

{
  "profile_execution_id": "00000000",
  "issue_date": "2025-05-24",
  "issue_time": "10:30:00",
  "invoice_type_code": "380",
  "due_date": "2025-06-24",
  "document_currency_code": "AED",
  "document_source": "API",
  "accounting_customer_party": {
    "name": "Buyer Name",
    "party_name": "Buyer Business LLC",
    "profile_id": "MBP-<abc>",
    "postal_address": {
      "street_name": "137/F",
      "city_name": "Abu Dhabi",
      "postal_zone": "873465",
      "country_subentity": "AUH",
      "country": "United Arab Emirates",
      "country_code": "AE"
    },
    "scheme_agency_id": "CD",
    "company_id": "6423682243",
    "tin": "1001234567",
    "party_tax_scheme": {
      "company_id": "100123456789003",
      "tax_scheme": "VAT"
    },
    "endpoint_id": "<PEPPOL_ID>",
    "endpoint_scheme_id": "0235",
    "email": "buyer@gmail.com"
  },
  "document_lines": [
    {
      "name": "Test Item - 1",
      "description": "Description for Test Item 1",
      "unit_code": "EA",
      "quantity": 2.0,
      "price": {
        "base_amount": 100.0,
        "base_quantity": 1.0
      },
      "classified_tax_category": {
        "id": "S",
        "percent": 5.0,
        "tax_scheme": "VAT"
      }
    }
  ]
}