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

Português

1. Quando se aplica

Evento	Operações	Adquirente (`buyer`)	Prazo
D-2241	Serviços remunerados por preço prestados a credenciados (estabelecimentos) ou destinatários	O estabelecimento credenciado ou o destinatário do serviço	5 dias após cada bloco de 5 dias
D-2242	Serviços remunerados por preço entre participantes do arranjo	O outro participante (instituidor, emissor ou credenciador)	5 dias após cada bloco de 5 dias

A antecipação de recebíveis de arranjos (remunerada por margem) não entra aqui: é D-2221, veja a guia de crédito e antecipação.

2. codBC

codBC	Descrição	Evento
2405 / 2410	A credenciados ou destinatários, cartões de débito e crédito	D-2241
2415 / 2420	A credenciados ou destinatários, cartões de benefícios (VA, VR e VT)	D-2241
2425 / 2430	A credenciados ou destinatários, outros arranjos	D-2241
2435 / 2440	Entre participantes, cartões de débito e crédito	D-2242
2445 / 2450	Entre participantes, cartões de benefícios (VA, VR e VT)	D-2242
2455 / 2460	Entre participantes, outros arranjos	D-2242

Nos pares, o primeiro código é com incidência de ISS e o segundo sem.

3. Campos específicos

Campo DeRE	Evento	Envio na API
`vLiqOper` (valor líquido da operação)	D-2241, D-2242	`items[].amount`
`vISSQNProp` (ISS sobre a operação própria)	D-2241, D-2242	Tributo `ISS`
`vISSQNOutro` (ISS sobre operações de outros participantes do arranjo)	D-2241, D-2242	Tributo `ISS Outro`
`vPisCofins`	D-2241, D-2242	Tributos `PIS` + `COFINS`
`vBCApur` = `vLiqOper` − (`vISSQNProp` + `vISSQNOutro` + `vPisCofins`)	D-2241, D-2242	`taxable_amount` das linhas de IBS e CBS
`tpParticip` (1 instituidor/bandeira, 2 emissor, 3 credenciador): papel da sua empresa no arranjo	D-2242	`items[].categories[]` com `list` = `"DeRE tpParticip"`. Sem a categoria, vale a categoria padrão da empresa declarante.

D-2241 e D-2242 não têm destinatário separado nem ponto de venda: não envie beneficiaries[] nem senders[].

4. Exemplo: D-2241

MDR cobrado de um estabelecimento credenciado, cartões de débito e crédito, com ISS (codBC 2405).

{
  "transaction_owner_company_id": "b52692d8-6dde-49b2-ad58-b8cc068c1b80",
  "transaction_external_id": "MDR-2026-10-09-000451",
  "invoice_date": "2026-10-09T15:42:44.847Z",
  "currency": "BRL",
  "type": "sale",
  "status": "completed",
  "use_tax_engine": false,
  "buyer": {
    "name": "LOJA EXEMPLO LTDA",
    "type": "business",
    "address": { "country": "BR", "state": "BR-SP", "city": "Sao Paulo", "municipality_code": "3550308" },
    "tax_registrations": [ { "number": "05577323000138", "type": "CNPJ", "level": "country", "location": "BR" } ]
  },
  "items": [
    {
      "name": "MDR cartões",
      "amount": 10000,
      "categories": [ { "list": "DeRE type", "code": "DeRE" } ],
      "taxes": [
        { "name": "ISS", "type": "ISS", "level": "country", "location": "BR", "rate": 0.02, "rate_type": "percentage", "taxable_amount": 10000, "amount": 200, "adds_to_final_amount": false },
        { "name": "ISS Outro", "type": "ISS", "level": "country", "location": "BR", "rate": 0.02, "rate_type": "percentage", "taxable_amount": 10000, "amount": 200, "adds_to_final_amount": false },
        { "name": "PIS", "type": "PIS", "level": "country", "location": "BR", "rate": 0.0065, "rate_type": "percentage", "taxable_amount": 10000, "amount": 65, "adds_to_final_amount": false },
        { "name": "COFINS", "type": "COFINS", "level": "country", "location": "BR", "rate": 0.03, "rate_type": "percentage", "taxable_amount": 10000, "amount": 300, "adds_to_final_amount": false },
        { "name": "IBS", "type": "VAT", "code": "2405", "level": "state", "location": "BR", "rate": 0.001, "rate_type": "percentage", "taxable_amount": 9235, "amount": 9.24, "adds_to_final_amount": false },
        { "name": "IBS", "type": "VAT", "code": "2405", "level": "municipality", "location": "BR", "rate": 0.001, "rate_type": "percentage", "taxable_amount": 9235, "amount": 9.24, "adds_to_final_amount": false },
        { "name": "CBS", "type": "VAT", "code": "2405", "level": "country", "location": "BR", "rate": 0.009, "rate_type": "percentage", "taxable_amount": 9235, "amount": 83.12, "adds_to_final_amount": false }
      ]
    }
  ]
}

Base: 10.000 − (200 + 200 + 65 + 300) = 9.235.

5. Exemplo: D-2242

Tarifa cobrada pelo emissor a um credenciador, cartões de débito e crédito, com ISS (codBC 2435). Em relação ao exemplo anterior, o buyer é o credenciador, as linhas de IBS e CBS levam code = 2435 e o item informa o papel da sua empresa:

"categories": [
  { "list": "DeRE type", "code": "DeRE" },
  { "list": "DeRE tpParticip", "code": "2" }
]

English

1. When it applies

Event	Operations	Buyer (`buyer`)	Deadline
D-2241	Services paid by price to accredited merchants or service recipients	The accredited merchant or the service recipient	5 days after each 5-day block
D-2242	Services paid by price between arrangement participants	The other participant (scheme owner, issuer or acquirer)	5 days after each 5-day block

Receivables advances in arrangements (paid by margin) are not covered here: they go to D-2221, see the credit and receivables guide.

2. codBC

See the codBC table in section 2 of the Portuguese version. In each pair, the first code is with ISS and the second without.

3. Specific fields

DeRE field	Event	API field
`vLiqOper` (net operation value)	D-2241, D-2242	`items[].amount`
`vISSQNProp` (ISS on the company's own operation)	D-2241, D-2242	`ISS` tax
`vISSQNOutro` (ISS on operations of other arrangement participants)	D-2241, D-2242	`ISS Outro` tax
`vPisCofins`	D-2241, D-2242	`PIS` + `COFINS` taxes
`vBCApur` = `vLiqOper` − (`vISSQNProp` + `vISSQNOutro` + `vPisCofins`)	D-2241, D-2242	`taxable_amount` of the IBS and CBS lines
`tpParticip` (1 scheme owner/brand, 2 issuer, 3 acquirer): your company's role in the arrangement	D-2242	`items[].categories[]` with `list` = `"DeRE tpParticip"`. Without the category, the declaring company's default category applies.

D-2241 and D-2242 have no separate recipient and no point of sale: do not send beneficiaries[] or senders[].

4. Example: D-2241

See the JSON in section 4 of the Portuguese version. MDR charged to an accredited merchant (codBC 2405). Base: 10,000 − (200 + 200 + 65 + 300) = 9,235.

5. Example: D-2242

See the snippet in section 5 of the Portuguese version. Fee charged by the issuer to an acquirer (codBC 2435), with tpParticip = 2 (issuer).