Avalara Developer Network Developer communications

Chapter 5.1 - CalcTaxes Request

The CalcTaxes Request

At the highest level, a CalcTaxes request is a JSON object comprised of the following:

Key Value
Company Data This object contains information about your company
Invoice This object contains information about the transaction
Override This object contains information about tax overrides you want to apply to the transaction (see note below)
Safe Harbor Override This object contains information about safe harbor overrides you want to apply to the transaction (see note below)


{
  "cmpn": {
      // Company Data 
  },
  "inv": [
    {
      // Invoice
    }
  ],
  "ovr": [
    {
      // Override
    }
  ],
  "sovr": [
    {
     // Safe Harbor Override
    }
  ]
}

Note

Although the CalcTaxes request gives the user the flexibility to input Override/Safe Harbor Override information for each transaction, we recommend using a Client Profile with a custom override file applied. This results in better performance from the Tax Engine because your override settings are cached before tax calculation begins.