Submit an invoice through the API

Submission is a single POST carrying the Base64-encoded Standard Business Document. Save the returned document ID to correlate later notifications.

If the Sovos API is unavailable, check the Sovos status page before resubmitting. Don't resubmit a document until you've confirmed it wasn't accepted — duplicate submissions will be treated as new invoices.

Submit the Base64-encoded SBD to /v1/documents with the required Authorization and x-correlationId headers.
JSON
POST /v1/documents Content-Type: application/json Authorization: Bearer {token} x-correlationId: {unique-value} { "data": "base64_encoded_SBD", "dataEncoding": "base64" }
```
POST /v1/documents
Content-Type: application/json
Authorization: Bearer {token}
x-correlationId: {unique-value}

{
  "data": "base64_encoded_SBD",
  "dataEncoding": "base64"
}
```
Base64-encode the complete SBD (SBDH + invoice body) before submitting. Use standard Base64 encoding without line breaks.
Confirm that the API returns HTTP 202.
JSON
{ "timestamp": 1605282724079, "status": 202, "success": true, "message": "Document Received", "data": { "documentId": "DOCUMENT-ID" } }
```
{
  "timestamp": 1605282724079,
  "status": 202,
  "success": true,
  "message": "Document Received",
  "data": {
    "documentId": "DOCUMENT-ID"
  }
}
```
Save the returned documentId to correlate later notifications.

e-invoicing

e-invoicing

Submit an invoice through the API