Reason for issuing a credit or debit note
Text saying why a credit or debit note was issued; mandatory on every note.
BR-KSA-17 requires every note (381 or 383) to state why it was issued. Citing Articles 40 and 54 of the VAT Implementing Regulations, the data dictionary lists five situations for a note, each with an Arabic and English wording.
The field is free text up to 1,000 characters, and its place is not obvious: InstructionNote inside PaymentMeans. It does not apply to invoices.
| Identifier | KSA-10 |
|---|---|
| Path in the document | /Invoice/cac:PaymentMeans/cbc:InstructionNote |
| Cardinality | 0..* |
| Data type | Text |
| Applies to | Standard tax invoice and Simplified tax invoice |
In JooDax
Partly builtThe programs write the reason the user enters for the return (for example «إرجاع بضاعة», "goods returned") without restricting it to the five wordings in the data dictionary.
crates/jdx-einvoice-sa/src/xml.rs
Applies to
| Tax invoice | Debit note | Credit note | Simplified | Simplified debit | Simplified credit |
|---|---|---|---|---|---|
| Not applicable | Mandatory | Mandatory | Not applicable | Mandatory | Mandatory |
Allowed values
Reasons listed in the data dictionary (Articles 40(1) and 54(3) of the VAT Implementing Regulations)
| Code | Meaning |
|---|---|
| 1 | Cancellation or suspension of the supplies after its occurrence either wholly or partially |
| 2 | In case of essential change or amendment in the supply, which leads to the change of the VAT due |
| 3 | Amendment of the supply value which is pre-agreed upon between the supplier and consumer |
| 4 | In case of goods or services refund |
| 5 | In case of change in Seller's or Buyer's information |
Rules that check it
- BR-KSA-17 · A credit or debit note must state the reason it was issued.
- BR-KSA-F-06 · Field lengths must stay within the data dictionary's minimum and maximum.
Related fields
Fields — E-invoicing in Saudi Arabia (FATOORA)
Sources
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
- اللائحة التنفيذية لنظام ضريبة القيمة المضافة (vالنسخة العاشرة (آخر تعديل بقرار 24-06-01 في 2024-11-19)) — ZATCA
Checked on: 4 November 2026. What concerns JooDax is taken from the programs’ own code.