API response
What should an API return after e-invoice submission?
Short answer
The response should be machine-readable and include the internal invoice ID, submission-attempt ID, the provider’s transaction ID, current status, timestamp, XML hash and any warnings or errors. For asynchronous submission, it must report that processing is pending rather than incorrectly claiming successful delivery.
ID
Invoice and attempt
Distinguish the document and specific send attempt.
Status
State of play
For example, accepted, queued, failed or delivered by mapping.
Hash
Binding XML
The answer should be linked to the exact content.
Errors
Codes and reports
The error is to be repairable, not mysterious.
Conclusion
The API response should be a usable integration and evidence record, not merely an acknowledgement that the HTTP request was accepted.
Sources
- Law No. 222/2004 Z. z. o VAT, § 76a
- Internal API documentation
- Partner Delivery Status
OpenPeppol Message Level Status 1.0
Not legal advice.