API Docs

The Supplier party object

When you create a purchase invoice or purchase credit note, you include the seller's details in the accounting_supplier_party object. The fields and rules on this page describe that supplier party and what you must send for Marmin to accept your request.

Supplier rules are not the same as business profile or customer rules.

On sales invoices and sales credit notes, your own supplier details are usually taken from your business profile automatically — you do not need to build a supplier object for those document types.

Before you start

Check whether the supplier's address is in the UAE (country_code = AE) or outside the UAE.
Registration details are optional. You do not need to send scheme_agency_id, company_id, or authority_name unless you want to include them.
Keep registration and VAT separate:
Registration number (company_id) — trade license or cabinet decision number (only when you send registration details)
VAT number / TRN (party_tax_scheme.company_id) — 15-digit UAE tax registration number

Attributes

Core fields

Field	Type	Required	Description
`name`	string	Required	Display name for the supplier.
`party_name`	string	Required	Legal name of the supplier business.
`party_name_in_local_language`	string	Optional	Supplier name in Arabic or local language.
`email`	string	Required	Supplier email address.
`telephone`	string	Conditional	Supplier telephone number. Required when the supplier has a UAE address.
`logo_url`	string	Optional	URL to the supplier's logo image.
`scheme_agency_id`	string	Optional	How the supplier is registered, if you choose to include registration details. `TL` or `CD` are typical for UAE suppliers. See Get Registration Types.
`company_id`	string	Optional	Official registration number. Not the VAT/TRN. Only send when you include registration details — see If you include registration details below.
`authority_name`	string	Optional	Issuing authority for the trade license. Only relevant when `scheme_agency_id` is `TL`.
`tin`	string	Conditional	Taxpayer Identification Number (TIN) from EmaraTax. Required for UAE suppliers. Must be 10 characters and start with `1`. Do not send for non-UAE suppliers.
`party_tax_scheme`	object	Optional	VAT details for UAE suppliers. If you send any part of it, you must send both fields in Party tax scheme object. Do not send for non-UAE suppliers.
`endpoint_id`	string	Optional	Peppol electronic address for the supplier.
`endpoint_scheme_id`	string	Optional	Scheme for `endpoint_id` (typically `0235`). See Get Electronic Address Schemes.
`postal_address`	object	Required	Supplier address. See Address object below.

Address object

Field	Type	Required	Description
`street_name`	string	Required	Street name or primary address line.
`additional_street_name`	string	Optional	Additional street details.
`city_name`	string	Required	City or town.
`postal_zone`	string	Optional	Postal or ZIP code.
`country_subentity`	string	Required	Emirate, state, or region code (e.g. `DXB`). For UAE addresses, use a code from Get UAE Subdivisions.
`address_line`	string	Optional	Additional address line.
`country`	string	Required	Country name (e.g. `United Arab Emirates`).
`country_code`	string	Required	Two-letter country code (e.g. `AE`). See Get Countries.

Party tax scheme object

Use this object only when you want to include the supplier's UAE VAT registration (TRN).

Field	Type	Required	Description
`company_id`	string	Conditional	UAE VAT registration number (TRN). 15 digits only; must start with `1` and end with `01` or `03`. Required if you include `party_tax_scheme`.
`tax_scheme`	string	Conditional	Tax scheme, usually `VAT`. Required if you include `party_tax_scheme`. See Get Tax Schemes.

If you omit party_tax_scheme entirely, the request is valid. If you include either company_id or tax_scheme, you must include both, and the TRN must match the UAE format above.

Validation by scenario

UAE supplier

What to send	Rule
`name`, `party_name`, `email`, `postal_address`	Required
`telephone`	Required
`tin`	Required — 10 characters, starts with `1`
`scheme_agency_id`, `company_id`, `authority_name`	Optional — registration details are not required
`party_tax_scheme`	Optional; if sent, both TRN and `tax_scheme` required with valid TRN format
`passport_issuing_country_code`	Do not send

Non-UAE supplier

What to send	Rule
`name`, `party_name`, `email`, `postal_address`	Required
`tin`	Do not send
`party_tax_scheme`	Do not send
Registration fields	Optional

If you include registration details

Registration fields are optional. If you choose to send scheme_agency_id, the following rules apply:

Registration type (`scheme_agency_id`)	Additional fields when registration is included
Any	`company_id` is required when `scheme_agency_id` is sent
`TL` (Trade License)	`authority_name` is also required
UAE supplier	`TL` or `CD` are typical

See Get Registration Types.

Using this object on purchase documents

Include these fields on accounting_supplier_party when you create or resubmit a purchase invoice or purchase credit note.