hi , need help on this please
Hi,
It looks like the issue may be related to the CSR or configuration. Please check the following:
- Make sure you are not using a sandbox CSR in production. Production requires a different certificate profile.
- Review your CSR config data and remove any Arabic or non-alpha characters, then test again.
- Verify that the VAT number is the correct one for production and not the sandbox VAT.
- When entering the OTP, ensure there are no leading or trailing whitespaces being passed.
Also, after entering OTP , save the doc before clicking next button.
Dear ERPGulf Support Team,
After the last ERPNext update on 23rd September, we are facing an issue with Simplified Tax Invoices. The system is only allowing us to save the invoice but not to submit
it.
Could you please check if this is related to the latest update and advise on the solution?
Trace ID
1ef8ae32-a6e5-4507-a7f3-cb6813d0d4b5
Best regards,
Send more details. like screen recording, or zatca resposne field details. etc.
? . pls send details
From where?
We are unable to reproduce this issue, others also dont have the same issue .
Your screen recording is not clear, you have not provided the field values etc. We will wait for any other user report the same problem.
Issue ZATCA regulations, Tax ID is required for customers in Saudi Arabia
When creating a Sales Invoice, the system only accepts “VAT Number” as the Customer ID Type. If we select any other option, such as CRN or 700, the invoice cannot be submitted.
This creates an issue because some of our customers do not have a VAT number but do have a commercial registration number (CRN) or another valid identification number.
Error Encountered:
When attempting to submit the invoice, the system shows an error message.
Steps to Reproduce:
- Create a new customer without a VAT number.
- Set the Customer ID Type to CRN (or 700).
- Create a Sales Invoice for this customer.
- Attempt to submit the invoice.
The invoice will not be submitted if the TAX ID is empty.
even if it is B2C.
I faced this problem just after updating ERPNEXT last week.
I recorded IQA number, in TAX ID.
We done the system as Tax ID is required only for B2B customers in Saudi Arabia, in accordance with ZATCA regulations. This means:
- B2B customers → Tax ID is mandatory if the customer’s address is in Saudi Arabia. Without it, the system will block invoice submission.
- **B2C customers ** → Tax ID is not mandatory, even if the customer is in Saudi Arabia. Invoices can be submitted without entering a Tax ID.
My practice for 5 days if the Tax ID is empty even for B2C the invoice will not be submitted , when I recorded IQA number in Tax Field the invoice submitted.
Note: this only start after I updated ERPNext in 23 sept.
are you using the main branch of code right?
Title: Update on ZATCA ERPGulf Based on New Regulation Updates
Post:
Here’s what we implemented in ZATCA ERPGulf for Sales Invoices and POS Invoices to ensure ZATCA compliance and proper handling of tax and customer data:Buyer ID Validation ZATCA requires that the Buyer ID field is only filled if the Buyer ID Type is specified.
- For B2C customers, Buyer ID is not mandatory. If the Buyer ID Type is blank, the Buyer ID field must also be blank.
- For B2B customers, Buyer ID and Buyer ID Type are mandatory. The system enforces that both fields must be filled.
- This validation ensures invoices do not contain incomplete or inconsistent customer identification information.
Intra-Company Transfer Handling These invoices are not submitted to ZATCA; they remain in ERPNext as normal submissions without generating XML or QR codes.
- We implemented logic that automatically detects when a company sells to itself (i.e., the Company Tax ID and Customer Tax ID are the same) and marks the invoice as an intra-company transfer.
- When the company and customer tax IDs match, the invoice’s ZATCA status and full response are updated accordingly:
- ZATCA Status: Intra-company transfer
- ZATCA Full Response: Intra-company transfer
This approach ensures that:
- B2C invoices can be submitted without requiring Buyer ID.
- B2B invoices comply with ZATCA rules and enforce proper customer identification.
- Intra-company transactions are correctly flagged internally while remaining aligned with ZATCA reporting requirements.
Compliance Check & Invoice Handling in ZATCA ERPGulf :
ZATCA no longer allows resubmission of the same invoice — an important change to maintain accurate tax reporting and prevent duplicate submissions.
What this means:
Compliance Corrections:
If an invoice needs correction, you cannot submit the same invoice again. You must create either:
• A duplicate invoice with corrected details
• A new invoice reflecting the updated information
warning: Error 509:
Attempting to resubmit the same invoice triggers error 509, preventing the submission.
Validation Visibility:
The system clearly shows the validation message to guide the user (as seen in the attached image).
Error in creating CSID:
“Error in creating CSID: Error: Issue with Certificate or OTP. Compliance transaction was submitted/generated before.”
• Certificate or OTP Issue: A problem with the digital certificate or One-Time Password (OTP) used for authentication
• Duplicate Submission: Occurs because the invoice has already been submitted or generated. The system rejects any repeat attempt to ensure compliance and prevent duplicate tax reporting
Why this matters:
• Ensures B2B and B2C invoices comply with ZATCA regulations
• Prevents duplicate tax reporting and potential penalties
• Maintains clean, accurate records while staying ZATCA-compliant
If it is a small business that does not have a VAT (tax) registration number and only has a commercial registration number, what should we do in this case?
And in the second case, if it is a government entity that only has the identifier number 700, what should we do?
- In the first case, if you don’t have a VAT (tax) registration number and only have a commercial registration number, then the invoice should be issued as a B2C customer.
- In the second case, do you have a VAT number?
NO ,Customer ID Type for ZATCA 700 only
I have two companies within the ERPNext system. One company sells to the other. Previously, the sales invoices were submitted to ZATCA without any issues. However, now I’m receiving the following error message:
Errors:
BR-CUSTOM-VALIDATION-01: [BR-CUSTOM-VALIDATION-01] - The Seller VAT registration number or seller group VAT registration number (BT-31) of the invoice must not match the buyer VAT registration number (BT-48).
Please guide me on the correct procedure to avoid this error when transactions occur between companies that share the same VAT registration number.
Thank you for your support. @Husna @Support-at-ERPgulf