Campos comuns (cabeçalho, buyer, Batch API, Tax ID Validation): guia geral.

Português

1. Quando se aplica

Evento	Operações	Prazo
D-2231	Arrendamento mercantil operacional e financeiro: parcelas, alienação e valor residual	7 dias após cada bloco de 7 dias

2. codBC

O codBC depende do tipo de arrendamento, do que está sendo cobrado, do bem e de o arrendatário ser ou não contribuinte do IBS/CBS.

codBC	Descrição
1410 / 1420	Operacional, valor da parcela, bens imóveis (contribuintes / não contribuintes)
1430 / 1440	Operacional, valor da parcela, bens móveis (contribuintes / não contribuintes)
1450 / 1460	Operacional, valor da alienação, bens imóveis (contribuintes / não contribuintes)
1470 / 1480	Operacional, valor da alienação, bens móveis (contribuintes / não contribuintes)
1605 / 1610	Financeiro, valor da parcela, contribuintes (com ISS / sem ISS)
1615 / 1620	Financeiro, valor da parcela, não contribuintes (com ISS / sem ISS)
1630	Financeiro, valor residual, bens imóveis
1640	Financeiro, valor residual, bens móveis

A Tax ID Validation ajuda a confirmar o cadastro do arrendatário antes de escolher o codBC.

3. Campos específicos

Campo DeRE	codBC	Envio na API
`vBCApur` (base líquida da operação)	Todos, exceto 1615 e 1620	`taxable_amount` das linhas de IBS e CBS
`vOper` (parcela recebida, incluindo a tarifa vinculada ao contrato)	1615, 1620	`items[].amount`. As linhas de IBS levam `code`, `rate` = 0, `amount` = 0 e `taxable_amount` = `vOper`.
Número do contrato	Todos	`transaction_external_id` ou `items[].external_item_id`

D-2231 não tem destinatário nem ponto de venda: não envie beneficiaries[] nem senders[].

4. Exemplo: parcela de arrendamento financeiro, contribuinte

codBC 1605 (financeiro, parcela, contribuinte, com ISS).

{
  "transaction_owner_company_id": "b52692d8-6dde-49b2-ad58-b8cc068c1b80",
  "transaction_external_id": "LEASING-55821-PARC-07",
  "invoice_date": "2026-10-09T15:42:44.847Z",
  "currency": "BRL",
  "type": "sale",
  "status": "completed",
  "use_tax_engine": false,
  "buyer": {
    "name": "TRANSPORTES EXEMPLO LTDA",
    "type": "business",
    "address": { "country": "BR", "state": "BR-PR", "city": "Curitiba", "municipality_code": "4106902" },
    "tax_registrations": [ { "number": "12345678000195", "type": "CNPJ", "level": "country", "location": "BR" } ]
  },
  "items": [
    {
      "name": "Parcela 7/36 arrendamento de caminhão",
      "external_item_id": "LEASING-55821",
      "amount": 5000,
      "categories": [ { "list": "DeRE type", "code": "DeRE" } ],
      "taxes": [
        { "name": "ISS", "type": "ISS", "level": "country", "location": "BR", "rate": 0.05, "rate_type": "percentage", "taxable_amount": 5000, "amount": 250, "adds_to_final_amount": false },
        { "name": "PIS", "type": "PIS", "level": "country", "location": "BR", "rate": 0.0065, "rate_type": "percentage", "taxable_amount": 5000, "amount": 32.5, "adds_to_final_amount": false },
        { "name": "COFINS", "type": "COFINS", "level": "country", "location": "BR", "rate": 0.04, "rate_type": "percentage", "taxable_amount": 5000, "amount": 200, "adds_to_final_amount": false },
        { "name": "IBS", "type": "VAT", "code": "1605", "level": "state", "location": "BR", "rate": 0.001, "rate_type": "percentage", "taxable_amount": 4517.5, "amount": 4.52, "adds_to_final_amount": false },
        { "name": "IBS", "type": "VAT", "code": "1605", "level": "municipality", "location": "BR", "rate": 0.001, "rate_type": "percentage", "taxable_amount": 4517.5, "amount": 4.52, "adds_to_final_amount": false },
        { "name": "CBS", "type": "VAT", "code": "1605", "level": "country", "location": "BR", "rate": 0.009, "rate_type": "percentage", "taxable_amount": 4517.5, "amount": 40.66, "adds_to_final_amount": false }
      ]
    }
  ]
}

Base: 5.000 − (250 + 32,50 + 200) = 4.517,50.

5. Exemplo: parcela de arrendamento financeiro, não contribuinte

codBC 1620 (financeiro, parcela, não contribuinte, sem ISS). O valor informado é a parcela (vOper), não a base:

"items": [
  {
    "name": "Parcela 3/24 arrendamento de veículo",
    "external_item_id": "LEASING-70114",
    "amount": 1800,
    "categories": [ { "list": "DeRE type", "code": "DeRE" } ],
    "taxes": [
      { "name": "IBS", "type": "VAT", "code": "1620", "level": "state", "location": "BR", "rate": 0, "rate_type": "percentage", "taxable_amount": 1800, "amount": 0, "adds_to_final_amount": false },
      { "name": "IBS", "type": "VAT", "code": "1620", "level": "municipality", "location": "BR", "rate": 0, "rate_type": "percentage", "taxable_amount": 1800, "amount": 0, "adds_to_final_amount": false }
    ]
  }
]

English

1. When it applies

Event	Operations	Deadline
D-2231	Operating and finance leasing: installments, sale and residual value	7 days after each 7-day block

2. codBC

The codBC depends on the lease type, what is being charged, the asset and whether the lessee is an IBS/CBS taxpayer. See the table in section 2 of the Portuguese version.

Tax ID Validation helps confirm the lessee's registration before choosing the codBC.

3. Specific fields

DeRE field	codBC	API field
`vBCApur` (net base of the operation)	All except 1615 and 1620	`taxable_amount` of the IBS and CBS lines
`vOper` (installment received, including the contract fee)	1615, 1620	`items[].amount`. The IBS lines carry `code`, `rate` = 0, `amount` = 0 and `taxable_amount` = `vOper`.
Contract number	All	`transaction_external_id` or `items[].external_item_id`

D-2231 has no recipient and no point of sale: do not send beneficiaries[] or senders[].

4. Example: finance lease installment, taxpayer

See the JSON in section 4 of the Portuguese version. codBC 1605. Base: 5,000 − (250 + 32.50 + 200) = 4,517.50.

5. Example: finance lease installment, non-taxpayer

See the snippet in section 5 of the Portuguese version. codBC 1620: the reported value is the installment (vOper), not the base.