Skip to content
BR-KSA-17

Rule BR-KSA-17 in Saudi e-invoicing

A credit or debit note must state the reason it was issued.

The reason goes in PaymentMeans/InstructionNote. The data dictionary lists five situations from Articles 40 and 54 of the Implementing Regulations: cancellation or suspension, a material change altering the VAT, an agreed change of value, return of goods or services, and a change in seller or buyer details.

The XML standard does not say which rules are errors and which are warnings; this classification is not confirmed by an official document.

IdentifierBR-KSA-17
EffectError: the document is rejected
Applies toStandard tax invoice and Simplified tax invoice

In JooDax

Built

Credit notes carry the reason the user enters for the return.

crates/jdx-einvoice-sa/src/xml.rs

Fields it checks

Other rules on the same fields

  • BR-KSA-05 · The invoice type code must be one of the Saudi subset: 388, 386, 383 or 381.
  • BR-KSA-56 · Credit notes (381) and debit notes (383) must carry the billing reference ID.

Validation rules — 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

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