Understanding the status lifecycle of a DigiTax Tanzania sale
Status lifecycle
Every invoice in DigiTax TZ progresses through a defined set of statuses as it moves from creation through EFDMS fiscalization:
| Status | Meaning |
|---|---|
PENDING | Invoice recorded in DigiTax; queued for submission to TRA's EFDMS. |
SUBMITTED | Transmitted to TRA EFDMS; awaiting confirmation. |
ISSUED | EFDMS has fiscalized the invoice; fiscal data (verification_code, verification_url, receipt_number, z_number) is available. |
FAILED | EFDMS rejected the submission; check the error response for the failure reason. |
What to do on FAILED
A FAILED status means TRA's EFDMS rejected the submission. Common causes:
- Invalid buyer TIN or VRN
- Counter sequence mismatch (managed by DigiTax automatically - contact support if this occurs)
- EFDMS connectivity issues (DigiTax retries automatically)
- Invalid tax category code
When an invoice fails, DigiTax includes diagnostic details in the error response. Review the error and, if the issue is in your data (e.g. invalid customer TIN), correct it and submit a new invoice.
Do not resubmit a FAILED invoice with the sametrader_invoice_numberCreate a new invoice with a new unique
trader_invoice_number. Reusing a failed invoice's number will result in a 409 Conflict error.
Checking status
Retrieve the invoice via GET /invoices/{invoice_id} or inspect full breakdowns via GET /invoices/{invoice_id}/detailed to check the current status and fiscal verification details.