Sovos.com
Contact SupportRetrieve invoices
Retrieve cleared invoices, process received documents, and handle errors when receiving inbound documents from Sovos.
Inbound invoices arrive through the same notification mechanism used for application responses. When another supplier sends you an invoice through Sovos, the invoice appears as a notification linked to the inbound product (my_invoice_inbound_1.0).
Retrieve notifications
Use the same polling or push mechanism described for outbound invoices.
GET https://api-test.sovos.com/v1/notifications/MY?processType=1&sourceSystemId={sourceSystemId}Use processType=1 to return inbound documents only. Continue polling until you receive SCICloudStatusCode: 209.
To retrieve the full document content, use the document ID from the notification on this request:
GET /v1/documents/{documentId}Process received documents
The received document is in the Malaysian UBL 2.1 format. Parse the XML to extract the invoice data. The Inland Revenue Board of Malaysia (IRBM) already embeds the UUID and QR code in the document.
After processing, make this request to acknowledge the notification:
PATCH /v1/notifications/{notificationId}
{
"isAcknowledged": true
}Handle errors and retries
| Scenario | Cause | Action |
|---|---|---|
| No notifications returned | No new documents or the filter parameters are incorrect. | Verify the ERP System ID and product assignment. |
| Document can't be parsed | Unexpected format or schema version. | Verify you are parsing the Malaysian UBL 2.1 format. |
| Duplicate notification | Previous acknowledgment failed or was not sent. | Acknowledge the notification. Deduplicate using the document ID. |