API de consultaEm produção

Santos: a firma existe ou não

Envie o CNPJ ou o CPF e receba da Prefeitura de Santos a certidão de inexistência de firma. Pela inscrição mobiliária, a API emite também a de existência e a de encerramento.

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

  1. 1

    Entrada

    cnpjcpfinscricao_mobiliaria
  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

  • cnpjopcional

    Na inexistência de firma.

  • cpfopcional

    Envie CNPJ ou CPF.

  • inscricao_mobiliariaopcional

    Na existência e no encerramento.

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.
Tela de emissão de certidões diversas do Tribusweb de Santos com Inexistência de Firma escolhida e o código da imagem borrado
RespostaJSON
{"com_apontamentos": false,"certidao_emitida": true,"mensagem_orgao": "Certidão de Inexistência de Firma …","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

As três certidões falam do cadastro mobiliário, não de dívida: dizem se há firma registrada para o documento, se ela existe ou se foi encerrada. Por isso, quando saem, voltam sem apontamento, e a situação vem do título: inexistencia, existencia ou encerramento.

Com pendência, o portal não emite online: a resposta volta positiva_restrita, com a tela e as orientações do portal. Erro do sistema volta como nao_emitida, com a mensagem literal. A certidão de débitos de Santos tem a API própria.

Perguntas frequentes

Para que serve a inexistência de firma?

Para provar que não há empresa registrada no documento em Santos.

Encerramento pede o quê?

A inscrição mobiliária da firma.

Marca apontamento?

Só quando há pendência e a certidão não sai.

API Certidões de Firma de Santos: inexistência, existência e encerramento na sua integração

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

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