API de consultaEm produção

CND de Santos: o Tribusweb inteiro

Envie o CNPJ ou o CPF e o tipo e receba da Prefeitura de Santos a certidão do Tribusweb: negativa municipal ou mobiliária, de inexistência, existência ou encerramento de firma, além da validação e do extrato de dívida ativa.

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

  1. 1

    Entrada

    tipocnpjcpf
  2. 2

    Fonte oficial

    Prefeitura de SantosTribusweb, Certidão Emissão Diversas

  3. 3

    Saída

    JSON + PDF

  4. CobrançaSó consulta concluída

Você envia, você recebe

Formato da resposta. Empresa fictícia.

Parâmetros

  • tipoobrigatório

    municipal, mobiliario, inexistencia_firma, existencia_firma, encerramento_firma ou todas.

  • cnpjopcional

    A empresa.

  • 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[].numero_documento
CPF/CNPJ consultado, só dígitos.
documentos[].tipo_certidao
Nome da certidão emitida.
documentos[].tipo
Tipo pedido: municipal, mobiliario, inexistencia, existencia ou encerramento.
documentos[].situacao
Situação da certidão no vocabulário do projeto.
documentos[].numero_certidao
Número da certidão impresso no PDF.
documentos[].codigo_verificacao
Código de Controle (XXXX.XXXX.XXXX.XXXX).
documentos[].documento_impresso
CPF ou raiz do CNPJ impressa.
documentos[].tipo_identificacao
Identificação usada no site: F (CPF), J (CNPJ), R (raiz de CNPJ) ou I (inscrição).
documentos[].tributos_abrangidos
Tributos abrangidos pela certidão.
documentos[].nota_inscricao
Frase sobre a inscrição em Santos.
documentos[].url_validacao
URL de autenticação (a do QR code).
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[].inscricao
Inscrição mobiliária (só existência/encerramento de firma).
documentos[].resultado_portal
Só sem certidão: COM PENDENCIAS ou NAO EMITIDA.
documentos[].mensagem
Só sem certidão: mensagem literal do site.
documentos[].links
Só em COM PENDENCIAS: links úteis (Consulta Dívida Ativa, GISS Online).
documentos[].email_pedido
Só em COM PENDENCIAS: e-mail para pedir a certidão por processo.
Certidão Emissão Diversas do Tribusweb de Santos, com mobiliário ou municipal, tipo e identificação
RespostaJSON
{"com_apontamentos": false,"certidao_emitida": true,"mensagem_orgao": "Certidão Negativa de Débitos de …","documentos": [{"com_apontamento": false,"dias_de_validade": 182,"valida_ate": "2027-04-27T00: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 DE …","tipo": "municipal","situacao": "negativa","numero_certidao": "123456/2026","codigo_verificacao": "AB12.CD34.EF56.GH78","documento_impresso": "11.222.333","tipo_identificacao": "R","tributos_abrangidos": "ISSQN, IPTU, ITBI, taxas e contribuição …","nota_inscricao": "O CNPJ/CPF acima identificado possui …","url_validacao": "https://…/...","emissao_portal": "27/10/2026","valida_ate_portal": "27/04/2027","inscricao": null,"resultado_portal": "COM PENDENCIAS","mensagem": "Não foi possível emitir Certidão …","links": {"Consulta Dívida Ativa": "https://…/1","GISS Online": "https://…/"},"email_pedido": "certidao@santos.sp.gov.br"}]}

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

Santos separa as certidões em dois grupos, mobiliário e municipal, e emite também as de inexistência, existência e encerramento de firma, úteis para baixa de empresa e para provar que o CNPJ não tem inscrição no município.

A tela pede o código de uma imagem antes de consultar. O passo a passo manual está no guia da certidão municipal de Santos.

Perguntas frequentes

Tem certidão de encerramento de firma?

Sim, entre os tipos do Tribusweb.

Dá para validar?

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

Traz a dívida ativa?

Sim, o extrato de dívida ativa sai em rota própria.

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

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

Emitir certidões de Santos 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.