MarminDeveloper Docs
BusinessesPartnersProduct Wiki

Purchase invoice examples

This page provides ready-to-use purchase invoice payloads for common UAE scenarios. All examples target POST /api/purchase-invoices/{business_profile_id}.

How to use these examples

  • Replace profile IDs, company identifiers, and references with your real values.

  • Ensure party tax data and VAT categories match the supplier invoice details.

  • Start with minimal payload, then add document-level or line-level adjustments as needed.

  • For profile_execution_id flag definitions and mandatory fields, see Profile execution ID on the purchase invoice object page.

Example 1: Minimal purchase invoice

Use this for a straightforward self-billed purchase invoice with one taxable line. See the Minimal purchase invoice example in the right-side code samples panel.

Example 2: Purchase invoice with document-level charges and allowances

Use this when freight/fees/discounts apply to the document total. See the Purchase invoice with document-level charges + allowances example in the right-side code samples panel.

Example 3: Purchase invoice with line-level charges and allowances

Use this when adjustments should be applied on specific invoice lines. See the Purchase invoice with line-level charges + allowances example in the right-side code samples panel.

  1. Validate with Example 1 in sandbox.

  2. Add document-level adjustments using Example 2.

  3. Use Example 3 when adjustments must be calculated per line.

Next