Learn how to configure outbound settings for invoice submission using Sovos.

1. Call the configuration endpoint using a POST request.

   Read more about the configuration API in the API reference.

   POST https://api-test.sovos.com/v2/configurations/organizations/{orgId}/settings
   Authorization: Bearer {accessToken}
   Content-Type: application/json
   

2. Your request must include the key parameters, according to your configuration.
   This example shows the setup for Type 1 and Type 2 (optional) certificates; use this configuration when you need offline invoice issuance capability. You must include both types in the same API call.

   Note:

   Use productId: "pl_Faktura__2.0 for outbound processing.

   {
     "TaxId": "[YOUR_TAX_ID]",
     "PartnerCredentials": {
       // Type 1 authentication certificate
       "CertificateCrtBase64": "[Base64 encoded certificate]",
       "CertificateCrtKeyBase64": "[Base64 encoded private key]",
       "CertificateCrtPassword": "YourPassword",
       
       // Type 2 offline certificate
       "CertificateOfflineBase64": "[Base64 encoded certificate]",
       "CertificateOfflineKeyBase64": "[Base64 encoded private key]",
       "CertificateOfflinePassword": "YourOfflinePassword"
     },
     "Scope": {
       "workspaceId": "[YOUR_WORKSPACE_ID]",
       "orgId": "[YOUR_ORG_ID]",
       "category": "PL_INV",
       "productId": "pl_Faktura__2.0",
       "taxId": "[YOUR_TAX_ID]"
     }
   }

Learn how to configure outbound settings for invoice polling using Sovos.

1. Call the configuration endpoint using a POST request.

   Read more about the configuration API in the API reference.

   POST https://api-test.sovos.com/v2/configurations/organizations/{orgId}/settings
   Authorization: Bearer {accessToken}
   Content-Type: application/json
   

2. Your request must include the key parameters, according to your configuration.
   This example shows the setup for Type 1 certificate. Configure the same Type 1 certificate for invoice status polling and retrieval.

   Note:

   Use pl_Faktura_Polling_2.0 for inbound processing.

   {
     "TaxId": "[YOUR_TAX_ID]",
     "PartnerCredentials": {
       // Type 1 authentication certificate
       "CertificateCrtBase64": "[Same Type 1 .crt as outbound]",
       "CertificateCrtKeyBase64": "[Same Type 1 .key as outbound]",
       "CertificateCrtPassword": "YourPassword"
     },
     "Scope": {
       "workspaceId": "[YOUR_WORKSPACE_ID]",
       "orgId": "[YOUR_ORG_ID]",
       "category": "PL_INV",
       "productId": "pl_Faktura_Polling_2.0",
       "taxId": "[YOUR_TAX_ID]"
     }
   }