Create a UAE Self-Billed Credit Note

Creates a new PINT-AE compliant self-billed credit note

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
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.

string
required

An issuer-assigned invoice number, unique within the business. When given, this is the document number sent over Peppol; otherwise, the DigiTax-generated number is used. Must contain valid Unicode and XML characters, with no leading or trailing whitespace, tabs, or line breaks

string
required

The coded reason for the self-billed credit note. See GET /resources/credit-reasons for available values.

string
required

The textual reason for the self-billed credit note

string

The DigiTax ID of the original self-billed invoice this credit note relates to

string
required

The UN/CEFACT document type code. If the credit note references an original invoice, the value should correspond to the original invoice type code (e.g. "261" for a self billed credit note referencing a "389" self billed invoice). See GET /resources/invoice-types for available values.

date
required

The date on which the self-billed credit note was issued (YYYY-MM-DD). Must not be in the future and must not be more than 30 days in the past.

string

The credit note issue time (HH:MM:SS)

date

The payment due date (YYYY-MM-DD)

string
required

The currency code (ISO 4217). See GET /resources/currencies for available values.

double

The exchange rate between document and tax currencies. Required and must be > 0 when document_currency_code is not AED. When document_currency_code is AED, must be 1 or omitted. Maximum 6 decimal places.

string
required

The DigiTax supplier ID of the supplier from whom the buyer is self-billing

payee_party
object

The payee (IBG-10), when payment is collected by someone other than the seller.
PINT AE binds only a name, an optional identifier and an optional legal
registration identifier here — a payee has no address, electronic address or tax
registration number.

tax_representative_party
object

The seller's tax representative (IBG-11). PINT AE binds a name, a postal address
and a VAT registration number here — no electronic address and no legal
registration identifier. The tax registration number is mandatory, so a
representative identified only by a TIN cannot be expressed.

string

An identifier assigned by the buyer used for internal routing purposes

string

A textual value that specifies where to book the relevant data into the buyer's financial accounts

string

A free-text note on the self-billed credit note

invoice_period
object

The period to which the invoice relates

order_reference
object

A reference to a purchase and/or sales order

despatch_document_reference
object

Despatch advice reference (BT-16)

receipt_document_reference
object

Receiving advice reference (BT-15)

originator_document_reference
object

Tender or lot reference (BT-17)

contract_document_reference
object

Contract reference (BT-12)

additional_documents
array of objects

Additional supporting document references

additional_documents
delivery
object

Delivery information for the items in the invoice. When transaction_types includes EXPORTS, delivery is required and delivery_address.country_code must not be AE. Incoterms are optional.

string

Textual payment terms

allowance_charges
array of objects

Invoice-level allowances and charges

allowance_charges
payments
array of objects

Payment means for this self-billed credit note

payments
items
array of objects
required

The self-billed credit note line items

items*
double

The amount already paid

double

The rounding amount

transaction_types
array of strings

The list of applicable PINT-AE transaction types

transaction_types
string

The TRN or TIN of the beneficiary for Free Trade Zone supplies. Required when transaction_types includes FREE_TRADE_ZONE.

string

The TRN of the principal for Disclosed Agent billing. Required when transaction_types includes AGENT_BILLING. Must differ from the business's own TRN.

Responses

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