Tax Tutorials

How to calculate net and gross values for prices

You can calculate net and gross values for prices through the Calculating net and gross values for prices endpoint.

Before you start

Make sure you configured sales tax rates through the Emporix API Tax Service.

Convert a gross price to a net price

To calculate a price's net value based on its gross value, put the following data in the request body:

{
  "input": {
      "targetLocation": {
          "countryCode": "DE" // country code indicated in the Tax Service
      },
      "targetTaxClass": "STANDARD", // tax class code defined in the Tax Service
      "includesTax": true, // the original price is expressed as a gross value
      "price": "1.99" // gross value
  }
}

Then, send a request to the Calculating net and gross values for prices endpoint:

API Reference
curl -i -X PUT \
  'https://api.emporix.io/tax/{tenant}/taxes/calculation-commands' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "targetLocation": {
        "countryCode": "DE"
      },
      "targetTaxClass": "STANDARD",
      "includesTax": true,
      "price": 1.59
    }
  }'

The calculated net value is returned in the output.netPrice field.

Convert a net price to a gross price

To calculate a price's gross value based on its net value, put the following data in the request body:

{
  "input": {
      "targetLocation": {
          "countryCode": "DE" // country code indicated in the Tax Service
      },
      "targetTaxClass": "STANDARD", // tax class defined in the Tax Service
      "includesTax": false, // the original price is expressed as a net value
      "price": "1.99" // net value
  }
}

Then, send a request to the Calculating net and gross values for prices endpoint:

API Reference
curl -i -X PUT \
  'https://api.emporix.io/tax/{tenant}/taxes/calculation-commands' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "targetLocation": {
        "countryCode": "DE"
      },
      "targetTaxClass": "STANDARD",
      "includesTax": false,
      "price": "1.99"
    }
  }'

The calculated gross value is returned in the output.grossPrice field.

How to calculate gross values between countries

You can calculate a gross price in one country to a gross price in another country through the Calculating net and gross values for prices endpoint.

Before you start

Make sure you configured sales tax rates through the Emporix API Tax Service.

Calculate the price

To calculate a gross price between countries based on its applicable tax classes, put the following data in the request body:

{
  "input": {
      "sourceLocation": {
          "countryCode": "DE" // code of the country for which the original gross price is defined (indicated in the Tax Service)
      },
      "sourceTaxClass": "STANDARD", // tax class applied to the original gross price (defined in the Tax Service)
      "targetLocation": {
          "countryCode": "AT" // code of the country for which the gross price should be calculated (indicated in the Tax Service)
      },
      "targetTaxClass": "STANDARD", // tax class that should be applied to the calculated gross price (defined in the Tax Service)
      "includesTax": true, // the original price is expressed as a gross value
      "price": "1.99" // original gross price
  }
}

Then, send a request to the Calculating net and gross values for prices endpoint:

API Reference
curl -i -X PUT \
  'https://api.emporix.io/tax/{tenant}/taxes/calculation-commands' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "sourceLocation": {
        "countryCode": "DE"
      },
      "sourceTaxClass": "STANDARD",
      "targetLocation": {
        "countryCode": "AT"
      },
      "targetTaxClass": "STANDARD",
      "includesTax": true,
      "price": "1.99"
    }
  }'

The calculated gross price is returned in the output.grossPrice field.

Last updated

Was this helpful?