API de consultaEm produção

Ribeirão Preto: a CND pelo CNPJ

Envie o CNPJ (a inscrição municipal é opcional) e receba da Prefeitura de Ribeirão Preto a certidão negativa de débitos. Quando o portal não emite, a resposta diz o porquê: pendência, cadastro insuficiente ou dados que não conferem.

Acesso no mesmo dia, com crédito para testar · atualizado em 27 de outubro de 2026

  1. 1

    Entrada

    cnpjcpfinscricao
  2. 2

    Fonte oficial

    Prefeitura de Ribeirão PretoSecretaria da Fazenda, CND

  3. 3

    Saída

    JSON + PDF

  4. CobrançaSó consulta concluída

Você envia, você recebe

Formato da resposta. Empresa fictícia.

Parâmetros

  • cnpjopcional

    A inscrição é descoberta pela consulta oficial.

  • cpfopcional

    Envie CNPJ ou CPF.

  • inscricaoopcional

    Opcional no CNPJ, obrigatória no CPF.

Campos retornados

com_apontamentos
true quando a consulta encontrou algo que pede atenção (débito, processo, sanção).
certidao_emitida
Se o órgão emitiu o documento nesta consulta.
mensagem_orgao
A mensagem que o próprio portal devolveu, quando há.
documentos
Os documentos emitidos, um por item.
documentos[].com_apontamento
true quando este documento tem apontamento.
documentos[].dias_de_validade
Prazo de validade do documento, em dias.
documentos[].valida_ate
Data de validade, pronta para agendar a renovação.
documentos[].pdf_url
O documento emitido pelo órgão, guardado pela Hath.
documentos[].texto_completo
O texto integral do documento, extraído do PDF.
documentos[].numero_documento
Documento ou identificador consultado, só dígitos.
documentos[].situacao
Situação da CND ou da recusa.
documentos[].tipo_certidao
Título lido do PDF ou 'CND - Certidão Negativa de Débitos'.
documentos[].abrangencia
Título da tela (tributos cobertos).
documentos[].numero_certidao
Código de controle da certidão.
documentos[].codigo_verificacao
Código de controle (mesmo valor), chave da rota validate.
documentos[].inscricao
Inscrição municipal usada.
documentos[].inscricao_descoberta
Se a inscrição foi descoberta pelo CNPJ (não veio no pedido).
documentos[].razao_social
Empresa/contribuinte exibido.
documentos[].documento_impresso
CPF/CNPJ impresso pelo site.
documentos[].situacao_cadastral
Situação cadastral exibida.
documentos[].emitida_em
Data e hora de emissão (dd/mm/aaaa hh:mm).
documentos[].emissao_portal
Data de emissão (dd/mm/aaaa).
documentos[].valida_ate_portal
Validade (emissão + 180 dias).
documentos[].nome_arquivo_portal
Nome do arquivo PDF devolvido pelo site.
documentos[].resultado_portal
Motivo literal da recusa (PENDENCIA, CADASTRO INSUFICIENTE, DADOS NAO CONFEREM) ou NAO ENCONTRADO na consulta de inscrição.
documentos[].mensagem
Texto literal do site na recusa.
Tela da CND da Secretaria da Fazenda de Ribeirão Preto, com CPF ou CNPJ, inscrição municipal e a pesquisa de certidões pelo código
RespostaJSON
{"com_apontamentos": false,"certidao_emitida": true,"mensagem_orgao": null,"documentos": [{"com_apontamento": false,"dias_de_validade": 60,"valida_ate": "2026-12-26T00:00:00","pdf_url": "https://…/exemplo.pdf","texto_completo": "PREFEITURA ... CERTIDÃO NEGATIVA ...","numero_documento": "12345678000190","situacao": "negativa","tipo_certidao": "CND DE IPTU, ITBI, ISS, TAXAS …","abrangencia": "CND DE IPTU, ITBI, ISS, TAXAS …","numero_certidao": "4215959","codigo_verificacao": "4215959","inscricao": "1777101","inscricao_descoberta": true,"razao_social": "EMPRESA EXEMPLO LTDA","documento_impresso": "12.345.678/0001-90","situacao_cadastral": "Ativa","emitida_em": "20/10/2026 18:31","emissao_portal": "20/10/2026","valida_ate_portal": "18/04/2027","nome_arquivo_portal": "CND_4215959.pdf","resultado_portal": "PENDENCIA","mensagem": "CNPJ não encontrado. Verifique os dados!"}]}

Como o resultado chega

A mesma estrutura em qualquer órgão: um status classificado e, quando a fonte emite, o PDF oficial. Só a consulta concluída é cobrada; tentativa sem resultado não entra na conta.

  • Regular

    verde

    Nada consta na fonte.

  • Atenção

    amarelo

    Há registro que não impede, como débito parcelado ou suspenso. Vale ler o documento.

  • Com apontamentos

    vermelho

    Consta débito, sanção ou processo. O documento vem junto.

  • Sem resposta

    cinza

    A fonte não respondeu, o captcha falhou ou ficou fora deste ciclo. Vira reprocessamento, nunca um "nada consta" falso.

A entrega sai em JSON, CSV, XLSX ou XML, por API REST, webhook ou direto no seu ERP. Portal que muda de layout, adiciona captcha ou troca de sistema é conta nossa: você paga pela entrega, não pelo conserto.

Como ler o resultado

Ribeirão Preto não emite positiva pela internet. Com pendência, a resposta vem como positiva_restrita e com apontamento; com cadastro insuficiente, como nao_emitida, e a emissão fica só no atendimento presencial; e se o documento não bate com a inscrição, como dados_nao_conferem. Nos três casos a tela do portal volta guardada no lugar do PDF.

O mesmo portal emite a situação cadastral pelo CNPJ e confere uma certidão pelo código, na pesquisa de certidões. O passo a passo manual está no guia da certidão municipal de Ribeirão Preto.

Perguntas frequentes

Preciso saber a inscrição municipal?

No CNPJ, não: ela é descoberta pela consulta oficial. No CPF, sim.

Sai positiva?

Não pela internet; a resposta traz o motivo e a tela do portal.

Dá para validar uma certidão?

Sim, pelo código, na pesquisa de certidões.

API Certidão Negativa de Débitos de Ribeirão Preto (SP) na sua integração

Em produção. Acesso no mesmo dia, com crédito para testar.

Emitir a CND de Ribeirão Preto em lote

A coleta é feita em fonte pública oficial: a Hath Data não é a fonte e não certifica o conteúdo publicado pelo órgão. O serviço é prestado sob contrato, o cliente é o controlador dos dados e declara a finalidade; a Hath atua como operadora. Nomes de órgãos são citados apenas para identificar a fonte, sem vínculo ou endosso. Veja os termos de uso e a política de privacidade.