Developers / UAE PINT AE

Use Case 12 — Standard Tax Credit Note

Submit UAE PINT AE Credit Notes with invoice type code 381, preceding invoice reference, reason code validation, trust hash, QR payload, evidence links, and UBL CreditNote XML.

Download JSON Download XML Use Case Coverage

Status

Implemented

Credit Note API, validation, storage, evidence, and XML generation are active.

Document Type

credit_note

UBL root is CreditNote.

Invoice Type Code

381

Use Case 12 Standard Tax Credit Note.

Endpoint

POST https://asp.mazenofficial.net/api/v1/credit-notes

Required Headers

Accept: application/json
Content-Type: application/json
X-ASP-API-KEY: <api-key>
X-Source-Tenant-Domain: <allowed-domain>
Idempotency-Key: <unique-key>

XML Validation Test

curl -k -L -o /tmp/sample-credit-note.xml \
https://asp.mazenofficial.net/developers/samples/credit-note.xml

grep -n "CustomizationID\|ProfileID\|CreditNoteTypeCode\|UUID\|381" \
/tmp/sample-credit-note.xml | head -n 40

Required Credit Note Fields

document_type	`credit_note`
use_case_code	`12`
invoice_type_code	`381`
original_invoice_number	Required preceding invoice reference.
original_invoice_issue_date	Required date in YYYY-MM-DD format.
credit_note_reason_code	Required reason code.
credit_note_reason_text	Required reason description.

Latest Successful Credit Note

UUID	`5885940f-73d6-4539-8721-06192a0aaaea`
Status	ACCEPTED / PASSED
Document Type	credit_note
Use Case	12 — Standard tax credit note
Invoice Type Code	381
Original Invoice	INV-ORIG-20260620051825
Reason Code	RETURN
Trust Hash	`09e250ffcef2a34233dde0b7bfc8b688b5f7ea441eb849481d690e1554ea3879`