Monitor Fiscal
Descrição
A Integração Fiscal Online 3.0 foi desenvolvida para possibilitar a sincronização das informações de maneira mais ágil entre os sistemas Construshow e Fiscal, possibilitando uma conferência e acompanhamento mais assertivo das apurações de impostos e demais informações que são compartilhadas entre os sistemas por meio da integração.
⚠️Importante: Este manual aborda apenas a configuração da Integração Fiscal numa instalação do Construshow com TMS
Índice
Pré-Requisitos
O módulo Fiscal deve estar instalado, atualizado e configurado corretamente no servidor.
As Configurações de Documento no Construshow devem estar parametrizadas para exportar para o módulo Fiscal.
Pelo menos um estabelecimento no módulo Fiscal deve estar ativo e configurado para uso.
É fundamental ter conhecimento sobre os parâmetros de exportação do SPED no módulo Fiscal.
Ao garantir o cumprimento desses pré-requisitos, a exportação do SPED poderá ser realizada com sucesso. No entanto, é importante destacar que a familiaridade prévia com o módulo Fiscal e suas funcionalidades é crucial para garantir que o processo seja executado sem problemas. Por isso, recomendamos que sejam realizados testes preliminares e que sejam seguidas as orientações específicas do manual de utilização do módulo Fiscal para a exportação do SPED e integração do Fiscal com o Construshow.
Passo a passo
7 - Monitor Fiscal
O Monitor Fiscal é uma rotina que foi criada totalmente a partir do TMS o qual possui uma hierarquia de pastas e estrutura de instalação diferente do que foi desenvolvido para o Construshow no Delphi 7. O funcionamento do Monitor Fiscal no TMS dispensa o uso do Servidor XE e da execução de script de carga inicial via banco de dados, pois podemos fazer todo este procedimento via interface de usuário. A seguir será detalhado como fazer a carga inicial para cada tipo de agrupamento de registros.
7.1 - Carga inicial de Cadastros
O grupo de Cadastros envolve registros de Pessoas, Mercadorias e não precisa ser definido um período específico, pois o objetivo é fazer a carga de todas as Pessoas e Mercadorias do Construshow para o Estabelecimento Fiscal.
No exemplo abaixo consultamos o registro de Pessoas que ainda não foram sincronizadas para a Fila Fiscal, que é a tabela do banco de dados o qual controla os envios para o Fiscal. Note que elas estão com o status “Não Integrado”.
Para Sincronizarmos os registros de Pessoas, basta clicarmos na caixa de seleção para Marcar todos os registros retornados na grade do Monitor, e clicarmos no botão Sincronizar. Temos também o botão Sincronizar em Massa, o qual podemos utilizar para fazer a carga apenas do que estiver com status Não Integrado, ignorando os registros que já estão na fila para sincronização ou que já foram integrados. Após a sincronização a situação será alterada para “Na Fila”.
Podemos aguardar o Job fazer a sincronização de forma automática conforme o período estipulado no Agendador de Tarefas ou forçar a integração dos registros para o Fiscal. Para isto, basta acessarmos o Agendador de Tarefas e forçarmos a sincronização.
Após a sincronização, caso a sincronização ocorra com sucesso, o registro irá mudar a situação para Integrado.
7.2 - Carga de Movimentações
Para os registros do grupo Movimentações precisamos informar a Data Inicial e Data Final dos registros os quais queremos consultar. Nos registros de Entrada e Saída é possível selecionar para que seja consultado apenas uma configuração de Documento ou estabelecimento específico. Lembrando que para que sincronize de outro estabelecimento, é necessário que ele já esteja configurado para sincronização do Fiscal Online.
Para fazer a carga basta selecionarmos o Período desejado, clicar em Consultar, selecionar o registro e clicar em Sincronizar.
7.3 - Carga de Periódicos
A carga de Periódicos são registros enviados apenas mensalmente. O print abaixo demonstra o envio da carga de Inventário. Note que precisamos informar o Motivo do Inventário para que o registro possa ser sincronizado.
7.4 - Status de Integração
O Status de Integração permite Consultar o Status de registros de todos os grupos de registros que ainda estão na Fila Fiscal com status Pendente, Reenvio e com Advertência. Nesta mesma tela também é possível selecionar registros específicos para que sejam reenviados.
7.5 - Situação dos Registros
A seguir será explicado brevemente as Situações que são apresentados no Monitor Fiscal envolvendo os registros consultados. As situações variam de acordo com o campo ENV_STATUS da tabela FILAFISCAL do banco de dados.
Não Integrado: Indica que o registro não está na fila fiscal para ser sincronizado.
Na Fila: Registro Pendente de sincronização ao Fiscal.
Reenvio: Registro marcado para reenvio.
Integrado: Registro que está na FilaFiscal e que foi enviado ao Fiscal.
Advertência: Registro o qual o módulo Fiscal retornou erro. Quando isso ocorre, temos na coluna Aviso uma descrição do erro.
8 - Como fazer o Acompanhamento Fiscal Online para consultar as integrações realizadas pelo Construshow?
Com a configuração finalizada e após a execução do JobFiscal do ViasoftServerMCP_XE.exe, dentro do módulo Fiscal acesse o menu Processos >> Importação >> Acompanhamento Fiscal Online.
Nele temos filtros os quais nos permitem consultar apenas notas em que a Situação está Com Erro ou Importado. Também é possível filtrar que pesquise apenas um tipo específico de Registro. Após a definição dos filtros clicamos no Executar para que seja apresentado o resultado.
Exemplo prático de análise do acompanhamento de Integração Online no Fiscal:
Abaixo temos um exemplo bem prático de caso em que após a alteração do registro de cadastro de Pessoas, o sistema retornou o campo Situação “Com erro” devido inconsistência no cadastro da Cidade vinculada ao Registro de Pessoa. Podemos observar no campo de Descrição que o sistema está pegando o código da cidade, sendo que o previsto no Layout Fiscal Online está no formato CODIGO PAIS| CÓDIGO UF | CÓDIGO MUNICIPIO (todos do IBGE), e no botão JSON podemos observar como o Construshow montou o registro.
Após o ajuste na geração do formato JSON baseado no Layout Fiscal Online pelo desenvolvedor, ao executarmos novamente o mesmo ainda exibe o histórico dos erros, porém o que consideramos importante é sempre o Recebimento mais atual, onde a Situação agora aparece como “Importado”, indicando que o mesmo foi importado com sucesso ao Fiscal.
Também é possível conferir que após a importação bem-sucedida, quando acessamos o menu Cadastros: Específicos >> Pessoas (Emitentes) >> Pessoas, todos os dados da Pessoa e que são pertinentes ao Fiscal foram sincronizados.
Caso a integração por algum motivo não seja bem sucedida, também é possível consultar o arquivo de log gerado pelo XE. E:\Viasoft\Server\Fiscos\IntegracaoOnlineFiscal\WinSWFiscalOnline.out.log.
Outra verificação neste sentido é consultando no banco de dados se os registros que não foram sincronizados constam na
tabela FILAFISCAL e se o campo ENV_STATUS está com Status “P” (Pendente).
Caso ocorra alguma situação em que o registro na FILAFISCAL mudou o Status para “S” e mesmo assim não apareça no Fiscal, podemos alterar via banco o status para “P”, executar a sincronização pelo XE e verificar no Active MQ se aparece o JSON deste registro. Outra forma de analisar o erro é através da tabela VIASOFTFISCAL.log_integracao.
select * from VIASOFTFISCAL.log_integracao where ids like '%NOTA|3000|3408%' order by DATARECEBIMENTO desc;
Dicionário de Dados
Dicionário do Banco de Dados
Caso tenha interesse em saber os campos do banco de dados que se relacionam a cada campo do sistema, sugerimos a leitura do artigo a seguir: Dicionário do Banco de Dados - Documentação para Usuários - Confluence
Erros Comuns
Situações que podem ocorrer durante o uso da rotina
Versão
Versão do Sistema | Versão do Banco de Dados | Versão da Documentação | Autor/Revisor |
---|---|---|---|
23.010 | 23.010 | 1.0 | Fátima Zahraa |
|
|
|
|