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:
Questions:
- For ERP setup, should we configure:
- One company with branches (outlets)?
- Or separate companies for each CR?
- How can we ensure all outlets are correctly linked under one VAT, given the limitation of setting up one offline machine per location?
- When creating sales invoices, how will the invoice be associated with a specific machine or outlet?
I appreciate your guidance on the best way to handle this setup.
- For ERP setup, should we configure:
- One company with branches (outlets)?
- Or separate companies for each CR?
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?
this issue explained in this forum already . Buyer needs proper address for standard invoices .
street name (BT-50), building number (KSA-18), postal code (BT-53), city (BT-52), District (KSA-4), country code (BT-55)
Thank you for your response. The error occurs not only for standard invoices but also for simplified invoices. I have already ensured that the address lines 1 and 2 are correctly entered as previously mentioned, but I’m still unsure where the issue lies. Do you have any screenshots that clearly indicate what needs to be entered in the mandatory fields?
Once the address for the buyer is added, it should be confirmed as the Customer’s Primary Address in the next step.
Now there is another message comes as below; does it mean I have to switch now to production to get qr-code
{"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":[],"errorMessages":[],"status":"PASS"},"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":[],"errorMessages":[],"status":"PASS"},"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":[],"errorMessages":[],"status":"PASS"},"reportingStatus":null,"clearanceStatus":"CLEARED","qrSellertStatus":null,"qrBuyertStatus":null}