Orientações e respostas da equipe da Direct Data

💡 Esta API permite consultar o Cadastro Centralizado de Contribuintes (CCC), facilitando a validação de destinatários em operações interestaduais. Inclui informações cadastrais de contribuintes mantidas pela SEFAZ RS e outras secretarias estaduais de fazenda.

Introdução

A API Sintegra - CCC é essencial para validar informações fiscais de contribuintes em transações interestaduais, sendo utilizada principalmente para compliance, análise de crédito e auditorias fiscais.

---

URL Base

https://api.directd.com.br

---

Endpoint

GET /api/SintegraCCC

Descrição: Endpoint para consultar informações do Cadastro Centralizado de Contribuintes.

Nota: Este endpoint permite a geração de comprovantes em PDF (adicional de 50% do valor da consulta).

---

Autenticação

A API exige um token de acesso.

1. O token deve ser passado como parâmetro na URL.
2. Para suporte, entre em contato com suporte@directd.com.br.

---

Campos da API

Dados Cadastrais

• CNPJ: Cadastro Nacional de Pessoa Jurídica.
• CPF: Cadastro de Pessoa Física.
• IE: Inscrição Estadual.
• Nome Empresarial: Nome oficial da empresa.
• Nome Fantasia: Nome comercial da empresa.

Endereço

• Logradouro: Rua ou avenida.
• Número: Número do endereço.
• Complemento: Informações adicionais do endereço.
• CEP: Código Postal.
• Bairro, Município e UF: Localização detalhada.

Situação Cadastral

• Situação Cadastral: Status do contribuinte.
• Motivo Situação Cadastral: Razão do status cadastral.
• Data Situação Cadastral: Data da última alteração no status.

Atividades Econômicas

• Atividade Econômica Principal: Código e descrição.
• Lista de Atividades Econômicas Secundárias: Detalhes das atividades adicionais.

Informações Adicionais

• Ocorrência Fiscal: Notificações relacionadas ao contribuinte.
• Regime de Apuração: Modalidade de apuração fiscal.
• Indicador de Obrigatoriedade de NFe: Status quanto à obrigatoriedade da emissão de NFe.
• Data de Início da Obrigatoriedade NFe: Quando passou a ser obrigatório.

---

Parâmetros

---

Exemplos de Requisição

Usando cURL

curl 'https://api.directd.com.br/api/SintegraCCC?CNPJ=12345678000195&UF=SP&TOKEN=seu_token_aqui'

---

Respostas

Sucesso (200)

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "Sintegra - Cadastro Centralizado de Contribuinte",
    "consultaUid": "directd-123456",
    "usuario": "Cliente",
    "mensagem": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 2100
  },
  "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

---

Notas Importantes

1. Parâmetros Obrigatórios: Para cada consulta, é obrigatório informar a UF e pelo menos um dos seguintes parâmetros: CPF, CNPJ ou IE.
2. Atualização de Dados: Os dados são atualizados com frequência, mas podem ter defasagem em relação às mudanças recentes no cadastro do contribuinte.
3. Limitação de Consultas: Apenas uma consulta por CNPJ, CPF ou IE por requisição.
4. Comprovante em PDF: Ative o parâmetro "GERARCOMPROVANTE=true" para gerar um comprovante oficial.
5. Proteção de Dados: As consultas respeitam a legislação vigente sobre proteção de dados.

---