Submit invoices to Sovos using the SBD format that has your Sovos Canonical Invoice (SCI).

1. Authenticate with OAuth 2.0.

   Get an access token before submitting documents. See API Authentication for details.

2. Build your invoice.

   Create your invoice in SCI format following UBL 2.1 structure. Include:

   • Invoice header with number, date, and currency
   • Supplier and customer party information
   • Line items with quantities, prices, and descriptions
   • Tax calculations and totals
   • Belgian-specific fields in SovosExtension
3. Wrap in Standard Business Document.

   Wrap your SCI in an SBD envelope with:

   • SBDH header with sender and receiver information
   • Product ID: BE_invoice_outbound_1.0
   • Your VAT number as sender identifier
   • Buyer's PEPPOL participant ID as receiver identifier
4. Submit to Sovos API.
   JSONCopy

   POST https://api.sovos.com/v2/documents Authorization: Bearer {access_token} Content-Type: application/xml <StandardBusinessDocument> <!-- Your complete SBD with SCI --> </StandardBusinessDocument>

   POST https://api.sovos.com/v2/documents
   Authorization: Bearer {access_token}
   Content-Type: application/xml
   
   <StandardBusinessDocument>
     <!-- Your complete SBD with SCI -->
   </StandardBusinessDocument>

5. Handle the response.

   Sovos returns HTTP 202 with a data ID on successful submission. Save this ID to track the document status.

   Other possible response codes:

   Response codes	Meaning
   202	Successfully accepted
   400	Validation error. Check error details
   401	Authentication failed
   403	Not authorized for this operation
   500	Server error. Retry with exponential backoff

6. Monitor transmission.

   Query the status API to confirm delivery:

   JSONCopy

   GET https://api.sovos.com/v2/documents/{transactionId}/status Authorization: Bearer {access_token}

   GET https://api.sovos.com/v2/documents/{transactionId}/status
   Authorization: Bearer {access_token}