QR Code Data For Simplified Tax Invoice ( Help )

I have laravel web app , i have tested standard tax invoices in sandbox zatca api , it is cleared successfully , now i am testing simplified tax invoice but i am getting QR validation error. i made QR as per documentation but i guess i am facing in last point which is : “the ECDSA signature of the cryptographic stamp’s issued by ZATCA’s technical CA”

when you will check below file you will noticed my all data is correct but in decoded data i am getting text ‘ZATCASignatureHere’ , i dont know how to generate it

Below file i am providing: Encoded data , QR Plain text , QR decoded data

File download : Unique Download Link | WeTransfer

kindly note that the Data in the sandbox portal is dummy data that should be used to understand the steps that need to be followed to ensure a successful onboarding. Therefore, you need to use either the simulation API endpoints if you aim to test your solution, or the core API endpoints to integrate with the production of Fatoora.

You can access the API end point in fatoora portal by navigating to API Documentation section

thank you , i am already testing on sandox and tested standard XML format encoded data , for simplified i am having issue , i guess my UBLExtensions tags data is really creating issue , since i am working on PHP so SDK is not useful for me , please provide me steps to create UBLExtensions tags data , for your information i already seen documents.

Dear @UnitedDev

The signing and QR code is mandatory only on simplified tax invoice, that is why your standard e invoices were being cleared successfully while the issue was related to simplified e invoices.

Since you are using your PHP application and don’t want to use our official E-invoicing SDK please review the below doc containing the steps in signing process which will be populating the UBL Extension tags.

SigningProcessUpdated.pdf (392.7 KB)

Thank you.

thanks i completed compliance , please can you help me in production onboarding

i am using sandbox account of zatca and using API Integration Sandbox, I have completed Compliance invoice API , but when i am using production Reporting API i am getting error , Please check if i am following the correct steps for production onboarding.

  1. I used ’ Production CSID ( Onboarding ) API. Click Here to see image

  2. I used ‘Reporting API’ : click here to see error i am getting


NOTE : I skipped the step ‘PRODUCTION CSID ( REVEWAL API )’

Hello @UnitedDev ,

Based on the error you have shared, kindly note that the VAT number on the Sandbox is always static that’s why the error will always appear if you use your own VAT.

Therefore, we would recommend using the simulation environment as a start to integrate successfully. Thus, follow the steps of the “Fatoora Portal User Manual” on the fatoora platform (https://fatoora.zatca.gov.sa/).

Kindly find the APIs_sim image that shows the correct APIs for simulation environment.

In order to get the solution onboarded either in a production or simulation environment with real data ( not static with sandbox) , you must have the credentials to access fatoora portal to obtain the OTP.

After following the previous steps, the validation process should pass successfully.

Do not hesitate to reach out our support team via below mail.

SP support mail: sp_support@zatca.gov.sa

Thanks,

1 Like