Retrieve invoices
Retrieve invoices your suppliers send through the Pan-European Public Procurement On-Line (PEPPOL) network and understand each step Sovos takes to validate and deliver them to you.
The inbound flow covers invoices your suppliers send to you through the PEPPOL network. Sovos retrieves these on your behalf and delivers them using Compliance Network. The full three-step flow applies when both you and your supplier are registered United Arab Emirates (UAE) PEPPOL participants.
Before you begin
Make sure you've completed the following before retrieving invoices:
-
Your Sovos account and PEPPOL Participant ID are set up.
-
You have a valid OAuth 2.0 bearer token. See Generate API credentials.
How inbound invoices work
Sovos retrieves invoices your suppliers send through the PEPPOL network and delivers them to you through Compliance Network. The full three-step flow applies when both you and your supplier are registered UAE PEPPOL participants.
Three variations apply:
- Deemed supply
- The document validation and Tax Data Status (TDS) sharing with Federal Tax Authority (FTA) don't apply.
- International supplier not on PEPPOL
- The document doesn't flow to you through Sovos.
- International supplier on PEPPOL
- Sovos receives and delivers the document, but doesn't apply UAE-specific validation rules.
Key terms
- Message Disposition Notification (MDN)
- A confirmation message sent over the UAE e-invoicing network to acknowledge receipt of a document. The buyer's ASP sends an MDN to the Sovos (supplier) ASP after receiving the invoice. The FTA sends an MDN to the Sovos' or the buyer's ASP after receiving the business document.
- Message Level Status (MLS)
- A confirmation message sent over the UAE e-invoicing network to acknowledge receipt and validation of a document. The buyer's ASP sends an MLS to Sovos (supplier ASP) after validating the invoice. The FTA sends an MLS to the Sovos's or the buyer's ASP after validating the business document.
- PINT-AE
- [keyword keyref='peppol'] International Invoice for UAE.
Flow steps
- Step 1 - Sovos receives the document
-
The Sovos ASP receives the document from the supplier's ASP, sends an MDN acknowledgment, and validates the document against the UAE mandate rules.
The following table shows the possible outcomes and the action to take for each one:
Outcome Status Error code Action MDN shared, validation success RECEIVED- Prepare Tax Data Document (TDD) and deliver to Sovos . Positive MLS RECEIVED- - Negative MLS, validation failure FAILEDREJECTED_BY_MLSSupplier must correct and resubmit. The Sovos ASP submits the TDS to FTA. Negative MLS, Sovos not reachable FAILEDREJECTED_BY_MLSRetry. When validation succeeds, the Sovos ASP prepares a TDD and reports it to the FTA, then delivers the invoice to the Sovos Compliance Network. The FTA validates the submission against the UAE mandate and shares the document with the FTA data platform.
After the FTA confirms receipt, Sovos passes the invoice to the buyer and marks the tax authority reporting status as successful.
- Step 2 - Sovos ASP reports TDD to FTA
-
After validating the invoice, the Sovos ASP prepares and submits the TDD to the FTA ASP. The FTA validates the submission against the UAE mandate.
The following table shows the possible outcomes and the action to take for each one:
Outcome Status Error code Action Positive MDN REPORTED- - Positive MLS from FTA ASP DELIVERED- Complete. Negative MDN FAILEDTRANSMISSION_FAILEDRetry. Negative MLS from FTA ASP FAILEDVALIDATION_ERRORSupplier corrects the document and shares it with their ASP. The complete flow runs again. No MLS from FTA ASP DELIVERED- Retry. When the FTA confirms receipt, Sovos sets the tax authority reporting status to complete.
- Step 3 - Retrieve inbound invoices
-
Poll the inbound notifications endpoint using the Tax Registration Number (TRN) of your company to retrieve invoices that suppliers have sent to you.
GET /notifications/AE Authorization: Bearer {token} X-Company-TRN: {yourTRN}Sovos delivers the validated invoice document to you in the response.
Note:Sovos doesn't work with multiple lifecycle events for the same invoice.