E-Invoicing Invoice Export Errors
Problem
In the E-Invoicing addon module, an invoice does not export to the e-invoicing service, or it displays Error in the E-Invoicing Status column of the Invoice Management section at Addons > E-Invoicing.
Cause
This issue usually occurs for one of the following reasons:
- The invoice does not meet the eligibility requirements for export.
- The system has not yet successfully exported the client’s contact to the e-invoicing service.
- During the export, the e-invoicing service returned an error.
Troubleshooting
To confirm that the invoice is eligible for export, check the following requirements:
| Requirement | Eligible State |
|---|---|
| Invoice status | The invoice can use any invoice status that is not Draft. |
| Invoice total | The invoice’s total must be greater than zero. The addon module excludes zero-value invoices to meet EU compliance rules. |
| Invoice tax | The invoice must include a tax. |
| Client E-Invoicing | You have enabled E-Invoicing for the client. |
| Client data | The client’s data is complete, and the addon module has exported the client’s contact successfully. |
| Export status | The addon module has not already exported the invoice. It cannot re-export an invoice after it sends it. |
To find the specific reason for an export failure, go to Configuration () > System Logs and review the Activity Log for the invoice.
Solution
To resolve this issue, identify the cause and follow the appropriate steps:
The Client Contact Has Not Exported
Resolve the contact issue first. For steps to resolve this issue, see E-Invoicing Client Data Errors.
Authentication Error (401)
The license credentials are incorrect. For steps to resolve this issue, see E-Invoicing License Errors.
Validation Error (4xx)
The e-invoicing service rejected a value. The Activity Log names the value. Correct the invoice or client data, then retry.
Server Error (5xx) or Connection Error
The e-invoicing service is temporarily unavailable. The addon module retries automatically up to three times. Monitor the invoice status, or retry manually after the service recovers.
To retry an export manually, click Retry in the Invoice Management section at Addons > E-Invoicing. You can retry up to three times per hour. If you reach the limit, the system displays the following message:
You have exceeded the maximum number of retry attempts (3 per hour).
Wait an hour, then try again.
If validation errors continue after you correct all of the data, or if server errors continue for more than two hours, contact WHMCS Technical Support.
Last modified: 2026 September 17