Professional Documents
Culture Documents
Existing integrations DO NOT need to be amended in order to be successfully validated. All the
changes are further enhancements and additional functionalities.
Data dictionary details
Column Details
A Business Term Name
B Describes the business term
C Mapping the business term with the e-invoicing resolution fields in annex (2)
ZATCA E-invoice Category
Business term group and ID in ISO CEN/EN 16931:2017 standard. The terms that are not in ISO CEN/EN 16931:2017 standa
- no group ID
- a KSA term ID (ex: KSA-1)
E-F
V-W - Visibility on Invoice for Tax invoices and associated credit and debit notes
- Visibility on human readable formats for Simplified Tax invoices and associated credit and debit notes
Y-AA Field Characters Limits
AB Example for each business term
2023-05-19
nformation
s are currently
notes
Business term name Description
Business process type Identifies a user-defined profile of the customization of UBL being used.
Invoice issue date The date when the Invoice was issued as per Article 53 of the VAT
(gregorian calendar) Implementing Regulation
Invoice issue time The time when the invoice was issued.
Invoice type code A code specifying the functional type of the Invoice.
Invoice type transactions A code of the invoice subtype and invoices transactions.
Invoice note A textual note that gives unstructured information that is relevant to the
Invoice as a whole.
Invoice currency code The currency in which all Invoice amounts are given, except for the Total
VAT amount in accounting currency.
Tax currency code The currency used for VAT accounting and reporting purposes as
accepted or required in the country of the Seller.
Billing reference ID The sequential number (Invoice number BT-1) of the original invoice(s)
that the credit/debit note is related to.
Contract ID The identification of a contract.
Invoice counter value Invoice counter value
Previous invoice hash The base64 encoded SHA256 hash of the previous invoice.
This hash will be computed from the business payload of the previous
invoice: UBL XML of the previous invoice without tags for QR code (KSA-
14) and cryptographic stamp (KSA-15).
Invoice QR code QR code must contain:
- Seller VAT number
- Seller Name
- VAT Total
Cryptographic stamp Invoice cryptographic stamp
Address - Additional street Seller address line 2 - an additional address line in an address that can
be used to give further details supplementing the main line.
Additional - Building Seller address building number
number
Address - City The common name of the city, town or village, where the Seller's address
is located.
Address - District The name of the subdivision of the Seller city, town, or village in which its
address is located, such as the name of its district or borough.
Other buyer ID Other Buyer ID, required only if buyer is not VAT registered, then one of
the following must be provided:
Address - Additional street Buyer address line 2 - an additional address line in an address that can
be used to give further details supplementing the main line.
Address - City The common name of the city, town or village, where the Buyer's address
is located.
Address - District The name of the subdivision of the Buyer city, town, or village in which its
address is located, such as the name of its district or borough.
Address - Country code Buyer country code
VAT number (registered) The Buyer's VAT identifier (also known as Buyer VAT identification
or Group VAT number number).
Supply end date Calendar field "End Date" for Continuous Supplies.
Payment means type code The means, expressed as code, for how a payment is expected to be or
has been settled.
Entries from the UNTDID 4461 code list
Reasons for issuance of Reasons for issuance of credit / debit note as per Article 40 (paragraph 1)
credit / debit note and Article 54 (3) of KSA VAT regulations, a Credit and Debit Note is
issued for these 5 instances:
- Cancellation or suspension of the supplies after its occurrence either
wholly or partially ()تم إلغاء أو وقف التوريد بعد حدوثه أو اعتباره كليًا أو جزئيًا
- In case of essential change or amendment in the supply, which leads to
the change of the VAT due (وجود تغيير أو تعديل جوهري في طبيعة التوريد بحيث يؤدي الى
)تغيير الضريبة المستحقة
- Amendment of the supply value which is pre-agreed upon between the
supplier and consumer ()تم االتفاق على تعديل قيمة التوريد مسبقًا
- In case of goods or services refund. ()عند ترجيع السلع أو الخدمات
- In case of change in Seller's or Buyer's information (عند التعديل على بيانات
)المورد أو المشتري
Payment terms The payment terms, if mode of payment is credit. Free text
Payment account identifier The account number, IBAN, to which the transfer should be made.
In the case of factoring this account is owned by the factor.
Document level allowance An indicator that this AllowanceCharge describes a discount.
indicator The value of this tag indicating discount (Allowance) must be "false".
Document level allowance The percentage that may be used, in conjunction with the document level
percentage allowance base amount, to calculate the document level allowance
amount.
Document level allowance The amount of an allowance, without VAT.
amount
Document level allowance The base amount that may be used, in conjunction with the document
base amount level allowance percentage, to calculate the document level allowance
amount.
Currency for document Currency for document level allowance base amount.
level allowance base
amount
Document level allowance A coded identification of what VAT category applies to the document
VAT category code level allowance.
Document level allowance The VAT rate, represented as percentage that applies to the document
VAT rate level allowance.
Reason for the document Each document-level allowance must have the reason for the document-
level allowance level allowance
Code for the reason for A reason code corresponding to the reason for the document-level
document level allowance allowance.
Document level charge The base amount that may be used, in conjunction with the document
base amount level charge percentage to calculate the document level charge amount.
Currency for document The currency of the document level charge base amount.
level charge base amount
Document level Charge A coded identification of what VAT category applies to the document
VAT category code level charge.
Document level Charge The VAT rate, represented as percentage that applies to the document
VAT rate level charge.
Reason for the document The reason of the document level charge
level charge
Code for the reason for A reason code corresponding to the reason for the document-level
document level charge charge.
Sum of Invoice line net Sum of all Invoice line net amounts in the Invoice without VAT
amount
Currency for sum of Currency for invoicetotal amount
invoice line net amount
Currency for sum of Currency for invoice total amount without VAT
charges on document
level
Invoice total amount The total amount of the Invoice without VAT.
without VAT
Currency for invoice total Currency for invoice total amount without VAT
amount without VAT
Invoice total VAT amount The total VAT amount for the Invoice.
The Invoice total VAT amount is the sum of all VAT category tax
amounts.
Invoice total VAT amount The VAT total amount expressed in the accounting currency accepted or
in accounting currency required in the country of the Seller.
To be used when the VAT accounting currency (BT-6) differs from the
Invoice currency code (BT-5).
The VAT amount in accounting currency is not used in the calculation of
the Invoice totals.
Currency for invoice total Currency for invoice total VAT amount in accounting currency
VAT amount in accounting
currency
Invoice total amount with The total amount of the Invoice with VAT.
VAT The Invoice total amount with VAT is the Invoice total amount without
VAT plus the Invoice total VAT amount.
Currency for invoice total Currency for invoice total amount with VAT
amount with VAT
Pre-Paid amount The sum of amounts which have been paid in advance including VAT.
This amount is subtracted from the invoice total amount with VAT to
calculate the amount due for payment.
Rounding amount Amount which must be added to total in order to round off the payment
amount.
Amount due for payment The outstanding amount that is requested to be paid.
This amount is the Invoice total amount with VAT minus the pre-paid
amount that has been paid in advance plus Rounding Amount. The
amount is zero in case of a fully paid Invoice.
Currency for amount due Currency for amount due for payment
for payment
VAT category taxable Sum of all taxable amounts subject to a specific VAT category code and
amount VAT category rate (if the VAT category rate is applicable).
The sum of Invoice line net amount minus allowances on document level
which are subject to a specific VAT category code and VAT category rate
(if the VAT category rate is applicable).
Currency for VAT category Currency for VAT category taxable amount
taxable amount
VAT category tax amount Calculated by multiplying the VAT category taxable amount with the VAT
category rate for the relevant VAT category.
VAT category rate The VAT rate, represented as percentage that applies for the relevant
VAT category.
VAT exemption reason A coded statement of the reason for why the amount is exempted from
code VAT.
VAT exemption reason A textual statement of the reason why the amount is exempted from VAT
text or why no VAT is being charged
Invoice line identifier A unique identifier for the individual line within the Invoice.
This value should be only numeric value between 1 and 999,999
Prepayment UUID
A unique reference identifying the invoice (KSA-1) of the associated
Prepayment invoice(s).
Prepayment Issue Date Issue Date (BT-2) of the associated Prepayment invoice(s).
Prepayment Issue Time Issue Time (KSA-25) of the associated Prepayment invoice(s).
Prepayment Document Invoice type code (BT-3) of the associated Prepayment invoice(s). The
Type Code only acceptable value is '386'.
Invoiced quantity The quantity of items (goods or services) that is charged in the Invoice
line.
Invoiced quantity unit of The unit of measure that applies to the invoiced quantity.
measure
Invoice line net amount The total amount of the Invoice line, including allowances (discounts). It
is the item net price multiplied with the quantity.
The amount is “net” without VAT.
Currency for invoice line Currency for invoice line net amount
net amount
Invoice line allowance The percentage that may be used, in conjunction with the Invoice line
percentage allowance base amount, to calculate the Invoice line allowance amount.
Reason for the invoice line The reason for allowance on line item-level
allowance
Code for the reason for A reason code corresponding to the reason for allowance on line item-
invoice line allowance level
Invoice line allowance The base amount that may be used, in conjunction with the Invoice line
base amount allowance percentage, to calculate the Invoice line allowance amount.
Currency for invoice line Currency for invoice line allowance base amount
allowance base amount
Currency for Invoice line The currency of the Invoice line charge amount
charge amount
Invoice line charge base The base amount that may be used, in conjunction with the invoice line
amount charge percentage to calculate the Invoice line charge amount.
Currency for invoice line The currency of the invoice line charge base amount
charge base amount
Reason for invoice line The reason of Invoice line level charge.
charge
Code for the reason for A Reason code corresponding to the 'reason' of line level charge.
invoice line charge
Currency for line amount Currency for line amount inclusive VAT
inclusive VAT
Prepayment VAT The sum total of VAT category taxable amount (BT-116) subject to
Category Taxable Amount specific VAT Category code of the associated Prepayment invoice(s).
Currency for Prepayment Currency for Prepayment VAT Category Taxable Amount
VAT category Taxable
Amount
Prepayment VAT The sum total of VAT category tax amount (BT-117) subject to specific
Category Tax Amount VAT Category code of the associated Prepayment invoice(s).
Currency for Prepayment Currency for Prepayment VAT Category Tax Amount
VAT Category Tax
Amount
Item name The description of goods or services as per Article 53 of the VAT
Implementing Regulation.
Item Buyer's identifier An identifier, assigned by the Buyer, for the item.
Item Seller's identifier An identifier, assigned by the Seller, for the item.
This should include the product code type and the actual code. This list
includes UPC (11 digit, 12 digit, 13 digit EAN), GTIN (14 digit), Customs
Item net price The price and
HS Code of anmultiple
item, exclusive of VAT, after subtracting item price
other codes
discount.
The Item net price has to be equal with the Item gross price minus the
Item price discount.
Currency for item net price Currency for item net price
Invoiced item VAT The VAT category code for the invoiced item.
category code
Invoiced item VAT rate The VAT rate, represented as percentage that applies to the invoiced
item as per Article 53 of the VAT Implementing Regulation
Prepayment VAT
Category Code The VAT category code (BT-118) of the associated Prepayment
invoice(s).
Prepayment VAT rate
The VAT rate (BT-119) of the specific VAT category code of the
associated Prepayment invoice(s).
Item price base quantity The number of item units to which the price applies.
Item price base quantity Item price base quantity unit code
unit code
Price allowance indicator An indicator that this AllowanceCharge describes a discount/Charge. The
value of this tag indicating discount (Allowance) must be "false".
Item price discount The total discount subtracted from the Item gross price to calculate the
Item net price.
Only applies if the discount is provided per unit and if it is not included in
the Item gross price.
This is in the context of the line item price level (not the line item level).
Currency for item price Currency for item price discount
discount
Item gross price The unit price, exclusive of VAT, before subtracting Item price discount.
Currency for item gross Currency for item gross prices. This is in the context of the line item price
prices level (not the line item level).
Business term ID (EN
16931) / KSA term ID
Group ID Term ID
3.1 Invoice issue date as per Article 53(5)(a) of the Dates - BT-2
VAT Implementing Regulation OR
NA Currencies - BT-5
NA Currencies - BT-6
13.1 A reference to the original invoice(s) that the Reference documents BG-3 BT-25
credit/debit note is related to
6.2 Contract Number Reference documents - BT-12
2.5 Invoice tamper-resistant counter value Invoice counter value - KSA-16
2.3 Previous document (invoice / note) hash. Previous invoice hash - KSA-13
4.2 Address as per Article 53(5)(e) of the VAT Seller address BG-5 BT-35
Implementing Regulation.
4.2 Address as per Article 53(5)(e) of the VAT Seller address BG-5 BT-36
Implementing Regulation.
4.2 Address as per Article 53(5)(e) of the VAT Seller address BG-5 KSA-17
Implementing Regulation.
4.2 Address as per Article 53(5)(e) of the VAT Seller address BG-5 KSA-23
Implementing Regulation.
4.2 Address as per Article 53(5)(e) of the VAT Seller address BG-5 BT-37
Implementing Regulation.
4.2 Address as per Article 53(5)(e) of the VAT Seller address BG-5 BT-38
Implementing Regulation.
4.2 Address as per Article 53(5)(e) of the VAT Seller address BG-5 BT-39
Implementing Regulation.
4.2 Address as per Article 53(5)(e) of the VAT Seller address BG-5 KSA-3
Implementing Regulation.
4.2 Address as per Article 53(5)(e) of the VAT Seller address BG-5 BT-40
Implementing Regulation.
4.3 VAT registration numbers as per Article 53(5) Seller identification BG-5 BT-31
(c) of the VAT Implementing Regulation and in
case the seller is part of a VAT group then the
VAT group Registration number should be entered
4.1 Name as per Article 53 of the VAT Seller identification BG-5 BT-27
Implementing Regulation
5.2 Address as per Article 53(5)(e) of the VAT Buyer address BG-8 BT-50
Implementing Regulation
5.2 Address as per Article 53(5)(e) of the VAT Buyer address BG-8 BT-51
Implementing Regulation
5.2 Address as per Article 53(5)(e) of the VAT Buyer address BG-8 KSA-18
Implementing Regulation
5.2 Address as per Article 53(5)(e) of the VAT Buyer address BG-8 KSA-19
Implementing Regulation
5.2 Address as per Article 53(5)(e) of the VAT Buyer address BG-8 BT-52
Implementing Regulation
5.2 Address as per Article 53(5)(e) of the VAT Buyer address BG-8 BT-53
Implementing Regulation
5.2 Address as per Article 53(5)(e) of the VAT Buyer address BG-8 BT-54
Implementing Regulation
5.2 Address as per Article 53(5)(e) of the VAT Buyer address BG-8 KSA-4
Implementing Regulation
5.2 Address as per Article 53(5)(e) of the VAT Buyer address BG-8 BT-55
Implementing Regulation
5.3 VAT registration number (if applicable) for the Buyer identification BG-7 BT-48
buye rand in case the buyer is part of a VAT group
then the VAT group Registration number should
be entered
5.1 Name, as per Article 53 of the VAT Buyer identification BG-7 BT-44
Implementing Regulation
9.1 Payment means, to specify if mode of Payment instructions - Payment mean BG-16 BT-81
payment is cash, credit/debit cards, bank transfer,
credit, and/or others.
13.2 Reason for issuance of credit / debit note as Payment instructions - credit / debit - KSA-10
per the VAT Implementing Regulation note reason
9.2 Payment Terms, if mode of payment is by Payment instructions - Credit transfer BG-17 KSA-22
credit.
9.3 Supplier’s Bank Account details, if mode of Payment instructions - Credit transfer BG-17 BT-84
payment is by credit.
NA Allowance (discount) at document BG-20 -
level
8.1 Discount or rebate percentage, if discount is Allowance (discount) at document BG-20 BT-94
provided at invoice level level
8.2 Discount or rebate amount, if discount is Allowance (discount) at document BG-20 BT-92
provided at invoice level as per Article 53 of the level
VAT Implementing Regulation
8.2 Discount or rebate amount, if discount is Allowance (discount) at document BG-20 BT-5
provided at invoice level as per Article 53 of the level
VAT Implementing Regulation
8.1 Discount or rebate percentage, if discount is Allowance (discount) at document BG-20 BT-93
provided at invoice level level
8.1 Discount or rebate percentage, if discount is Allowance (discount) at document BG-20 BT-5
provided at invoice level level
8.1 Discount or rebate percentage, if discount is Allowance (discount) at document BG-20 BT-95
provided at invoice level OR level
8.2 Discount or rebate amount, if discount is
provided at invoice level as per Article 53 of the
VAT Implementing Regulation
8.1 Discount or rebate percentage, if discount is Allowance (discount) at document BG-20 BT-96
provided at invoice level OR level
8.2 Discount or rebate amount, if discount is
provided at invoice level as per Article 53 of the
VAT Implementing Regulation
NA Allowance (discount) at document BG-20 BT-97
level
8.6 Charge amount, without VAT if charge is Charge at document level BG-21 BT-99
applied at document level
8.6 Charge amount, without VAT if charge is Charge at document level BG-21 BT-5
applied at document level
8.3 Invoice Taxable Amount per rate or exemption Invoice total amounts - Total amount BG-22 BT-109
as per Article 53 of the VAT Implementing without VAT
Regulation
8.3 Invoice Taxable Amount per rate or exemption Invoice total amounts - Total amount BG-22 BT-5
as per Article 53 of the VAT Implementing without VAT
Regulation
8.4 VAT Total as per Article 53(5)(j) of the VAT Invoice total amounts - Total VAT BG-22 BT-110
Implementing Regulation OR amount
8.4 VAT Total as per Article 53(8)(e) of the VAT
Implementing Regulation
8.4 VAT Total as per Article 53(5)(j) of the VAT Invoice total amounts - Total VAT BG-22 BT-5
Implementing Regulation OR amount
8.4 VAT Total as per Article 53(8)(e) of the VAT
Implementing Regulation
8.4 VAT Total as per Article 53(5)(j) of the VAT Invoice total amounts - Total VAT BG-22 BT-111
Implementing Regulation OR amount in accounting currency
8.4 VAT Total as per Article 53(8)(e) of the VAT
Implementing Regulation
8.4 VAT Total as per Article 53(5)(j) of the VAT Invoice total amounts - Total VAT BG-22 BT-6
Implementing Regulation OR amount in accounting currency
8.4 VAT Total as per Article 53(8)(e) of the VAT
Implementing Regulation
8.5 Invoice Gross Total (inclusive of VAT) OR Invoice total amounts - Total amount BG-22 BT-112
8.5 Invoice Gross Total (inclusive of VAT) as per with VAT
Article 53(8)(d) of the VAT Implementing
Regulation
If VAT total is not entered, Gross Total to be
entered
Statement - "Amount includes VAT"
8.5 Invoice Gross Total (inclusive of VAT) OR Invoice total amounts - Total amount BG-22 BT-5
8.5 Invoice Gross Total (inclusive of VAT) as per with VAT
Article 53(8)(d) of the VAT Implementing
Regulation
If VAT total is not entered, Gross Total to be
entered
Statement - "Amount includes VAT"
8.7 Advanced payment adjustment amount Invoice total amounts - Pre-Paid BG-22 BT-113
(inclusive of VAT) amount
8.7 Advanced payment adjustment amount Invoice total amounts - Pre-Paid BG-22 BT-5
(inclusive of VAT) amount
8.9 Amount due for payment Invoice total amounts - Payable BG-22 BT-115
amount
11.1 Where Tax is not charged at the standard VAT breakdown BG-23 BT-120
rate, this field should have a narration “Tax
treatment applied to the supply” as per Article 53
of the VAT Implementing Regulation
7.4 Quantity as per Article 53 of the VAT Line items - Quantity BG-25 BT-129
Implementing Regulation
7.4 Quantity as per Article 53 of the VAT Line items - Quantity BG-25 BT-130
Implementing Regulation
7.7 Subtotal (exclusive of VAT) Line items - Line extension amount BG-25 BT-131
7.7 Subtotal (exclusive of VAT) Line items - Line extension amount BG-25 BT-5
7.5 Discount or rebate percentage, if discount is Line items - Allowance (discount) at BG-27 BT-138
provided at line item level line level
NA Line items - Allowance (discount) at BG-27 BT-139
line level
7.6 Discount or rebate amount, if discount is Line items - Allowance (discount) at BG-27 BT-136
provided at line item level as per Article 53(5)(h) of line level
the VAT Implementing Regulation
7.6 Discount or rebate amount, if discount is Line items - Allowance (discount) at BG-27 BT-5
provided at line item level as per Article 53(5)(h) of line level
the VAT Implementing Regulation
7.5 Discount or rebate percentage, if discount is Line items - Allowance (discount) at BG-27 BT-137
provided at line item level line level
7.5 Discount or rebate percentage, if discount is Line items - Allowance (discount) at BG-27 BT-5
provided at line item level line level
7.12 Charge amount, without VAT if charge is Line items - Charge at line level BG-28 BT-141
provided at line item level
7.12 Charge amount, without VAT if charge is Line items - Charge at line level BG-28 BT-5
provided at line item level
7.10 VAT amount as per Article 53(5)(j) of the VAT Line items - Line VAT amount - KSA-11
Implementing Regulation OR
7.10 VAT amount as per Article 53(8)(e) of the
VAT Implementing Regulation
7.10 VAT amount as per Article 53(5)(j) of the VAT Line items - Line VAT amount - BT-5
Implementing Regulation OR
7.10 VAT amount as per Article 53(8)(e) of the
VAT Implementing Regulation
7.11 Subtotal (inclusive of VAT) OR Line items - Line amount with VAT - KSA-12
7.11 Subtotal (inclusive of VAT) as per Article
53(8)(d) of the VAT Implementing Regulation with
a statement saying “inclusive of VAT”
7.11 Subtotal (inclusive of VAT) OR Line items - Line amount with VAT - BT-5
7.11 Subtotal (inclusive of VAT) as per Article
53(8)(d) of the VAT Implementing Regulation with
a statement saying “inclusive of VAT”
7.13 prepayment subtotal (Exclusive of VAT) per Line items - Prepayment amount - KSA-31
Rate or exemption
7.13 prepayment subtotal (Exclusive of VAT) per Line items - Prepayment amount - BT-5
Rate or exemption
7.14 prepayment VAT amount per Rate or Line items - Prepayment amount - KSA-32
exemption”
7.14 prepayment VAT amount per Rate or Line items - Prepayment amount - BT-5
exemption”
7.1 Goods or Service Description as per Article Line items - Description BG-31 BT-153
53(5)(f) of the VAT Implementing Regulation OR
7.1 Goods or Service Description as per Article
53(8)(c) of the VAT Implementing Regulation
7.2 Goods or Service Code Line items - Identifiers BG-31 BT-156
7.3 Unit Price as per Article 53(5)(h) of the VAT Line items - Item price BG-29 BT-146
Implementing Regulation
7.3 Unit Price as per Article 53(5)(h) of the VAT Line items - Item price BG-29 BT-5
Implementing Regulation
7.8 VAT rate as per Article 53(5)(i) of the VAT Line items - VAT BG-30 BT-152
Implementing Regulation
7.4 Quantity as per Article 53 of the VAT Line items - Item price BG-29 BT-149
Implementing Regulation
7.4 Quantity as per Article 53 of the VAT Line items - Item price BG-29 BT-150
Implementing Regulation
7.6 Discount or rebate amount, if discount is Line items - Item price BG-29 BT-147
provided at line item level as per Article 53(5)(h) of
the VAT Implementing Regulation
7.6 Discount or rebate amount, if discount is Line items - Item price BG-29 BT-5
provided at line item level as per Article 53(5)(h) of
the VAT Implementing Regulation
7.3 Unit Price as per Article 53 of the VAT Line items - Item price BG-29 BT-148
Implementing Regulation
7.3 Unit Price as per Article 53 of the VAT Line items - Item price BG-29 BT-5
Implementing Regulation
Business requirements and rules
UBL specifications
where
cac:AdditionalDocumentReferene / cbc:ID
= ICV
where cac:AccountingSupplierParty /
cac:Party / cac:PartyTaxScheme /
cac:TaxScheme = VAT
cac:AccountingSupplierParty / cac:Party / 1..1 Text BR-06 BR-KSA-F-06
cac:PartyLegalEntity /
cbc:RegistrationName
cac:AccountingCustomerParty / cac:Party / 0..* Identifier BR-KSA-14
cac:PartyIdentification / cbc:ID BR-KSA-49
BR-KSA-81
where attribute "schemeID" is according to
cac:AccountingCustomerParty
the description / cac:Party / 0..1 Text BR-10 BR-KSA-10
cac:PostalAddress / cbc:StreetName BR-KSA-63
BR-KSA-F-06
cac:AccountingCustomerParty / cac:Party / 0..1 Text BR-KSA-F-06
cac:PostalAddress /
cbc:AdditionalStreetName
cac:AccountingCustomerParty / cac:Party / 0..1 Text BR-KSA-63
cac:PostalAddress / cbc:BuildingNumber
where cac:AccountingCustomerParty /
cac:Party / cac:PartyTaxScheme /
cac:TaxScheme = VAT
cac:AccountingCustomerParty / cac:Party / 1..1 if its parent Text BR-KSA-25
cac:PartyLegalEntity / context exists BR-KSA-42
cbc:RegistrationName BR-KSA-71
BR-KSA-F-06
With cbc:ChargeIndicator="false"
cac:AllowanceCharge / cac:TaxCategory / 1..1 if its parent Percentage BR-S-06 BR-KSA-12
cbc:Percent context exists BR-Z-06 BR-KSA-DEC-02
BR-E-06
With cbc:ChargeIndicator="false"
0..1 Text BR-KSA-F-06
cac:AllowanceCharge/
cbc:AllowanceChargeReason
With cbc:ChargeIndicator="false"
0..1 Code
cac:AllowanceCharge/
cbc:AllowanceChargeReasonCode
With cbc:ChargeIndicator="false"
cac:AllowanceCharge / cac:TaxCategory / 1..1 if its parent string
cac:TaxScheme / cbc:ID context exists
With cbc:ChargeIndicator="true"
With cbc:ChargeIndicator="true"
With cbc:ChargeIndicator="true"
With cbc:ChargeIndicator="true"
With cbc:ChargeIndicator="false"
0..1 Code
cac:InvoiceLine / cac:AllowanceCharge /
cbc:AllowanceChargeReasonCode
With cbc:ChargeIndicator="false"
With cbc:ChargeIndicator="true"
With cbc:ChargeIndicator="true"
cac:InvoiceLine / cac:AllowanceCharge / 1..1 if its parent Code BR-CL-03 BR-KSA-CL-02
cbc:Amount @currencyID context exists
With cbc:ChargeIndicator="true"
With cbc:ChargeIndicator="true"
KSA status (Mandatory / Optional / Conditional / Not applicable) in the XML format
M M M M M M
M M M M M M
M M M M M M
M M M M M M
M M M M M M
M M M M M M
M M M M M M
O O O O O O
M M M M M M
M M M M M M
O O O O O O
NA M M NA M M
O O O O O O
M M M M M M
M M M M M M
M M M M M M
M M M M M M
M M M M M M
M M M M M M
O O O O O O
M M M M M M
O O O O O O
M M M M M M
M M M M M M
O O O O O O
M M M M M M
M M M M M M
M M M M M M
M M M M M M
C C C C C C
M M M O O O
O O O O O O
C C C O O O
O O O O O O
M M M O O O
C C C O O O
O O O O O O
C C C O O O
M M M O O O
C C C O O O
M M M C C C
C C C C C C
C C C C C C
O O O O O O
NA M M NA M M
O O O O O O
O O O O O O
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
O O O O O O
O O O O O O
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
M M M M M M
M M M M M M
C C C C C C
C C C C C C
C C C C C C
C C C C C C
M M M M M M
M M M M M M
M M M M M M
M M M M M M
C C C C C C
C C C C C C
M M M M M M
M M M M M M
O O O O O O
O O O O O O
O O O O O O
O O O O O O
M M M M M M
M M M M M M
M M M M M M
M M M M M M
M M M M M M
M M M M M M
M M M M M M
C C C C C C
C C C C C C
C C C C C C
M M M M M M
M M M M M M
C C C C C C
O O O O O O
C C C C C C
C C C C C C
C C C C C C
M M M M M M
O O O O O O
M M M M M M
M M M M M M
C C C C C C
C C C C C C
O O O O O O
O O O O O O
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
M M M O O O
M M M O O O
M M M M M M
M M M M M M
C C C C C C
C C C C C C
C C C C C C
C C C C C C
M M M M M M
O O O O O O
O O O O O O
O O O O O O
M M M M M M
M M M M M M
M M M M M M
M M M M M M
C C C C C C
C C C C C C
M M M M M M
O O O O O O
O O O O O O
C C C C C C
C C C C C C
C C C C C C
C C C C C C
C C C C C C
Visibility on Invoice for Tax invoices and
associated credit and debit notes
KSA specific format
Not Required
Required
Required
HH:mm:ss Not Required
Not Required
Not Required
Not Required
numeric Not Required
Not Required
Required
Not Required
alphanumeric Required
Required
Required, if populated
Required
Required, if populated
Required
Required, if populated
Required
Required
Required
Required
Required
Required, if populated
Required
Required, if populated
Required
Required
Required, if populated
Required
Required
Required
Required
Required
Required
Not Required
Not Required
Not Required
Required, if populated
Not Required
Not Required
Not Required
Up to 2 decimal places, in Arabic Not Required
numerals (The following numerals:
1234567890)
Not Required
Subset of UNCL5305 as specified Not Required
in 11.2.4 of the XML
implementation standards
Not Required
Not Required
Required, if populated
Required, if populated
Required
In Arabic numerals (The following Required
numerals: 1234567890)
Required
Required, if populated
Required, if populated
Required, if populated
Not Required
Not Required
Required
Not Required
Not required
Not required
Not required
Not required
Not required
Required
Not Required
Required, if populated
Not Required
Not Required
Upto 2 decimal places, in Arabic Not Required
numerals (EX: 123456)
Value between 0.00 and 100.00
Required, if populated
Required
Upto 2 decimal places, in SAR, in Required
Arabic numerals (EX: 123456)
Required
Required, if populated
Required, if populated
Required
Not Required
Not Required
Not Required
Required
Not Required
Upto 2 decimal places, in Arabic Required, if populated
numerals (EX: 123456)
Value between 0.00 and 100.00
Not Required
Not Required
Not Required
Not Required
Not Required
Visibility on human readable formats for
Simplified Tax invoices and associated Field character limits
credit and debit notes Number of characters Number of characters
(minimum limit) - Standard (minimum limit) -
documents Simplified documents
Not Required - -
Not Required - -
Required - -
Not Required - -
Not Required - -
(The invoice type -not the code- will be printed
in the title)
Not Required - -
Not Required - -
Required - -
Not Required - -
Required - -
Not Required - -
Not Required - -
Required, if populated - -
Required - -
Required - -
Required - -
Required 1 character 1 character
Required, if populated - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Required - -
Required - -
Not Required - -
Required 1 character 1 character
Not Required - -
Not Required - -
Required, if populated - -
Required, if populated - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Not Required 0 0
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Required, if populated - -
Required, if populated - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Not Required 0 0
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Required, if populated - -
Required, if populated - -
Required, if populated - -
Required, if populated - -
Required - -
Required - -
Not Required - -
Not Required - -
Required, if populated - -
Required, if populated - -
Required - -
Required - -
Required, if populated - -
Required, if populated - -
Required, if populated - -
Required, if populated - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Not required - -
Not required - -
Not required - -
Not required - -
Not required - -
Required - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Not Required 0 0
Not Required - -
Required, if populated - -
Required, if populated - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Required, if populated - -
Required, if populated - -
Not Required - -
Not Required - -
Not Required 0 0
Not Required - -
Not Required - -
Not Required - -
Required with a statement saying “inclusive of - -
VAT”
Required - -
Required, if populated - -
Required, if populated - -
Required, if populated - -
Required, if populated - -
Required - -
Required - -
Not Required - -
Not Required - -
Not Required - -
Required, if populated - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
Not Required - -
mits Example
Number of characters
(maximum limit)
- Default value
reporting:1.0
- 3cf5ee18-ee25-44ea-a444-2c37ba7f28be
- 2021-02-25
- 16:55:24
- 388
- 010100
- SAR
- SAR
- NWZlY2ViNjZmZmM4NmYzOGQ5NTI3ODZjNmQ2OTZjNzljMmRiYzIzOWRk
NGU5MWI0NjcyOWQ3M2EyN2ZiNTdlOQ==
- AQkxMjM0NTY3ODkCCjEyLzEyLzIwMjADBDEwMDADAzE1MPaIn2Z2jg6Vq
WvWV6IrZZNzLF7xvZrWXW5xRV5yFY2xFu0ycXOiyqV0k7Wsh6b1IcE2Tfza
p1AQAQVsktmsv1FFQ1MxIAAAAGKblFMh9nFRSn8tvftXqo9zRSz2VEAPITS
Z3W7UDHKhUx+7yXGijLtJSZGXMOc+jpKwARzDl68GmmRd75NWdOs=
- In the UBL extension
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionURI>urn:oasis:names:specification:ubl:dsig:enveloped:xades</
ext:ExtensionURI>
<ext:ExtensionContent>
<sig:UBLDocumentSignatures
xmlns:sac="urn:oasis:names:specification:ubl:schema:xsd:SignatureAggregat
eComponents-2"
xmlns:sbc="urn:oasis:names:specification:ubl:schema:xsd:SignatureBasicCo
mponents-2"
xmlns:sig="urn:oasis:names:specification:ubl:schema:xsd:CommonSignature
Components-2">
<sac:SignatureInformation>
<cbc:ID>urn:oasis:names:specification:ubl:signature:1</cbc:ID>
<sbc:ReferencedSignatureID>urn:oasis:names:specification:ubl:signature:Inv
oice</sbc:ReferencedSignatureID>
<ds:Signature Id="signature"
xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
<ds:SignedInfo>
<ds:CanonicalizationMethod
- 456789123
Algorithm="http://www.w3.org/2006/12/xml-c14n11"/>
127 characters
-
- 72415
- SA
- 3xxxxxxxxx00003
1,000 characters SELLER SA
- 456789123
- 3xxxxxxxxx00003
- 2021-02-26
- 2021-02-26
- 30
1,000 characters Cancellation or suspension of the supplies after its occurrence either wholly or
partially
- 20
- 24
- SAR
- 120
- SAR
- S
- 20
1,000 characters Discount
- 95
- VAT
- 20
- SAR
- 1000
- SAR
- S
- 15
- CG
- VAT
- 4200.00
- SAR
- 300
- SAR
- 300
- SAR
- 4000.00
- SAR
- 800.00
- SAR
- 800.00
- SAR
- 4800.00
- SAR
- 100
- SAR
- 0.04
- SAR
- 4701.52
- SAR
- 200
- SAR
- 40
- SAR
- S
- 20.00
-
- VAT
6 characters 1
- 12345678
- 3cf5ee18-ee25-44ea-a444-2c37ba7f28be
- 2021-02-28
- 18:50:30
- 386
- 4
- 2000
- SAR
- 20.00
1,000 characters Discount
- 95
- 24.34
- SAR
- 120.34
- SAR
- 20
- SAR
- 1000
- SAR
1,000 characters Cleaning
- CG
- 20.04
- SAR
- 20.04
- SAR
- 1000
- SAR
- 150
- SAR
- 50.24
- SAR
- S
- 20
- S
- 15
- VAT
- 1
- 10
- SAR
- 60.25
- SAR
In the UBL extension
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionURI>urn:oasis:names:specification:ubl:dsig:enveloped:xades</ext:ExtensionURI>
<ext:ExtensionContent>
<sig:UBLDocumentSignatures xmlns:sac="urn:oasis:names:specification:ubl:schema:xsd:SignatureAggre
xmlns:sbc="urn:oasis:names:specification:ubl:schema:xsd:SignatureBasicComponents-2" xmlns:sig="urn:oasis:n
<sac:SignatureInformation>
<cbc:ID>urn:oasis:names:specification:ubl:signature:1</cbc:ID>
<sbc:ReferencedSignatureID>urn:oasis:names:specification:ubl:signature:Invoice</sbc:ReferencedS
<ds:Signature Id="signature" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
<ds:SignedInfo>
<ds:CanonicalizationMethod Algorithm="http://www.w3.org/2006/12/xml-c14n11"/>
<ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha256"/>
<ds:Reference Id="invoiceSignedData" URI="">
<ds:Transforms>
<ds:Transform Algorithm="http://www.w3.org/TR/1999/REC-xpath-19991116">
<ds:XPath>not(//ancestor-or-self::ext:UBLExtensions)</ds:XPath>
</ds:Transform>
<ds:Transform Algorithm="http://www.w3.org/TR/1999/REC-xpath-19991116">
<ds:XPath>not(//ancestor-or-self::cac:Signature)</ds:XPath>
</ds:Transform>
<ds:Transform Algorithm="http://www.w3.org/TR/1999/REC-xpath-19991116">
<ds:XPath>not(//ancestor-or-self::cac:AdditionalDocumentReference[cbc:ID='QR'])</ds:
</ds:Transform>
<ds:Transform Algorithm="http://www.w3.org/2006/12/xml-c14n11"/>
</ds:Transforms>
<ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
<ds:DigestValue>tIgyb6RmuRm+rvj8tL5cbwK5eRk=</ds:DigestValue>
</ds:Reference>
<ds:Reference Type="http://www.w3.org/2000/09/xmldsig#SignatureProperties" URI="#xades
<ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
<ds:DigestValue>skZ+8g6hyUFzbbTZvJZRyAREMiM=</ds:DigestValue>
</ds:Reference>
</ds:SignedInfo>
<ds:SignatureValue>J3dQSz3nEQd8wagH2CBlip1fj03NTccYAQTGiU/4IhBYzylKxjB09OMBb5vXj2Lv7
g4Gy3pqNQoC7AOghUUXTjvFEBcHVgpt/5wDC8U3PwNfx9hzpU00t/b042GyLECGjPDzr8mGbI09mobT7sSb9oPPzx
BaOYLjEGvZrOxmoK2doUZNPi811tbq6nC4jjlrU+NRr5kQA==</ds:SignatureValue>
<ds:KeyInfo>
<ds:X509Data>
<ds:X509Certificate>MIIDaDCCAlCgAwIBAgIKlswlvJ8beIpd9jANBgkqhkiG9w0BAQsFADBiMRkwFwYDVQQDExBNb
QEWDFRlc3RAcHdjLmNvbTELMAkGA1UEBhMCQUUwHhcNMjEwMjI1MTI1NjU3WhcNMjYwMjI1MTI1NjU3WjBiM
AxGzAZBgkqhkiG9w0BCQEWDFRlc3RAcHdjLmNvbTELMAkGA1UEBhMCQUUwggEiMA0GCSqGSIb3DQEBAQUAA4
h7UE+B2ClyW+CRixDx82Qkn9IUX+nw28QO7ux9UBDt3nIeL6euAUPMxrnyESALXXRjTLrJK3p6vsFr3hNbP4V0t/ZDA
vT1UgeolOrvnsEKeDR8w43C1Juuw9CVi3duekYf1WVjfuNNClocjZ0N4D7dYdg536bqtc4F8C6sBmk/2YfG/
Fsqb6DSU0FU1dSj+rjZvaR6tIDAgMBAAGjIDAeMA8GCSqGSIb3LwEBCgQCBQAwCwYDVR0PBAQDAgeAMA0GCSqG
0Yfe1EkjbFLV25AGw/06jZV7Fy8jK2jR7TJnv2QnxZz4ldg2k8DolC6J4YZqI5R0THFnd09MNHcgV6ChGJNzivRRkTrwFM
UilQdexNFUmkUyZBisKEhpdHURHCJY2ip0iH8wZtG4oiGtisLEHJT+ZREWIzjTUKlw9ImXu2e4ptzrPBPLMGdWdQ153
</ds:X509Data>
</ds:KeyInfo>
<ds:Object>
<xades:QualifyingProperties Target="signature" xmlns:xades="http://uri.etsi.org/01903/v1.3.2
<xades:SignedProperties Id="xadesSignedProperties">
<xades:SignedSignatureProperties>
<xades:SigningTime>2021-02-25T12:57:51Z</xades:SigningTime>
<xades:SigningCertificate>
<xades:Cert>
<xades:CertDigest>
<ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
<ds:DigestValue>p6/1GNOqntK37JwfUub56vSecg0=</ds:DigestValue>
</xades:CertDigest>
<xades:IssuerSerial>
<ds:X509IssuerName>C=SA, E=Test@test Taxpayer.com, OU="", O=te
<xades:SignedSignatureProperties>
<xades:SigningTime>2021-02-25T12:57:51Z</xades:SigningTime>
<xades:SigningCertificate>
<xades:Cert>
<xades:CertDigest>
<ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
<ds:DigestValue>p6/1GNOqntK37JwfUub56vSecg0=</ds:DigestValue>
</xades:CertDigest>
<xades:IssuerSerial>
<ds:X509IssuerName>C=SA, E=Test@test Taxpayer.com, OU="", O=te
<ds:X509SerialNumber>1234</ds:X509SerialNumber>
</xades:IssuerSerial>
</xades:Cert>
</xades:SigningCertificate>
</xades:SignedSignatureProperties>
</xades:SignedProperties>
</xades:QualifyingProperties>
</ds:Object>
</ds:Signature>
</sac:SignatureInformation>
</sig:UBLDocumentSignatures>
</ext:ExtensionContent>
</ext:UBLExtension>
</ext:UBLExtensions>
>
:signature:Invoice</sbc:ReferencedSignatureID>
00/09/xmldsig#">
rg/2006/12/xml-c14n11"/>
1/04/xmldsig-more#rsa-sha256"/>
99/REC-xpath-19991116">
s)</ds:XPath>
99/REC-xpath-19991116">
s:XPath>
99/REC-xpath-19991116">
cumentReference[cbc:ID='QR'])</ds:XPath>
12/xml-c14n11"/>
/04/xmlenc#sha256"/>
DigestValue>
g#SignatureProperties" URI="#xadesSignedProperties">
/04/xmlenc#sha256"/>
:DigestValue>
QTGiU/4IhBYzylKxjB09OMBb5vXj2Lv7eXhciRoMmvSF+A9eIUd2a4b5aEm7VBkxIbyGgltNHR8u3oZ7Ee+HNWRAQU+IFCKpZoVA68Bo/
ECGjPDzr8mGbI09mobT7sSb9oPPzxsC71dph+oU0ug+TAh2NheVih+HWCe870hFJvH3mZ9YcC/lcMXb80Ot+LSjgV8gcTSDz/
lue>
BAQsFADBiMRkwFwYDVQQDExBNb2hkIEtoYWxpZmEgUDEyMRAwDgYDVQQKEwd0ZXMgcHdjMQkwBwYDVQQLEwAxGzAZBgkqhkiG9w0BC
jU3WhcNMjYwMjI1MTI1NjU3WjBiMRkwFwYDVQQDExBNb2hkIEtoYWxpZmEgUDEyMRAwDgYDVQQKEwd0ZXMgcHdjMQkwBwYDVQQLEw
wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDWaRBaLHqhlZDDAf+YH2H2xgtHT9tMcg3vmGuP4YT2aeG77RWnIu0bqtNiNrOK+
ALXXRjTLrJK3p6vsFr3hNbP4V0t/ZDAtk36PAn6WfKZICMI63GnzWLAQz6QOGvVmOYNym93Q84W9Ttn844yfun1EVj/+XC3bYmysTPbAgPZ/
536bqtc4F8C6sBmk/2YfG/
AwCwYDVR0PBAQDAgeAMA0GCSqGSIb3DQEBCwUAA4IBAQDACtfjpOtcy5dPp1tS31rB9lJ7aeQ6dayxJGyXGovhjYZ8N60sAR/
Fnd09MNHcgV6ChGJNzivRRkTrwFM0qWErTCh/5wA/GHgqRKjWUA/S2P7UbKbjIA5Ba6N3K/zT4DfspxvvCp50jigPyh1e/
Klw9ImXu2e4ptzrPBPLMGdWdQ153YCkXFKLbV97JBUzilUhJ7GouDYKj3PnUzLMCSd</ds:X509Certificate>
es="http://uri.etsi.org/01903/v1.3.2#">
:SigningTime>
3.org/2001/04/xmlenc#sha256"/>
Secg0=</ds:DigestValue>
3.org/2001/04/xmlenc#sha256"/>
Secg0=</ds:DigestValue>
d:xades</cbc:SignatureMethod>
-2">
NWRAQU+IFCKpZoVA68Bo/
Ot+LSjgV8gcTSDz/
wYDVQQLEwAxGzAZBgkqhkiG9w0BC
Ewd0ZXMgcHdjMQkwBwYDVQQLEw
GuP4YT2aeG77RWnIu0bqtNiNrOK+p
44yfun1EVj/+XC3bYmysTPbAgPZ/
XGovhjYZ8N60sAR/
Cp50jigPyh1e/
>