ZATCA Authority Alerts - Error Codes and Customer Responses

If the customer asks about ZATCA notifications or requests an explanation or clarification of a notification, whether it’s a single notification or multiple different notifications, respond as follows for each notification individually:

– Description in English
– Responsible party for the modification
– In case the modification is from:
Customer: Provide solution steps
Qoyod: Appropriate response: Dear customer,
The notification displayed is internal to Qoyod’s system and does not require any action on your part.
Our system is fully integrated with the General Authority of Zakat and Income and all notifications are updated automatically and continuously to ensure complete system compliance.
The invoice has been issued and approved correctly, and it does not affect your business or cause any penalties.

Note:

If the invoice status is “Received with observations”: No modification needed, just observations for future invoices.

If the invoice status is “Error in invoice”: Modification required + Credit note + New invoice.

Common inquiry phrases:
– I received notifications (and the notification text is written)
– What do these notifications mean (and the notification text is written)
– Explain the notifications to me (and the notification text is written)

List of Errors and Modifications:

Error Code: BR-02
English Description: An Invoice shall have an Invoice number (BT-1).
Arabic Description: The invoice must contain the reference number (BT-1).
Responsible Party: Qoyod.
Appropriate Response: Dear customer,
The notification displayed is internal to Qoyod’s system and does not require any action on your part.
Our system is fully integrated with the General Authority of Zakat and Income and all notifications are updated automatically and continuously 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-03
English Description: An Invoice shall have an Invoice issue date (BT-2).
Arabic Description: The invoice must contain the invoice issue date (BT-2).
Responsible Party: Qoyod.
Appropriate Response: Dear customer,
The notification displayed is internal to Qoyod’s system and does not require any action on your part.
Our system is fully integrated with the General Authority of Zakat and Income and all notifications are updated automatically and continuously 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-04
English Description: An Invoice shall have an Invoice type code (BT-3).
Arabic Description: The invoice must contain the invoice type code (BT-3).
Responsible Party: Qoyod.
Appropriate Response: Dear customer,
The notification displayed is internal to Qoyod’s system and does not require any action on your part.
Our system is fully integrated with the General Authority of Zakat and Income and all notifications are updated automatically and continuously 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-05
English Description: An Invoice shall have an Invoice currency code (BT-5).
Arabic Description: The invoice must contain the invoice currency code (BT-5).
Responsible Party: Qoyod.
Appropriate Response: Dear customer,
The notification displayed is internal to Qoyod’s system and does not require any action on your part.
Our system is fully integrated with the General Authority of Zakat and Income and all notifications are updated automatically and continuously 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-06
English Description: An Invoice shall contain the Seller name (BT-27).
Arabic Description: The invoice must include the seller’s name (BT-27).
Responsible Party: Qoyod.
Appropriate Response: Dear customer,
The notification displayed is internal to Qoyod’s system and does not require any action on your part.
Our system is fully integrated with the General Authority of Zakat and Income and all notifications are updated automatically and continuously 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-08
English Description: An Invoice shall contain the Seller postal address (BG-5).
Arabic Description: The invoice must include the seller’s postal address (BG-5).
Responsible Party: 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 the General Authority of Zakat and Income in Phase Two.
Solution: The Authority requires every tax invoice to contain complete seller information, including the postal address, as it is part of the company’s official identity and is used for verification and audit purposes.
Solution:
Step 1: Access Company Settings

From the main menu, go to:
Settings > General Settings.

Look for the “Address” field

In the Address field, complete the following information:

Street: Street or neighborhood name (example: “King Fahd Street”).
City: City name (example: “Riyadh”).
Postal Code: 5-digit postal code (example: 12345).
Neighborhood/District: Neighborhood name (example: “Al-Wurud”).
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 observations”, invoice modification is not required as it is just an observation for future invoices. Do not request any information from the customer such as facility number or invoice number if the modification is on their part.

Error Code: BR-09
English Description: The Seller postal address (BG-5) shall contain a Seller country code (BT-40).
Arabic Description: The seller’s postal address must contain the seller’s country code (BT-40).
Responsible Party: Qoyod.
Appropriate Response: Dear customer,
The notification displayed is internal to Qoyod’s system and does not require any action on your part.
Our system is fully integrated with the General Authority of Zakat and Income and all notifications are updated automatically and continuously 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-1010
English Description: 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).
Arabic Description: The invoice must include the buyer’s postal address (BG-8). Not applicable to simplified tax invoices and associated credit notes and debit notes.
Responsible Party: Customer.
Problem: You issued a tax invoice (not simplified), but you did not enter the buyer’s complete postal address. This is mandatory on tax invoices according to the Authority’s 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 does not have a 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 whose invoice shows this error.

Click Edit next to their name.

Enter the customer’s postal address accurately

Street: Street or neighborhood name (example: “Al-Tahlia Street”).
City: City name (example: “Jeddah”).
District: Neighborhood name if possible (example: “Al-Nuzha”).
Postal Code: 5-digit postal code (example: 23456).
Building Number.
Country.
Then save.

Error Code: BR-13
English Description: An Invoice shall have the Invoice total amount without VAT (BT-109).
Arabic Description: The invoice must include the total invoice amount before VAT (BT-109).
Responsible Party: Qoyod.
Appropriate Response: Dear customer,
The notification displayed is internal to Qoyod’s system and does not require any action on your part.
Our system is fully integrated with the General Authority of Zakat and Income and all notifications are updated automatically and continuously 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-14
English Description: An Invoice shall have the Invoice total amount with VAT (BT-112).
Arabic Description: The invoice must include the total invoice amount with VAT (BT-112).
Responsible Party: Qoyod.
Appropriate Response: Dear customer,
The notification displayed is internal to Qoyod’s system and does not require any action on your part.
Our system is fully integrated with the General Authority of Zakat and Income and all notifications are updated automatically and continuously 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-15
English Description: An Invoice shall have the Amount due for payment (BT-115).
Arabic Description: The invoice must include the amount due for payment (BT-115).
Responsible Party: Qoyod.
Appropriate Response: Dear customer,
The notification displayed is internal to Qoyod’s system and does not require any action on your part.
Our system is fully integrated with the General Authority of Zakat and Income and all notifications are updated automatically and continuously 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-16
English Description: An Invoice shall have at least one Invoice line (BG-25).
Arabic Description: An invoice must contain at least one invoice line (BG-25).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur any penalties.

Error Code: BR-21
English Description: Each Invoice line (BG-25) shall have an Invoice line identifier (BT-126).
Arabic Description: Each invoice line must contain an invoice line identifier (BT-126).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur any penalties.

Error Code: BR-22
English Description: Each Invoice line (BG-25) shall have an Invoiced quantity (BT-129).
Arabic Description: Each invoice line must contain the invoiced quantity (BT-129).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur any penalties.

Error Code: BR-24
English Description: Each Invoice line (BG-25) shall have an Invoice line net amount (BT-131).
Arabic Description: Each invoice line must contain the net amount of the invoice line (BT-131).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur any penalties.

Error Code: BR-25
English Description: Each Invoice line (BG-25) shall contain the Item name (BT-153).
Arabic Description: Each invoice line must contain the item name (BT-153).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur any penalties.

Error Code: BR-26
English Description: Each Invoice line (BG-25) shall contain the Item net price (BT-146).
Arabic Description: Each invoice line must contain the item net price (BT-146).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur any penalties.

Error Code: BR-31
English Description: Each Document level allowance (BG-20) shall have a Document level allowance amount (BT-92). Arabic Description: Each document-level discount must contain the discount amount (BT-92).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur any penalties.

Error Code: BR-32
English Description: Each Document level allowance (BG-20) shall have a Document level allowance VAT category code (BT-95).
Arabic Description: Each document-level discount must contain the VAT category code for the discount (BT-95).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur 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: Each invoice line discount must contain the discount amount (BT-136).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur any penalties.

Error Code: BR-45
English Description: Each VAT breakdown (BG-23) shall have a VAT category taxable amount (BT-116).
Arabic Description: Each VAT breakdown must contain the taxable amount for the tax category (BT-116).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur any penalties.

Error Code: BR-46
English Description: Each VAT breakdown (BG-23) shall have a VAT category tax amount (BT-117).
Arabic Description: Each VAT breakdown must contain the tax amount for the tax category (BT-117).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur 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: Each VAT breakdown must be defined through a tax category code (BT-118).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur 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: Each VAT breakdown (BG-23) must contain the VAT category rate (BT-119), except if the invoice is 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 on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur any penalties.

Error Code: BR-49
English Description: A Payment instruction (BG-16) shall specify the Payment means type code (BT-81).
Arabic Description: Payment instructions must specify the payment method type code (BT-81).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur 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: If the VAT accounting currency code is present, then the total VAT amount in the accounting currency must be provided.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur any penalties.

Error Code: BR-55
English Description: Each Preceding Invoice reference (BG-3) shall contain a Preceding Invoice reference (BT-25).
Arabic Description: Each preceding invoice reference must contain a preceding invoice reference (BT-25).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and does not require any action on your part.
Our system is fully integrated with the General Authority for Zakat and Tax, and all alerts are automatically updated continuously to ensure complete system compliance.
Your invoice has been issued and approved correctly and will not affect your work or incur 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: Each invoice line must be categorized with a VAT category code for the invoiced item (BT-151).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur 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: The sum of invoice line net amount (BT-106) must equal Σ invoice line net amount (BT-131).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur 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: The sum of allowances at document level (BT-107) must equal Σ document level allowance amount (BT-92).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur 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: The invoice total amount without VAT (BT-109) must equal Σ invoice line net amount (BT-131) minus the sum of allowances at document level (BT-107).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur any penalties.

Error Code: BR-CO-14
English Description: Invoice total VAT amount (BT-110) = Σ VAT category tax amount (BT-117).
Arabic Description: The invoice total VAT amount (BT-110) must equal Σ VAT category tax amount (BT-117).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur 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: The invoice total amount with VAT (BT-112) must equal the invoice total amount without VAT (BT-109) plus the invoice total VAT amount (BT-110).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur 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: The amount due for payment (BT-115) must equal the invoice total amount with VAT (BT-112) minus the paid amount (BT-113).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur 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: VAT category tax amount (BT-117) = VAT category taxable amount (BT-116) x (VAT category rate (BT-119) / 100), rounded to two decimal places.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur any penalties.

Error Code: BR-CO-18
English Description: An Invoice shall at least have one VAT breakdown group (BG-23).
Arabic Description: An invoice must contain at least one VAT breakdown group (BG-23).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur 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: 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) must be greater than zero.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur 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: The VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where the VAT category code (BT-118) is “standard rated” must equal the VAT category taxable amount (BT-116) multiplied by the VAT category rate (BT-119) / 100), rounded to two decimal places.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur 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: A VAT breakdown (BG-23) with VAT category code (BT-118) “Standard rate” must not contain a VAT exemption reason code (BT-121) or VAT exemption reason text (BT-120).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur 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 with “Zero rated”.

Arabic 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” must contain in the VAT breakdown (BG-23) exactly one VAT category code (BT-118) equal to “Zero rated”.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert is internal from the Qoyod system and does not require any action on your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are automatically updated to ensure full system compliance.
The invoice is issued and approved correctly, and it does not affect your work or incur any penalties.

Error code: BR-Z-05
Description in English: 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).
Description in Arabic: In an invoice line (BG-25), the invoiced item 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 to Qoyod’s system and requires no action from you.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any fines.

Error code: BR-Z-06
Description in English: 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).
Description in Arabic: In the document-level allowance (BG-20), the document-level allowance VAT category code (BT-95) is “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 to Qoyod’s system and requires no action from you.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any fines.

Error code: BR-Z-09
Description in English: 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).
Description in Arabic: The VAT category tax amount (BT-117) in the VAT breakdown (BG-23), 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 to Qoyod’s system and requires no action from you.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any fines.

Error code: BR-E-01
Description in English: 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”.
Description in Arabic: 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 “exempted from VAT”, must contain a VAT breakdown (BG-23) where the VAT category code (BT-118) equals “exempted from VAT”.
Responsible for modification: Qoyod.
Appropriate response: Dear customer,
The alert shown is internal to Qoyod’s system and requires no action from you.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any fines.

Error code: BR-E-05
Description in English: “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).”
Description in Arabic: “In an invoice line (BG-25), the invoice VAT category code (BT-151) is “”exempted from VAT””, the invoice VAT rate (BT-152) must be 0.”
Responsible for modification: Qoyod.
Appropriate response: Dear customer,
The alert shown is internal to Qoyod’s system and requires no action from you.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any fines.

Error code: BR-E-06
Description in English: “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).”
Description in Arabic: “In a document-level allowance (BG-20), the document-level allowance VAT category code (BT-95) is “”exempted 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 to Qoyod’s system and requires no action from you.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any fines.

Error code: BR-E-09
Description in English: “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).”
Description in Arabic: “The VAT category tax amount (BT-117) in the VAT breakdown (BG-23), the VAT category code (BT-118) equals “”exempted from VAT””, must equal 0.”
Responsible for modification: Qoyod.
Appropriate response: Dear customer,
The alert shown is internal to Qoyod’s system and requires no action from you.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any fines.

Error code: BR-E-10
Description in English: “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).”
Description in Arabic: “The VAT breakdown (BG-23) with the VAT category code (BT-118) “”exempted 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 select an item in the invoice as “exempted 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 shows the error

Go to Sales, then Sales Invoices.

Find the rejected invoice → open it
Inside the invoice, review each line.

Look for any line where the “Tax Type” field = “Exempted from VAT”.

Check that the exemption reason is entered for the VAT-exempted product by going to Products and Costs, searching for the product that appears exempted on the invoice, clicking Edit next to the product, and verifying that the tax reason has been added.

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 this is merely a note for future invoices. Do not request any customer data such as establishment number or invoice number if the modification is on their end.

Error code: BR-O-01
Description in English: “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””.”
Description in Arabic: 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 to Qoyod’s system and requires no action from you.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any fines.

Error code: BR-O-05
Description in English: “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).”
Description in Arabic: In an invoice line (BG-25), when 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 to Qoyod’s system and requires no action from you.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any fines.

Error code: BR-O-06
Description in English: 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).
Description in Arabic: 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 to Qoyod’s system and requires no action from you.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any fines.

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 net invoice line amount (BT131) minus the total document-level discount amounts (BT-92) where the VAT category codes (BT-151, BT-95) are “Not subject to VAT”.
Responsible for Edit: Qoyod.
Appropriate Response: Dear Customer,
This alert is an internal notification from the Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax (GAZT) 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-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 category tax amount (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 Edit: Customer.
Problem Clarification: If you selected on 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 system 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” = no tax exists in the first place → must be 0.00

This option is rare and used only in special cases such as:

Internal non-commercial transactions (such as inventory transfers between branches without 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,” “Exempt,” and “0%”—each has a different use!

Go to the invoices list in Qoyod.

Search for the rejected invoice → open it for editing.

Review each line in the invoice.

Search for any line where the “Tax Type” field = “Not subject to VAT“.

On that same line, check the following fields:

Field / Required Value / Tax Type / Not subject to VAT / Tax Amount / 0.00 ️ (must be exactly zero)

If there is any number, even 0.01 or -1, change it to 0.00

Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error.” If the status is “Received with Alerts,” no invoice modification is required—it is only a note for future invoices. Do not request any information from the customer such as establishment number or invoice number if the modification is done 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) for those allowances is not “Not subject to VAT”.
Responsible for Edit: Qoyod.
Appropriate Response: Dear Customer,
This alert is an internal notification from the Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax (GAZT) 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-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 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) for those allowances is different from “Not subject to VAT”.
Responsible for Edit: Qoyod.
Appropriate Response: Dear Customer,
This alert is an internal notification from the Qoyod system and does not require any action from you.
Our system is fully integrated with the General Authority of Zakat and Tax (GAZT) 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 it exists in the invoice and the invoice is not an export invoice (KSA-2, position 5 = false), the buyer VAT registration number or buyer group VAT registration number (BT-48) must contain 15 digits, and the first and last digits must be “3”.
Responsible for Edit: Customer.
Problem: If you entered a buyer VAT registration number in an invoice that is not an export,
then this number must consist of 15 digits,
and starts and ends with the digit “3,” for example:
312345678901233

You entered a buyer VAT registration 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 VAT registration number.

Situation / Should You Enter the Tax Number?
Customer is a registered company in tax / Yes, required.
Customer is an end consumer / No.
Export (outside Saudi Arabia) / No, select the “Export” type.

Go to the invoices list → open the rejected invoice.

Check the customer name.

Go to the customers list and go to the VAT registration number field

Its length is exactly 15 digits.
It starts with “3“.
It ends with “3“.
It does not contain dashes (-), spaces, or letters.

Correct example:
312345678901233

Incorrect examples:
3123456789 ← Missing (only 10 digits)
31234567890123 ← Missing (14 digits)
312-345-678-90123 ← Contains dashes
312345678901234 ← Does not end with 3
.
Note: Do not ask the customer to reissue the invoice unless the invoice status is “Invoice Error.” If the status is “Received with Alerts,” no invoice modification is required—it is only a note for future invoices. Do not request any information from the customer such as establishment number or invoice number if the modification is done from their side.

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 VAT registration number or buyer group VAT registration number (BT-48) must not exist in the invoice.
Responsible for Edit: Customer.
Problem: If your invoice is an export invoice (i.e., sale to a customer outside Saudi Arabia),
you must not enter any VAT registration number for the buyer at all, because the buyer is not registered with the Saudi tax authority.

You specified the invoice type as “Export” ️ (and this is correct).

But at the same time you entered a VAT registration number for the buyer (which is not allowed in exports).

The GAZT considers this a contradiction—how can the customer be outside Saudi Arabia and have a Saudi VAT registration number?!

When selling goods or services to:

A company or individual outside the Kingdom of Saudi Arabia.

Example: A customer in Dubai, America, Germany, etc.

In this case:

There is no Saudi VAT registration number for the buyer → the field must be left blank.

Go to the invoices list → open the rejected invoice.

Make sure the invoice type is:

“Export invoice for goods or services,” which can be seen in the additional information at the bottom of the invoice

Go to Sales, then Customers, search for the customer name “buyer” and click Edit next to it, then go to the VAT registration number field:

Clear any number written in it completely, even if it is 300000000000003 or any other number.

Leave the field completely blank.
Then click “Save“

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 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 don’t add the “Other Buyer ID” as a national ID
Solution:
Step 1: Access 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 data page, look for a field called:

“Additional IDs” you will find it at the bottom of the page

Add an ID 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 “Arrived with Alerts”, the invoice does not need to be modified; it is just a note for future invoices. Do not ask the customer for any data such as: establishment number or invoice number if the modification is from their side.

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 line VAT amount (KSA-11) must equal the invoice line net amount (BT-131) multiplied by the line tax rate (BT-152) divided by 100.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown 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.
The invoice is 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 invoice line net amount (BT-131) plus the line VAT amount (KSA-11).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown 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.
The invoice is 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 line VAT amount (KSA-11) is mandatory in the tax invoice and associated credit and debit notes (KSA-2, position 1 and 2 = 01). Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown 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.
The invoice is 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 and debit notes (KSA-2, position 1 and 2 = 01).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown 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.
The invoice is 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,
The alert shown 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.
The invoice is 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 and debit notes (KSA-2, position 1 and 2 = 02).
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown 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.
The invoice is 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 previous invoice hash must exist in the invoice.
Responsible for Modification: Qoyod.
Appropriate Response: Dear Customer,
The alert shown 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.
The invoice is 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 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 within Saudi Arabia (Country = Saudi Arabia),
you must enter their complete national address data in the invoice, which is: street name, city, region, postal code, building number, country code (already existing “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 “region”

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 data page, look for the “Billing Address” section, and fill in the fields WITHOUT EXCEPTION:

Do not leave any field empty, even if approximate.

Then click “Save“

Error Code: BR-KSA-64
English Description: Seller Address Additional number (KSA-23) must be 4 digits.
Arabic Description: The seller address additional number (KSA-23) must contain 4 digits.
Responsible for Modification: Customer.
Problem: The additional number for your establishment address (seller) is incorrect (must be 4 digits)
What is the “Additional Number” in the national address?

It is part of the unified national address in Saudi Arabia, and is usually:

The unit/apartment or office number inside the building.

Or the additional number that identifies the location more precisely.

Solution: Re-enter the correct additional number in the establishment data through Settings and then General Settings and then look for the Address field. Usually written after the postal code, such as:
12345, 6789.

After editing, click “Save” at the bottom of the page.

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 buyer address additional number (KSA-19) must contain 4 digits.
Responsible for Modification: Customer.
Problem:

If you enter any value in the “Additional Number for Buyer Address (Customer)” field,
this value must consist of exactly 4 digits only, no more, no less, and no letters.

Correct example:
0101, 9999, 1234

Incorrect example:
123 ← 3 digits, not acceptable
12345 ← 5 digits, not acceptable
AB12 ← contains letters, not acceptable
Empty ← acceptable (because the condition says “if it exists”)

Either you entered in the customer file an additional number 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 issues.
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 showed the error → click to open their information.

On the customer information page, under the Address section, search for the additional number entered

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

Delete any content in the “Additional Number” field.

Leave it completely empty ← and this is 100% acceptable because the condition states: “If found“.

Practical tip:
If the customer has not 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”. If the invoice status is “Received with Alerts”, the invoice does not require modification; 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 was made by them.
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”, the invoice does not require modification; 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 was made by them.

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.
The Issue:

In your company’s address information (seller), the “Postal Code” field must consist of exactly 5 digits only – no more, no less, and no letters.

Correct Example:
12345 , 75312 , 00000

Incorrect Example:
1234 ← 4 digits, not acceptable
123456 ← 6 digits, not acceptable
AB123 ← contains letters, not acceptable
Empty ← not acceptable (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’s 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, search for the field:

“Postal Code“

Enter the postal code

After entering the correct postal code (5 digits) → click “Save“.

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.
The Issue:

If the customer (buyer) is from within Saudi Arabia → then their “Postal Code” field must consist of exactly 5 digits only – no more, no less, and no letters.

Correct Example:
12345 , 75312 , 00000

Incorrect Example:
1234 ← 4 digits, not acceptable
123456 ← 6 digits, not acceptable
AB123 ← contains letters, not acceptable
Empty ← not acceptable (because the condition is mandatory when selecting “SA”)

Customer is from Saudi Arabia ️

But the postal code in their file:

Is insufficient (fewer 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 information.

On the customer information page, under the “Address” section, search for the field:

“Postal Code“

Or “Postal Code“

Enter the postal code.

After entering the correct postal code (5 digits) → click “Save“.

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,
The alert shown is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with ZATCA (General Authority of Zakat and Tax) and all alerts are updated automatically in real-time to ensure full system compliance.
The invoice is issued and approved correctly, and there is no impact on your work or 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.
The Issue: If you selected the tax type “Zero%” (Zero Rated) on any line of the invoice,
then you must mandatorily enter:

️ VAT exception reason text (for example: “Export outside the Kingdom”) in the product information.

You used on one of the items: “Zero%” ️

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 transportation.

️ Supplies to establishments in qualified free zones.

Go to the invoices list → open the rejected invoice.

Inside the invoice, review each line.

Search for any line where the “Tax Type” field = “Zero%“.

This can be done by going to Products and Costs and then clicking Edit next to the product in the invoice

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 Arabia Time AST) or hh:mm:ssZ (UTC).
Responsible for modification: Qoyod.
Appropriate Response : Dear Customer,
The alert shown is internal to the Qoyod system and requires no action from you.
Our system is fully integrated with ZATCA (General Authority of Zakat and Tax) and all alerts are updated automatically in real-time to ensure full system compliance.
The invoice is issued and approved correctly, and there is no impact on your work or 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 a simplified invoice type (KSA-2, position 1 and 2 = 02, position 6 = 1), then the buyer name must be present.
Responsible for modification: Customer.
The Issue:
If you issued a simplified invoice (meaning the customer does not have a tax number),
then you must mandatorily enter the buyer’s name clearly , even if they are an end consumer.

You entered invoice type: “Simplified” ️

But you did not enter a clear buyer name

Common Example:

A retail store collects a full day’s purchases for one customer → 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, ZATCA 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”

Search 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.

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 a simplified invoice type (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.
Responsible for Amendment: Customer.
Problem and Solution:
If you issued a simplified and summary invoice (i.e., containing more than one transaction or service),
then you MUST mandatorily enter: supply date

Note: Do not ask the customer to re-issue the invoice unless the invoice status is “Invoice Error”, as if the invoice status is “Received with Alerts”, no invoice modification is required but rather a note for future invoices, and do not request any customer data such as: establishment number or invoice number if the modification is 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 maximum two decimal places. Only numerals are accepted and the percentage symbol (%) is not allowed.
Responsible for Amendment: Customer.
Problem: If you used a discount by percentage in the invoice (at line level or at invoice level),
then the value must be:

A number only, without the % symbol
Between 0.00 and 100.00
Not exceeding two decimal places (example: 25.50 ✓, but not 25.555)

You entered in the discount field: "10%" ← Contains % symbol

Or entered: "105" ← Greater than 100

Or entered: "-5" ← Less than 0

Or entered: "25.123" ← More than two decimal places

Or entered: "ten" ← Text, not a number

Go to the Invoice List → Open the rejected invoice.

Within the lines, when editing any product/service.

Search for the field “Discount %” or “Discount %“.

At the end of the invoice, section “Discount” or “Discount“.

Criteria What to Do Correct Examples
No symbol, remove 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, shorten to 25.12, 0.75 ← Correct.
Numbers only, do not write “half” or “ten”, 100.00 ← Correct

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 maximum two decimal places. Only numerals are accepted and the percentage symbol (%) is not allowed.
Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal to the Qoyod system and requires no action on your part.
Our system is integrated with the Zakat, Tax and General Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is correctly issued and approved, and does 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: VAT amount at line level (KSA-11) must have a maximum two decimal places.
Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal to the Qoyod system and requires no action on your part.
Our system is integrated with the Zakat, Tax and General Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is correctly issued and approved, and does 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: Amount at line level including VAT (KSA-12) must have a maximum two decimal places.
Responsible for Amendment: Customer.
Problem and Solution:
In each line of the invoice, the field “Amount Including Tax” must contain a decimal number not exceeding two decimal places only.

Error Code: BR-KSA-CL-01
English Description: Currency code (BT-5) must be according to ISO 4217:2005 .
Arabic Description: Currency code (BT-5) must comply with ISO 4217:2005 standard.
Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal to the Qoyod system and requires no action on your part.
Our system is integrated with the Zakat, Tax and General Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is correctly issued and approved, and does not affect your work or cause 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: All currency 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).
Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal to the Qoyod system and requires no action on your part.
Our system is integrated with the Zakat, Tax and General Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is correctly issued and approved, and does not affect your work or cause any penalties.

Error Code: BR-KSA-CL-03
English Description: Mime code must be according to subset of IANA code list.
Arabic Description: MIME code must comply with a subset of the IANA code list.
Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
The alert shown is internal to the Qoyod system and requires no action on your part.
Our system is integrated with the Zakat, Tax and General Authority and all alerts are updated automatically in real-time to ensure complete system compliance.
The invoice is correctly issued and approved, and does not affect your work or cause 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: The VAT exemption reason code (BT-121) must exist in the invoice. Codes Z and E must contain the tax exemption (or exception) reason code and text – specific to Saudi Arabia.
Responsible for Amendment: Customer.
Problem:
If you selected in the invoice a tax type:

Z = Zero%

Or E = Exempt

you MUST mandatorily enter:

✓ Tax Reason (BT-120), such as: “Export outside Saudi Arabia”

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

Type When do you use it? Required Code Suggested Text Zero% (Z) Export outside Saudi Arabia, free zones, international transport VATEX-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 health or educational services VATEX-SA-HEA “Certified health service” VATEX-SA-EDU “Certified educational service” VATEX-SA-EXEMPT-OTHER “Other approved tax exemption”

Go to the Invoice List → Open the rejected invoice or the one with an alert.

Within the invoice, review each line.

Search for any line where the field “Tax Type” = “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 and then save.

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: If the VAT exemption reason code (BT-121) is codes “Z” or “E”, then VAT exemption reason text (BT-120) must exist with one of the values from the tax exemption (or exception) reason code and text – specific to Saudi Arabia.
Responsible for Amendment: Customer.
Problem:
If you used a tax code:

Z = Zero% (Zero Rated)

Or E = Exempt (Exempt)

you MUST mandatorily enter:

Tax Reason in Product Data

You used code Z or E ✓

But you:

You did not enter the tax reason in the product data

Go to the Invoices menu → Open the rejected invoice.

Inside the invoice, review each line.

Look for any line where:

Tax type = “0%” or “VAT exempt“

or Code = Z or E

Go to the Products and Costs menu and click Edit next to the product, then add the tax reason, and then 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 “Arrived with Warnings”, no invoice modification is required, it is only a note for future invoices, and do not request any customer data such as: establishment number or invoice number if the modification is on their end.

Error code: BR-KSA-EN16931-01
English description: Business process (BT-23) must be “reporting:1.0”.
Arabic description: The business process type field (BT-23) must be “reporting:1.0”.
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause any penalties.

Error code: BR-KSA-EN16931-02
English description: VAT accounting currency code (BT-6) must be “SAR”.
Arabic description: The VAT accounting currency code (BT-6) must be “SAR”.
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause 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: The allowance amount (BT-92, BT-136) must equal the base amount (BT-93, BT-137) multiplied by the percentage (BT-94, BT-138) divided by 100, if the base amount and percentage exist.
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause 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: The allowance base amount (BT-93, BT-137) must be entered when the allowance percentage (BT-94, BT-138) is entered.
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause 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: The allowance percentage (BT-94, BT-138) must be entered when the allowance base amount (BT-93, BT-137) is entered.
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause 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: Additional charges at the price level (BG-29) are not permitted. The only allowed value is ‘false’.
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause 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: The item net price (BT-146) must equal (Gross price (BT-148) – Allowance amount (BT-147)) when the gross price is provided. 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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause 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: Only one tax total (BG-22) with tax subtotals must be provided.
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause 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: Only one tax total (BG-22) without tax subtotals must be provided when the tax currency code is provided.
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause 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: The invoice line net amount (BT-131) must equal the invoiced quantity (BT-129) multiplied by (item net price (BT-146) divided by the item price base quantity (BT-149)) minus the invoice line allowance amount (BT-136).
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause any penalties.

Error code: BR-KSA-EN16931-12
English description: Base quantity (BT-149) must be a positive number above zero.
Arabic description: The base quantity (BT-149) must be a positive number greater than zero.
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause any penalties.

Error code: BR-KSA-F-01
English description: A date MUST be formatted YYYY-MM-DD.
Arabic description: The date must be in the YYYY-MM-DD format.
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause any penalties.

Error code: BR-KSA-F-02
English description: Allowance/Charge Indicator value MUST equal to ‘false’/’True’ respectively .
Arabic description: The allowance/charge indicator value must be equal to “false” or “true” depending on the case.
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 integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work or cause 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,
This alert is internal to the Qoyod system and requires no action from you.
Our system is integrated with the Zakat, Tax and Customs Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice is issued and approved correctly, and it does not affect your work 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 shown is internal to Qoyod system and does not require any action on your part.
Our system is 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-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 shown is internal to Qoyod system and does not require any action on your part.
Our system is 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-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 for document-level charges (BT-105) and the reason 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 shown is internal to Qoyod system and does not require any action on your part.
Our system is 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-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’, there must be a VAT exemption (or exception) reason code (BT-121) with one of the values specified in paragraph 11.2.4 of the XML implementation standards for tax exemptions (or exceptions) specific to Saudi Arabia.
Responsible for Modification: Qoyod.
Appropriate Response : Dear Customer,
The alert shown is internal to Qoyod system and does not require any action on your part.
Our system is 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-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 shown is internal to Qoyod system and does not require any action on your part.
Our system is 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-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 contain a VAT exemption (or exception) reason text (BT-120) with one of the values specified in paragraph 11.2.4 of the XML implementation standards for tax exemptions (or exceptions) specific to Saudi Arabia.
Responsible for Modification: Qoyod.
Appropriate Response : Dear Customer,
The alert shown is internal to Qoyod system and does not require any action on your part.
Our system is 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-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 a prepayment Document Type Code (KSA-30) is provided, the following values must equal 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 shown is internal to Qoyod system and does not require any action on your part.
Our system is 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-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 and credit notes (KSA-2, position 1 and 2 = 01) when the buyer VAT registration number or buyer group VAT registration number (BT-48) is not provided.
Responsible for Modification: Customer.
The Issue:

If you issued a tax invoice ️
and you specified in the customer data that they are subject to tax, meaning you selected the option “Is the establishment subject to tax?” and you did not enter a tax number for the buyer (i.e., field BT-48 is empty),
then you are required to enter:

️ “Other Buyer ID” (BT-46)

which is an alternative field used to identify the customer when they do not have a Saudi tax number.

Invoice Type = “Tax Invoice” ️

You did not enter any tax number for the buyer (field BT-48 is empty) ️

But you did not enter “Other Buyer ID”, which is mandatory in this case.

️ This requirement does not apply to:

Simplified invoices, where the Other Buyer ID is not required.

If the buyer has a tax number, there is no need for the Other ID.

When you sell to a customer:

who does not have a tax number (for example: a foreign company, an individual, or an 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 it’s a company)

National ID (if it’s a Saudi individual)

Passport (if it’s a foreigner)

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 data.

On the customer data page, look for a section:

“Additional IDs” or “Other Buyer IDs”

You will find it at the bottom of the page under “Additional Details – Additional Customer IDs”

Select the appropriate type (such as: National ID, Commercial Registration…).

In the “Value” field → Enter the customer’s number/code.

After entering the 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 “Issued with Alerts”, no invoice modification is required as this is only a note for future invoices, and 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-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 encoded using the code lists specific to invoices and credit notes according to the UNTDID 1001 standard.
Responsible for Modification: Qoyod.
Appropriate Response : Dear Customer,
The alert shown is internal to Qoyod system and does not require any action on your part.
Our system is 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-CL-03
English Description: currencyID MUST be coded using ISO code list 4217 alpha-3 .
Arabic Description: The currency code must be coded using ISO 4217 three-letter code list.
Responsible for Modification: Qoyod.
Appropriate Response : Dear Customer,
The alert shown is internal to Qoyod system and does not require any action on your part.
Our system is 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-CL-04
English Description: Invoice currency code MUST be coded using ISO code list 4217 alpha-3.
Arabic Description: Invoice currency code MUST be coded using ISO code list 4217 alpha-3.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and 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: Tax currency code MUST be coded using ISO code list 4217 alpha-3.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and 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 clarification, respond as follows:
Arabic Description: Country codes in an invoice must be coded using ISO standard code list 3166-1.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and 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: Payment method in the invoice must be coded using UNCL4461 code list.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and 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 UNCL5305 code list.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and 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 discount amount (BT-92) is 2.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and 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 discount base amount (BT-93) is 2.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and 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 decimal places for the sum of invoice line net amounts (BT-106) is 2.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and does not affect your business 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 decimal places for the sum of allowances at the document level (BT 107) is 2.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and does not affect your business 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 decimal places for the invoice total amount without VAT (BT-109) is 2.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and does not affect your business 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 decimal places for the invoice-level VAT amount (BT-110) is 2.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and does not affect your business 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 decimal places for the invoice total amount with VAT (BT-112) is 2.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and does not affect your business 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 decimal places for the invoice-level VAT amount in accounting currency (BT-111) is 2.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and does not affect your business 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 decimal places for the paid amount (BT-113) is 2.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and does not affect your business 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 decimal places for the amount due for payment (BT-115) is 2.
Responsible for Amendment: 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 Zakat and Tax Authority, and all alerts are updated automatically in real-time to ensure complete system compliance.
Your invoice is issued and approved correctly, and does not affect your business 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 decimal places for the taxable amount for the tax category (BT-116) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert appearing is internal from the Qoyod system and does not require any action from your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compliance.
The invoice is issued and correctly approved, and does not affect your work or cause any penalty.

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 decimal places for the tax amount of the tax category (BT-117) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert appearing is internal from the Qoyod system and does not require any action from your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compliance.
The invoice is issued and correctly approved, and does not affect your work or cause any penalty.

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 decimal places for the invoice line net amount (BT-131) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert appearing is internal from the Qoyod system and does not require any action from your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compliance.
The invoice is issued and correctly approved, and does not affect your work or cause any penalty.

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 decimal places for the invoice line discount amount (BT-136) is 2.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert appearing is internal from the Qoyod system and does not require any action from your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compliance.
The invoice is issued and correctly approved, and does not affect your work or cause any penalty.

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 decimal places for the invoice line discount base amount (BT 137) is 2. Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert appearing is internal from the Qoyod system and does not require any action from your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compliance.
The invoice is issued and correctly approved, and does not affect your work or cause any penalty.

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 by the device that issued the document (unique message identifier for the exchange process). This identifier must contain only letters, numbers, and dashes. (Note: In Windows operating system, UUID is referred to by the term GUID).
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert appearing is internal from the Qoyod system and does not require any action from your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compliance.
The invoice is issued and correctly approved, and does not affect your work or cause any penalty.

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 appearing is internal from the Qoyod system and does not require any action from your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compliance.
The invoice is issued and correctly approved, and does not affect your work or cause any penalty.

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 appearing is internal from the Qoyod system and does not require any action from your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compliance.
The invoice is issued and correctly approved, and does not affect your work or cause any penalty.

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 follow 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) = summary invoice, 0 = no, 1 = yes. B (position 7) = self-billed invoice.
Responsible for modification: Qoyod.
Appropriate Response: Dear customer,
The alert appearing is internal from the Qoyod system and does not require any action from your part.
Our system is fully integrated with the Zakat and Tax Authority and all alerts are updated automatically continuously to ensure complete system compliance.
The invoice is issued and correctly approved, and does not affect your work or cause any penalty.

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: Client.
The 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 indicated that the invoice is for exporting goods or services in the invoice’s additional information.

But at the same time you enabled the “self-billing” option.

And this is prohibited by the authority, 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 “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 establishment number or invoice number if the modification is from their side.

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 – Municipality license with “MOM” as scheme ID – MLSD license with “MLS” as scheme ID – Sagia license with “SAG” as scheme ID – Other ID with “OTH” as scheme ID. If multiple IDs exist, one of the above must be entered according to the specified sequence.
Responsible for modification: Client.
The Problem:
In your company (seller) data, there must be only one identifier, of an approved type, 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 identifier for the seller

Or you entered more than one identifier

Or you used an unapproved scheme code

Or you wrote the identifier with symbols or spaces or unacceptable characters

From the main menu → go to:
Settings > General Settings.

On the General Settings page, look for the “Additional Identifiers” section

You will find a list containing types of identifiers

Only one identifier , delete any extra identifiers.
Use an identifier available to you such as :
→ CRN (Commercial Registration) ← Best and most common

The identifier must be alphanumeric only , without:

Spaces

Long dashes , (you can use - 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

Do not enter them all, the authority requires only one identifier.

Choose the highest priority, which is always:

️ Commercial Registration Number (CRN) ← if available.

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”, no invoice modification is required, it is only a note for future invoices, and do not request any data from the customer such as: organization number or invoice number if the modification is on their end

Error Code: BR-KSA-09
English Description: 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).
Arabic Description: 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 editing: Customer.
Problem: Seller address is incomplete (missing street, building, postal code, city, district, or country code). Solution: Complete the address information in the establishment settings by going to Settings, then General Settings, then search for the “Address” field and fill in all data carefully, 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”, no invoice modification is required, it is only a note for future invoices, and do not request any data from the customer such as: organization number or invoice number if the modification is on their end

Error Code: BR-KSA-10
English Description: 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).
Arabic Description: Buyer address must contain street (BT-50), city (BT-52), postal code (BT-53), country code (BT-55). This rule does not apply to simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02).
Responsible for editing: Customer.
Problem:
If you issued a tax invoice ️
then you must mandatorily 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 solve the problem :

From the main menu → go to:
Sales > Customers.

Search for the customer associated with the invoice → click to open their file.

On the customer data page, search for the “Address” section fill in the fields without exception:

and then click ” Save “.

Error Code: BR-KSA-14
English Description: 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 .
Arabic Description: Buyer identification (BT-46) must exist only once with one of the system 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 system code – Commercial Registration Number with “CRN” as system code – Municipal license with “MOM” as system code – MLSD license with “MLS” as system code – 700 Number with “700” as system code – SAG license with “SAG” as system code – National ID with “NAT” as system code – GCC ID with “GCC” as system code – Residency Number with “IQA” as system code – Passport Number with “PAS” as system code – Other ID with “OTH” as system code.
Responsible for editing: Customer.
Problem:
The authority says: If you entered an “identifier” for the customer (such as their ID or commercial registration or passport…),
then:

Keep it to one identifier only , not two or three.

Choose an approved type from the list (e.g.: NAT for ID, CRN for registration…).

Write the number or code without spaces or symbols , only numbers and English letters.

Solution:
Step 1: Enter the customer data

From the menu → choose “Sales” and then choose ” Customers “

Click edit to open their data.

It’s usually at the bottom of the page,

Step 3: Clear all extra identifiers, and keep only one

Delete any extra row , keep only one row.

and then ” Save ” .

Error Code: BR-KSA-15
English Description: 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).
Arabic Description: The 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 editing: Customer.
Problem:
If your invoice is a tax invoice (not simplified),
you must enter a mandatory field called:
️ “Supply Date”

Otherwise… the authority will reject it!

Solution: is to add the supply date to the tax invoices,

Error Code: BR-KSA-16
English Description: Payment means code (BT-81) in an invoice exist, then it must contain one of the values from subset of UNTDID 4461 code list .
Arabic Description: If a 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 editing: 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 the Zakat and Tax Authority and all alerts are updated automatically to ensure full system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.

Error Code: BR-KSA-17
English Description: 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 .
Arabic Description: Debit and credit notes (when the invoice type code (BT-3) is equal to 383 or 381) must contain the reason for issuing this type of invoice (KSA-10).
Responsible for editing: Customer.
Problem: The reason for issuance in the debit or credit note is missing. Solution: You must add the reason for issuance in the debit or credit 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”, no invoice modification is required, it is only a note for future invoices, and do not request any data from the customer such as: organization number or invoice number if the modification is on their end

Error Code: BR-KSA-18
English Description: VAT category code must contain one of the values (S, Z, E, O).
Arabic Description: VAT category code must contain one of the values (S, Z, E, O).
Responsible for editing: 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 the Zakat and Tax Authority and all alerts are updated automatically to ensure full system compliance.
The invoice is issued and approved correctly, and does not affect your work or cause any penalties.

Error Code: BR-KSA-25
English Description: 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.
Arabic Description: If it was 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 Amendment: Customer.
The Issue:
If you issued a simplified invoice (meaning it is not a tax invoice)
and used an educational or health exemption in it, such as:

The authority tells you:
👉 You must enter the customer name, you are not allowed to leave it blank!

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; rather, this is a note for future invoices. Do not request any information from the customer such as: establishment number or invoice number if the modification is from their end.

Error Code: BR-KSA-26
English Description: 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.
Arabic Description: If the invoice contains the previous invoice hash (KSA-13), this hash must be encrypted in base64 SHA256 format. The hash must be calculated using the method described in the ds:transforms block in the XML invoice specifications.
Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action on your part.
Our system is fully integrated with the Zakat, Tax and General Revenue Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your business or cause any penalties.

Error Code: BR-KSA-27
English Description: The document must contain a QR code (KSA-14), and this code must be base64Binary.
Arabic Description: The document must contain a QR code (KSA-14), and this code must be in base64Binary format.
Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action on your part.
Our system is fully integrated with the Zakat, Tax and General Revenue Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your business or cause any penalties.

Error Code: BR-KSA-28
English Description: 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.
Arabic Description: If the cryptographic stamp (KSA-15) is found in the invoice, the cryptographic stamp (KSA-15) must contain the exact value “urn:oasis:names:specification:ubl:signature:1” for the signature information ID.
Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action on your part.
Our system is fully integrated with the Zakat, Tax and General Revenue Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your business or cause any penalties.

Error Code: BR-KSA-29
English Description: 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.
Arabic Description: If the cryptographic stamp (KSA-15) is found in the invoice, the cryptographic stamp (KSA-15) must contain the exact value “urn:oasis:names:specification:ubl:signature:Invoice” for the referenced signature ID and signature ID.
Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action on your part.
Our system is fully integrated with the Zakat, Tax and General Revenue Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your business 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’s cryptographic stamp (KSA-15) must contain the exact value “urn:oasis:names:specification:ubl:dsig:enveloped:xades” for the signature method.
Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action on your part.
Our system is fully integrated with the Zakat, Tax and General Revenue Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your business or cause any penalties.

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 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 Amendment: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action on your part.
Our system is fully integrated with the Zakat, Tax and General Revenue Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your business or cause any penalties.

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 Amendment: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action on your part.
Our system is fully integrated with the Zakat, Tax and General Revenue Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your business or cause any penalties.

Error Code: BR-KSA-34
English Description: The invoice counter value (KSA 16) contains only digits.
Arabic Description: The invoice counter (KSA-16) must contain only digits.
Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action on your part.
Our system is fully integrated with the Zakat, Tax and General Revenue Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your business or cause any penalties.

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 Amendment: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action on your part.
Our system is fully integrated with the Zakat, Tax and General Revenue Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your business or cause any penalties.

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), then this date must be greater than or equal to the supply date (KSA-5). Responsible for Amendment: Qoyod.
Appropriate Response: Dear Customer,
This alert is internal to the Qoyod system and requires no action on your part.
Our system is fully integrated with the Zakat, Tax and General Revenue Authority and all alerts are updated automatically to ensure complete system compliance.
The invoice has been issued and approved correctly and will not affect your business or cause any penalties.

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 Amendment: Customer.
The Issue: The seller’s building number is incorrect (must be 4 digits). Solution: Re-enter the correct building number for the seller through Settings, then General Settings, then the 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; rather, this is a note for future invoices. Do not request any information from the customer such as: establishment number or invoice number if the modification is from 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 modification: Customer.
Problem: Your company’s (seller) VAT registration number is missing. Solution: Add the tax registration number in the entity settings through Settings and then General Settings.
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 just a note for future invoices, and do not request any data from the customer such as the entity 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 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 last digits must be “3”.
Responsible for modification: Customer.
Problem: The seller’s VAT registration number is incorrect (must be 15 digits starting and ending with 3). Solution: Re-enter the number correctly in Settings and then General Settings and then search for the Tax Registration Number field.
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 just a note for future invoices, and do not request any data from the customer such as the entity 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 modification: Customer.
Problem: The buyer name is missing from the tax invoice. Solution: Add the buyer name in the invoice 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 Alerts”, no invoice modification is required as it is just a note for future invoices, and do not request any data from the customer such as the entity number or invoice number if the modification is on their end.

ZATCA Authority Alerts – Error Codes and Customer Responses

مركز المساعدة

لم تجد ما تبحث عنه؟

شاهد ندوات قيود

تصفح تحديثات قيود

تواصل مع خدمة العملاء