Set up a Custom Tax Endpoint

Overview

If you have specific tax requirements or use a system Foxy does not support natively, you can use a custom tax endpoint. It works like the custom shipping endpoint: Foxy sends a payload to your endpoint, and your endpoint returns the tax to apply. Common cases include pulling rates from an ERP or applying highly specific rates or thresholds.

How it works

Foxy sends a payload (mirroring the API format) to your endpoint for each relevant event, and your endpoint responds with the tax to apply. The events and the response format are documented in Custom tax endpoint reference.

Steps

1. 1

   Deploy an endpoint that accepts Foxy's request and returns a valid response. Foxy provides a starter function (see below).

2. 2

   Go to the Foxy admin, go to Settings > Integrations, and add a new integration with Provider set to Custom Tax Endpoint. Enter your endpoint URL, then click Create.

3. 3

   Go to Settings > Taxes and add a new tax. Enter a Name, set the Type to Custom tax endpoint, and click Create. Only the name and type are needed; the other fields are set automatically.

4. 4

   Apply the tax to your categories.

Starter code

Foxy provides a Netlify function code to help you get started. With a Netlify account, follow the readme in Foxy's Netlify functions repository (https://github.com/Foxy/foxy-node-netlify-functions) to deploy the example custom tax function and tailor it to your needs.