Calculate Tax Rates Via Webhook

Overview

This workflow exposes a Tax Calculator API via a webhook endpoint. By sending POST requests to the webhook URL, you can query standard tax rates, retrieve current active rates, and set custom tax rates for various commodities such as Alcohol, Food, Literature, Transport, and more.

Supported Actions

How It Works

1. Webhook Trigger — The workflow starts when a POST request is received at the webhook URL.
2. Code Node — A code node processes the incoming payload, resolves the commodity, and performs the requested action (query or update). It returns the result as a JSON response.

If no valid action is provided, the workflow runs in demo mode and returns a set of sample results based on a predefined test scenario.

Supported Commodities

• Default
• Alcohol
• Food
• FoodServices
• Literature
• Transport
• CulturalServices

Example Payloads

1. Get Standard Tax Rate

{
  "action": "getStandardTaxRate",
  "commodity": "Alcohol"
}

2. Get Current Tax Rate

{
  "action": "getCurrentTaxRate",
  "commodity": "Food"
}

3. Set a Custom Tax Rate and Then Fetch It

You can batch multiple operations in a single request using the operations array:

{
  "operations": [
    { "action": "setCustomTaxRate", "commodity": "Literature", "rate": 0.08 },
    { "action": "getCurrentTaxRate", "commodity": "Literature" }
  ]
}

Standard Tax Rate Reference

Tips

• Custom rates override standard rates once set. The getCurrentTaxRate action automatically considers any custom rate that is active as of the current date and time.
• When setting a custom rate, you can optionally include a date field (ISO 8601 format) to specify when the rate should take effect.
• If you send a request without an action or operations field, the workflow will return demo results to help you understand the response format.