> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/sintegraws.md). # SintegraWS ### Visão geral A integração entre o Consistem ERP e o SintegraWS tem como objetivo principal otimizar e automatizar o processo de cadastros (cliente, fornecedor, transportador, conta) no sistema. Através de um webservice, a integração permite realizar consultas à Receita Federal em tempo real utilizando apenas o CNPJ. Com isso, o sistema adquire e preenche automaticamente dados essenciais como registro, situação cadastral, CNAEs, contatos, endereço, quadro de sócios e a Inscrição Estadual, reduzindo erros de digitação e aumentando a produtividade. Cabe notar que este serviço é exclusivo para consultas de CNPJ e não retorna dados de CPF. ### Requisitos
Consistem ERPSintegraWS

Compatibilidade: 7.5 ou superiores do Consistem ERP.

Módulos: Comercial, Financeiro, Cadastros Gerais e Escrita Fiscal.

Orientamos o acompanhamento da nossa equipe de consultores.

Aquisição de licença e implantação deve ser verificada com a empresa fornecedora.
Saiba mais
Credenciais: Obtenção de um Token de API ativo gerado na plataforma do SintegraWS para autenticação das requisições.
### Configuração da integração **No Consistem ERP:** 1. Acesse o programa [Configurações de Integrações (CSWMEN180)](/componentes/manuais-de-telas/configuracao-dos-componentes/configuracoes-de-integracoes.md), na[ Aba Serviço Consulta CNPJ](/componentes/manuais-de-telas/configuracao-dos-componentes/configuracoes-de-integracoes/aba-servico-consulta-cnpj.md), localize o campo **Serviço Consulta CNPJ** e selecione a opção *SintegraWS*. 2. Insira o **Token Serviço CNPJ** gerado no painel do SintegraWS para habilitar a comunicação segura.
3. **Opcional para rotinas fiscais:** No programa [Parâmetro Geral Sintegra de Convênio ICMS 69 (CCEPI073)](/contabil-fiscal/manuais-de-telas/contabil-fiscal-escrita-fiscal/sintegra/parametro-geral-sintegra-de-convenio-icms-69.md), configure o campo **Efetua Download do Arquivo Quando Disponível** como *Sim* caso deseje liberar o botão de download no programa de monitoramento contábil.
**No SintegraWS:** 1. Acesse o portal oficial através da URL: `https://www.sintegraws.com.br/`. 2. Crie ou acesse a sua conta corporativa. 3. Adquira o plano comercial adequado ao volume de consultas diárias da sua empresa (evitando os limites e bloqueios das opções gratuitas). 4. Acesse a área de desenvolvedor/configurações para gerar e copiar o **Token de Acesso**, que será utilizado na parametrização interna do Consistem ERP. ### Como a integração funciona A comunicação entre os sistemas ocorre de forma síncrona através de chamadas de API via Web-Service, utilizando o protocolo HTTP/HTTPS. Quando um usuário inicia o cadastro de uma nova entidade no Consistem ERP e insere um CNPJ válido, o ERP dispara uma requisição de consulta enviando o número do documento como parâmetro. O SintegraWS recebe essa requisição, realiza a consulta em tempo real nas bases da Receita Federal e dos órgãos estaduais e devolve a resposta estruturada. O formato de comunicação e troca de dados (leiaute de retorno estruturado em JSON) é processado internamente pelo Consistem ERP, traduzindo as informações da API para os campos correspondentes na tela do usuário. ### Fluxo do processo 1. **Acesso ao Programa:** O usuário acessa um dos programas de cadastro que possuem a inteligência da integração ativa: 1. [Cadastro de Cliente (CCCDB005)](/cadastros-gerais/manuais-de-telas/clientes/cadastro-de-cliente.md) 2. [Cadastro de Transportadora (CCAPL020)](/cadastros-gerais/manuais-de-telas/cadastros-gerais/cadastro-de-transportadora.md) 3. [Cadastro de Fornecedor (CCFFB005)](/financeiro/manuais-de-telas/financeiro-contas-a-pagar/fornecedor/cadastro-de-fornecedor.md) 4. [Cadastro de Conta (CCTELCO010)](/comercial/manuais-de-telas/comercial-crm/contas/cadastro-de-conta.md) 2. **Inserção do CNPJ:** O operador inicia um novo registro de cadastro e insere o número do CNPJ no campo correspondente. 3. **Disparo e Envio da Requisição:** Ao sair do campo do **CNPJ** (ou teclar Enter), o Consistem ERP detecta o evento e dispara silenciosamente uma requisição segura via protocolo HTTPS (método GET) para o servidor do SintegraWS. 1. **O que a Consistem envia:** Uma URL contendo o parâmetro do **CNPJ** e o seu **Token** de acesso de autenticação. 4. **Processamento no Provedor:** O gateway do SintegraWS recebe os parâmetros, valida o token, consulta a base de dados oficial em tempo real e processa o resultado. 5. **Retorno e Recepção dos Dados (Leiaute de Retorno):** O SintegraWS responde à requisição do ERP entregando um objeto estruturado em formato JSON. 1. **O que a Consistem recebe:** Uma estrutura JSON com os campos de identificação, endereço, contatos e Inscrição Estadual. 6. **Autopreenchimento no ERP:** O Consistem ERP interpreta o arquivo JSON recebido e preenche, de forma automática e instantânea na tela ativa, os seguintes campos sugeridos: Razão Social, CEP, Endereço, Número, Bairro, E-mail, Telefone e Inscrição Estadual. 7. **Validação e Gravação:** O operador confere se as informações trazidas estão corretas, preenche os demais campos obrigatórios internos do ERP e grava o registro para finalizar o processo. {% hint style="info" %} **Nota de Processo Fiscal (PER-DCOMP)**\ Para fluxos relacionados ao programa [Geração Arquivos IPI - PER-DCOMP (CCEPI180)](/contabil-fiscal/manuais-de-telas/contabil-fiscal-escrita-fiscal/informacoes-para-per-dcomp/geracao-arquivos-ipi-per-dcomp.md), se o parâmetro de download estiver ativo como *Sim* no programa [Parâmetro Geral Sintegra de Convênio ICMS 69 (CCEPI073)](/contabil-fiscal/manuais-de-telas/contabil-fiscal-escrita-fiscal/sintegra/parametro-geral-sintegra-de-convenio-icms-69.md), os arquivos gerados ficam disponíveis para a engenharia de dados e download direto do usuário através do programa de [Controle dos Arquivos Gerados no Sistema Contábil/Fiscal (CCINF040)](/contabil-fiscal/manuais-de-telas/contabil-fiscal-informacoes-fiscais/configuracao-geral-de-informacoes-fiscais/controle-dos-arquivos-gerados-no-sistema-contabil-fiscal.md). {% endhint %}

Esse conteúdo foi útil?

Sim Não

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/sintegraws.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.