Certidão Negativa de Débitos Federal conjunta

A API de CND Federal conjunta RFB/PGFN consulta a Certidão de Débitos Relativos a Créditos Tributários Federais e à Dívida Ativa da União. A operação aceita um CNPJ ou um CPF acompanhado da data de nascimento e preserva o tipo real retornado pela fonte:

• CND: Certidão Negativa de Débitos;
• CPEND: Certidão Positiva com Efeitos de Negativa;
• CPD: Certidão Positiva;
• impossibilidade funcional de emissão.

A consulta também está disponível na área autenticada do APP, com os mesmos preços e regras de cache e acesso aos comprovantes da API.

Custos

Os valores abaixo são o total de créditos por requisição, para um CNPJ ou CPF.

Uma resposta funcional e autoritativa sem CND, como CPD ou impossibilidade de emissão por pendências, é uma consulta processada: custa 3 créditos quando veio da fonte e 1 crédito quando reutilizada do cache curto. Falhas exclusivamente técnicas, sem resultado utilizável, não consomem créditos.

Crédito é a unidade de consumo do plano. Consulte o valor dos planos e a tabela de Consumo por consulta.

Entrada

Informe exatamente um documento por requisição.

Documentos inválidos, CPF sem nascimento, data futura e CPF mais CNPJ na mesma requisição são rejeitados antes da consulta à fonte e custam 0 créditos.

Idempotência e retries do cliente

Para uma operação que possa ser repetida após timeout de rede, envie o header opcional Idempotency-Key, com 8 a 128 caracteres ASCII visíveis. Reutilize a mesma chave somente para a mesma conta e os mesmos parâmetros normalizados.

• a primeira requisição executa o fluxo normal;
• uma repetição concluída recebe o resultado já registrado, sem nova cobrança nem consulta à fonte;
• se uma execução anterior ainda estiver pendente, a API responde 409 e não inicia outra operação;
• X-Request-Id e o request_id do corpo identificam a operação idempotente.

Estratégias de cache

SO_ONLINE e preferencia_emissao=nova são decisões diferentes. A primeira ignora o cache da SintegrAPI. A segunda também solicita à fonte a emissão de uma nova certidão.

Validade e origem

CND e CPEND com código e validade verificáveis ficam disponíveis até o fim do dia anterior à validade efetiva. Quando a fonte informa uma validade prorrogada posterior, ela passa a ser a validade efetiva. As datas são tratadas como datas civis brasileiras.

CPD, impossibilidade de emissão e outros resultados que podem mudar após uma regularização usam cache curto. Falha técnica, timeout, resposta inválida e indisponibilidade não são armazenados como resultado fiscal.

A resposta diferencia:

• issued_at: quando a certidão foi emitida;
• source_queried_at: quando a fonte foi consultada;
• served_at: quando a SintegrAPI entregou esta resposta;
• effective_validity: validade original ou prorrogada aplicável;
• valid_until: último dia em que aquela entrada pode ser servida pelo cache.

Assim, uma certidão encontrada no cache não é apresentada como se tivesse sido emitida novamente.

Consultar CND Federal

curl -G "https://api.sintegrapi.com.br/consultas/v2/certidao-negativa-de-debitos-federal" \
  --data-urlencode "cnpj=12.345.678/0001-95" \
  --data-urlencode "cache_strategy=CACHE_PREFERENCIAL" \
  --data-urlencode "preferencia_emissao=2via" \
  -H "x-api-key: SUA_API_KEY" \
  -H "Idempotency-Key: 4a27091f-56d0-49bf-9d73-a12dc7ab0123"

import requests

response = requests.get(
    'https://api.sintegrapi.com.br/consultas/v2/certidao-negativa-de-debitos-federal',
    params={
        'cpf': '52998224725',
        'data_nascimento': '19900102',
        'preferencia_emissao': '2via',
    },
    headers={'x-api-key': 'SUA_API_KEY'},
)
result = response.json()

Resposta de exemplo

{
  "certificate_type": "Positiva com efeitos de negativa",
  "certificate": "CERTIDÃO POSITIVA COM EFEITOS DE NEGATIVA DE DÉBITOS RELATIVOS AOS TRIBUTOS FEDERAIS E À DÍVIDA ATIVA DA UNIÃO",
  "certificate_code": "ABCD.1234.EFGH.5678",
  "cnpj": "12.345.678/0001-95",
  "corporate_name": "EMPRESA EXEMPLO LTDA",
  "status": "Válida",
  "issued_at": "2026-08-20",
  "validity": "2026-12-18",
  "effective_validity": "2026-12-18",
  "valid_until": "2026-12-17",
  "source_queried_at": "2026-08-20T10:15:00-03:00",
  "served_at": "2026-08-28T14:30:00-03:00",
  "source": "cache",
  "issued_successfully": true,
  "rfb_debts": true,
  "pgfn_debts": false,
  "receipt_type": "application/pdf",
  "receipt_verification_code": "ABCD.1234.EFGH.5678",
  "print": "https://api.sintegrapi.com.br/consultas/v2/certidao-negativa-de-debitos-federal/print/00000000-0000-0000-0000-000000000000",
  "provider_code": 200,
  "provider_billable": true,
  "provider_elapsed_time_in_milliseconds": 705,
  "billing": {
    "credits": 1,
    "source": "cache"
  },
  "request_id": "00000000-0000-0000-0000-000000000000",
  "success": true,
  "error": false,
  "error_message": {}
}

Campos principais da resposta

Códigos HTTP

Comprovante e privacidade

O comprovante indicado em print exige autenticação com uma API key da mesma conta que realizou a consulta. Não persista CPF e data de nascimento em logs próprios; armazene apenas os dados necessários e siga sua base legal e política de retenção.

Boas práticas

• use 2via como padrão para aumentar a chance de localizar uma certidão válida;
• use nova somente quando precisar explicitamente de nova emissão;
• conserve request_id, source_queried_at, issued_at e served_at juntos;
• trate CPEND como certidão válida, sem convertê-la para CND;
• verifique error antes de interpretar success;
• trate print como opcional e mantenha o processamento estruturado independente do arquivo;
• envie uma Idempotency-Key estável ao repetir a mesma operação após falha de transporte;
• não repita automaticamente chamadas online após timeout, pois uma emissão pode ter sido iniciada na fonte.

Integração com CRMs e ERPs

Integre a CND Federal conjunta da Receita Federal e da PGFN à homologação de fornecedores e ao acompanhamento de regularidade fiscal. A consulta aceita CNPJ ou CPF com data de nascimento e distingue o tipo de certidão retornado.

CND Federal no TOTVS Protheus, SAP e Oracle Fusion Cloud

Em projetos com TOTVS Protheus, TOTVS RM, SAP S/4HANA, SAP Business One, Oracle Fusion Cloud ou Sankhya, registre o documento consultado, o tipo real da certidão e a validade efetiva no cadastro ou processo documental. A partir desses dados, sua integração pode programar verificações e encaminhar resultados para aprovação.

Acompanhamento documental no Salesforce e Dynamics 365

No Salesforce, Microsoft Dynamics 365, HubSpot ou Zoho CRM, use o resultado em etapas de qualificação e revisão documental. success=false com error=false indica uma consulta concluída com resultado fiscal negativo, e não uma indisponibilidade. Considere o tipo da certidão no processo de aprovação.

A integração exige chamadas HTTPS e mapeamento desenvolvido para os recursos do sistema contratado. Proteja a API key e os dados pessoais, use Idempotency-Key nas repetições da mesma operação após timeout e valide o JSON Schema da resposta. Consulta online e nova emissão têm finalidades distintas, descritas nesta documentação.

JSON Schema da Resposta

O schema usa JSON Schema Draft 2020-12. Os campos de negócio podem ser omitidos ou nulos quando não há informação disponível ou quando ocorre um erro. Valide também success e error antes de atualizar o cadastro. Propriedades adicionais são aceitas para permitir evolução compatível. O schema descreve o corpo JSON; o código HTTP deve ser tratado separadamente.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "CND Federal conjunta RFB/PGFN — Resposta",
  "type": "object",
  "properties": {
    "request_id": { "type": "string", "format": "uuid" },
    "success": {
      "type": "boolean",
      "description": "Resultado funcional da consulta; avalie junto com error."
    },
    "error": {
      "type": "boolean",
      "description": "Indica falha técnica ou de validação."
    },
    "error_message": {
      "type": ["object", "null"],
      "properties": {
        "message": {
          "type": ["string", "null"],
          "description": "Mensagem pública da consulta."
        },
        "code": {
          "type": ["string", "null"],
          "description": "Código público, quando informado."
        }
      }
    },
    "certificate_type": {
      "type": ["string", "null"],
      "description": "Tipo real da certidão; pode indicar negativa, positiva com efeitos de negativa, positiva ou não emitida."
    },
    "certificate": { "type": ["string", "null"] },
    "certificate_code": { "type": ["string", "null"] },
    "cnpj": { "type": ["string", "null"] },
    "cnpj_status": { "type": ["string", "null"] },
    "cpf": { "type": ["string", "null"] },
    "name": { "type": ["string", "null"] },
    "corporate_name": { "type": ["string", "null"] },
    "status": { "type": ["string", "null"] },
    "description": { "type": ["string", "null"] },
    "message": { "type": ["string", "null"] },
    "notes": { "type": ["string", "null"] },
    "receipt_type": { "type": ["string", "null"] },
    "receipt_verification_code": { "type": ["string", "null"] },
    "issued_at": {
      "type": ["string", "null"],
      "description": "Data civil no formato YYYY-MM-DD.",
      "format": "date"
    },
    "validity": {
      "type": ["string", "null"],
      "description": "Data civil no formato YYYY-MM-DD.",
      "format": "date"
    },
    "extended_validity": {
      "type": ["string", "null"],
      "description": "Data civil no formato YYYY-MM-DD.",
      "format": "date"
    },
    "effective_validity": {
      "type": ["string", "null"],
      "description": "Data civil no formato YYYY-MM-DD.",
      "format": "date"
    },
    "valid_until": {
      "type": ["string", "null"],
      "description": "Data civil no formato YYYY-MM-DD.",
      "format": "date"
    },
    "source_queried_at": {
      "type": ["string", "null"],
      "description": "Data e hora com fuso horário.",
      "format": "date-time"
    },
    "served_at": {
      "type": ["string", "null"],
      "description": "Data e hora com fuso horário.",
      "format": "date-time"
    },
    "issued_successfully": { "type": ["boolean", "null"] },
    "rfb_debts": { "type": ["boolean", "null"] },
    "pgfn_debts": { "type": ["boolean", "null"] },
    "provider_billable": { "type": ["boolean", "null"] },
    "source": {
      "type": ["string", "null"],
      "description": "Origem do resultado. Pode estar vazia em erro técnico.",
      "enum": ["cache", "online", "", null]
    },
    "print": {
      "type": ["string", "null"],
      "description": "URL opcional de download autenticado do comprovante.",
      "format": "uri"
    },
    "provider_code": { "type": ["integer", "null"] },
    "provider_elapsed_time_in_milliseconds": {
      "type": ["integer", "null"],
      "minimum": 0
    },
    "billing": {
      "type": ["object", "null"],
      "properties": {
        "credits": {
          "type": "integer",
          "minimum": 0,
          "description": "Total consumido: 1 no cache, 3 online e 0 em falha técnica sem resultado utilizável."
        },
        "source": {
          "type": "string",
          "enum": ["cache", "online", ""],
          "description": "Origem comercial; vazia quando não há resultado utilizável."
        }
      }
    }
  },
  "required": ["request_id", "success", "error"],
  "additionalProperties": true
}