API de consultaEm produção

Franca: a certidão sem login

Envie o CNPJ ou o CPF e receba da Prefeitura de Franca a certidão de débitos não inscritos em dívida, em PDF e com validade de três meses. Quando o portal recusa, a resposta diz se foi débito ou falta de cadastro.

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

  1. 1

    Entrada

    cnpjcpf
  2. 2
  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

    O contribuinte pessoa jurídica.

  • cpfopcional

    Envie CNPJ ou 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[].tipo_certidao
Título impresso ou o nome do serviço.
documentos[].modalidade
Tipo do documento (cnd, ficha, rol, valor-venal, validar).
documentos[].codigo_verificacao
Chave de validação XXXXX-XXXXX impressa.
documentos[].documento_impresso
CPF/CNPJ impresso no PDF.
documentos[].relatorio
Nome do relatório do site.
documentos[].arquivo_portal
Nome do arquivo gerado pelo site.
documentos[].situacao
negativa (o site só emite negativa) ou a da recusa.
documentos[].numero_certidao
Número/ano, novo a cada emissão.
documentos[].identificacao
Identificação do contribuinte impressa.
documentos[].numero_controle
Controle, fixo por contribuinte.
documentos[].emissao_portal
Emissão (dd/mm/aaaa, lida por extenso).
documentos[].valida_ate_portal
Validade impressa (3 meses).
documentos[].resultado_portal
Só na recusa: COM RESTRICOES, SEM CADASTRO ou NAO EMITIDA.
documentos[].mensagem
Só na recusa: texto literal do site.
documentos[].resposta_bruta_portal
Só na recusa: resposta bruta do site.
documentos[].numero_documento
CPF/CNPJ consultado, só dígitos.
Serviços OnLine de Franca com o menu de serviços e o formulário da Certidão de Débitos Não Inscritos em Dívida, com CPF ou CNPJ e o captcha borrado
RespostaJSON
{"com_apontamentos": false,"certidao_emitida": true,"mensagem_orgao": "Certidão emitida","documentos": [{"com_apontamento": false,"dias_de_validade": 120,"valida_ate": "2027-02-24T00:00:00","pdf_url": "https://…/certidao.pdf","texto_completo": "CERTIDÃO NEGATIVA ...","tipo_certidao": "CERTIDÃO NEGATIVA DE DÉBITOS","modalidade": "cnd","codigo_verificacao": "QQCMA-AOKVO","documento_impresso": "12.345.678/0001-90","relatorio": "CertidaoNegativadeDebito","arquivo_portal": "1234567.pdf","situacao": "negativa","numero_certidao": "12345/2026","identificacao": "778899","numero_controle": "445566","emissao_portal": "27/10/2026","valida_ate_portal": "27/01/2027","resultado_portal": "SEM CADASTRO","mensagem": "Nenhum cadastro foi encontrado.","resposta_bruta_portal": "false¬Nenhum cadastro foi encontrado.","numero_documento": "12345678000190"}]}

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

Sem pendência, o PDF sai na hora, com número novo a cada emissão. Com débito, o portal avisa que "foram detectadas restrições" e não emite: a resposta volta como positiva_restrita, com apontamento e sem PDF. Se o documento não tem cadastro em Franca, volta sem_inscricao_municipal, sem apontamento.

O formulário pede o texto de uma imagem, resolvido do lado da Hath. O mesmo portal tem a ficha da situação cadastral da empresa, o rol nominal mobiliário e a validação de documentos pela chave. O passo a passo manual está no guia da certidão municipal de Franca.

Perguntas frequentes

Quanto tempo vale?

Três meses a partir da emissão.

E se houver débito?

O portal não emite; volta positiva_restrita, sem PDF.

Precisa de inscrição municipal?

Não. Basta o CNPJ ou o CPF.

API Certidão de Débitos Não Inscritos em Dívida de Franca (SP) na sua integração

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

Emitir a certidão de Franca 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.