API de consultaEm produção

CND de Itu: pelo portal da dívida ativa

Envie o CNPJ, o CPF ou o cadastro e receba da Prefeitura de Itu a certidão negativa de débitos, emitida no portal da dívida ativa do município, com a rota de validação.

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

  1. 1

    Entrada

    cnpjcpfcadastro
  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

    A empresa.

  • cpfopcional

    Pessoa física.

  • cadastroopcional

    O número do cadastro municipal. Envie um dos três.

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
CPF/CNPJ consultado, só dígitos.
resultados
Resultado de cada cadastro processado (sem o documento).
resultados[].resultados[].inscricao
Inscrição do cadastro.
resultados[].resultados[].origem
Tipo do cadastro (Mobiliário/Imobiliário).
resultados[].resultados[].resultado
EMITIDA, NAO EMITIDA ou ERRO.
resultados[].resultados[].certidao
Código da certidão emitida (só EMITIDA).
resultados[].resultados[].documento_diferente
Se a certidão saiu em nome de outro CPF/CNPJ vinculado (só EMITIDA).
resultados[].resultados[].mensagem
Mensagem do bloqueio (só NAO EMITIDA).
resultados[].resultados[].erro
Erro técnico do cadastro (só ERRO).
cadastros
Cadastros vinculados ao CPF/CNPJ (origem, inscrição, endereço); com listar=true é o único retorno.
cadastros[].cadastros[].origem
Tipo do cadastro.
cadastros[].cadastros[].inscricao
Inscrição do cadastro.
cadastros[].cadastros[].endereco
Endereço do cadastro.
resultado
Só sem cadastro ou na listagem: NAO ENCONTRADO ou LISTA.
mensagem
Só no NAO ENCONTRADO: mensagem do portal.
documentos[].tipo_certidao
Título da certidão.
documentos[].situacao
Situação da certidão; positiva_restrita quando o cadastro está bloqueado (NAO EMITIDA).
documentos[].numero_certidao
Código da certidão (20 caracteres).
documentos[].codigo_verificacao
Código para validação impresso no PDF.
documentos[].especie_certidao
Tipo da certidão na grade do portal.
documentos[].tipo_cadastro
mobiliario ou imobiliario.
documentos[].codigo_cadastro
Código Cadastro impresso.
documentos[].razao_social
Contribuinte impresso na certidão.
documentos[].documento_titular
CPF/CNPJ impresso na certidão.
documentos[].vinculo
Vínculo do contribuinte com o cadastro.
documentos[].situacao_cadastro
Situação do cadastro impressa.
documentos[].emissao
Hora e dia da emissão impressos.
documentos[].documento_confere
Se o CPF/CNPJ impresso é o pesquisado (false = outro documento vinculado).
documentos[].reaproveitada
Se reaproveitou certidão válida existente em vez de emitir nova.
documentos[].grade_certidoes
Certidões do cadastro listadas no portal.
grade_certidoes[].grade_certidoes[].codigo
Código da certidão.
grade_certidoes[].grade_certidoes[].data_emissao
Data de emissão.
grade_certidoes[].grade_certidoes[].data_validade
Data de validade.
grade_certidoes[].grade_certidoes[].tipo
Tipo da certidão.
documentos[].origem
Tipo do cadastro como o portal escreve.
documentos[].inscricao
Inscrição do cadastro.
documentos[].endereco
Endereço do cadastro.
documentos[].contribuintes
Contribuintes do cadastro (nome, vínculo).
contribuintes[].contribuintes[].nome
Nome do contribuinte.
contribuintes[].contribuintes[].vinculo
Vínculo com o cadastro.
documentos[].url_cadastro
URL da página do cadastro no portal.
documentos[].emissao_portal
Data de emissão (dd/mm/aaaa).
documentos[].valida_ate_portal
Validade impressa (dd/mm/aaaa).
documentos[].motivo
Só NAO EMITIDA: bloqueio_cada.
documentos[].mensagem
Só NAO EMITIDA: texto do bloqueio do portal.
Tela Emissão de Certidão do portal da dívida ativa de Itu, com tipo de pesquisa, número e verificação
RespostaJSON
{"com_apontamentos": false,"certidao_emitida": true,"mensagem_orgao": "Mobiliário 0054740: EMITIDA","documentos": [{"com_apontamento": false,"dias_de_validade": 90,"valida_ate": "2026-11-26T00:00:00","pdf_url": "https://…/certidao.pdf","texto_completo": "CERTIDÃO NEGATIVA DE DÉBITOS ...","numero_documento": "12345678000190","tipo_certidao": "CERTIDÃO NEGATIVA DE DÉBITOS","situacao": "negativa","numero_certidao": "ABCD1234EFGH5678IJKL","codigo_verificacao": "ABCD1234EFGH5678IJKL","especie_certidao": "Negativa","tipo_cadastro": "mobiliario","codigo_cadastro": "112233","razao_social": "EMPRESA EXEMPLO LTDA","documento_titular": "12.345.678/0001-90","vinculo": "Razão social","situacao_cadastro": "ATIVO","emissao": "10:15:32 do dia 27/10/2026","documento_confere": true,"reaproveitada": false,"grade_certidoes": [{"codigo": "ABCD1234EFGH5678IJKL","data_emissao": "27/10/2026 10:15","data_validade": "25/01/2027","tipo": "Negativa"}],"origem": "Mobiliário","inscricao": "0054740","endereco": "RUA EXEMPLO, 100 - CENTRO","contribuintes": [{"nome": "EMPRESA EXEMPLO LTDA","vinculo": "Razão social"}],"url_cadastro": "https://…/CertidaoPorCad…ro.aspx","emissao_portal": "27/10/2026","valida_ate_portal": "25/01/2027","motivo": "bloqueio_cada","mensagem": "Está certidão não pode ser emitida por …"}],"resultados": [{"resultados[]": {"inscricao": "0054740","origem": "Mobiliário","resultado": "EMITIDA","certidao": "ABCD1234EFGH5678IJKL","documento_diferente": false,"mensagem": "Está certidão não pode ser emitida por …","erro": "ItuError: PDF não baixado"}}],"cadastros": [{"cadastros[]": {"origem": "Mobiliário","inscricao": "0054740","endereco": "RUA EXEMPLO, 100 - CENTRO"}}],"resultado": "NAO ENCONTRADO","mensagem": "Número de CNPJ informado não retornou …","grade_certidoes": [{"grade_certidoes[]": {"codigo": "ABCD1234EFGH5678IJKL","data_emissao": "27/10/2026 10:15","data_validade": "25/01/2027","tipo": "Negativa"}}],"contribuintes": [{"contribuintes[]": {"nome": "EMPRESA EXEMPLO LTDA","vinculo": "Razão social"}}]}

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

Em Itu, a certidão negativa é emitida no portal da dívida ativa, mantido por empresa contratada pela prefeitura. A pesquisa pode ser por documento ou por cadastro, com um código de imagem antes de avançar.

Quando o portal está instável, o status volta como fonte indisponível e a Hath tenta de novo. O passo a passo manual está no guia da certidão municipal de Itu.

Perguntas frequentes

Dá para validar a certidão?

Sim, a integração tem a rota de validação.

Pesquisa pelo cadastro?

Sim, além de CNPJ e CPF.

E se o portal cair?

O status volta como fonte indisponível e a coleta é refeita.

API CND de Itu (SP) na sua integração

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

Emitir a CND de Itu 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.