Taxes
The Taxes section (/taxes) manages the registry of rates and levies that can be linked to payables and receivables (withholdings/taxes on the document).
Fields
| Field | Description |
|---|---|
| Name | Tax identifier (e.g. "Employer INSS", "Municipal ISS") — unique per workspace |
| Default rate (%) | Suggested tax percentage |
| Withheld | Marks the tax as withholding. Default: yes |
| Active | Whether the tax appears for selection |
Usage
Registered taxes can be assigned as a charge to a payable or receivable — the document records which taxes apply to it.
note
Registering a tax is not paying a tax slip. To record the payment of a specific slip (DARF, GPS, GRU, FGTS…), use a payable with Document = Tax — see Tax / tribute in Payables.
API
The taxes resource is available in the Public API, with the finance.taxes (read) and finance.taxes.write (write) scopes.