Esta versão do sistema foi descontinuada e não recebe atualizações e novas implementações. Acesse a documentação da versão 5.10.3 aqui
Segmentos > Compliance > Consulta de cadastros na SEFAZ

Consulta de cadastros na SEFAZ

O Gestão Empresarial | ERP permite a atualização cadastral de clientes, fornecedores, transportadoras, endereços de entrega de cliente e endereços de origem de mercadoria através de uma consulta ao cadastro centralizado da SEFAZ. Esta consulta é realizada por meio de uma integração entre o Gestão Empresarial | ERP e o eDocs.

Importante

A Consulta de cadastros na SEFAZ ocorre por meio da comunicação do eDocs com o web service de NfeConsultaCadastro disponibilizado pela SEFAZ, que faz a conexão com o CCC (Cadastro Centralizado de Contribuinte).

Desta forma, caso haja necessidade de verificar como a SEFAZ está disponibilizando as informações deste contribuinte, orienta-se a consulta no Cadastro Centralizado de Contribuinte disponível neste endereço. As informações presentes no CCC podem ser diferentes das informações presentes no Sintegra e na Receita Federal.

Um ponto de atenção é que a SEFAZ pode ainda apresentar informações diferentes entre o que é apresentado na consulta no site do CCC em relação ao que é retornado pelo web service de consulta da SEFAZ. Nesse caso, se houver dúvidas sobre o que a SEFAZ retorna na consulta do web service, o log XML do eDocs poderá ser verificado.

Em caso de desconformidade de alguma informação entre Sintegra, Receita Federal e CCC, orienta-se o contato direto com a SEFAZ para verificação dessa questão, uma vez que os sistemas da Senior apenas fazem uma consulta ao CCC, mas não são responsáveis por manter essa base de dados.

Parametrizações necessárias - Gestão Empresarial | ERP

No Gestão Empresarial | ERP, a ativação dessa funcionalidade depende exclusivamente das configurações parametrizadas na tela Parâmetros de Integração (F191CPT). Ao preencher o campo Grupo com a opção eDocs e o campo Subgrupo com a opção Comunicação com eDocs, deve-se seguir obrigatoriamente a seguinte parametrização:

  1. Gerar log integração eDocs: determina se serão gerados registros da comunicação do Gestão Empresarial | ERP com o eDocs. É recomendado configurar este campo como S -Sim quando houver necessidade de coletar as informações geradas durante o processo de integração entre os sistemas
  2. Usuário: deverá ser preenchido com o usuário definido no cadastro da empresa registrada no eDocs. Esta informação é definida no campo Usuário da seção web service da guia Integração do eDocs
  3. Senha: deverá ser preenchido com a senha do usuário definido no campo Usuário. A configuração desta senha é realizada no momento do cadastro de uma empresa no eDocs e é definida no campo Senha da seção web service da guia Integração do eDocs
  4. URL: a URL a ser parametrizada é a URL de comunicação com o web service do eDocs. A URL sempre estará no padrão http://<servidor_eDocs>:<porta_WebService>/Sde/Integracao?WSDL, onde:
    1. <servidor_eDocs>: é o IP ou nome do Servidor do eDocs
    2. <porta_WebService>: é a porta do web service configurada em Configuração > Geral > guia Integração > campo Porta
  5. No grupo Cliente, subgrupo Gerais é possível escolher quais dados devem ser atualizados no cliente, fornecedor e transportadora:
    Campos
    Atualiza informações cadastrais ao realizar consulta na Sefaz
    Atualizar o campo UF
    Atualizar o campo IE
    Atualizar o campo Nome
    Atualizar o campo CNAE
    Atualizar o campo Nome Fantasia
    Atualizar o campo Regime de Apuração
    Atualizar o campo Endereço
    Atualizar o campo Logradouro
    Atualizar o campo Número
    Atualizar o campo Complemento
    Atualizar o campo Bairro
    Atualizar o campo Código Municipio
    Atualizar o campo Nome Município
    Atualizar o campo CEP
    Manter cliente ativo no ERP quando inativo na Sefaz

    Opções:

    • S - Alterar a situação para a encontrada na SEFAZ (valor padrão para filial configurada com eDocs)
    • I - Alterar a situação apenas quando inativo na SEFAZ
    • A - Alterar a situação apenas quando ativo na SEFAZ
    • N - Não alterar a situação

Ao alterar alguma informação nas telas F085CAD, F095CAD e F073TRA, será aberta uma tela de comparação dos dados do ERP x SEFAZ. Somente os campos nela selecionados serão atualizados.

A tela F000APA e os web services, por se tratarem de rotinas automáticas, utilizam os parâmetros por campo para atualização. Dessa forma, é necessário parametrizar os campos específicos que devem ser atualizados por meio da tela F191CPT, indicando a opção S.

Importante

As parametrizações estabelecidas na tela Parâmetros de Integração (F191CPT) são as mesmas utilizadas para geração do EFD-Reinf e emissão de documentos fiscais via web service do eDocs quando ha integração do Gestão Empresarial | ERP com o eDocs. Atualmente não existe uma forma de ativar apenas a geração do EFD-Reinf e não ativar a rotina de consulta de cadastros, por exemplo. Ou seja, a partir do momento que a opção eDocs é configurada para o campo Grupo, o Gestão Empresarial | ERP considera como ativa a rotina de consulta de cadastros na SEFAZ.

Parametrizações necessárias - eDocs

No eDocs, é importante verificar a parametrização dos campos Usuário, Senha e a porta do web service, bem como ativar o web service de integração. Este web service é ativado através do campo Ativar web service de integração presente na guia Integração do sistema.

Importante

Recomendamos que o eDocs seja reinicializado após a alteração das parametrizações.

Funcionamento do processo no Gestão Empresarial | ERP

Quando a rotina estiver parametrizada na tela Parâmetros de Integração (F191CPT) e ativa, o Gestão Empresarial | ERP permitirá a consulta de cadastro dos clientes, fornecedores e transportadoras junto ao cadastro centralizado da SEFAZ. A consulta pode ser feita por meio dos seguintes artefatos:

Parâmetros globais que podem te ajudar:

Para que o Gestão Empresarial | ERP consiga realizar a consulta à SEFAZ por meio da comunicação com o eDocs, deve-se atender os seguintes pré-requisitos:

Para todos os pontos acima, exceto no processamento da tela F000APA ou execução do processo agendado 105, o Gestão Empresarial | ERP vai acionar a rotina de consulta à SEFAZ toda vez que for realizado um novo cadastro. Quando forem realizadas alterações em um cadastro já existente, a rotina será acionada somente quando o CNPJ/CPF do cliente, fornecedor ou transportadora tiver alguma alteração, sendo exibida a tela F000AMC permitindo que o usuário escolha quais dados do cadastro deverão ser atualizados.

Nas telas Cadastro de Clientes (F085CAD), Cadastro de Fornecedores (F095CAD) e Transportadoras (F073TRA), quando forem inseridos novos cadastros ou forem realizadas alterações no CNPJ/CPF de um cadastro já existente, o Gestão Empresarial | ERP acionará a rotina de consulta e, caso encontre alguma divergência entre os dados cadastrados e os dados retornados da consulta, será apresentada a seguinte mensagem: Foi identificado que o cliente possui alterações cadastrais em relação a Receita Federal/Sintegra. Campo(s) divergente(s): XXXXX, XXXXX, XXXXX, XXXXX, XXXXX. Deseja atualizar estes dados?, sendo possível realizar ou não a atualização no cadastro de acordo com as informações retornadas da consulta.

Na utilização dos web services citados anteriormente, não será apresentada a mensagem que possibilita a escolha da atualização dos dados cadastrais de acordo com o retorno da consulta, pois a atualização será realizada automaticamente se a consulta na SEFAZ for realizada com sucesso. Se durante a execução da rotina de atualização cadastral for apresentada alguma inconsistência ou erro, a atualização das informações será ignorada, mas o processamento do web service continuará normalmente.

O processamento da tela Atualização cadastral cliente/fornecedor e transportadora (F000APA) tem como intuito realizar a consulta de um ou mais cadastros de cliente, fornecedor ou transportadora na SEFAZ, sem a necessidade de realizar uma alteração cadastral, já que a tela não permite a inserção de novos cadastros. Como ela não solicita a alteração cadastral, ao final do processamento será apresentado um registro indicando os cadastros que foram atualizados e o que foi alterado em cada um deles.

Importante

Pré-requisitos para consulta de CPF

Quando o cliente (F085CAD), fornecedor (F095CAD) ou transportadora (F073TRA) for do tipo Pessoa Física e a inscrição estadual estiver diferente de ISENTA ou ISENTO (não pode estar em branco), o sistema também irá considerar esses registros para consultar os dados cadastrais através do web service da Receita Federal via eDocs. Caso haja alguma informação para ser atualizada (endereço, número, CEP, complemento etc.), o sistema acusará.

Observação

Funcionamento do processo no eDocs

O eDocs é responsável por receber a requisição através da porta ConsultarCadastroContribuinte do web service de integração e encaminhar a requisição para a SEFAZ. Ela será direcionada conforme o estado do cliente, fornecedor ou transportadora seguindo o registro no cadastro do cliente.

Por exemplo, se o estado do cliente está definido como Santa Catarina - SC, o Gestão Empresarial | ERP acionará o web service do eDocs e encaminhará a requisição indicando que a UF é a 42 (código IBGE de SC). O eDocs verificará em sua base de dados qual é a URL que deve ser utilizada para efetuar consulta de cadastros de contribuintes de SC e encaminhará a requisição para a SEFAZ. O retorno da requisição enviada para a SEFAZ será interpretado pelo eDocs e retornado para o Gestão Empresarial | ERP como resultado da requisição encaminhada ao web service de integração. O eDocs encaminhará um retorno sempre no mesmo formato para o ERP, mesmo que hajam diferenças nos leiautes de retorno entre as SEFAZ.

Importante

Esta integração entre o Gestão Empresarial | ERP e o eDocs utilizando a porta ConsultarCadastroContribuinte do web service de integração não define o tipo de ambiente que será enviada a solicitação para a SEFAZ (produção ou homologação). Desta forma, quando o eDocs recebe a solicitação oriunda do ERP, ele verificará a URL que será utilizada para enviar a requisição conforme o ambiente parametrizado na tela Configuração > Geral do Monitor do eDocs. Ou seja, se o ambiente estava definido como Produção no momento que o serviço do eDocs atendeu a requisição enviada pelo ERP, ele encaminhará a solicitação de consulta do cadastro para a SEFAZ utilizando a URL do ambiente de produção.

Verifique a documentação do eDocs para maiores informações sobre a porta ConsultarCadastroContribuinte do web service de integração.

Limitações da consulta de cadastros na SEFAZ

A disponibilidade desta rotina depende de web services específicos que permitam a consulta de cadastros por cada SEFAZ que possua ambiente autorizador. Esta disponibilidade poderá ainda variar de acordo com o ambiente. Exemplos:

A disponibilidade de URLs de consulta para cada ambiente autorizador poderá ser verificar no Portal Nacional da NF-e (tanto portal do ambiente de produção como portal do ambiente de homologação).

Quando a consulta não estiver disponível, seja por falha na comunicação com o eDocs, indisponibilidade da SEFAZ do cliente para realização de consultas de cadastros, ou por qualquer outro impedimento, o Gestão Empresarial | ERP não impedirá o cadastramento ou alteração cadastral do cliente, fornecedor ou transportadora e nenhuma mensagem será gerada ao referente a este procedimento. A tela F000APA poder ser utilizada posteriormente para solicitar nova atualização.

Como fazer testes e análises

Em determinados momentos, as informações trocadas na integração entre o Gestão Empresarial | ERP e o eDocs serão analisadas para identificar quais dados o eDocs está retornando para o ERP na consulta de um cadastro específico. Para esse tipo de análise, recomendamos executar uma requisição manual para a porta ConsultarCadastroContribuinte do web service de integração do eDocs.

Para mais informações, verifique as seguintes informações na Base de Conhecimento da Senior:

Este artigo ajudou você?