Sovos Simple Connect API

An easy and reliable path to sales and use tax calculation.

Overview

What is the Sovos Simple Connect API?

The Sovos Simple Connect API for Accounts Payable (AP) and for Accounts Receivable (AR) provides an user-friendly, streamlined solution for leveraging Sovos’ powerful Global Tax Determination (GTD) engine, allowing users to calculate tax on sales invoices in real time. Sovos Simple Connect API is designed to solve the most common tax challenges for clients in small to mid-sized markets without the added complexity and upkeep of more customizable, option-laden APIs.

Postman Collection

This is a Postman Collection for previews in Sovos Simple Connect API.

For more details, read the Developer Guide Documentation.

Authentication Method

NOTE: This the default authentication method provided with the collection a is the one used for URLs with the /pre-auth prefix.

Users are required to provide an authentication string via the "Authorization" header. The value has the following format:

ACCESS_KEY:BASE64_DIGEST

BASE64_DIGEST is a base64 digest of a HMAC-256 hash generated with the concatenation of the timestamp and the ACCESS_KEY as the message and the SECRET_KEY as the secret passphrase.

The timestamp, that will be included in the generation of the authorization header and the x-request-date, is the current time in UTC in ISO 8601 format (yyyy-MM-ddTHH:mm:ss.SSSZ).

Environment

This collection requires a set of variables that are needed to authenticate each request through the Authorization and x-request-date header (these headers are generated by a pre-request script that comes with the collection). You will need to add values to each variable in a custom Environment.

Name	Description
`ACCESS_KEY`	Your consumer key
`SECRET_KEY`	Your consumer secret
`API_BASE_URL`	The URL of the server + `/api/pre-auth` for HMAC-based auth or `/api/basic-auth` for basic-based auth, without the triling forward slash, you want to reach

You can copy these values from the S1 portal.

To add these values to your Postman environment:

Select the ⚙️ icon next to the Sovos Simple Connect API environment name. If you don't have this environment created yet, create it or import it.

Select Sovos Simple Connect API.

For each variable, add the values from your S1 portal in the Current value column.

When you're done adding all values, click Update.

Postman will set up your requests to be authenticated using these environment variables.