API Docs

Get Credit Note Reason Codes

Returns discrepancy response code enumeration per UAE FTA Federal Decree-Law No. 8 of 2017 on Value Added Tax, Article DL8.61.1. These codes are mandatory for credit notes and must be specified in the discrepancyResponse field.

Use credit note reason codes when setting the discrepancyResponse field in credit note requests.

See the right panel for request, response, and JSON examples.

Rate limit

60 requests/minute per authenticated account. See Rate limiting for response headers (X-RateLimit-*) and retry guidance.

Request

# Base URL: https://api-sandbox.ae.marmin.ai
# GET /api/codelist/credit-note-reason-codes

curl "https://api-sandbox.ae.marmin.ai/api/codelist/credit-note-reason-codes"

Response

[
  {
    "code": "DL8.61.1.A",
    "reason": "If the supply was cancelled."
  },
  {
    "code": "DL8.61.1.B",
    "reason": "If the tax treatment of the supply has changed due to a change in the nature of the supply."
  },
  {
    "code": "DL8.61.1.C",
    "reason": "If the previously agreed consideration for the supply was altered for any reason (i.e. bad debt relief)."
  },
  {
    "code": "DL8.61.1.D",
    "reason": "If the recipient of goods or recipient of services returned them to the registrant in full or in part and the Consideration was returned in full or in part."
  },
  {
    "code": "DL8.61.1.E",
    "reason": "If the tax was charged or tax treatment was applied in error."
  },
  {
    "code": "VD",
    "reason": "Volume Discount"
  }
]