Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cadanapay.com/llms.txt

Use this file to discover all available pages before exploring further.

The Global Tax Engine calculates payroll taxes across multiple countries through a single API. It handles country-specific regulations, tax brackets, deductions, and employer contributions — so you don’t have to build and maintain tax logic for each market.

​
Key Capabilities

Multi-Jurisdiction

Tax calculations across countries and regions, with support for state-level rules.

Bi-Directional

Calculate gross-to-net or net-to-gross for compensation planning.

Transparent Breakdowns

Step-by-step calculation details showing exact formulas, brackets, and rates applied.

Always Current

Tax tables and regulations are kept up to date automatically.

​
How It Works

1

Check location support

Verify which countries and regions are available.
2

Create a person

Create a person with their address, salary, and country-specific tax fields.
3

Calculate taxes

Submit salary details and receive a full breakdown of deductions and contributions.

​
Example Response

A tax calculation for a Brazilian employee earning R$10,000/month: 
{
  "personId": "per_01ABC...",
  "grossAmount": { "amount": 1000000, "currency": "BRL" },
  "netAmount": { "amount": 761244, "currency": "BRL" },
  "deductions": [
    {
      "name": "INSS (Instituto Nacional do Seguro Social)",
      "amount": { "amount": 82839, "currency": "BRL" }
    },
    {
      "name": "IRRF (Imposto de Renda Retido na Fonte)",
      "amount": { "amount": 155917, "currency": "BRL" }
    }
  ],
  "employerContributions": [
    {
      "name": "FGTS (Fundo de Garantia do Tempo de Serviço)",
      "amount": { "amount": 80000, "currency": "BRL" }
    }
  ]
}
The response includes employee deductions, employer contributions, and an optional summary field with step-by-step calculation details for each line item.
Amounts are in the lowest denomination of the currency. For BRL, 1000000 = R$10,000.00.

​
Getting Started

Integration Guide

Step-by-step guide to integrating the Tax Engine

Tax API Reference

Full API documentation

Statutory Compliance

File statutory returns and remit taxes to government authorities

Employment Cost Calculator

Quick gross-to-net salary estimates without creating a person