Announcing the launch of the Saudi Zatca-2 E-Invoicing app on FrappeCloud

New dashboard

I bench migrate but error remains still same.even after that I have pulled latest update as well.

what is the error ? send details.

We were missing this filed ( custom_ksa_einvoicing_xml ) on fixture. Now pushed . You can pull and migragte

Thank you very much. Now invoices are submitted.

New features added for inclusive tax. Now you can post invoices with tax included on the line

Added new feature of print PDF-A3 .
Please pull and update from our github repo.

How to use video Watch it here

1 Like

Hi @Support-at-ERPgulf

First and foremost, I want to extend my gratitude for the incredible app you’ve built. I do have a few concerns.

  1. In the Customer DocType, there are two fields:
    'Customer ID Type for Zatca ’ and 'Buyer ID type for Zatca '.
    Could you please provide guidance on configuring a regular customer in B2C scenarios?
    Should these fields be populated, and if so, what values should be used?
    Also for the B2B , Should i put the customer Vat Registeration number and CRN Number in customer doctype ?

  2. When I try to simulate on Fatoora Portal using the OTP I received, I encounter an Error in creating CSID: Error: OTP is not valid. {“errors”:[{“code”:“Invalid-OTP”,“message”:“The provided OTP is invalid”}]}.

Could you please advise on what might be going wrong? Additionally, here’s some more information about the CSR:
csr.common.name=TST-886431145-30110-----003
csr.serial.number=1-TST|2-TST|3-e4291a9a-6a13-9726-0b3f-9df5fad7
csr.organization.identifier=30110------003
csr.organization.unit.name=30110000----003
csr.organization.name=مؤسسة----قاولات
csr.country.name=SA
csr.invoice.type=1100
csr.location.address=حفر الباطن
csr.industry.business.category=Retail Services

Thank you

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 :slight_smile:
This CSR config looks correct. Make sure you created OTP from simulation portal and use it within 60 minutes.

1 Like

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.

1 Like

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:

  1. For ERP setup, should we configure:
  • One company with branches (outlets)?
  • Or separate companies for each CR?
  1. How can we ensure all outlets are correctly linked under one VAT, given the limitation of setting up one offline machine per location?
  2. 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.

  1. 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 )**

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

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

Ok, filled them up as well.

The error is reduced to this now:

fill it here also. Your version looks old. update .