Índice
- Objetivo
- Histórico de versão
- Regras de retorno
- Endpoint da api
- 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
-
URL de Produção Restrita:
https://api.receitafederal.gov.br/apuracao-cbs-prr/v2/rad/{cnpj}
-
URL de Produção:
https://api.receitafederal.gov.br/apuracao-cbs/v2/rad/{cnpj}
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 |
|---|---|---|---|
| cdRetorno | string | - |
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
- Substitua
$TOKENpelo valor deaccess_token. - 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"
]
}