API Docs

Creating an Electronic Invoice

Generating an Electronic Invoice is the final, critical step in the e-invoicing process. Every invoice created within Marmin must adhere to the UAE's XML-based technical requirements to ensure successful validation and transmission.

Available Document Types

Marmin supports the creation of the following four document categories:

Electronic Tax Invoice: The standard document for recording a Taxable Supply.
Electronic Tax Credit Note: Used to reduce or cancel an existing Taxable Supply.
Self-billed electronic Tax Invoice: Issued by the buyer on behalf of the supplier, subject to prior agreement and regulatory conditions.
Self-billed electronic Tax Credit Note: Issued by the buyer for adjustments to a self-billed transaction.

Note: Commercial Invoices and Commercial Credit Notes are also supported for supplies that do not require a Tax Invoice under the VAT Decree-Law.

How to Create an Invoice

Select Document Type: Navigate to the Create Invoice module and select the appropriate document type from the list above.
Select Customer/Supplier: Choose from your pre-populated master data. You must always set endpoint_id and endpoint_scheme_id explicitly — Marmin no longer applies a default when they are omitted. For buyers not subject to UAE e-invoicing regulations, use endpoint_scheme_id 0235 and endpoint_id 9900000098. For deemed supply use 9900000097; for exports where the receiver is not Peppol-registered use 9900000099. See The Customer party object for the full reference table.
Input Transaction Details: Populate the line items using your master product/service list, including quantity, price, and unit of measure.
Assign Tax Categories: For every item, verify and select the correct tax category (for example, Standard Rated, Exempt, Zero Rated, Reverse Charge).
Review & Generate: Before finalizing, verify all mandatory fields, including the UUID, invoice date, currency, and VAT point date. Once verified, click Create to generate the XML file for transmission.