1- It was an error on labelling . First one is type, and second one is number . Now corrected. screenshot attached
For b2C customer , you dont need this.
but for medical , clinic , pharmacy etc, there is a tax exception for Saudi nationals. in that case only you need to fill this.
2- First of all, dont share your details on public forums 
This CSR config looks correct. Make sure you created OTP from simulation portal and use it within 60 minutes.
Thank you for the insights,
just one more thing , For B2B customers lets say company with vat number **300112233400003 **
this number is not a real vat number
then this is a correct mapping
| Field | Value | Notes |
|---|---|---|
| Tax ID Number (Standard Field) | 300112233400003 | not mandatory. |
| Customer ID Type for ZATCA | TIN | Required for compliance with ZATCA. |
| Buyer ID for ZATCA | 300112233400003 | Same as Tax ID (for validation consistency). |
and if correct , is there any additional info to include like crn and where i should put both values
Zatca needs only one , ie NAT, TIN, CRN etc. There is not place in XML to put both.
Thank you for your prompt answer and Happy New Year!.
I have a question regarding the configuration of multiple branches under ZATCA Phase 2.
Let’s assume Company “ABC” with VAT Number “345542580000003” operates several outlets, each with a unique CR number but sharing the same VAT.
| Outlet | CR Number | VAT Number |
|---|---|---|
| Main Company | 1234325678 | 345542580000003 |
| Outlet 1 | 3414123456 | 345542580000003 |
| Outlet 2 | 6789123456 | 345542580000003 |
| Outlet 3 | 9876123456 | 345542580000003 |
Since ZATCA allows one offline machine setup per outlet, and the process must be repeated for each machine at each location, I have a few questions:
I appreciate your guidance on the best way to handle this setup.
If 11th digit of VAT number is 1 , then its a group-VAT , other wise single.
** if 11th digit of above vat-id is 1 then csr.organization.unit.name should be 10 digit TIN )**
How can we ensure all outlets are correctly linked under one VAT, given the limitation of setting up one offline machine per location?
Check the new update , it has offline features. You need to integrate your POS machine accordingly
When creating sales invoices, how will the invoice be associated with a specific machine or outlet?
Check the new update , it has offline features. You need to integrate your POS machine accordingly
Hi,
We’ve installed the ZATCA ERP Gulf app in our Frappe Bench with ERPNext, and after setting up the ZATCA settings, we’re encountering the following error when trying to create and submit a sales invoice.
Could you please assist us in resolving this as soon as possible?
Thanks in advance for your help!
These errors are related to buyer VAT and address.
If you are submitting standard ( B2B ) , customer has to have VAT ID , and proper address. Like Building number 4 digit, ZIP/po-box 5 digits etc .
I’ve provided all the details in the address and provided the VAT number in the TAX ID field.
Here’s the Sales Invoice Screenshot:
Am I missing something?
Put address-line 2 also. and building number
Is this fine?
Now, only the main error remains:
“”“Your version looks old. update .”“”
→ I actually just installed the app few hrs ago `bench get-app GitHub - ERPGulf/zatca_erpgulf: Implementation of Zatca Phase-2 E-Invoicing - for FrappeCLoud"
But I still ran the update and ‘Already up to date’ as you can see:
bench migrate and restart . looks like fields not updated .
check you CR number is part of VAT group.
check you CR number is part of VAT group. and the same CRN entered as in the screenshot above.
I didn’t really get what you meant by this.
But I want to clarify around this point that, I’m trying to test the zatca settings with environment selected as sandbox, is it because of that, that it’s throwing such errors?
And the reason for it is because for every API call from CSR, CSID and Clearance we need to use the exact company details, customer details and the invoice details to get the success messages? And since I don’t have any of those in my erpnext the sandbox would keep throwing these errors? i.e. I need to send the exact invoice that’s in the sandbox portal to the API’s and only then it’ll send me the success message?
And the error it’s throwing to me to use the VAT that’s in the certificate is it that because for the sandbox environment it’s just hardcoded for those exact invoice, etc. details and since I’ve provided different values than in the sandbox portal it’s thowing that error?
Is my above understanding, correct?
For sandbox, use this CSR , use any CRN on company and Customer for testing. it should work.
csr.common.name=TST-886431145-399999999900003
csr.serial.number=1-TST|2-TST|3-ed22f1d8-e6a2-1118-9b58-d9a8f11e874f
csr.organization.identifier=399999999900003
csr.organization.unit.name=399999999900003
csr.organization.name=Test Company LTD
csr.country.name=SA
csr.invoice.type=1100
csr.location.address=RIYADH
csr.industry.business.category=Testing zatca
Hello,
I am facing this issue. currently my setup is in SIMULATION.
ERPNext: v15.48.4 (version-15)
Frappe Framework: v15.52.0 (version-15)
Zatca Erpgulf: v2.0.1 (main)
This while is I do compliance check of Invoices.
{"validationResults":{"infoMessages":[{"type":"INFO","code":"XSD_ZATCA_VALID","category":"XSD validation","message":"Complied with UBL 2.1 standards in line with ZATCA specifications","status":"PASS"}],"warningMessages":[{"type":"WARNING","code":"BR-KSA-63","category":"KSA","message":"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/","status":"WARNING"}],"errorMessages":[],"status":"WARNING"},"reportingStatus":null,"clearanceStatus":"CLEARED","qrSellertStatus":null,"qrBuyertStatus":null}
ERROR in clearance invoice, ZATCA validation: {"validationResults":{"infoMessages":[{"type":"INFO","code":"XSD_ZATCA_VALID","category":"XSD validation","message":"Complied with UBL 2.1 standards in line with ZATCA specifications","status":"PASS"}],"warningMessages":[{"type":"WARNING","code":"BR-KSA-63","category":"KSA","message":"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/","status":"WARNING"}],"errorMessages":[],"status":"WARNING"},"reportingStatus":null,"clearanceStatus":"CLEARED","qrSellertStatus":null,"qrBuyertStatus":null}
Error in Zatca invoice call: ERROR in clearance invoice, ZATCA validation: {"validationResults":{"infoMessages":[{"type":"INFO","code":"XSD_ZATCA_VALID","category":"XSD validation","message":"Complied with UBL 2.1 standards in line with ZATCA specifications","status":"PASS"}],"warningMessages":[{"type":"WARNING","code":"BR-KSA-63","category":"KSA","message":"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/","status":"WARNING"}],"errorMessages":[],"status":"WARNING"},"reportingStatus":null,"clearanceStatus":"CLEARED","qrSellertStatus":null,"qrBuyertStatus":null}
Any idea?