Skip to main content

Tax / tribute

A payable whose document is a Tax / tribute stands for a federal, state or municipal tax form. In the form: Operation type = Document payment → Document = Tax / tribute (a tax is a document, not a "payment method" — see Operation and payment). The Tax type field decides which tax-form-specific fields you get.

Tax types​

Nine, as they appear in the "Tax type" picker:

TaxStructured tax form?
ITBI — Real Estate Transfer TaxNo
ICMS — Tax on the Circulation of Goods and ServicesNo
ISS — Service TaxNo
IPTU — Urban Property and Land TaxNo
FGTS — Severance Indemnity FundYes
DARE — State Revenue Collection DocumentNo
DARF — Federal Revenue Collection DocumentYes
GRU — Federal Collection GuideYes
GPS — Social Security GuideYes

How to enter the tax form​

Once the type is chosen, DARF, GRU, GPS and FGTS get a second field — "How to enter" — with two options:

  • Barcode (the default) — a single field: "Barcode / digitable line".
  • Guide fields — opens the structured sections of the document, described below.
note

The other five types don't get that choice. ICMS, ISS, IPTU, ITBI and DARE take the barcode only — the "How to enter" field never shows up for them.

Tax form fields​

Only in Guide fields mode, and only for the four types above. Each tax form is laid out in sections that mirror the official document.

DARF​

SectionFields
Taxpayer identificationTaxpayer type · Taxpayer CPF/CNPJ · Taxpayer name
Guide dataRevenue / payment code · Reference number · Calculation date · Due date
Charges and incomeFine · Interest · Gross income

DARF has the widest Taxpayer type list: CNPJ, CPF, NIT, PIS, PASEP, CEI, NB, Title no., DEBCAD and Reference.

GRU​

SectionFields
Due date and referenceDue date · Reference number · Total amount
Value adjustments (optional)Discount · Other deductions · Other additions · Fine · Interest

GPS​

SectionFields
Taxpayer identificationTaxpayer type · Taxpayer CPF/CNPJ · Taxpayer name
Guide dataRevenue / payment code · Competence · Due date · Other entities
Charges (optional)Monetary update · Fine · Interest

The GPS Taxpayer type list is shorter than the DARF one: CNPJ, CPF, NIT, PIS, PASEP and CEI.

FGTS​

SectionFields
IdentificationContributor code · PIS/PASEP number · Collection code
FGTS dataFGTS code · JAM percentage (%) · Connectivity seal

FGTS has no taxpayer section and no charges section — the codes are what identify it.

Sending through the Banking Gateway​

note

All nine types can be sent to the bank. Routing looks at the operation × document pair — "Document payment" + "Tax / tribute" resolves to the gateway's tax resource, whatever the tax type is. An IPTU entered as a barcode goes out just as well as a DARF.

What is exclusive to DARF, GRU, GPS and FGTS isn't the sending, it's the way you enter it: only they take the structured tax form. The rest travel on the barcode.

Sending is never automatic. Nothing leaves on its own: you click it — "Send to the bank" on the detail screen, or "Send payments" to dispatch a batch from the listing. See Sending to the bank and Lifecycle.