Create a UAE business Party

Creates a new party for use in UAE e-invoices.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The party's Tax Identification Number (TIN). Required for every party, and checked against the UAE 10-digit format when the party is UAE-registered (see uae_registered)

string

The UAE Tax Registration Number (TRN), which marks UAE VAT registration. Only a UAE-registered party may have one (see uae_registered)

boolean | null

Whether the party holds a UAE Tax Identification Number with the FTA, whatever its address. Send true for a registered party, including a non-resident with a UAE TIN, and false only when you know it is not. Omit it, or send null, when unsure: the party's peppol_id_scheme decides when it has one, otherwise address.country_code (AE is registered). false is not the same as omitting it: it holds nothing to the UAE TIN format, rejects a TRN, and never looks the party up on Peppol, so the document is reported to the FTA only. true holds the TIN to the UAE format, allows a TRN, and, with no peppol_id, addresses the party at 0235:<TIN> after checking it is live on Peppol. On an inline buyer that already exists, an explicit value replaces the stored one; omit it to leave the party as it is.

address
object
required

Postal address

string

The name of the contact person

string

The contact phone number

string

The contact email address

string

The party's Peppol participant identifier

string

The Peppol EAS code for peppol_id, required when peppol_id is given. See GET /resources/electronic-address-schemes for available values.

string
length ≤ 100

Free-form text to attach to this resource, such as your own reference or a JSON string, up to 100 characters. Digitax stores it as given and returns it as public_metadata on the resource. Set at creation only.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json