Guides

Tax Integration

Suggest Edits

For the cases in which Sensible is responsible for remitting US taxes on the purchase of a Weather Guarantee, tools are available to assess taxes on the cost of the Weather Guarantee so that the amount can be included in the charges sent to Sensible. In these cases, assessing taxes is a requirement before a quote can be accepted. VAT is always assessed automatically on quotes for Weather Guarantees in the EU + UK, with no further action to inform Sensible of the jurisdiction being required.

Taxes are assessed on the Weather Guarantee quote prior to acceptance, and require the customer's billing information.

📘

When the partner is the Merchant of Record and based in the US, the partner will assess and collect sales tax on the Weather Guarantee using their existing process.

API Integration

Partners can easily assess taxes on quotes by calling the Assess Taxes Guarantee Quote endpoint with the quote ID and billing address. 

curl --request PATCH \
  --url https://protect.sandbox.sensibleweather.io/api/v0_1/quote/guarantee/{{guaranteeQuoteID}}/assess-taxes \
  --header 'accept: application/json' \
  --header 'authorization: Bearer {{token}}' \
  --header 'content-type: application/json' \
  --data '
{
  "billing_address": {
    "address_line_1": "123 Main St",
    "city": "Los Angeles",
    "region": "CA",
    "postal_code": "90401",
    "country": "USA",
  }
}
'



import requests
import json

# Replace {{guaranteeQuoteID}} with your actual guarantee quote ID
guarantee_quote_id = "{{guaranteeQuoteID}}"
url = f"https://protect.sandbox.sensibleweather.io/api/v0_1/quote/guarantee/{guarantee_quote_id}/assess-taxes"

payload = json.dumps({
  "billing_address": {
    "postal_code": "90401",
    "country": "USA"
  }
})

headers = {
  'accept': 'application/json',
  'authorization': 'Bearer {{token}}',  # Replace {{token}} with your actual token
  'content-type': 'application/json'
}

response = requests.patch(url, headers=headers, data=payload)

If the request is successful, the response will include the entire quote object with the following fields:

{
  "tax_amount": 7.24,
  "tax_rate": 0.1025,
  "tax_was_assessed": true
}

Requests to the Assess Taxes Guarantee Quote when the partner is Merchant of Record will not assess taxes on the quote.

SDK and Widget Integrations

Partners utilizing the SDK or Widget for quoting will need to make a request to the Assess Taxes Guarantee Quote API following the above steps.

Addon Integration

Because the Addon fully handles the checkout process, it also handles all tax assessment and collection. Partners do not need to take any additional steps as it pertains to taxes when using the Addon integration.

Updated 4 months ago