> 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/comercial/sefaz.md).

# Sefaz

### Visão geral

O objetivo principal da integração com a Sefaz é validar o status cadastral e fiscal do cliente em tempo real diretamente na base da Secretaria da Fazenda. Esta funcionalidade permite automatizar a checagem de regularidade fiscal no momento da digitação do pedido de venda ou na seleção para faturamento, notificando o usuário imediatamente caso o cliente esteja inativo ou apresente irregularidades. Isso evita a rejeição de Notas Fiscais Eletrônicas (NF-e) em etapas posteriores do faturamento, otimizando o fluxo comercial e reduzindo retrabalhos.

### Requisitos

<table><thead><tr><th width="462">Consistem ERP</th><th>Sefaz</th></tr></thead><tbody><tr><td><p><strong>Compatibilidade:</strong> 7.5 ou superiores do Consistem ERP.</p><p><strong>Módulos:</strong> Comercial, Financeiro e Cadastros Gerais.</p><p>Orientamos o acompanhamento da nossa equipe de consultores.</p></td><td>Este serviço é liberado gratuitamente.<br><a href="https://www.nfe.fazenda.gov.br/portal/principal.aspx">Saiba mais</a></td></tr><tr><td></td><td><strong>Disponibilidade do Serviço:</strong> O cliente consultado deve pertencer a uma Unidade Federativa (UF) que possua o serviço de Consulta Cadastro ativo na Sefaz.</td></tr><tr><td></td><td><strong>Restrições de UF:</strong> As UFs <strong>AL, AP, DF, RJ, RO, RR, SE, TO, MA, PA, PI</strong> não disponibilizam o serviço de consulta ao cadastro do contribuinte.</td></tr><tr><td></td><td><strong>Certificado Digital:</strong> Certificado digital válido (A1 ou A3) configurado no Consistem ERP para assinar e transmitir a requisição de consulta à Sefaz.</td></tr></tbody></table>

### Configuração da integração

#### No Consistem ERP

1. Acesse o programa [Configuração da Consulta do Cliente na Sefaz (CCFTN017)](/comercial/manuais-de-telas/comercial-faturamento/configuracao-da-nota-fiscal-eletronica/configuracao-da-consulta-do-cliente-na-sefaz.md) e configure os campos abaixo:
   1. **Verificar Cadastro do Cliente:** Defina o momento e o comportamento da validação conforme a necessidade da empresa. Note que as opções que possuem o termo "bloquear" impedirão a continuidade da digitação do pedido de venda ou da seleção para faturamento caso o cliente retorne com a situação *0-Não Habilitado* ou se a Inscrição Estadual estiver divergente do cadastro interno.
   2. **Mostrar Somente Cliente não Habilitado:** Defina como *Sim* para que o sistema exiba o resultado da consulta na tela apenas se o cliente apresentar irregularidades. Se definido como *Não*, o resultado será exibido sempre.
   3. **Mostrar Mensagem sem Conexão:** Defina como *Sim* para exibir um alerta caso ocorra falha de comunicação ou *timeout* com os servidores da Sefaz.
   4. **Mostrar Mensagem UF sem Serviço:** Defina como *Sim* para ser avisado quando o destino for uma das UFs que não possuem o serviço de consulta (AL, AP, DF, RJ, RO, RR, SE, TO, MA, PA, PI).<br>

      <figure><img src="/files/3v4bK6vlvgddaHpTM0WA" alt=""><figcaption></figcaption></figure>

#### Na Sefaz

Não é necessária nenhuma configuração específica dentro do ambiente da Sefaz, uma vez que a consulta utiliza a API pública e padronizada de **Consulta Cadastro** (ConsCad) disponibilizada pelas Sefaz autorizadoras ou SVRS (Suframa/Ambiente Nacional), bastando que o CNPJ/IE consultado esteja cadastrado e a requisição seja assinada por um certificado digital autorizado.

### Como a integração funciona

A comunicação entre o Consistem ERP e a Sefaz ocorre de forma síncrona através de Web Services baseados no protocolo SOAP, utilizando o formato XML para a troca de dados.

Ao informar o código do cliente na digitação de um pedido de venda ou na seleção para faturamento, o Consistem ERP gera uma estrutura de dados de envio e aguarda a resposta do servidor do governo em tempo real. O sistema processa o retorno e toma as ações de exibição ou bloqueio conforme os parâmetros estabelecidos na rotina de configuração.

### Fluxo do processo

O fluxo de trabalho obedece ao padrão técnico da Consistem, organizando as etapas da validação em passos operacionais simples:

1. **Início da Operação:** O usuário inicia a digitação de um pedido de venda ou de uma seleção para faturamento e preenche o código do cliente.
2. **Envio de Dados (Consistem** <i class="fa-arrow-right">:arrow-right:</i> **Sefaz):** O sistema verifica as diretrizes do programa [Configuração da Consulta do Cliente na Sefaz (CCFTN017)](/comercial/manuais-de-telas/comercial-faturamento/configuracao-da-nota-fiscal-eletronica/configuracao-da-consulta-do-cliente-na-sefaz.md). Estando ativa a validação, o ERP monta e transmite o leiaute de envio (padrão XML / ConsCad) contendo a identificação do cliente pesquisado: a Unidade Federativa (UF) e o CNPJ ou Inscrição Estadual (IE).
3. **Retorno de Dados (Sefaz** <i class="fa-arrow-right">:arrow-right:</i> **Consistem):** A Sefaz realiza a pesquisa síncrona em sua base e devolve para o ERP o leiaute de retorno (XML). O sistema recebe as informações fiscais atualizadas do contribuinte, com destaque para a Inscrição Estadual (IE) e o status de situação cadastral (*1 - Habilitado* ou *0 - Não Habilitado*).
4. **Tratamento e Consumo dos Dados:** O Consistem ERP intercepta as informações recebidas e executa as seguintes diretrizes:
   1. **Se regular** (Situação = *Habilitado* e *IE idêntica ao cadastro*): O processo de digitação do pedido ou seleção continua normalmente. A tela com o resultado da Sefaz é ocultada ou exibida apenas para conferência (conforme parametrização).
   2. **Se irregular** (Situação = *Não Habilitado* ou *IE divergente*): O ERP projeta obrigatoriamente na tela do usuário os detalhes retornados pela Sefaz. Caso a configuração ativa inclua a instrução de "bloquear", o sistema interrompe imediatamente o processo, bloqueando o avanço do preenchimento e impedindo a conclusão da operação até que a situação do cliente seja regularizada.

<p align="center">Esse conteúdo foi útil?</p>

<p align="center"><a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-up">Sim</a> <a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-down">Não</a></p>


---

# 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/comercial/sefaz.md?ask=<question>&goal=<endgoal>
```

`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.