> ## 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.

# Overview

> Simplify global payroll tax calculations with a single API

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

<CardGroup cols={2}>
  <Card title="Multi-Jurisdiction" icon="globe">
    Tax calculations across countries and regions, with support for state-level rules.
  </Card>

  <Card title="Bi-Directional" icon="arrows-left-right">
    Calculate gross-to-net or net-to-gross for compensation planning.
  </Card>

  <Card title="Transparent Breakdowns" icon="list-check">
    Step-by-step calculation details showing exact formulas, brackets, and rates applied.
  </Card>

  <Card title="Always Current" icon="rotate">
    Tax tables and regulations are kept up to date automatically.
  </Card>
</CardGroup>

***

## How It Works

<Steps>
  <Step title="Check location support">
    Verify which countries and regions are available.
  </Step>

  <Step title="Create a person">
    Create a person with their address, salary, and country-specific tax fields.
  </Step>

  <Step title="Calculate taxes">
    Submit salary details and receive a full breakdown of deductions and contributions.
  </Step>
</Steps>

***

## Example Response

A tax calculation for a Brazilian employee earning R\$10,000/month:

```json theme={null}
{
  "personId": "81933bed-97ba-4477-81a7-b8c5ab507b6f",
  "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.

<Note>
  Amounts are in the **lowest denomination** of the currency. For BRL, `1000000` = R\$10,000.00.
</Note>

***

## Getting Started

<CardGroup cols={2}>
  <Card title="Integration Guide" icon="rocket" href="/tax/getting-started">
    Step-by-step guide to integrating the Tax Engine
  </Card>

  <Card title="Tax API Reference" icon="code" href="/api-reference/tax">
    Full API documentation
  </Card>

  <Card title="Statutory Compliance" icon="file-circle-check" href="/statutory/overview">
    File statutory returns and remit taxes to government authorities
  </Card>

  <Card title="Employment Cost Calculator" icon="calculator" href="/tax/getting-started#estimate-gross-or-net-salary">
    Quick gross-to-net salary estimates without creating a person
  </Card>
</CardGroup>