nafiealhilaly / fast-fatoora

API to help generating QR-code for ZATCA's e-invoice known as "Fatoora" with any programming language

Hi 👋,

I'm Nafie Alhelaly نافع الهلالي

I'm a 😎 Software Engineer 😎 at Resal, I enjoy building softwares 🤓

• 🌱 I’m currently learning Unity / C# 🎮
• 📫 How to reach me [email protected]
• 📄 Know about my experiences https://www.linkedin.com/in/nafie-alhilaly/
• ⚡ Fun fact 'Nafie'|'نافع' is an Arabic name which means beneficial/useful/helpful person 🤗

fast-fatoora's Issues

ZATCA 2nd phase QR

We want to integrate zatca 2nd phase QR. Can you help us?

Query Regarding ZATCA E-Invoicing Integration

Issue 1: Inconsistency in E-Invoicing Statistics

After successfully integrating and following the official documentation provided by ZATCA, I have encountered an inconsistency in the e-invoicing statistics displayed on the Fatoora portal's simulation section. Despite receiving a "status":"PASS", "reportingStatus": "REPORTED" for submitted simplified invoices via the API endpoint "https://gw-fatoora.zatca.gov.sa/e-invoicing/simulation/invoices/reporting/single" and despite receiving a "status": "PASS", "clearanceStatus": "CLEARED" for standard invoices via "https://gw-fatoora.zatca.gov.sa/e-invoicing/simulation/invoices/clearance/single", the total count of submitted documents does not reflect accurately on the portal. This issue persists even after multiple checks over several days. Also, if I submitted and got a successful response from the API as the document is accepted and while checking on the Fatoora statistics page sometimes it is counted in rejected documents. Why is this mismatch happening? If I received REPORTED, CLEARED status with no error or warning messages, can I confirm that my document is submitted and accepted by ZATCA successfully? Please clarify this.

Issue 2: Lack of Clarity on Tax Amount Calculation

Additionally, I seek clarification on the calculation of the total tax amount payable to ZATCA for the submitted and accepted invoice documents. As there is no provision to retrieve this information from the ZATCA side, could you please confirm whether we need to calculate this amount internally based on the submitted invoices? For instance, if five invoices are successfully submitted and accepted, how do we determine the total tax amount owed to ZATCA?

Could someone please clarify these doubts?

Found typo in README.md