💡 Esta API verifica a situação cadastral e o regime de tributação de ICMS de empresas junto à SEFAZ. Ideal para auditorias fiscais, validação de destinatários em operações interestaduais e análises de risco.
Introdução
A API Sintegra - Cadastros Estaduais permite verificar a situação cadastral de contribuintes registrados nos estados brasileiros, validando informações tributárias e confirmando a regularidade das operações comerciais.
URL Base
https://api.directd.com.br
Endpoint
GET /api/Sintegra
Descrição: Consulta informações cadastrais e tributárias estaduais, incluindo opção de gerar comprovantes em PDF.
Nota: O parâmetro UF é obrigatório.
Autenticação
- É necessário fornecer um token de autenticação válido como parâmetro da URL.
- Caso tenha dúvidas sobre o token, entre em contato com suporte@directd.com.br.
Campos da API
Dados Básicos
- CNPJ: Número do Cadastro Nacional de Pessoa Jurídica.
- CPF: Cadastro de Pessoa Física.
- IE: Inscrição Estadual.
Dados Empresariais
- Nome Empresarial e Nome Fantasia.
- Natureza Jurídica: Tipo de registro jurídico da empresa.
Endereço
- Logradouro, Número, Complemento, Bairro, Município e UF.
- CEP: Código postal.
Situação Cadastral
- Situação Cadastral: Status atual do registro.
- Motivo da Situação Cadastral: Razão para o status atual.
- Data da Situação Cadastral.
Atividades Econômicas
- Atividade Econômica Principal.
- Lista de Atividades Econômicas Secundárias.
Informações Complementares
- Regime de Apuração: Modalidade tributária de ICMS.
- Indicador de Obrigatoriedade de NFe.
- Data de Início da Obrigatoriedade de NFe.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| UF | string | Sim | Unidade Federativa do contribuinte. |
| CPF | string | Não | CPF do contribuinte (quando aplicável). |
| CNPJ | string | Não | CNPJ do contribuinte (quando aplicável). |
| IE | string | Não | Inscrição Estadual (quando aplicável). |
| TOKEN | string | Sim | Token de autenticação. |
| GERARCOMPROVANTE | string | Não | Define se deve gerar comprovante em PDF (valor: "true"). |
Exemplos de Requisição
Usando cURL
curl 'https://api.directd.com.br/api/Sintegra?CNPJ=12345678000195&UF=SP&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "Sintegra - Cadastros Estaduais",
"consultaUid": "directd-123456",
"usuario": "Cliente",
"mensagem": "Sucesso",
"apiVersao": "v3",
"tempoExecucaoMs": 1800
},
"retorno": {
"cnpj": "12.345.678/0001-95",
"nomeEmpresarial": "EMPRESA EXEMPLO LTDA",
"situacaoCadastral": "Ativa",
"atividadeEconomicaPrincipal": "Comércio varejista de roupas",
"dataAbertura": "01/01/2000",
"uf": "SP",
"municipio": "São Paulo",
"telefone": "(11) 1234-5678",
"email": "contato@empresaexemplo.com.br",
"indicadorObrigatoriedadeNFe": "Sim",
"dataInicioObrigatoriedadeNFe": "01/07/2018"
}
}
Erros Comuns
| Código | Descrição |
|---|---|
| 400 | Requisição inválida: parâmetros incorretos. |
| 401 | Não autenticado: token inválido ou ausente. |
| 403 | Não autorizado: saldo insuficiente para realizar a consulta. |
| 404 | Não encontrado: registro não localizado. |
| 408 | Tempo esgotado: consulta não foi concluída no prazo. |
| 500 | Erro interno: falha no processamento da consulta. |
| 503 | Serviço em manutenção: indisponível temporariamente. |
Notas Importantes
- Obrigatoriedade de Parâmetros: O parâmetro UF é sempre necessário.
- Atualizações Regulares: As informações podem sofrer atrasos dependendo do estado.
- Comprovantes: Utilize o parâmetro "GERARCOMPROVANTE" para obter comprovantes em PDF.
- Documentos: Apenas um documento pode ser consultado por vez.
- Limitações Regionais: Estados podem variar na disponibilidade de dados.