If a customer asks about authority alerts or requests an explanation or clarification of the alert, whether it is one alert or multiple different alerts, respond as follows below for each alert separately:
– Description in Arabic
– Responsible for modification
– In case of modification from:
Customer: steps to the solution are clarified
Qoyod: The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Note:
If the invoice status is “Received with remarks”: no modification, only remarks for future invoices.
If the invoice status is “Error in invoice”: modification + credit note + new invoice required.
Common inquiry formats:
– I received the alerts (the alert text is written)
– What do the alerts mean (the alert text is written)
– Explain the alerts to me (the alert text is written)
List of errors and modifications:
Error Code: BR-02
Description in English: An Invoice shall have an Invoice number (BT-1).
Description in Arabic: The invoice must contain the reference number (BT-1).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-03
Description in English: An Invoice shall have an Invoice issue date (BT-2).
Description in Arabic: The invoice must contain the invoice issue date (BT-2).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-04
Description in English: An Invoice shall have an Invoice type code (BT-3).
Description in Arabic: The invoice must contain the invoice type code (BT-3).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-05
Description in English: An Invoice shall have an Invoice currency code (BT-5).
Description in Arabic: The invoice must contain the invoice currency code (BT-5).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-06
Description in English: An Invoice shall contain the Seller name (BT-27).
Description in Arabic: The invoice must contain the seller name (BT-27).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-08
Description in English: An Invoice shall contain the Seller postal address (BG-5).
Description in Arabic: The invoice must contain the seller’s postal address (BG-5).
Responsible for modification: Customer.
Problem: The invoice you issued from Qoyod does not contain a complete postal address for the seller (your company), which violates the requirements of ZATCA in phase two.
Solution: ZATCA requires that each tax invoice contain complete seller data, including a postal address, because it is part of the company’s official identity and is used for verification and audit purposes.
Solution:
Step 1: Go to Company Settings
From the main menu, go to:
Settings > General Settings.
Search for the “Address” field
In the Address field, fill in the following data completely:
Street: Street or neighborhood name (example: “King Fahd Street”).
City: City (example: “Riyadh”).
Postal Code: 5-digit postal code (example: 12345).
District / Region: District name (example: “Al-Worood”).
Then save at the bottom of the page.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Error in invoice.” If the invoice status is “Received with alerts,” invoice modification is not required, only remarks for future invoices, and do not request any data from the customer such as facility number or invoice number if the modification is from their side.
Error Code: BR-09
Description in English: The Seller postal address (BG-5) shall contain a Seller country code (BT-40).
Description in Arabic: The seller’s postal address must contain the seller country code (BT-40).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-1010
Description in English: An Invoice shall contain the Buyer postal address (BG-8). Not applicable for simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02).
Description in Arabic: The invoice must contain the buyer’s postal address (BG-8). Not applicable to simplified tax invoices and associated credit and debit notes.
Responsible for modification: Customer.
Problem: You issued a tax invoice, not a simplified one, but you did not enter the buyer’s complete postal address. This is mandatory in tax invoices according to ZATCA requirements.
When are you required to enter the buyer’s address?
Invoice Type: Tax invoice – Yes, mandatory.
Invoice Type: Simplified tax invoice – No, not required
How do you know the invoice type?
If the customer has a tax number, it is considered a tax invoice. If the customer has no tax number in their data, it is considered a simplified tax invoice.
Solution:
From the main menu in Qoyod, go to:
Sales > Customers.
Search for the customer who the invoice appeared with this error.
Click edit next to them.
Enter the customer’s postal address accurately
Street: Street or neighborhood name (example: “Al-Tahlia Street”).
City: City (example: “Jeddah”).
Region:District name if possible (example: “Al-Nuzha”).
Postal Code:5-digit postal code (example: 23456).
Building number.
Country.
Then save.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Error in invoice.” If the invoice status is “Received with alerts,” invoice modification is not required, only remarks for future invoices, and do not request any data from the customer such as facility number or invoice number if the modification is from their side.
Error Code: BR-13
Description in English: An Invoice shall have the Invoice total amount without VAT (BT-109).
Description in Arabic: The invoice must include the total invoice amount before VAT (BT-109).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-14
Description in English: An Invoice shall have the Invoice total amount with VAT (BT-112).
Description in Arabic: The invoice must include the total invoice amount with VAT (BT-112).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-15
Description in English: An Invoice shall have the Amount due for payment (BT-115).
Description in Arabic: The invoice must include the amount due for payment (BT-115).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-16
Description in English: An Invoice shall have at least one Invoice line (BG-25).
Description in Arabic: The invoice must contain at least one invoice line (BG-25).
Responsible for modification: Qoyod .
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-21
Description in English: Each Invoice line (BG-25) shall have an Invoice line identifier (BT-126).
Description in Arabic: Each invoice line must contain an invoice line identifier (BT-126).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-22
Description in English: Each Invoice line (BG-25) shall have an Invoiced quantity (BT-129).
Description in Arabic: Each invoice line must contain the invoiced quantity (BT-129).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-24
Description in English: Each Invoice line (BG-25) shall have an Invoice line net amount (BT-131).
Description in Arabic: Each invoice line must contain the net amount of the invoice line (BT-131).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-25
Description in English: Each Invoice line (BG-25) shall contain the Item name (BT-153).
Description in Arabic: Each invoice line must contain the item name (BT-153).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-26
Description in English: Each Invoice line (BG-25) shall contain the Item net price (BT-146).
Description in Arabic: Each invoice line must contain the item net price (BT-146).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-31
Description in English: Each Document level allowance (BG-20) shall have a Document level allowance amount (BT-92). Description in Arabic: Each document level allowance must contain the allowance amount (BT-92).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-32
Description in English: Each Document level allowance (BG-20) shall have a Document level allowance VAT category code (BT-95).
Description in Arabic: Each document level allowance must contain a document level allowance VAT category code (BT-95).
Responsible for modification: Qoyod.
The appropriate response: Dear Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-41
English Description: Each Invoice line allowance (BG-27) shall have an Invoice line allowance amount (BT-136).
Arabic Description: يجب أن يحتوي كل خصم على مستوى سطر الفاتورة على مبلغ الخصم (BT-136).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-45
English Description: Each VAT breakdown (BG-23) shall have a VAT category taxable amount (BT-116).
Arabic Description: يجب أن يحتوي كل تفصيل لضريبة القيمة المضافة على مبلغ خاضع للضريبة لفئة الضريبة (BT-116).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-46
English Description: Each VAT breakdown (BG-23) shall have a VAT category tax amount (BT-117).
Arabic Description: يجب أن يحتوي كل تفصيل لضريبة القيمة المضافة على مبلغ ضريبة لفئة الضريبة (BT-117).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-47
English Description: Each VAT breakdown (BG-23) shall be defined through a VAT category code (BT-118).
Arabic Description: يجب تعريف كل تفصيل لضريبة القيمة المضافة من خلال رمز فئة الضريبة (BT-118).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-48
English Description: Each VAT breakdown (BG-23) shall have a VAT category rate (BT-119), except if the Invoice is not subject to VAT.
Arabic Description: يجب أن كل تتضمن تفاصيل ضريبة القيمة المضافة (BG-23) نسبة فئة ضريبة القيمة المضافة (BT-119), إلا إذا كانت الفاتورة غير خاضع لضريبة القيمة المضافة.
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-49
English Description: A Payment instruction (BG-16) shall specify the Payment means type code (BT-81).
Arabic Description: يجب أن تحدد تعليمات الدفع رمز نوع طريقة الدفع (BT-81).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-53
English Description: If the VAT accounting currency code (BT-6) is present, then the Invoice total VAT amount in accounting currency (BT-111) shall be provided.
Arabic Description: إذا كان رمز عملة المحاسبة لضريبة القيمة المضافة موجودًا، فيجب توفير إجمالي مبلغ الضريبة بعملة المحاسبة.
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-55
English Description: Each Preceding Invoice reference (BG-3) shall contain a Preceding Invoice reference (BT-25).
Arabic Description: يجب أن يحتوي كل مرجع فاتورة سابقة على مرجع الفاتورة السابقة (BT-25).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-CO-04
English Description: Each Invoice line (BG-25) shall be categorized with an Invoiced item VAT category code (BT-151). Arabic Description: يجب تصنيف كل سطر فاتورة برمز فئة ضريبة القيمة المضافة للصنف المفوتر (BT-151).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-CO-10
English Description: Sum of Invoice line net amount (BT-106) = Σ Invoice line net amount (BT-131).
Arabic Description: يجب أن يكون مجموع صافي مبلغ سطر الفاتورة (BT-106) = Σ صافي مبلغ سطر الفاتورة (BT-131).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-CO-11
English Description: Sum of allowances on document level (BT-107) = Σ Document level allowance amount (BT-92). Arabic Description: يجب أن مجموع الخصومات على مستوى المستند (BT-107) = Σ الخصم على مستوى المستند (BT-92).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-CO-13
English Description: Invoice total amount without VAT (BT-109) = Σ Invoice line net amount (BT-131) – Sum of allowances on document level (BT-107).
Arabic Description: يجب أن إجمالي مبلغ الفاتورة بدون ضريبة القيمة المضافة (BT-109) = Σ صافي مبلغ سطر الفاتورة (BT-131) – مجموع الخصومات على مستوى المستند (BT-107).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-CO-14
English Description: Invoice total VAT amount (BT-110) = Σ VAT category tax amount (BT-117).
Arabic Description: يجب أن مجموع الضريبة في الفاتورة (BT-110) = Σ مبلغ ضريبة فئة الضريبة (BT-117).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-CO-15
English Description: Invoice total amount with VAT (BT-112) = Invoice total amount without VAT (BT-109) + Invoice total VAT amount (BT-110).
Arabic Description: يجب أن إجمالي مبلغ الفاتورة مع ضريبة القيمة المضافة (BT-112) = إجمالي مبلغ الفاتورة بدون ضريبة القيمة المضافة (BT-109) + مجموع الضريبة في الفاتورة (BT-110).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-CO-16
English Description: Amount due for payment (BT-115) = Invoice total amount with VAT (BT-112) – Paid amount (BT-113). Arabic Description: يجب أن المبلغ المستحق للدفع (BT-115) = إجمالي مبلغ الفاتورة مع ضريبة القيمة المضافة (BT-112) – المبلغ المدفوع (BT-113).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-CO-17
English Description: VAT category tax amount (BT-117) = VAT category taxable amount (BT-116) x (VAT category rate (BT-119) / 100), rounded to two decimals.
Arabic Description: مبلغ ضريبة فئة الضريبة (BT-117) = المبلغ الخاضع للضريبة لفئة الضريبة (BT-116) x (نسبة فئة ضريبة القيمة المضافة (BT-119) / 100), مقرب إلى منزلتين عشريتين.
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-CO-18
English Description: An Invoice shall at least have one VAT breakdown group (BG-23).
Arabic Description: يجب أن تحتوي الفاتورة على مجموعة واحدة على الأقل لتفصيل ضريبة القيمة المضافة (BG-23).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-S-06
English Description: In a Document level allowance (BG-20) where the Document level allowance VAT category code (BT-95) is “Standard rated” the Document level allowance VAT rate (BT-96) shall be greater than zero.
Arabic Description: في الخصم على مستوى المستند (BG-20) إذا كان الخصم على مستوى المستند رمز فئة ضريبة القيمة المضافة (BT-95) “خاضع للنسبة الأساسية” the خصم على مستوى المستند نسبة الضريبة (BT-96) يجب أن يكون أكبر من صفر.
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-S-09
English Description: The VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where VAT category code (BT-118) is “Standard rated” shall equal the VAT category taxable amount (BT-116) multiplied by the VAT category rate (BT-119) / 100), rounded to two decimals.
Arabic Description: يجب أن مبلغ ضريبة فئة الضريبة (BT-117) في تفصيل الضريبة (BG-23) عندما رمز فئة ضريبة القيمة المضافة (BT-118) “خاضع للنسبة الأساسية” يجب أن يساوي المبلغ الخاضع للضريبة لفئة الضريبة (BT-116) * نسبة فئة ضريبة القيمة المضافة (BT-119) / 100), مقرب إلى منزلتين عشريتين.
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-S-10
English Description: A VAT breakdown (BG-23) with VAT Category code (BT-118) “Standard rate” shall not have a VAT exemption reason code (BT-121) or VAT exemption reason text (BT-120).
Arabic Description: يجب أن تفصيل الضريبة (BG-23) مع رمز فئة ضريبة القيمة المضافة (BT-118) “النسبة الأساسية” يجب ألا يحتوي على رمز سبب إعفاء الضريبة (BT-121) أو سبب إعفاء الضريبة نصا(BT-120).
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-Z-01
English Description: An Invoice that contains an Invoice line (BG-25), a Document level allowance (BG-20) where the VAT category code (BT-151 or BT-95) is “Zero rated” shall contain in the VAT breakdown (BG-23) exactly one VAT category code (BT-118) equal to “Zero rated”.
Arabic Description: يجب أن في الفاتورة التي بها خصم على مستوى السطر (BG-25), خصم على مستوى المستند (BG-20) the رمز فئة ضريبة القيمة المضافة (BT-151 or BT- 95) هو “خاضع للضريبة بنسبة 0%” يجب ان يكون تفصيل الضريبة (BG-23) رمز فئة ضريبة القيمة المضافة (BT-118) تساوي “خاضع للضريبة بنسبة 0%”.
Responsibility for the modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax, and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and this does not impact your work or cause any penalties.
Error Code: BR-Z-05
English Description: In an Invoice line (BG-25) where the Invoiced item VAT category code (BT-151) is “Zero rated” the Invoiced item VAT rate (BT-152) shall be 0 (zero).
Arabic Description: In an Invoice line (BG-25) where the VAT category code (BT-151) is “Zero rated”, the invoice VAT rate (BT-152) must be 0.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-Z-06
English Description: In a Document level allowance (BG-20) where the Document level allowance VAT category code (BT-95) is “Zero rated” the Document level allowance VAT rate (BT-96) shall be 0 (zero).
Arabic Description: In a document level allowance (BG-20) where the document level allowance has a VAT category code (BT-95) “Zero rated”, the document level allowance VAT rate (BT-96) must be 0.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-Z-09
English Description: The VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where VAT category code (BT-118) is “Zero rated” shall equal 0 (zero).
Arabic Description: The VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where the VAT category code (BT-118) is “Zero rated” must equal 0.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-E-01
English Description: An Invoice that contains an Invoice line (BG-25), a Document level allowance (BG-20) where the VAT category code (BT-151 or BT- 95) is “Exempt from VAT” shall contain exactly one VAT breakdown (BG-23) with the VAT category code (BT-118) equal to “Exempt from VAT”.
Arabic Description: In an invoice that contains an invoice line (BG-25) and a document level allowance (BG-20) where the VAT category code (BT-151 or BT- 95) is “Exempt from VAT”, the VAT breakdown (BG-23) must have the VAT category code (BT-118) equal to “Exempt from VAT”.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-E-05
English Description: “In an Invoice line (BG-25) where the Invoiced item VAT category code (BT-151) is “”Exempt from VAT””, the Invoiced item VAT rate (BT-152) shall be 0 (zero).”
Arabic Description: In an invoice line (BG-25) where the invoice VAT category code (BT-151) is “”Exempt from VAT””, the invoice VAT rate (BT-152) must be 0.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-E-06
English Description: “In a Document level allowance (BG-20) where the Document level allowance VAT category code (BT-95) is “”Exempt from VAT””, the Document level allowance VAT rate (BT-96) shall be 0 (zero).”
Arabic Description: In a document level allowance (BG-20) where the document level allowance VAT category code (BT-95) is “”Exempt from VAT””, the document level allowance VAT rate (BT-96) must be 0.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-E-09
English Description: “The VAT category tax amount (BT-117) In a VAT breakdown (BG-23) where the VAT category code (BT-118) equals “”Exempt from VAT”” shall equal 0 (zero).”
Arabic Description: The VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where the VAT category code (BT-118) equals “”Exempt from VAT”” must equal 0.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-E-10
English Description: “A VAT breakdown (BG-23) with VAT Category code (BT-118) “”Exempt from VAT”” shall have a VAT exemption reason code (BT-121) or a VAT exemption reason text (BT-120).”
Arabic Description: A VAT breakdown (BG-23) with VAT category code (BT-118) “”Exempt from VAT”” must have a VAT exemption reason code (BT-121) or a VAT exemption reason text (BT-120).
Responsible for Modification: Customer.
Problem: If you selected an item in the invoice as “Exempt from VAT”, you must enter the exemption reason in the product details. Without this reason, the invoice will be rejected by the Authority.
Solution:
Open the invoice that received the error
Go to Sales and then Sales Invoices.
Search for the rejected invoice → Open it
Inside the invoice, review each line.
Look for any line where the “Tax Type” field = “Exempt from VAT“.
Verify that the exemption reason has been entered for the exempt product by going to Products and Costs, searching for the product that appears in the invoice as exempt, clicking Edit next to the product, and verifying that the tax reason has been added.
Note: Only ask the customer to reissue the invoice if the invoice status is “Invoice Error”. If the invoice status is “Received with Alerts”, no invoice modification is required—it is just a note for future invoices. Do not request any customer data such as facility number or invoice number if the modification is from their side.
Error Code: BR-O-01
English Description: “An Invoice that contains an Invoice line (BG-25), a Document level allowance (BG-20) where the VAT category code (BT-151 or BT-95) is “”Not subject to VAT”” shall contain exactly one VAT breakdown group (BG-23) with the VAT category code (BT-118) equal to “”Not subject to VAT””.”
Arabic Description: An invoice that contains an invoice line (BG-25) and a document level allowance (BG-20) where the VAT category code (BT-151 or BT-95) = ‘Not subject to VAT’, must contain exactly one VAT breakdown group (BG-23) where the VAT category code (BT-118) = ‘Not subject to VAT’
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-O-05
English Description: “An Invoice line (BG-25) where the VAT category code (BT-151) is “”Not subject to VAT”” shall not contain an Invoiced item VAT rate (BT-152).”
Arabic Description: In an invoice line (BG-25) where the VAT category code (BT-151) is “”Not subject to VAT””, the VAT rate (BT-152) must not be included.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-O-06
English Description: A Document level allowance (BG-20) where VAT category code (BT-95) is “Not subject to VAT” shall not contain a Document level allowance VAT rate (BT-96).
Arabic Description: A document level allowance (BG-20) where the VAT category code (BT-95) is “Not subject to VAT” must not contain a document level allowance VAT rate (BT-96).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-O-08
English Description: In a VAT breakdown (BG-23) where the VAT category code (BT-118) is ” Not subject to VAT” the VAT category taxable amount (BT-116) shall equal the sum of Invoice line net amounts (BT131) minus the sum of Document level allowance amounts (BT-92) where the VAT category codes (BT-151, BT-95) are “Not subject to VAT”.
Arabic Description: In a VAT breakdown (BG-23) where the VAT category code (BT-118) is ” Not subject to VAT”, the VAT category taxable amount (BT-116) must equal the total invoice line net amount (BT131) minus the total document level allowance amounts (BT-92) where the VAT category codes (BT-151, BT-95) are “Not subject to VAT”.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-O-09
English Description: The VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where the VAT category code (BT-118) is “Not subject to VAT” shall be 0 (zero).
Arabic Description: The VAT amount for the VAT category (BT-117) in a VAT breakdown (BG-23) where the VAT category code (BT-118) is “Not subject to VAT” must be 0 (zero).
Responsible for Modification: Customer.
Problem Clarification: If you selected in one of the invoice lines that the tax is “Not subject to VAT“,
then the tax amount must be exactly zero, not any other number.
You used a tax type: “Not subject to VAT“.
But the program or you manually entered a non-zero tax value (example: 10 SAR, or even 0.1 SAR).
This violates the technical specifications, because “Not subject” = there is no tax from the beginning → it must be 0.00
This option is rare and only used in special cases such as:
Internal non-commercial transactions (such as inventory transfer between branches without a sale).
Some government or exceptional transactions that are not subject to tax in the first place.
Not used with ordinary products or services — for those use “15%” or “0%”.
Do not confuse “Not subject to VAT” with “Exempt from VAT” and “0%”—each has a different use!
Go to the invoice list in Qoyod.
Search for the rejected invoice → Open it for editing.
Review each line in the invoice.
Look for any line where the “Tax Type” field = “Not subject to VAT“.
In that same line, check the following fields:
FieldRequired ValueTax TypeNot subject to VAT Tax Amount0.00 ✓ (must be exactly zero)
If there is any number, even 0.01 or -1, change it to 0.00
Note: Only ask the customer to reissue the invoice if the invoice status is “Invoice Error”. If the invoice status is “Received with Alerts”, no invoice modification is required—it is just a note for future invoices. Do not request any customer data such as facility number or invoice number if the modification is from their side.
Error Code: BR-O-10
English Description: An Invoice that contains a VAT breakdown group (BG-23) with a VAT category code (BT-118) “Not subject to VAT” shall not contain Document level allowances (BG-20) where Document level allowance VAT category code (BT-95) is not “Not subject to VAT”.
Arabic Description: An invoice that contains a VAT breakdown group (BG-23) with a VAT category code (BT-118) “Not subject to VAT” must not contain document level allowances (BG-20) where the VAT category code (BT-95) is not “Not subject to VAT”.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal from Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are automatically updated continuously to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.
Error Code: BR-O-13
English Description: An Invoice that contains a VAT breakdown group (BG-23) with a VAT category code (BT-118) “Not subject to VAT” shall not contain Document level allowances (BG-20) where Document level allowance VAT category code (BT-95) is not “Not subject to VAT”.
Arabic Description: An invoice containing a VAT breakdown group (BG-23) with a VAT category code (BT-118) “Not subject to VAT” must not contain document-level allowances (BG-20) where the VAT category code (BT-95) differs from “Not subject to VAT”.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-44
English Description: If it exists in the invoice, and if it is not an export invoice (KSA-2, position 5 is false), the buyer VAT registration number or buyer group VAT registration number (BT-48) must contain 15 digits. The first digit and the last digit is “3”.
Arabic Description: If found in the invoice, and if it is not an export invoice (KSA-2, position 5 = false), the buyer’s VAT registration number or buyer group VAT registration number (BT-48) must contain 15 digits, with the first and last digits being “3”.
Responsible for Modification: Customer.
Problem: If you entered a buyer’s tax number in an invoice that is not an export,
this number must be 15 digits,
and start and end with the digit “3“, such as:
312345678901233
You entered a buyer’s tax number, but it:
Is not 15 digits (example: only 10 digits).
Does not start with “3”.
Does not end with “3”.
Or you wrote it with dashes or letters (such as: 312-345-678-90123).
️ This condition does not apply to export invoices, because the buyer is outside Saudi Arabia and does not have a Saudi tax number.
Case: Should you enter the tax number?
Customer is a company registered for tax: Yes, mandatory.
Customer is a final consumer: No.
Export (outside Saudi Arabia): No, select export type.
Go to the invoice list → open the rejected invoice.
Check the customer name.
Go to the customer list and go to the tax number field.
Must be exactly 15 digits.
Start with “3“.
End with “3“.
Does not contain dashes (-), spaces, or letters.
Correct example:312345678901233
Wrong examples:3123456789 ← Missing (only 10 digits)31234567890123 ← Missing (14 digits)312-345-678-90123 ← Contains dashes312345678901234 ← Does not end with 3
.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Alerts”, no invoice modification is required; it is just a note for future invoices. Do not request any data from the customer, such as the establishment number or invoice number if the modification is on their part.
Error Code: BR-KSA-46
English Description: If it is an export invoice (KSA-2, position 5 is true), the buyer VAT registration number or buyer group VAT registration number (BT-48) must not exist in the invoice.
Arabic Description: If the invoice is an export invoice (KSA-2, position 5 = true), the buyer’s VAT registration number or buyer group VAT registration number (BT-48) must not exist in the invoice.
Responsible for Modification: Customer.
Problem: If your invoice is an export invoice (i.e., a sale to a customer outside Saudi Arabia),
you must not enter any tax number for the buyer at all, because the buyer is not registered for Saudi tax.
You specified the invoice type as “Export” ️ (and this is correct).
But at the same time, you entered a tax number for the buyer (which is not allowed in exports).
ZATCA considers this a contradiction: How can the customer be outside Saudi Arabia and have a Saudi tax number?!
When selling goods or services to:
A company or individual outside the Kingdom of Saudi Arabia.
Example: a customer in Dubai, USA, Germany, etc.
In this case:
There is no Saudi tax number for the buyer → the field must be left empty.
Go to the invoice list → open the rejected invoice.
Make sure the invoice type is:
“Export invoice for goods or services”, which you can select from the additional information at the bottom of the invoice
Go to Sales > Customers, search for the customer name “Buyer”, click Edit next to it, then go to the Tax Number field:
Clear any number entered in it completely, even if it is 300000000000003 or any other number.
Leave the field completely empty.
Then click “Save“
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Alerts”, no invoice modification is required; it is just a note for future invoices. Do not request any data from the customer, such as the establishment number or invoice number if the modification is on their part.
Error Code: BR-KSA-49
English Description: If the tax exemption reason code (BT-121) is equal to VATEX-SA EDU or VATEX-SA-HEA, then the other buyer ID (BT-46) is mandatory and must be national ID (BT-46-1 = NAT)
Arabic Description: If the tax exemption reason code (BT-121) is equal to VATEX-SA EDU or VATEX-SA-HEA, then the other buyer ID (BT-46) is mandatory and must be a national ID (BT-46-1 = NAT).
Responsible for Modification: Customer.
Problem: This alert appears when you select an educational or health tax exemption reason, but you don’t add “Other Buyer ID” as a national ID.
Solution:
Step 1: Enter the customer file (buyer)
From the main menu in Qoyod → go to:
Sales > Customers.
Search for the customer associated with the invoice → click to open their file.
On the customer information page, look for a field called:
“Additional Identifiers” — you’ll find it at the bottom of the page.
Add an identifier named “National ID” and enter the customer’s national ID.
Click “Save“
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Alerts”, no invoice modification is required; it is just a note for future invoices. Do not request any data from the customer, such as the establishment number or invoice number if the modification is on their part.
Error Code: BR-KSA-50
English Description: The line VAT amount (KSA-11) must be Invoice line net amount (BT-131) x (Line VAT rate (BT 152)/100).
Arabic Description: The VAT amount in the line (KSA-11) must equal the net line amount (BT-131) multiplied by the line tax rate (BT-152) divided by 100.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-51
English Description: The line amount with VAT (KSA 12) must be Invoice line net amount (BT-131) + Line VAT amount (KSA-11)
Arabic Description: The line amount including VAT (KSA-12) must equal the net line amount (BT-131) plus the line VAT amount (KSA-11).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-52
English Description: The line VAT amount (KSA-11) is mandatory for tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2 = 01).
Arabic Description: The VAT amount in the line (KSA-11) is mandatory in the tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2 = 01). Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-53
English Description: The line amount with VAT (KSA 12) is mandatory for tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2 = 01).
Arabic Description: The line amount including VAT (KSA-12) is mandatory in the tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2 = 01).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-56
English Description: For credit notes ((BT-3) has the value of 381) and debit notes ((BT-3) has the value of 383), the billing reference ID (BT-25) is mandatory.
Arabic Description: For credit notes (BT-3 value = 381) and debit notes (BT-3 value = 383), the billing reference ID (BT-25) is mandatory.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-60
English Description: Cryptographic stamp (KSA-15) must exist in simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02)
Arabic Description: The cryptographic stamp (KSA-15) must exist in simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-61
English Description: Previous invoice hash (KSA-13) must exist in an invoice.
Arabic Description: The hash of the previous invoice must exist in the invoice.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is fully integrated with ZATCA and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice has been issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-63
English Description: If the buyer country code (BT-55) is “SA”, then these fields are mandatory: street name (BT-50), building number (KSA-18), postal code (BT-53), city (BT-52), District (KSA-4), country code (BT-55). For more information please access this link: https://splonline.com.sa/en/national address-1/
Arabic Description: If the buyer’s country code (BT-55) is “SA”, then these fields are mandatory: street name (BT-50), building number (KSA-18), postal code (BT-53), city (BT-52), district (KSA-4), country code (BT-55).
Responsible for Modification: Customer.
Problem:
If the buyer is from inside Saudi Arabia (Country = Saudi Arabia),
you must enter the complete national address information for them in the invoice, which includes: street name, city, district, postal code, building number, country code (already exists: “Saudi Arabia”)
You specified that the customer is from Saudi Arabia (Country code = SA) ️
But one of the above fields is empty or incomplete
Example: You forgot to enter “Building Number” or “District”
From the main menu in Qoyod → go to:
Sales > Customers.
Search for the customer associated with the invoice → click to open their file.
On the customer information page, look for the section “Billing Address” and fill in the fields without exception:
Do not leave any field empty, even if approximate.
Then click “Save“
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Alerts”, no invoice modification is required; it is just a note for future invoices. Do not request any data from the customer, such as the establishment number or invoice number if the modification is on their part.
Error Code: BR-KSA-64
English Description: Seller Address Additional number (KSA-23) must be 4 digits.
Arabic Description: The additional number for the seller’s address (KSA-23) must contain 4 digits.
Responsible for Modification: Customer.
Problem: The additional number for your establishment’s address (seller) is incorrect (must be 4 digits)
What is the “additional number” in the national address?
It is part of Saudi Arabia’s unified national address system, and is usually:
The number of the residential unit or office within the building.
Or the additional number that identifies the location more precisely.
Solution: Re-enter the correct additional number in your establishment’s data through Settings > General Settings, then look for the Address field. It usually appears after the postal code, like:
12345, 6789.
After editing, click “Save” at the bottom of the page.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Alerts”, no invoice modification is required; it is just a note for future invoices. Do not request any data from the customer, such as the establishment number or invoice number if the modification is on their part.
Error Code: BR-KSA-65
English Description: Buyer Address Additional number (KSA-19) must be 4 digits if it exists.
Arabic Description: If it exists, the additional number for the buyer’s address (KSA-19) must contain 4 digits.
Responsible for Modification: Customer.
Problem:
If you entered any value in the field “Additional number for buyer’s address “Customer”“,
this value must be exactly 4 digits only, no more, no less, and no letters.
Correct examples:
0101, 9999, 1234
Incorrect example:
123 ← 3 digits, not accepted
12345 ← 5 digits, not accepted
AB12 ← contains letters, not accepted
Empty ← Accepted (because the condition says “if found”)
Either you entered an additional number in the customer file that is not 4 digits long.
Or you entered letters or symbols.
Or you used the “Additional Number” field incorrectly.
⚠️ Important Note:
This field is not mandatory, meaning you can leave it empty without any issue.
The condition only applies if you enter anything in it, then it must be 4 digits.
From the main menu → go to:
Sales > Customers.
Search for the customer associated with the invoice that had the error → click to open their details.
On the customer details page, under the Address section, find the additional number that was added
Change the existing value to 4 digits only.
Example:
If it was 123 → change it to 0123
If it was Apt5 → change it to 0005
If it was 12345 → shorten it to 2345 or 1234
Clear any content in the “Additional Number” field.
Leave it completely empty ← this is 100% acceptable because the condition says: “if found“.
Practical Tip:
If the customer hasn’t provided you with an official additional number, the best and fastest option is to leave it empty.
After editing → click “Save“.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”, as if the invoice status is “Received with Alerts”, the invoice does not need to be modified but rather serves as a note for future invoices, and do not request any data from the customer such as: establishment number or invoice number if the modification was made on their end.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”, as if the invoice status is “Received with Alerts”, the invoice does not need to be modified but rather serves as a note for future invoices, and do not request any data from the customer such as: establishment number or invoice number if the modification was made on their end.
Error Code: BR-KSA-66
English Description: Seller postal code (BT-38) must be 5 digits.
Arabic Description: The seller’s postal code (BT-38) must contain 5 digits.
Responsible for Modification: Customer.
Problem:
In your company address data (seller), the “Postal Code” field must contain exactly 5 digits only, no more, no less, and no letters.
Correct example:
12345, 75312, 00000
Incorrect example:
1234 ← 4 digits, not accepted
123456 ← 6 digits, not accepted
AB123 ← contains letters, not accepted
Empty ← not accepted (because seller postal code is mandatory)
Either you entered a postal code that is not 5 digits long.
Or you entered letters or symbols.
Or you left the field empty.
Or you used an old or unofficial code.
⚠️ Important Note:
The seller postal code is always mandatory, unlike the “Additional Number” which can be left empty.
From the main menu → go to:
Settings > General Settings.
Under the “Address” section, look for the field:
“Postal Code“
Enter the postal code
After entering the correct postal code (5 digits) → click “Save“.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”, as if the invoice status is “Received with Alerts”, the invoice does not need to be modified but rather serves as a note for future invoices, and do not request any data from the customer such as: establishment number or invoice number if the modification was made on their end.
Error Code: BR-KSA-67
English Description: If the buyer country code (BT-55) is “SA”, then the Buyer postal code (BT-53) must be 5 digits.
Arabic Description: If the buyer country code (BT-55) is “SA”, then the buyer’s postal code (BT-53) must contain 5 digits.
Responsible for Modification: Customer.
Problem:
If the customer (buyer) is from within Saudi Arabia → then the “Postal Code” field must contain exactly 5 digits only, no more, no less, and no letters.
Correct example:
12345, 75312, 00000
Incorrect example:
1234 ← 4 digits, not accepted
123456 ← 6 digits, not accepted
AB123 ← contains letters, not accepted
Empty ← not accepted (because the condition is mandatory when selecting “SA”)
Customer is from Saudi Arabia ⚠️
But the postal code in their file:
Is incomplete (less than 5 digits)
Is excessive (more than 5)
Contains letters or symbols
Or is completely empty
From the main menu → go to:
Sales > Customers.
Search for the customer associated with the invoice → click to open their details.
On the customer details page, under the “Address” section, look for the field:
“Postal Code“
Or “Postal Code“
Enter the postal code.
After entering the correct postal code (5 digits) → click “Save“.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”, as if the invoice status is “Received with Alerts”, the invoice does not need to be modified but rather serves as a note for future invoices, and do not request any data from the customer such as: establishment number or invoice number if the modification was made on their end.
Error Code: BR-KSA-68
English Description: Tax currency code (BT-6) must exist in an invoice.
Arabic Description: The tax currency code (BT-6) must exist in the invoice.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-69
English Description: A VAT breakdown (BG-23) with VAT Category code (BT-118) “Zero rated” shall have a VAT exception reason code (BT-121) and VAT exception reason text (BT-120).
Arabic Description: A VAT breakdown (BG-23) with VAT Category code (BT-118) “Zero rated” must have a VAT exception reason code (BT-121) and VAT exception reason text (BT-120).
Responsible for Modification: Customer.
Problem: If you selected “0%” (Zero Rated) as the tax type in one of the invoice lines,
then you must enter:
⚠️ Tax Reason Text (for example: “export outside Saudi Arabia”) in the product details.
You used in one of the items: “0%” ⚠️
But you did not enter the tax reason
In specific cases such as:
⚠️ Export of goods or services outside Saudi Arabia.
Supplies related to international transport.
⚠️ Supplies to entities in qualified free zones.
Go to the invoices list → open the rejected invoice.
Inside the invoice, review each line.
Find any line where the “Tax Type” field = “0%”.
By going to Products and Costs, then clicking edit next to the product that is in the invoice
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”, as if the invoice status is “Received with Alerts”, the invoice does not need to be modified but rather serves as a note for future invoices, and do not request any data from the customer such as: establishment number or invoice number if the modification was made on their end.
Error Code: BR-KSA-70
English Description: The invoice must contain an Invoice issue times (KSA-25) This value will be in the format: hh:mm:ss for time expressed in AST or hh:mm:ssZ for time expressed in UTC. (eg 19:20:30).
Arabic Description: The invoice issue time (KSA-25) must be included in the format hh:mm:ss (Saudi time AST) or hh:mm:ssZ (UTC).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-71
English Description: If the Invoice is a simplified invoice type and is a summary invoice (KSA-2, position 1 and 2 = 02, position 6 = 1), then the buyer name must be present.
Arabic Description: If the invoice is of type simplified invoice (KSA-2, position 1 and 2 = 02, position 6 = 1), then the buyer name must be present.
Responsible for Modification: Customer.
Problem:
If you issued a simplified invoice (meaning the customer does not have a tax number),
then you must enter the buyer’s name clearly, even if they are an end consumer.
You entered invoice type: “Simplified” ⚠️
But you did not enter the buyer’s name clearly
Common example:
A retail store collects purchases for one customer throughout the day → issues them one simplified invoice containing 10 items → this is “simplified + summary”.
A service company provides 3 different services to an end consumer in one day → issues one simplified summary invoice.
In these cases, the Authority requires the presence of the buyer’s name.
Go to the invoices list → open the rejected invoice.
Make sure that:
Invoice type = “Simplified“
And it contains more than one line ← meaning it is “summary”
Look for the field:
“Buyer Name“
Or “Buyer Name“
If it is empty or unclear → enter a clear name by going to the customers list and then clicking edit next to the customer’s name, modifying it, and then saving.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”, as if the invoice status is “Received with Alerts”, the invoice does not need to be modified but rather serves as a note for future invoices, and do not request any data from the customer such as: establishment number or invoice number if the modification was made on their end.
Error Code: BR-KSA-72
English Description: If the Invoice is a simplified invoice type and is a summary invoice (KSA-2, position 1 and 2 = 02, position 6 = 1), then a supply date (KSA-5) and supply end date (KSA-24) must be present.
Arabic Description: If the invoice is of type simplified invoice (KSA-2, position 1 and 2 = 02, position 6 = 1), then the supply date (KSA-5) and supply end date (KSA-24) must be present.
Responsible for Modification: Customer.
Problem and Solution:
If you issued a simplified and summary invoice (meaning it contains more than one transaction or service),
then you must enter: the supply date
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”, as if the invoice status is “Received with Alerts”, the invoice does not need to be modified but rather serves as a note for future invoices, and do not request any data from the customer such as: establishment number or invoice number if the modification was made on their end.
Error Code: BR-KSA-DEC-01
English Description: The allowance percentage values (BT-94, BT-138) must be from 0.00 to 100.00, with maximum two decimal places. Only numerals are accepted, the percentage symbol (%) is not allowed.
Arabic Description: Discount percentage values (BT-94, BT-138) must be between 0.00 and 100.00, with a maximum of two decimal places. Only numbers are accepted and the percentage symbol (%) is not allowed.
Responsible for Modification: Customer.
Problem: If you used a percentage discount on the invoice (at the line level or at the invoice level),
then the value must be:
Only a number, without the % symbol
Between 0.00 and 100.00
No more than two decimal places (example: 25.50 ✓, but not 25.555)
You entered in the discount field: "10%" ← has the % symbol
Or you entered: "105" ← greater than 100
Or you entered: "-5" ← less than 0
Or you entered: "25.123" ← more than two decimal places
Or you entered: "ten" ← text, not a number
Go to the invoices list → open the rejected invoice.
Inside the lines, when editing any product/service.
Look for the “Discount Percentage” or “Discount %” field.
At the end of the invoice, in the “Discount” or “Discount” section.
Criterion What to Do Correct Examples
Without the % symbol, clear any % sign if found, 10 ← correct.
Between 0.00 and 100.00, do not write 105 or -5, 25.50 ← correct.
Maximum two decimal places, do not write 25.123, round to 25.12, 0.75 ← correct.
Numbers only, do not write “half” or “ten”, 100.00 ← correct
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”, as if the invoice status is “Received with Alerts”, the invoice does not need to be modified but rather serves as a note for future invoices, and do not request any data from the customer such as: establishment number or invoice number if the modification was made on their end
Error Code: BR-KSA-DEC-02
English Description: The VAT rates (BT-96119, BT-152) must be from 0.00 to 100.00, with maximum two decimals. Only numerals are accepted, the percentage symbol (%) is not allowed.
Arabic Description: VAT rates (BT-96119, BT-152) must be between 0.00 and 100.00, with a maximum of two decimal places. Only numbers are accepted and the percentage symbol (%) is not allowed.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-DEC-03
English Description: VAT amount at line level (KSA-11) must have a maximum two decimals.
Arabic Description: The VAT amount at the line level (KSA-11) must have a maximum of two decimal places.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and will not affect your work or cause any penalties.
Error Code: BR-KSA-DEC-04
English Description: Amount with VAT at line level (KSA-12) must have a maximum two decimals.
Arabic Description: يجب أن يحتوي مبلغ البند شامل الضريبة (KSA-12) على منزلتين عشريتين كحد أقصى.
Responsible for Modification: Customer.
Problem and Solution:
On each line of the invoice, the field “Amount with VAT” must contain a decimal number with a maximum of two decimal places only.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error.” If the invoice status is “Received with Alerts,” no invoice modification is required; it is merely a note for future invoices. Do not request any data from the customer such as: establishment number or invoice number if the modification is from their side.
Error Code: BR-KSA-CL-01
English Description: Currency code (BT-5) must be according to ISO 4217:2005.
Arabic Description: يجب أن يكون كود العملة (BT-5) متوافقًا مع معيار ISO 4217:2005.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-CL-02
English Description: All currencyID attributes (BT-5) must have the same value as the invoice currency code (BT-5), except for the invoice total VAT amount in accounting currency (BT-111).
Arabic Description: جميع سمات العملة (BT-5) يجب أن تحمل نفس قيمة كود عملة الفاتورة (BT-5)، باستثناء إجمالي ضريبة القيمة المضافة بالعملة المحاسبية (BT-111).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-CL-03
English Description: Mime code must be according to subset of IANA code list.
Arabic Description: يجب أن يكون كود MIME متوافقًا مع قائمة الأكواد الفرعية الخاصة بـ IANA.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-CL-04
English Description: VAT exemption reason code (BT-121) must exist in the invoice, the codes Z, E must have Tax exemption (or exceptions) reason code and text – specific to Saudi Arabia .
Arabic Description: يجب أن يوجد كود سبب الإعفاء من ضريبة القيمة المضافة (BT-121) في الفاتورة. الأكواد Z و E يجب أن تحتوي على كود ونص سبب الإعفاء أو الاستثناء الضريبي حسب ما هو محدد في السعودية.
Responsible for Modification: Customer.
Problem:
If you selected a tax type in the invoice:
Z = Zero %
or E = Exempt
then you must enter:
️ Tax Reason (BT-120), such as: “Export outside the Kingdom”
Without this field, the invoice may be rejected or recorded as “non-compliant“.
You used in one of the items: “Zero %” or “Exempt” ️
but you did not enter the reason code in the product data
TypeWhen to Use ItRequired CodeSuggested TextZero % (Z)Export outside Saudi Arabia, Free zones, International shipmentVATEX-SA-EXPORT“Export outside the Kingdom of Saudi Arabia”VATEX-SA-FREEZONE“Supply to a qualified free zone”VATEX-SA-TRANSPORT“International transport service”Exempt (E)Qualified healthcare or educational servicesVATEX-SA-HEA“Authorized healthcare service”VATEX-SA-EDU“Authorized educational service”VATEX-SA-EXEMPT-OTHER“Other approved tax exemption”
Go to the Invoices list → open the rejected invoice or the one with an alert.
Inside the invoice, review each line.
Look for any line where the “Tax Type” field = “Zero %” or “Exempt from VAT“.
Go to the Products and Costs list and click Edit next to the product and enter the tax reason correctly, then save.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error.” If the invoice status is “Received with Alerts,” no invoice modification is required; it is merely a note for future invoices. Do not request any data from the customer such as: establishment number or invoice number if the modification is from their side.
Error Code: BR-KSA-CL-05
English Description: If VAT exemption reason code (BT-121) is the codes “Z” or “E”, then VAT exemption reason text (BT-120) must exist with one of the values from Tax exemption (or exception) reason code and text – specific to Saudi Arabia .
Arabic Description: إذا كان كود سبب الإعفاء من الضريبة (BT-121) هو “Z” أو “E”، يجب أن يوجد نص سبب الإعفاء (BT-120) بأحد القيم المحددة في قائمة الأكواد والنصوص الخاصة بالإعفاء أو الاستثناء الضريبي في السعودية.
Responsible for Modification: Customer.
Problem:
If you used a tax code:
Z = Zero % (Zero Rated)
or E = Exempt
then you must enter:
Tax Reason in the Product Data
You used code Z or E ️
but you:
Did not enter the tax reason in the product data
Go to the Invoices list → open the rejected invoice.
Inside the invoice, review each line.
Look for any line where:
Tax Type = “Zero %” or “Exempt from VAT“
or Code = Z or E
Go to the Products and Costs list and click Edit next to the product, then add the tax reason and click “Save” at the bottom of the page.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error.” If the invoice status is “Received with Alerts,” no invoice modification is required; it is merely a note for future invoices. Do not request any data from the customer such as: establishment number or invoice number if the modification is from their side.
Error Code: BR-KSA-EN16931-01
English Description: Business process (BT-23) must be “reporting:1.0”.
Arabic Description: يجب أن يكون حقل نوع العملية (BT-23) هو “reporting:1.0.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-EN16931-02
English Description: VAT accounting currency code (BT-6) must be “SAR”.
Arabic Description: يجب أن يكون رمز عملة المحاسبة لضريبة القيمة المضافة (BT-6) هو “SAR”.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-EN16931-03
English Description: Allowance amount (BT-92, BT-136) must equal base amount (BT-93, BT-137) * percentage (BT-94, BT-138) / 100 if base amount and percentage exists.
Arabic Description: يجب أن يساوي مبلغ الخصم (BT-92, BT-136) المبلغ الأساسي (BT-93, BT-137) مضروبًا في النسبة المئوية (BT-94, BT-138) مقسومًا على 100، في حال وجود المبلغ الأساسي والنسبة.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-EN16931-04
English Description: Allowance base amount (BT-93, BT-137) must be provided when allowance percentage (BT-94, BT-138) is provided.
Arabic Description: يجب إدخال المبلغ الأساسي للخصم (BT-93, BT-137) عند إدخال نسبة الخصم (BT-94, BT-138).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-EN16931-05
English Description: Allowance percentage (BT-94, BT-138) must be provided when the allowance base amount (BT-93, BT-137) is provided.
Arabic Description: يجب إدخال نسبة الخصم (BT-94, BT-138) عند إدخال المبلغ الأساسي للخصم (BT-93, BT-137).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-EN16931-06
English Description: Charge on price level (BG-29) is NOT allowed. Only value ‘false’ allowed.
Arabic Description: التكاليف الإضافية على مستوى السعر (BG-29) غير مسموح بها. القيمة المسموح بها هي ‘false’ فقط.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-EN16931-07
English Description: Item net price (BT-146) must equal (Gross price (BT-148) – Allowance amount (BT-147)) when gross price is provided.
Arabic Description: يجب أن يساوي صافي سعر السلعة (BT-146) (السعر الإجمالي (BT-148) – مبلغ الخصم (BT-147)) في حال توفر السعر الإجمالي. Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-EN16931-08
English Description: Only one tax total (BG-22) with tax subtotals must be provided. Refer to Calculation of VAT.
Arabic Description: يجب توفير إجمالي ضريبة واحد فقط (BG-22) مع مجاميع فرعية للضريبة.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-EN16931-09
English Description: Only one tax total (BG-22) without tax subtotals must be provided when tax currency code is provided.
Arabic Description: يجب توفير إجمالي ضريبة واحد فقط (BG-22) بدون مجاميع فرعية للضريبة عند توفير رمز عملة الضريبة.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-EN16931-11
English Description: Invoice line net amount (BT-131) must equal (Invoiced quantity (BT-129) * (Item net price (BT-146) / item price base quantity (BT- 149))- Sum of invoice line allowance amount (BT-136) .
Arabic Description: يجب أن يساوي صافي مبلغ بند الفاتورة (BT-131) كمية الفاتورة (BT-129) مضروبة في (صافي سعر الصنف (BT-146) مقسومًا على الكمية الأساسية لسعر الصنف (BT-149)) مطروحًا منه مبلغ خصم البند (BT-136).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-EN16931-12
English Description: Base quantity (BT-149) must be a positive number above zero.
Arabic Description: يجب أن تكون الكمية الأساسية (BT-149) رقمًا موجبًا أكبر من صفر.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-F-01
English Description: A date MUST be formatted YYYY-MM-DD.
Arabic Description: يجب أن يجب أن يكون التاريخ بتنسيق YYYY‑MM‑DD.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-F-02
English Description: Allowance/Charge Indicator value MUST equal to ‘false’/’True’ respectively .
Arabic Description: يجب أن تكون قيمة مؤشر الخصم/الرسوم مساوية لـ “false” أو “true” حسب الحالة.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the General Authority of Zakat and Tax and all alerts are updated automatically to ensure full system compliance.
Your invoice has been issued and approved correctly, and will not affect your operations or incur any penalties.
Error Code: BR-KSA-F-03
English Description: Document MUST not contain empty elements.
Arabic Description: The document must not contain empty elements.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-KSA-F-04
English Description: All the document amounts and quantities must be positive.
Arabic Description: All amounts and quantities in the document must be positive.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-KSA-F-06
English Description: Minimum & Maximum character limits should be maintained as per data dictionary for every data field .
Arabic Description: The minimum and maximum character limits for each data field must be maintained according to the data dictionary.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-CL-06
English Description: Code for the reason for document level charge (BT-105) and the code for the reason for invoice line charge (BT-145) MUST be coded using UNTDID 7161 code list. https://unece.org/filead min/DAM/trade/untdid/d 16b/tred/tred7161.htm .
Arabic Description: The reason code for document-level charges (BT-105) and the reason code for invoice line charges (BT-145) must be coded using the UNTDID 7161 code list.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-CL-04
English Description: If VAT category Code (BT 118) is ‘Z’, or ‘E’ or ‘O’, VAT exemption (or exception) reason code (BT-121) must exist with one of the values from paragraph 11.2.4 of XML implementation standards on Tax exemption (or exception) reason code – specific to Saudi Arabia.
Arabic Description: If the VAT category code (BT-118) is ‘Z’, ‘E’, or ‘O’, the VAT exemption or exception reason code (BT-121) must exist with one of the values specified in section 11.2.4 of the XML implementation standards for tax exemption or exception reason codes specific to Saudi Arabia.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-KSA-DEC 06
English Description: Prepayment VAT category Taxable Amount (KSA-31) and Prepayment VAT Category Tax Amount (KSA-32) must have a maximum two decimals.
Arabic Description: The prepayment VAT category taxable amount (KSA-31) and prepayment VAT category tax amount (KSA-32) must have a maximum of two decimal places.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-KSA-83
English Description: A VAT breakdown (BG-23) with VAT Category code (BT-118) ‘Exempt from VAT’ or ‘Zero rated’or ‘Not subject to VAT’ shall have a VAT exemption (or exception reason text (BT-120) with one of the values from paragraph 11.2.4 of XML implementation standardS on Tax exemption (or exception) reason text – specific to Saudi Arabia .
Arabic Description: A VAT breakdown (BG-23) with VAT category code (BT-118) “Exempt from VAT”, “Zero-rated”, or “Not subject to VAT” must include VAT exemption or exception reason text (BT-120) with one of the values specified in section 11.2.4 of the XML implementation standards for tax exemption or exception reason text specific to Saudi Arabia.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-KSA-82
English Description: An Invoice line (BG-25) where prepayment Document Type Code (KSA-30) is provided, then Item net price (BT-146); Invoice line allowance amount (BT-136); Invoice line charge amount (BT 141); Item line net amount (BT 131); line VAT amount (KSA-11); and line amount with VAT (KSA 12) for that line shall be 0 (Zero),if exist. Arabic Description: In an invoice line (BG-25) where the prepayment document type code (KSA-30) is provided, the following values must be zero: item net price (BT-146), invoice line allowance amount (BT-136), invoice line charge amount (BT-141), item line net amount (BT-131), line VAT amount (KSA-11), and line amount with VAT (KSA-12).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-KSA-81
English Description: The other Buyer ID (BT-46) must present in the tax invoice and associated debit notes and credit notes (KSA-2, position 1 and 2 = 01), where the buyer VAT registration number or buyer group VAT registration number (BT-48) is not provided .
Arabic Description: The other Buyer ID (BT-46) must be entered in the tax invoice and associated debit notes and credit notes (KSA-2, positions 1 and 2 = 01) when the buyer’s VAT registration number or buyer group VAT registration number (BT-48) is not provided.
Responsible for Modification: Customer.
Problem:
If you issue a tax invoice ️
and specified in the customer data that the business is subject to VAT (i.e., you selected the “Is the business subject to VAT?” option) and did not enter a VAT number for the buyer (i.e., field BT-48 is empty),
then you must enter:
️ “Other Buyer ID” (BT-46)
This is an alternative field used to identify the customer when they do not have a Saudi VAT registration number.
Invoice Type = “Tax Invoice” ️
You did not enter any VAT number for the buyer (field BT-48 is empty) ️
But you did not enter the “Other Buyer ID”, which is mandatory in this case.
️ This condition does not apply to:
Simplified invoices, where the Other Buyer ID is not required.
If the buyer has a VAT number, the Other ID is not needed.
When you sell to a customer:
Who does not have a VAT number (example: foreign company, individual, or unregistered entity).
But you issued them a tax invoice (not simplified).
In this case, the Authority requires an alternative identifier for the customer, such as:
Commercial registration number (if a company)
National ID (if a Saudi individual)
Passport (if foreign)
Or even a contract number or internal code (in exceptional cases)
From the main menu → Go to:
Sales > Customers.
Search for the customer associated with the invoice → Click to open their details.
On the customer details page, look for a section:
“Additional Identifiers” or “Other Buyer IDs”
You will find it at the bottom of the page under the heading “Additional Details – Additional Customer Identifiers”
Select the appropriate type (e.g., national ID, commercial registration…).
In the “Value” field → Enter the customer’s number/code.
After entering the identifier → Click “Save“.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Alerts”, no invoice modification is required as it is only a note for future invoices, and do not request any data from the customer such as the business number or invoice number if the modification is on their end.
Error Code: BR-CL-01
English Description: The document type code MUST be coded by the invoice and credit note related code lists of UNTDID 1001.
Arabic Description: The document type code must be coded using the code lists for invoices and credit notes according to UNTDID 1001 standard.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-CL-03
English Description: currencyID MUST be coded using ISO code list 4217 alpha-3 .
Arabic Description: The currency code must be coded using the ISO 4217 three-character code list.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-CL-04
English Description: Invoice currency code MUST be coded using ISO code list 4217 alpha-3.
Arabic Description: The invoice currency code must be coded using the ISO 4217 three-character code list.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-CL-05
English Description: Tax currency code MUST be coded using ISO code list 4217 alpha-3 .
Arabic Description: The tax currency code must be coded using the ISO 4217 three-character code list.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-CL-14
English Description: Country codes in an invoice MUST be coded using ISO code list 3166-1.
How to Handle Customer Inquiry: If the customer asks about the reason for the alert or requests an explanation or clarification of the alert, respond as follows:
Arabic Description: Country codes in the invoice must be coded using the ISO 3166-1 standard code list.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-CL-16
English Description: Payment means in an invoice MUST be coded using UNCL4461 code list.
Arabic Description: The payment method in the invoice must be coded using the UNCL4461 code list.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-CL-18
English Description: Invoice tax categories MUST be coded using UNCL5305 code list.
Arabic Description: Invoice tax categories must be coded using the UNCL5305 code list.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-DEC-01
English Description: The allowed maximum number of decimals for the Document level allowance amount (BT-92) is 2 Arabic Description: The maximum allowed number of decimal places for the document-level allowance amount (BT-92) is 2.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-DEC-02
English Description: The allowed maximum number of decimals for the Document level allowance base amount (BT-93) is 2.
Arabic Description: The maximum allowed number of decimal places for the document-level allowance base amount (BT-93) is 2.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal to Qoyod’s system and requires no action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.
Error Code: BR-DEC-09
English Description: The allowed maximum number of decimals for the Sum of Invoice line net amount (BT-106) is 2 Arabic Description: The maximum allowed number of decimals for the total net amount of the invoice line (BT-106) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-DEC-10
English Description: The allowed maximum number of decimals for the Sum of allowances on document level (BT 107) is 2.
Arabic Description: The maximum allowed number of decimals for the total allowances at document level (BT 107) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-DEC-12
English Description: The allowed maximum number of decimals for the Invoice total amount without VAT (BT-109) is 2 Arabic Description: The maximum allowed number of decimals for the total invoice amount without VAT (BT-109) is 2. Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-DEC-13
English Description: The allowed maximum number of decimals for the Invoice total VAT amount (BT-110) is 2.
Arabic Description: The maximum allowed number of decimals for the VAT amount at invoice level (BT-110) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-DEC-14
English Description: The allowed maximum number of decimals for the Invoice total amount with VAT (BT-112) is 2.
Arabic Description: The maximum allowed number of decimals for the total invoice amount with VAT (BT-112) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-DEC-15
English Description: The allowed maximum number of decimals for the Invoice total VAT amount in accounting currency (BT-111) is 2.
Arabic Description: The maximum allowed number of decimals for the VAT amount at invoice level in accounting currency (BT-111) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-DEC-16
English Description: The allowed maximum number of decimals for the Paid amount (BT-113) is 2.
Arabic Description: The maximum allowed number of decimals for the amount paid (BT-113) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-DEC-18
English Description: The allowed maximum number of decimals for the Amount due for payment (BT-115) is 2.
Arabic Description: The maximum allowed number of decimals for the amount due for payment (BT-115) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties..
Error Code: BR-DEC-19
English Description: The allowed maximum number of decimals for the VAT category taxable amount (BT-116) is 2.
Arabic Description: The maximum allowed number of decimals for the taxable amount for the VAT category (BT-116) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-DEC-20
English Description: The allowed maximum number of decimals for the VAT category tax amount (BT-117) is 2.
Arabic Description: The maximum allowed number of decimals for the VAT category tax amount (BT-117) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-DEC-23
English Description: The allowed maximum number of decimals for the Invoice line net amount (BT-131) is 2.
Arabic Description: The maximum allowed number of decimals for the invoice line net amount (BT-131) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-DEC-24
English Description: The allowed maximum number of decimals for the Invoice line allowance amount (BT-136) is 2.
Arabic Description: The maximum allowed number of decimals for the invoice line allowance amount (BT-136) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-DEC-25
English Description: The allowed maximum number of decimals for the Invoice line allowance base amount (BT 137) is 2. Arabic Description: The maximum allowed number of decimals for the invoice line allowance base amount (BT 137) is 2. Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-KSA-03
English Description: The invoice must contain a unique identifier (“UUID”) (KSA-1) given by the machine that issued the document (unique message identifier for interchange process). This value must contain only letters, digits, and dashes. (Note: In Windows OS UUIDs are referred to by the term GUID.) .
Arabic Description: The invoice must contain a unique identifier (UUID) (KSA-1) generated from the device that issued the document (unique message identifier for the interchange process). This identifier must contain only letters, numbers, and dashes. (Note: In Windows operating systems, UUID is referred to by the term GUID).
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-KSA-04
English Description: The document issue date (BT-2) must be less or equal to the current date.
Arabic Description: The document issue date (BT-2) must be less than or equal to the current date.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-KSA-05
English Description: The invoice type code (BT-3) must be equal to one of value from the subset of UN/CEFACT code list 1001, D.16B agreed for KSA electronic invoices..
Arabic Description: The invoice type code (BT-3) must be equal to one of the values from the UN/CEFACT code list 1001, D.16B agreed upon for electronic invoices in the Kingdom of Saudi Arabia.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-KSA-06
English Description: The invoice transaction code (KSA-2) must exist and respect the following structure: NNPNESB where NN (positions 1 and 2) = invoice subtype: – 01 for tax invoice – 02 for simplified tax invoice P (position 3) = 3rd Party invoice transaction, 0 for false, 1 for true N (position 4) = Nominal invoice transaction, 0 for false, 1 for true E (position 5) = Exports invoice transaction, 0 for false, 1 for true S (position 6) = Summary invoice transaction, 0 for false, 1 for true B (position 7) = Self billed invoice .
Arabic Description: The invoice transaction code (KSA-2) must exist and comply with the following structure: NNPNESB where NN (positions 1 and 2) = invoice subtype: 01 for tax invoice, 02 for simplified invoice. P (position 3) = third-party invoice transaction, 0 = no, 1 = yes. N (position 4) = nominal invoice transaction, 0 = no, 1 = yes. E (position 5) = export invoice, 0 = no, 1 = yes. S (position 6) = simplified invoice, 0 = no, 1 = yes. B (position 7) = self-billed invoice.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert shown is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with ZATCA and all alerts are automatically updated to ensure complete system compliance.
The invoice is issued and approved correctly, and it will not affect your work or cause any penalties.
Error Code: BR-KSA-07
English Description: Self-billing is not allowed (KSA-2, position 7 cannot be “1”) for export invoices (KSA-2, position 5 = 1).
Arabic Description: Self-billing is not allowed (KSA-2, position 7 cannot be “1”) for export invoices (KSA-2, position 5 = 1).
Responsible for modification: Customer.
Problem: If your invoice is an export invoice (i.e., a sale to a customer outside Saudi Arabia), you are not allowed to use the “self-billing” feature.
Why does this error occur?
You specified that the invoice is for exporting goods or services in the additional information of the invoice.
However, at the same time, you enabled the “self-billing” option.
This is prohibited by ZATCA, because self-billing is only used within Saudi Arabia and in specific cases.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Arrived with Alerts”, no modification is required for the invoice; it is just a note for future invoices. Do not request any data from the customer such as the establishment number or invoice number if the modification is to be made by them.
Error Code: BR-KSA-08
English Description: The seller identification (BT-29) must exist only once with one of the scheme ID (BT-29-1) (CRN, MOM, MLS, SAG, OTH) and must contain only alphanumeric characters. – Commercial Registration number with “CRN” as schemeID – Momra license with “MOM” as schemeID – MLSD license with “MLS” as schemeID – Sagia license with “SAG” as schemeID – Other OD with “OTH” as schemeID In case multiple IDs exist then one of the above must be entered following the sequence specified above.
Arabic Description: The seller identification (BT-29) must exist only once with one of the scheme IDs (BT-29-1) (CRN, MOM, MLS, SAG, OTH) and must contain only alphanumeric characters. – Commercial Registration number with “CRN” as scheme ID – Municipal license with “MOM” as scheme ID – MLSD license with “MLS” as scheme ID – SAGIA license with “SAG” as scheme ID – Other identifier with “OTH” as scheme ID. If multiple IDs exist, one of the above must be entered following the specified sequence.
Responsible for modification: Customer.
Problem:
In your company’s (seller) data, there must be only one identifier, of an approved type, and written with letters and numbers only (without symbols or spaces).
Approved types (by priority):
Tax Group Number, Commercial Registration Number, Ministry of Municipal and Rural Affairs License
Priority is important:
If you have more than one identifier, use the first one in the list (i.e., start with the Tax Group Number or Commercial Registration Number).
You did not enter any seller identification
or you entered more than one identifier
or you used an unapproved scheme code
or you wrote the identifier with symbols, spaces, or unacceptable characters
Log in to Qoyod Accounting.
From the main menu → go to:
Settings > General Settings.
On the General Settings page, find the section titled “Additional Identifiers“
You will find a list containing identifier types
Only one identifier, delete any extra identifiers.
Use an identifier available to you such as:
→ CRN (Commercial Registration Number) ← the best and most common
The identifier must be alphanumeric only, without:
Spaces
Long dashes (you can use a short - if it’s part of the license)
Symbols such as: #, @, /
Arabic letters
Correct examples:
CRN + 701234567
MOM + MOM987654
OTH + COMPANY2025
Incorrect examples:
CRN + 701 234 567 ← spaces
OTH + شركة-2025 ← Arabic letters
CRN + #701234567 ← # symbol
Don’t enter them all; ZATCA requires only one identifier.
Choose the highest priority, which is always:
Commercial Registration Number (CRN) ← if it exists.
After editing → click “Save“.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Warnings”, the invoice does not need to be modified; it is a note for future invoices. Do not request any customer data such as establishment number or invoice number if the modification is on their side.
Error code: BR-KSA-09
Description in English: Seller address must contain street name (BT-35), building number (KSA-17), postal code (BT-38), city (BT-37), District (KSA-3), country code (BT-40).
Description in Arabic: The seller address must contain street name (BT-35), building number (KSA-17), postal code (BT-38), city (BT-37), district (KSA-3), country code (BT-40).
Responsible for the modification: Customer.
Problem: The seller address is incomplete (missing street, building, postal code, city, district, or country code). Solution: Complete the address data in establishment settings by going to Settings and then General Settings and then find the “Address” field and fill in all data accurately then save.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Warnings”, the invoice does not need to be modified; it is a note for future invoices. Do not request any customer data such as establishment number or invoice number if the modification is on their side.
Error code: BR-KSA-10
Description in English: Buyer address must contain a street (BT-50), city (BT-52), postal code (BT-53), country code (BT 55). This rule does not apply on the simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02).
Description in Arabic: The buyer address must contain street (BT-50), city (BT-52), postal code (BT-53), country code (BT-55). This condition does not apply to simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02).
Responsible for the modification: Customer.
Problem:
If you issued a tax invoice
then you must enter in the customer (buyer) data:
Street name
City
Postal code (5 digits)
Country code (e.g.: SA)
This condition does not apply to simplified invoices, so don’t worry if your invoice is simplified.
Invoice type = “Tax“
But one of the four fields in the buyer address is empty or missing:
Street
City
Postal code
Country code
Example:
You forgot to enter “street” or “postal code” → the error appears.
Steps to resolve the problem:
From the main menu → go to:
Sales > Customers.
Find the customer associated with the invoice → click to open their file.
On the customer information page, find the “Address” section and fill in the fields without exception:
Then click “Save”.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Warnings”, the invoice does not need to be modified; it is a note for future invoices. Do not request any customer data such as establishment number or invoice number if the modification is on their side.
Error code: BR-KSA-14
Description in English: The buyer identification (BT-46) must exist only once with one of the scheme ID (BT-46-1) (NAT, IQA, PAS, CRN, MOM, MLS, SAG, GCC, OTH) and must contain only alphanumeric characters. – Tax Identification Number “TIN” as schemeID – Commercial registration number with “CRN” as schemeID – Momra license with “MOM” as schemeID – MLSD license with “MLS” as schemeID – 700 Number with “700” as schemeID – Sagia license with “SAG” as schemeID – National ID with “NAT” as schemeID – GCC ID with “GCC” as schemeID – Iqama Number with “IQA” as schemeID – Passport ID with “PAS” as schemeID – Other ID with “OTH” as.
Description in Arabic: Buyer identification (BT-46) must exist only once with one of the scheme codes (BT-46-1) (NAT, IQA, PAS, CRN, MOM, MLS, SAG, GCC, OTH) and must contain only alphanumeric characters. – Tax Identification Number with “TIN” as scheme code – Commercial Registration Number with “CRN” as scheme code – Municipality license with “MOM” as scheme code – MLSD license with “MLS” as scheme code – 700 Number with “700” as scheme code – Sagia license with “SAG” as scheme code – National ID with “NAT” as scheme code – GCC ID with “GCC” as scheme code – Iqama Number with “IQA” as scheme code – Passport Number with “PAS” as scheme code – Other ID with “OTH” as scheme code.
Responsible for the modification: Customer.
Problem:
ZATCA says: If you add an “identifier” for the customer (like their ID or commercial registration or passport…), then:
Keep it as only one identifier, not two or three.
Choose an approved type from the list (for example: NAT for ID, CRN for registration…).
Write the number or code without spaces or symbols, just numbers and English letters.
Solution:
Step 1: Access customer data
From the menu → choose “Sales” and then choose “Customers“
Click on edit to open their data.
Usually it’s at the bottom of the page,
Step 3: Delete all extra identifiers and keep only one
Delete any extra row; keep only one row.
Then click “Save“.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Warnings”, the invoice does not need to be modified; it is a note for future invoices. Do not request any customer data such as establishment number or invoice number if the modification is on their side.
Error code: BR-KSA-15
Description in English: The tax invoice ((invoice type code (BT-30) = 388) & (invoice transaction code (KSA-2) has “01” as first 2 digits)) must contain the supply date (KSA-5).
Description in Arabic: A tax invoice ((invoice type code (BT-30) = 388) and (invoice transaction code (KSA-2) starts with “01”)) must contain the supply date (KSA-5).
Responsible for the modification: Customer.
Problem:
If your invoice is a tax invoice (not simplified), then you must enter a required field called:
Supply Date
Otherwise, ZATCA will reject it!
Solution: Add the supply date to tax invoices,
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Warnings”, the invoice does not need to be modified; it is a note for future invoices. Do not request any customer data such as establishment number or invoice number if the modification is on their side.
Error code: BR-KSA-16
Description in English: Payment means code (BT-81) in an invoice exist, then it must contain one of the values from subset of UNTDID 4461 code list .
Description in Arabic: If payment method code (BT-81) exists in the invoice, it must contain one of the values from the subset of the UNTDID 4461 code list .
Responsible for the modification: Qoyod.
Appropriate response: Dear Customer,
This warning is internal to Qoyod’s system and requires no action from you.
Our system is fully integrated with ZATCA and all warnings are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your work or cause any penalties.
Error code: BR-KSA-17
Description in English: Debit and credit note (invoice type code (BT-3) is equal to 383 or 381) must contain the reason (KSA-10) for this invoice type issuing .
Description in Arabic: Debit and credit notes (when invoice type code (BT-3) equals 383 or 381) must contain the reason (KSA-10) for issuing this type of invoice.
Responsible for the modification: Customer.
Problem: The reason for issuance in the debit or credit note is missing. Solution: You must add the reason for issuance in the credit or debit note data.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Warnings”, the invoice does not need to be modified; it is a note for future invoices. Do not request any customer data such as establishment number or invoice number if the modification is on their side.
Error code: BR-KSA-18
Description in English: VAT category code must contain one of the values (S, Z, E, O).
Description in Arabic: VAT category code must contain one of the values (S, Z, E, O).
Responsible for the modification: Qoyod.
Appropriate response: Dear Customer,
This warning is internal to Qoyod’s system and requires no action from you.
Our system is fully integrated with ZATCA and all warnings are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your work or cause any penalties.
Error code: BR-KSA-25
Description in English: If it is a simplified tax invoice or an associated credit note or a debit note (KSA-2, position 1 and 2 = 02) and the tax exemption reason code (BT-121) is equal with VATEX-SA-EDU or VATEX-SA-HEA, then buyer name (BT-44) is mandatory.
Description in Arabic: If it is a simplified tax invoice or an associated credit/debit note (KSA-2, position 1 and 2 = 02) and the tax exemption reason code (BT-121) equals VATEX-SA-EDU or VATEX-SA-HEA, then the buyer name (BT-44) is mandatory.
Responsible for the modification: Customer.
Problem:
If you issued a simplified invoice (meaning not a full tax invoice) and used an educational or health exemption such as:
Then ZATCA tells you:
You must enter the buyer name; you cannot leave it empty!
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error”. If the invoice status is “Received with Warnings”, the invoice does not need to be modified; it is a note for future invoices. Do not request any customer data such as establishment number or invoice number if the modification is on their side.
Error code: BR-KSA-26
Description in English: If the invoice contains the previous invoice hash (KSA-13), this hash must be base64 encoded SHA256. The hash shall be computed using the following method as described in the ds:transforms block in the XML Invoice Specifications: 1. Remove the block 2. Remove the block where = QR 3. Remove the bloc.
Description in Arabic: If the invoice contains the previous invoice hash (KSA-13), this hash must be base64 encoded SHA256. The hash must be calculated using the method described in the ds:transforms block in the XML invoice specifications.
Responsible for the modification: Qoyod.
Appropriate response: Dear Customer,
This warning is internal to Qoyod’s system and requires no action from you.
Our system is fully integrated with ZATCA and all warnings are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your work or cause any penalties.
Error code: BR-KSA-27
Description in English: The document must contain aa QR code (KSA-14), and this code must be base64Binary.
Description in Arabic: The document must contain a QR code (KSA-14), and this code must be in base64Binary format.
Responsible for the modification: Qoyod.
Appropriate response: Dear Customer,
This warning is internal to Qoyod’s system and requires no action from you.
Our system is fully integrated with ZATCA and all warnings are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your work or cause any penalties.
Error code: BR-KSA-28
Description in English: If the cryptographic stamp (KSA 15) exists in the invoice, this cryptographic stamp (KSA-15) must contain the exact “urn:oasis:names:specification:ubl :signature:1” value for signature information ID.
Description in Arabic: If the cryptographic stamp (KSA-15) exists in the invoice, the cryptographic stamp (KSA-15) must contain the exact “urn:oasis:names:specification:ubl:signature:1” value for signature information ID.
Responsible for the modification: Qoyod.
Appropriate response: Dear Customer,
This warning is internal to Qoyod’s system and requires no action from you.
Our system is fully integrated with ZATCA and all warnings are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your work or cause any penalties.
Error code: BR-KSA-29
Description in English: If the cryptographic stamp (KSA15) exists in the invoice, this cryptographic stamp (KSA-15) must contain the exact “urn:oasis:names:specification:ubl :signature:Invoice” value for referenced signature ID and signature ID.
Description in Arabic: If the cryptographic stamp (KSA-15) exists in the invoice, the cryptographic stamp (KSA-15) must contain the exact “urn:oasis:names:specification:ubl:signature:Invoice” value for referenced signature ID and signature ID.
Responsible for the modification: Qoyod.
Appropriate response: Dear Customer,
This warning is internal to Qoyod’s system and requires no action from you.
Our system is fully integrated with ZATCA and all warnings are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your work or cause any penalties.
Error Code: BR-KSA-30
English Description: The document cryptographic stamp (KSA-15) must contain the exact “urn:oasis:names:specification:ubl:dsig:enveloped:xades” value for signature method.|
Arabic Description: The document cryptographic stamp (KSA-15) must contain the exact “urn:oasis:names:specification:ubl:dsig:enveloped:xades” value for signature method.
Responsible for the Modification: Qoyod.
Appropriate Response: Dear Our Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compatibility.
The invoice is issued and approved correctly, and it does not affect your business or cause any fines.
Error Code: BR-KSA-31
English Description: For simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02), only the following are accepted: ● third party (KSA-2, position 3 = 1), ● nominal supply (KSA-2, position 4 = 1) and summary transactions (KSA-2, position 6 = 1).
Arabic Description: For simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02), only the following are accepted: ● third party (KSA-2, position 3 = 1) ● nominal supply (KSA-2, position 4 = 1) ● summary transactions (KSA-2, position 6 = 1).
Responsible for the Modification: Qoyod.
Appropriate Response: Dear Our Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compatibility.
The invoice is issued and approved correctly, and it does not affect your business or cause any fines.
Error Code: BR-KSA-33
English Description: Each invoice must have an invoice counter value (KSA-16).
Arabic Description: Each invoice must have an invoice counter value (KSA-16).
Responsible for the Modification: Qoyod.
Appropriate Response: Dear Our Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compatibility.
The invoice is issued and approved correctly, and it does not affect your business or cause any fines.
Error Code: BR-KSA-34
English Description: The invoice counter value (KSA-16) must contain only digits.
Arabic Description: The invoice counter value (KSA-16) must contain only digits.
Responsible for the Modification: Qoyod.
Appropriate Response: Dear Our Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compatibility.
The invoice is issued and approved correctly, and it does not affect your business or cause any fines.
Error Code: BR-KSA-35
English Description: If the invoice contains a supply end date (KSA-24), then the invoice must contain a supply date (KSA-5).
Arabic Description: If the invoice contains a supply end date (KSA-24), then it must also contain a supply date (KSA-5).
Responsible for the Modification: Qoyod.
Appropriate Response: Dear Our Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compatibility.
The invoice is issued and approved correctly, and it does not affect your business or cause any fines.
Error Code: BR-KSA-36
English Description: If the invoice contains a supply end date (KSA-24), then this date must be greater than or equal to the supply date (KSA-5).
Arabic Description: If the invoice contains a supply end date (KSA-24), this date must be greater than or equal to the supply date (KSA-5). Responsible for the Modification: Qoyod.
Appropriate Response: Dear Our Customer,
The alert shown is internal to the Qoyod system and does not require any action from you.
Our system is integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compatibility.
The invoice is issued and approved correctly, and it does not affect your business or cause any fines.
Error Code: BR-KSA-37
English Description: The seller address building number must contain 4 digits.
Arabic Description: The seller address building number must contain 4 digits.
Responsible for the Modification: Customer.
Problem: The seller’s building number is incorrect (must be 4 digits). Solution: Re-enter the correct building number for the seller through Settings → General Settings → Building Number in the Address.
Note: Do not ask the customer to re-issue the invoice unless the invoice status is “Invoice Error.” If the invoice status is “Received with Alerts,” no invoice modification is required as it is a note for future invoices. Do not request any data from the customer such as: establishment number or invoice number if the modification is on their end.
Error Code: BR-KSA-39
English Description: The invoice must contain the seller VAT registration number or seller group VAT number (BT-31). Arabic Description: The invoice must contain the seller VAT registration number or seller group VAT number (BT-31).
Responsible for the Modification: Customer.
Problem: Your company’s tax registration number (seller) is missing. Solution: Add the tax number in the establishment settings through Settings → General Settings.
Note: Do not ask the customer to re-issue the invoice unless the invoice status is “Invoice Error.” If the invoice status is “Received with Alerts,” no invoice modification is required as it is a note for future invoices. Do not request any data from the customer such as: establishment number or invoice number if the modification is on their end.
Error Code: BR-KSA-40
English Description: If it exists in the invoice, the seller VAT registration number or the seller group VAT registration number (BT-31) must contain 15 digits. The first and the last digits are “3”.
Arabic Description: If present in the invoice, the seller VAT registration number or the seller group VAT registration number (BT-31) must contain 15 digits. The first and last digits must be “3”.
Responsible for the Modification: Customer.
Problem: The seller’s tax registration number is incorrect (must be 15 digits starting and ending with 3). Solution: Re-enter the number correctly in Settings → General Settings → find the Tax Number field.
Note: Do not ask the customer to re-issue the invoice unless the invoice status is “Invoice Error.” If the invoice status is “Received with Alerts,” no invoice modification is required as it is a note for future invoices. Do not request any data from the customer such as: establishment number or invoice number if the modification is on their end.
Error Code: BR-KSA-42
English Description: The buyer name (BT-44) must be present in the tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2 = 01).
Arabic Description: The buyer name (BT-44) must be present in the tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2 = 01).
Responsible for the Modification: Customer.
Problem: Buyer name is missing from the tax invoice. Solution: Add the buyer name to the invoice data.
Note: Do not ask the customer to re-issue the invoice unless the invoice status is “Invoice Error.” If the invoice status is “Received with Alerts,” no invoice modification is required as it is a note for future invoices. Do not request any data from the customer such as: establishment number or invoice number if the modification is on their end.
