FIRS e-invoice flow

e-Invoice generation prerequisites

For an invoice to be generated, an item and a party need to be created.

Relevant API endpoints:

1. Create Party
2. Create Item

e-Invoice steps

1. Create Invoice
2. The Invoice Reference Number (IRN) is generated on DigiTax
   • This marks the invoice as DRAFT status
3. Validate invoice request is sent to FIRS E-Invoicing System
   • This marks the invoice as PENDING status
   • The QR code is generated
4. Submit invoice (called signing) request is sent to FIRS E-Invoicing System
   • This marks the invoice as COMPLETE
   • Invoice details are download-able from FIRS
5. The complete invoice is transmitted to the receiving party (if they have an endpoint registered)
6. The party accepts the complete invoice. It's marked accepted when the request is received by the receiving party.
7. Transmission is considered done 🎉

An invoice is marked FAILED if there's an error at step 3.