v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB

Tax

Preview jurisdiction tax amounts

Computes disbursement IOF tax amounts using the active compiled jurisdiction profile without persisting data.

post/api/v1/br/tax/preview

Request body

disbursementDatestring date-time required

Disbursement date (RFC3339).

finalDueDatestring date-time required

Final due date (RFC3339).

grossAmountstring required

Gross disbursement amount in major currency units (e.g. "100000.00").

jurisdictionCodestring required

ISO 3166-1 alpha-2 jurisdiction code (e.g. "BR").

netDeliveredAmountstring

Optional net delivered amount in major currency units.

taxRegimestring required

Tax regime selector understood by the jurisdiction tax engine.

Example request

{
  "disbursementDate": "2026-06-14T12:00:00Z",
  "finalDueDate": "2026-06-14T12:00:00Z",
  "grossAmount": "100000.00",
  "jurisdictionCode": "BR",
  "netDeliveredAmount": "99913.16"
}

Response

Example response

{
  "data": {
    "cofins": "30.00",
    "grossAmount": "100000.00",
    "iofAdditional": "38.00",
    "iofDaily": "12.34",
    "jurisdictionCode": "BR",
    "netDeliveredAmount": "99913.16",
    "pis": "6.50",
    "profileVersion": "1.0.0",
    "rateTableSnapshotId": "550e8400-e29b-41d4-a716-446655440002",
    "totalIof": "50.34",
    "totalTax": "86.84"
  }
}