Regularidade fiscal estadual
CND Estadual por API para automatizar consultas de regularidade fiscal
Consulte por CNPJ e UF o resultado disponibilizado pela Fazenda estadual, receba dados estruturados e acesse o comprovante em PDF quando ele for fornecido pela origem.
Aplicação prática
Para que serve a API CND Estadual?
A consulta centraliza em uma única integração o acesso às fontes estaduais. Ela apoia a conferência de regularidade fiscal, a homologação de empresas e a organização de evidências sem exigir que sua equipe navegue por diferentes portais.
Homologação de empresas
Inclua a verificação fiscal estadual no cadastro de clientes, fornecedores e parceiros.
Habilitação e contratos
Organize a evidência usada em processos que exigem comprovação de regularidade perante a Fazenda estadual.
Monitoramento de validade
Capture a data de validade retornada e programe a renovação no seu processo documental.
Integração com ERP e backoffice
Leve o resultado e o comprovante para o sistema utilizado pelas equipes fiscal e cadastral.
Menos consulta manual
Substitua acessos repetitivos a diferentes portais estaduais por uma chamada padronizada.
Resposta estruturada
O que a consulta retorna
A resposta informa se a fonte conseguiu emitir uma certidão negativa, além de código, número, mensagem, data, validade e link do comprovante quando esses dados estiverem disponíveis.
Resultado da certidão
Indicadores que informam se a fonte retornou e conseguiu emitir uma certidão negativa.
Código e número
Identificadores da certidão quando fornecidos pela origem estadual.
Mensagem da fonte
Texto fiscal associado ao resultado encontrado para o CNPJ e a UF.
Data da consulta
Data e hora normalizadas da consulta; se a fonte omitir o horário, a SintegrAPI registra o momento do processamento em Brasília.
Validade
Data de validade da certidão no formato ISO, quando informada.
Comprovante
Link público e compartilhado para o PDF importado pela SintegrAPI quando a fonte disponibilizar o documento.
Identificador da requisição
UUID que permite correlacionar o resultado com o consumo e o atendimento.
Importante: campos e valores dependem da disponibilidade e do preenchimento da Fonte Oficial.
Integração para desenvolvedores
Uma chamada HTTP, uma resposta pronta para o seu sistema
Os exemplos abaixo mostram o formato básico da integração. Use sua chave de API e consulte a documentação para parâmetros, autenticação e tratamento de erros.
Abrir documentação completaGET https://api.sintegrapi.com.br/consultas/v2/certidao-negativa-de-debitos-estadual/{cnpj}?uf=SP
x-api-key: SUA_API_KEY{
"codigo": "CERTIDAO-EXEMPLO",
"certidao_mensagem": "Não constam débitos estaduais",
"certidao_negativa": true,
"conseguiu_emitir_certidao_negativa": true,
"datahora": "2026-08-22 10:30:00",
"numero": "0000000000",
"validade": "2026-11-20",
"print": "https://api.sintegrapi.com.br/consultas/v2/certidao-negativa-de-debitos-estadual/print/{receipt_id}",
"request_id": "00000000-0000-0000-0000-000000000000",
"success": true,
"error": false
}Exemplo ilustrativo. Consulte a documentação para o contrato completo da resposta.
Infraestrutura para operações B2B
Por que usar a SintegrAPI
Concentre diferentes consultas fiscais e cadastrais em uma integração pensada para sistemas de negócio.
Do cadastro ao compliance
Casos de uso da API CND Estadual
Adapte a consulta às regras e aos pontos de decisão da sua operação.
ERP
Consulta e registro da situação fiscal estadual dentro da ficha da empresa.
Cadastro de fornecedores
Apoio à homologação e à atualização documental de parceiros.
Licitações e contratos
Organização de evidências de regularidade exigidas no processo aplicável.
Fiscal e tributário
Conferência do resultado estadual e da validade retornada pela fonte.
Compliance
Padronização de verificações e trilhas internas de análise.
Onboarding de clientes
Validação fiscal integrada à entrada de novas empresas.
Comece no seu ritmo
Planos para testar, integrar e escalar
Use planos pré-pagos para sua operação ou converse com o time comercial sobre pay-per-use e alto volume.
Dúvidas frequentes
FAQ sobre API CND Estadual
Respostas objetivas para avaliar a integração.
Para que serve a CND Estadual?
Ela é usada para comprovar a situação do contribuinte perante a Fazenda estadual, conforme a abrangência e as regras da UF emissora. A consulta ajuda a incorporar essa verificação a cadastros, homologações, contratos e rotinas fiscais.
Quais dados são obrigatórios?
Informe o CNPJ completo e a sigla da UF. A consulta aceita as 26 unidades federativas e o Distrito Federal, uma UF por requisição.
Quanto custa a consulta?
Uma certidão válida encontrada no cache da SintegrAPI custa 1 crédito. Quando é necessário consultar a fonte, inclusive por uma atualização online solicitada pelo cliente, o custo é de 3 créditos. Falhas técnicas custam 0 créditos.
Por quanto tempo a certidão fica no cache?
O resultado positivo pode ser reutilizado até o fim do dia anterior à validade informada pela fonte. Uma validade ausente, inválida ou já alcançada impede o uso do cache.
A consulta está disponível no Free Tier?
Não. Contas que possuem somente o plano Free Tier precisam ativar um plano pago para usar a CND Estadual. Requisições bloqueadas por essa regra não reservam nem descontam créditos.
O que significa success igual a false?
Quando error é false, significa que a consulta foi concluída, mas o resultado fiscal não permitiu emitir uma certidão negativa. Quando error é true, houve uma falha técnica na realização da consulta.
O comprovante em PDF é sempre retornado?
Não. O campo print é preenchido apenas quando a fonte fornece um comprovante válido e ele pode ser importado com segurança pela SintegrAPI.
A consulta substitui a análise fiscal ou jurídica?
Não. A abrangência e as regras variam entre as UFs. Confira a mensagem, a validade e a autenticidade do documento e aplique os critérios definidos para o seu processo.
