Índice

  1. Objetivo
  2. Histórico de versão
  3. Regras de retorno
  4. Endpoint da api
  5. Exemplos de retorno

Gerar DARF para Recolhimento de CBS como Adquirente

1. Objetivo

Gerar documento de arrecadação de CBS na condição de adquirente.

2. Histórico de versão

Data Versão Descrição
14/09/2026 1.0 Versão inicial

3. Regras de retorno

Não se aplica

4. Endpoint da api

4.1 Campos de Entrada

Campo Formato Descrição
cnpj String (8) CNPJ base do adquirente informado no path. Quando necessário, informar com zeros à esquerda.
body Array de Object Lista de solicitações de geração de DARF, uma por DF-e.
body[].chaveDFE String Chave DF-e utilizada para geração do documento de arrecadação.
body[].opcaoPagamento String Opção de pagamento para emissão do DARF. Valores possíveis: PAGAMENTO_PARCIAL e PAGAMENTO_TOTAL.
body[].valorDarfParcial Number Valor parcial do DARF, obrigatório quando opcaoPagamento = PAGAMENTO_PARCIAL

4.2 Header

Campo Formato Descrição
Authorization String Bearer <token de acesso>, informado na requisição.

4.3 Campos Retornados

Campo Tipo Formato Descrição
cdRetornostring- Código de retorno da operação:
DARF_GERADO = Documento fiscal encontrado, ainda não extinto e Darf gerado com sucesso
DFE_NAO_ENCONTRADO = Documento fiscal não encontrado ou não vinculado ao CNPJ requisitante
VALOR_PARCIAL_SUPERIOR_DFE = Valor informado para pagamento parcial é superior ao valor total do documento fiscal informado
CNPJ_NAO_ADQUIRENTE = CNPJ não é o adquirente da DF-e
DADOS_DE_ENTRADA_INVALIDOS = dados inválidos < lista de dados inválidos>
darf object - Grupo com dados de pagamento do DARF.
darf.cdPIX string - Chave PIX para pagamento.
darf.cdBarras string - Código de barras do DARF.
darf.linkPDF string url Link para download do PDF do DARF.
informacao object - Grupo com vencimento e valores.
informacao.dataMaximaPagamento date yyyy-mm-dd Data máxima para pagamento.
informacao.principal number (18,2) Valor principal.
informacao.total number (18,2) Valor total a pagar.

4.4 Acionar o endpoint

  1. Substitua $TOKEN pelo valor de access_token.
  2. Substitua {cnpj} pelo CNPJ base com 8 dígitos.

Método: POST

Exemplo de chamada (Produção Restrita)

curl --location --request POST 'https://api.receitafederal.gov.br/apuracao-cbs-prr/v2/rad/{cnpj}' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '[
    {"chaveDFE": "35260912345678000123550010000000011000000010",
    "opcaoPagamento": "PAGAMENTO_PARCIAL",
    "valorDarfParcial": 1500.75
    },
    {
    "chaveDFE": "35260912345678000123550010000000011000000011",
    "opcaoPagamento": "PAGAMENTO_PARCIAL",
    "valorDarfParcial": 500.00
     },
    {
    "chaveDFE": "35260912345678000123550010000000011000000012",
    "opcaoPagamento": "PAGAMENTO_TOTAL"
    }
  ]'

Exemplo de chamada (Pagamento parcial)

curl --location --request POST 'https://api.receitafederal.gov.br/apuracao-cbs-prr/v2/rad/12345678' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '[    
    {
    "chaveDFE": "35260912345678000123550010000000011000000011",
    "opcaoPagamento": "PAGAMENTO_PARCIAL",
    "valorDarfParcial": 500.00
     }
  ]'

Exemplo de retorno em caso de sucesso (HTTP 200)

{
  "cdRetorno": "DARF_GERADO",      
  "darf": {
    "cdPIX": "11111111111111111111111111111111111111111111",
    "cdBarras": "85870000001512345678901234567890123456789012",
    "linkPDF": "https://api.receitafederal.gov.br/darf/12345678901234567890123456789012345678901234.pdf"
  },
  "informacao": {
    "dataMaximaPagamento": "2026-09-30",
    "principal": 100.55,
    "total": 115.55
  }      
}

Exemplo de retorno em caso de erro (HTTP 400/401/404/500)

{
  "cdRetorno": "DADOS_DE_ENTRADA_INVALIDOS",
  "mensagem": "Dados de entrada inválidos.",
  "dadosInvalidos": [
    "chaveDFE",
    "opcaoPagamento",
    "valorDarfParcial"
  ]
}