API de consultaEm produção

CND de Santana da Vargem: econômico e imóvel

Envie o CNPJ e receba da Prefeitura de Santana da Vargem (MG) a CND do econômico, do cadastro da empresa no município, ou a CND do imóvel, emitidas no portal Cidadão Web.

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

  1. 1

    Entrada

    cnpjcpftipo
  2. 2

    Fonte oficial

    Prefeitura de Santana da VargemCertidão Negativa (Cidadão Web)

  3. 3

    Saída

    JSON + PDF

  4. CobrançaSó consulta concluída

Você envia, você recebe

Formato da resposta. Contribuinte fictício.

Parâmetros

  • cnpjopcional

    A empresa; a tela da prefeitura pede o código do econômico, e a API parte do CNPJ.

  • cpfopcional

    O contribuinte pessoa. Envie um dos dois.

  • tipoopcional

    economico (padrão) ou imovel.

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.
acao_necessaria
Só no econômico, quando a inscrição é de outro titular: o que o cliente precisa corrigir.
acao_necessaria.codigo
Código da ação: registration_document_mismatch.
acao_necessaria.campos
Campos da entrada a corrigir.
acao_necessaria.mensagem
Explicação, com o documento impresso mascarado.
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.
documentos[].tipo_certidao
Nome da certidão emitida.
documentos[].numero_certidao
Número da certidão impresso no PDF.
documentos[].codigo_verificacao
Código de controle (16 caracteres) para validar no site da prefeitura.
documentos[].situacao
Situação da certidão no vocabulário do projeto.
documentos[].observacao
Frase de débitos da certidão ("Sem débitos pendentes...").
documentos[].nome
Nome / razão social impresso.
documentos[].inscricao
Código consultado (inscrição municipal, código do imóvel ou inscrição imobiliária).
documentos[].tipo_inscricao
Tipo do código: inscricao_municipal, codigo_imovel ou inscricao_imobiliaria.
documentos[].referencia
Linha de referência do cadastro (código - descrição).
documentos[].endereco
Endereço impresso (com CEP).
documentos[].documento_titular
CPF/CNPJ impresso no PDF, só dígitos.
documentos[].documento_confere
Se o documento impresso confere com o pedido (CNPJ pela raiz); null se o PDF não imprime.
documentos[].hora_emissao
Hora da emissão (HH:MM).
documentos[].emissao_portal
Data de emissão impressa na certidão (dd/mm/aaaa).
documentos[].valida_ate_portal
Validade como texto dd/mm/aaaa (lida ou calculada a partir do prazo da certidão).
documentos[].mensagem
Só na recusa: mensagem literal da prefeitura.
Tela de emissão da certidão negativa de econômico de Santana da Vargem no Cidadão Web
RespostaJSON
{"com_apontamentos": false,"certidao_emitida": true,"mensagem_orgao": "O econômico 54000339 está baixado.","documentos": [{"com_apontamento": false,"dias_de_validade": 90,"valida_ate": "2027-01-25T00:00:00","pdf_url": "https://…/certidao.pdf","texto_completo": "CERTIDÃO NEGATIVA DE DÉBITOS …","numero_documento": "11222333000181","tipo_certidao": "Certidão Negativa de Débitos do …","numero_certidao": "1234","codigo_verificacao": "A1B2C3D4E5F6G7H8","situacao": "negativa","observacao": "Sem débitos pendentes até a presente …","nome": "EMPRESA EXEMPLO LTDA","inscricao": "54000153","tipo_inscricao": "inscricao_municipal","referencia": "54000153 - COMÉRCIO VAREJISTA","endereco": "RUA EXEMPLO, 100 - CENTRO - CEP …","documento_titular": "11222333000181","documento_confere": true,"hora_emissao": "14:32","emissao_portal": "27/10/2026","valida_ate_portal": "25/01/2027","mensagem": "Não foi encontrado o imóvel para o …"}],"acao_necessaria": {"codigo": "registration_document_mismatch","campos": ["inscricao"],"mensagem": "O econômico 54000153 está em nome de …"}}

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

A página oficial da prefeitura oferece três caminhos: CND do imóvel, CND do econômico e validar CND emitida. Para a empresa, a certidão é a do econômico, o cadastro mobiliário do município.

A própria prefeitura apresenta a certidão como documento para licitações e negócios. A emissão roda no Cidadão Web, o portal de serviços que o município usa.

Perguntas frequentes

Preciso saber o código do econômico?

Não para a API: a Hath recebe o CNPJ.

Dá para validar a certidão?

Sim. A página da prefeitura tem o botão Validar CND Emitida.

E a certidão do imóvel?

Também sai pela API, com o tipo imovel.

API CND de Santana da Vargem (MG) na sua integração

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

Emitir a CND de Santana da Vargem 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.