POST v2/TaxCalculation

Returns applicable taxes for the Catalog Items in the body of the call. Only valid for Tax Exclusive locations, which apply taxes in addition to the selling price.

Information:

Base URL:

https://api.covasoft.net/taxes

Request Information

URI Parameters

None.

Body Parameters

The Catalog Items you want to get the Taxes for see above for Example

TEPTaxCalculationRequest

Name	Type	Additional information
CompanyId	integer	None.
EntityId	integer	None.
LineItems	Collection of LineItem	None.

Request Formats

application/json, text/json

Sample:

{
  "CompanyId": 1,
  "EntityId": 2,
  "LineItems": [
    {
      "LineNumber": 1,
      "ProductCatalogId": "af800a30-d052-45dd-9c4d-4342a031ab15",
      "Quantity": 3.1,
      "Price": 4.1,
      "BasePriceListPrice": 5.1
    },
    {
      "LineNumber": 1,
      "ProductCatalogId": "af800a30-d052-45dd-9c4d-4342a031ab15",
      "Quantity": 3.1,
      "Price": 4.1,
      "BasePriceListPrice": 5.1
    }
  ]
}

Response Information

Resource Description

The Taxes for the Catalog Items

TEPTaxCalculationResult

Name	Type	Additional information
Id	globally unique identifier	None.
SaleId	globally unique identifier	None.
CompanyId	integer	None.
EntityId	integer	None.
LineItems	Collection of TaxLineItem	None.
Status	string	None.
TaxCalculationDateUtc	date	None.
TaxTotals	Collection of TaxTotal	None.
TotalTaxAmount	decimal number	None.

Response Formats

application/json, text/json

Sample:

{
  "Id": "d5c14a44-4dc8-4f78-9da2-df77e5219d11",
  "SaleId": "57153a0a-4026-4f0f-9ea9-6ba846713e17",
  "CompanyId": 3,
  "EntityId": 4,
  "LineItems": [
    {
      "LineNumber": "sample string 1",
      "ProductCatalogId": "7f5f43e4-7126-4896-b58e-c940e00030e1",
      "Quantity": 3.1,
      "Price": 4.1,
      "Tax": 5.1,
      "UnroundedTax": 6.1,
      "Taxable": 7,
      "TaxDetails": [
        {
          "TaxId": "1ecd4dee-9cc9-4c7a-8894-f7ec7e396f97",
          "Rate": 2.1,
          "TaxName": "sample string 3",
          "Tax": 4.1,
          "Exemptions": {
            "Total": 1.1,
            "Details": [
              {
                "ExemptAmount": 1.1
              },
              {
                "ExemptAmount": 1.1
              }
            ]
          },
          "TaxAuthorityType": "sample string 5",
          "TaxType": "sample string 6",
          "Layer": 7
        },
        {
          "TaxId": "1ecd4dee-9cc9-4c7a-8894-f7ec7e396f97",
          "Rate": 2.1,
          "TaxName": "sample string 3",
          "Tax": 4.1,
          "Exemptions": {
            "Total": 1.1,
            "Details": [
              {
                "ExemptAmount": 1.1
              },
              {
                "ExemptAmount": 1.1
              }
            ]
          },
          "TaxAuthorityType": "sample string 5",
          "TaxType": "sample string 6",
          "Layer": 7
        }
      ]
    },
    {
      "LineNumber": "sample string 1",
      "ProductCatalogId": "7f5f43e4-7126-4896-b58e-c940e00030e1",
      "Quantity": 3.1,
      "Price": 4.1,
      "Tax": 5.1,
      "UnroundedTax": 6.1,
      "Taxable": 7,
      "TaxDetails": [
        {
          "TaxId": "1ecd4dee-9cc9-4c7a-8894-f7ec7e396f97",
          "Rate": 2.1,
          "TaxName": "sample string 3",
          "Tax": 4.1,
          "Exemptions": {
            "Total": 1.1,
            "Details": [
              {
                "ExemptAmount": 1.1
              },
              {
                "ExemptAmount": 1.1
              }
            ]
          },
          "TaxAuthorityType": "sample string 5",
          "TaxType": "sample string 6",
          "Layer": 7
        },
        {
          "TaxId": "1ecd4dee-9cc9-4c7a-8894-f7ec7e396f97",
          "Rate": 2.1,
          "TaxName": "sample string 3",
          "Tax": 4.1,
          "Exemptions": {
            "Total": 1.1,
            "Details": [
              {
                "ExemptAmount": 1.1
              },
              {
                "ExemptAmount": 1.1
              }
            ]
          },
          "TaxAuthorityType": "sample string 5",
          "TaxType": "sample string 6",
          "Layer": 7
        }
      ]
    }
  ],
  "Status": "sample string 5",
  "TaxCalculationDateUtc": "2025-06-30T22:02:01.7382841+00:00",
  "TaxTotals": [
    {
      "TaxId": "sample string 1",
      "TaxRateType": "sample string 2",
      "Rate": 3.1,
      "TaxName": "sample string 4",
      "TaxDisplayName": "sample string 5",
      "Tax": 6.1,
      "Taxable": 7.1
    },
    {
      "TaxId": "sample string 1",
      "TaxRateType": "sample string 2",
      "Rate": 3.1,
      "TaxName": "sample string 4",
      "TaxDisplayName": "sample string 5",
      "Tax": 6.1,
      "Taxable": 7.1
    }
  ],
  "TotalTaxAmount": 7.1
}