Skip to main content

Tax / tribute

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

Tax types

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

TaxStructured slip?
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 slip

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.

Slip fields

Only in Guide fields mode, and only for the four types above. Each slip 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.

Dispatch 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 slip. 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.