Overview
The E-Invoicing API enables developers to connect ERP and accounting systems (e.g., Microsoft Dynamics NAV, Business Central, SAP, Oracle, etc.) with the government-compliant e-invoicing platform. It provides secure authentication, endpoints for creating invoices, and validation/error handling to ensure compliance.
Current Documentation: This guide covers Standard Tax Invoice implementation for B2B transactions. Simplified Tax Invoice documentation will be available soon.
Base URL: https://uae-e-invoicing.azurewebsites.net/api/v1
Authentication
All API calls require a Bearer token obtained from the Token API.
POSTauth/token/outbound
Headers
Content-Type: application/json
Request Body
{
"client_id": "00000000-0000-0000-0000-000000000000",
"client_secret": "sample-client-secret-1234567890",
"client_uuid": "11111111-1111-1111-1111-111111111111"
}
Success Response 200 OK
{
"success": true,
"token": "eyJhbGciOiJIUzI1NiIsInpXVCJ9...",
"expiresIn": 3600,
"tokenType": "Bearer"
}
Using the Token: Include the token in all subsequent requests:
Authorization: Bearer {your_access_token}
Submit a Standard Tax Invoice Standard Tax Invoice
Use this endpoint to submit B2B invoices with complete tax details and customer information.
POST/outbound
Headers
Content-Type: application/json
Authorization: Bearer {your_access_token}
Request Body Example
{
"invoiceNo": "INV-2025-000567",
"documentType": "388",
"documentDate": "12/31/2025",
"transactionType": "00000000",
"paymentType": "10",
"paymentDueDate": "12/31/2025",
"currency": "AED",
"currencyExchangeRate": 1.00,
"customerName": "John",
"customerCountry": "AE",
"customerCity": "Dubai",
"customerTRN": "100000000000003",
"customerState": "DXB",
"customerAddress": "Business Bay, Dubai, UAE",
"deliveryAddress1": "Office 602, Mai Tower",
"deliveryState": "DXB",
"deliveryCountry": "AE",
"deliveryCity": "Dubai",
"paymentAccountNo": "AE070331234567890123456",
"paymentAccountName": "Sample Trading LLC",
"paymentServiceProvider": "Sample Bank UAE",
"invoiceLines": [
{
"itemName": "Laptop",
"itemType": "Goods",
"vatCategory": "S",
"unitPrice": 100.00,
"unitOfMeasure": "EA",
"quantity": 1,
"lineDiscount": 5.00
}
]
}
Success Response 201 Created
{
"success": true,
"message": "Invoice processing completed",
"header": {
"id": "7b5beb3f-e583-f011-b4cb-7c1e525d602c",
"success": true
},
"lines": {
"total": 1,
"successful": 1,
"failed": 0,
"details": [
{
"success": true,
"lineSequence": 1,
"id": "2a1031de-b4cb-f011-bec2-7c1e525d602c"
}
]
}
}
Error Response 400 Bad Request
{
"success": false,
"message": "Validation failed"
}
Error Codes
| Code |
Description |
| 200 |
Token generated successfully |
| 201 |
Invoice created successfully |
| 400 |
Bad request – invalid/missing parameters |
| 401 |
Unauthorized – invalid or expired token |
| 403 |
Forbidden – access denied |
| 409 |
Conflict – invoice number already exists |
| 422 |
Unprocessable Entity – validation rules failed |
| 500 |
Internal server error |
Validation Rules Standard Tax Invoice
- Date Format: MM/DD/YYYY (e.g., 12/31/2025)
- Currency Codes: ISO 4217 (AED, USD, EUR)
- Country Codes: ISO 3166-1 alpha-2 (AE, US)
- VAT Categories: S (Standard), Z (Zero), E (Exempt), O (Out of scope)
- Units of Measure: EA (Each), KG (Kilogram), LTR (Liter), HR (Hour), PC (Piece)
- Customer TRN: Required for Standard Tax Invoices - 15 digit Tax Registration Number
- Payment Details: Bank account information required for B2B transactions
