Skip to content
KSA-10

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.

IdentifierKSA-10
Path in the document/Invoice/cac:PaymentMeans/cbc:InstructionNote
Cardinality0..*
Data typeText
Applies toStandard tax invoice and Simplified tax invoice

In JooDax

Partly built

The 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 invoiceDebit noteCredit noteSimplifiedSimplified debitSimplified credit
Not applicableMandatoryMandatoryNot applicableMandatoryMandatory

Allowed values

Reasons listed in the data dictionary (Articles 40(1) and 54(3) of the VAT Implementing Regulations)

CodeMeaning
1Cancellation or suspension of the supplies after its occurrence either wholly or partially
2In case of essential change or amendment in the supply, which leads to the change of the VAT due
3Amendment of the supply value which is pre-agreed upon between the supplier and consumer
4In case of goods or services refund
5In 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

  1. Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  2. Electronic Invoice Data Dictionary to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
  3. الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
  4. اللائحة التنفيذية لنظام ضريبة القيمة المضافة (vالنسخة العاشرة (آخر تعديل بقرار 24-06-01 في 2024-11-19)) — ZATCA

Checked on: 4 November 2026. What concerns JooDax is taken from the programs’ own code.