A definição
O projeto DocFiscAll consiste numa solução para documentos fiscais eletrônicos dos modelos SPED 55 (NF-e) e 65 (NFC-e), incluindo os casos de notas mistas, como já realizadas no Distrito Federal e em Manaus (AM), visando maior agilidade e confiabilidade nas etapas de venda de produtos e serviços e check-out dos hóspedes.
A arquitetura utilizada
O projeto trabalha com plugins que fazem a emissão dos documentos e a sincronização, tanto destes documentos, quanto das informações cadastrais de itens, empresas, regras tributárias, parâmetros e outros com a base de dados utilizada pelo sistema Hotal Full, onde estão contidos os módulos VHF e FiscAll Flex (Oracle ou SQL Server) com um banco de dados secundário localizado no servidor da unidade, o qual será apresentado mais abaixo.
Sua composição é dada por:
- API DocFiscal;
- API FiscAllFlex;
- Robot (Robô);
- Banco de dados DOCFISCAL.
— A API DocFiscal:
A API DocFiscal é preparada para receber as informações dos PDVs TOTVS, da ferramenta Lançador (VHF) ou PDVs de terceiros. Após o recebimento das informações das vendas realizadas, a mesma faz a transmissão ou o cancelamento destes documentos para a respectiva Secretaria de Fazenda e faz consultas sobre situação dos documentos enviados, gravando as respostas das consultas na base de dados local.
— O plugin Robot (Robô):
O plugin Robot faz consultas regulares sobre atualizações de informações em ambos os bancos de dados e garante a simetria de informações entre os mesmos. Desta forma, quando são emitidos ou alterados os documentos fiscais na base de dados DOCFISCAL, estes serão sincronizados para a base de dados do Hotal Full. Quando forem feitas alterações em cadastros e parâmetros no banco de dados do Hotal Full que afetem a emissão de documentos fiscais, o plugin será responsável por escrever tais informações no banco de dados DOCFISCAL.
Sua operação é dada por meio de tarefas agendadas e repetidas em períodos regulares, as quais são configuradas em um painel dentro da aplicação. Esta configuração será demonstrada no decorrer deste artigo.
— A API FiscAllFlex:
A API FiscAllFlex é responsável por receber as informações enviadas pelo Robot e conceder respostas às consultas realizadas pelo mesmo, viabilizando a sincronização entre os bancos de dados Oracle/SQL Server com o banco de dados DOCFISCAL (MongoDB).
— O banco de dados DOCFISCAL:
O banco de dados DOCFISCAL armazena as informações utilizando o modelo de banco de dados não-relacional. Neste projeto, foi utilizado o Sistema Gerenciador de Banco de Dados (SGBD) MongoDB visando maior velocidade nas transações e reduzindo a possibilidade de perda de pacotes, traduzindo segurança e confiabilidade às operações.
A instalação
O projeto DocFiscal é de fácil instalação e não há a necessidade de ter um ambiente MongoDB previamente criado. Os arquivos deste projeto estarão inclusos no mesmo pacote de instalação do Hotal Full, disponível na Central de Downloads da TOTVS. Contudo, sua utilização é restrita às empresas que tenham contratado esta solução.
Para configurar a API DocFiscall, siga os passos abaixo:
- Acesse a pasta raiz do Hotal Full (por padrão, o caminho é C:\TOTVS\Hoteis) e clique duas vezes no arquivo WSPluginDocFiscal.exe. A seguinte janela irá abrir:
Observação: Este é o programa que fará o download dos instaladores do MongoDB. - Após a instalação do plugin, retorne à tela API DocFiscall e clique no botão .
Observação: não é necessário informar o usuário e senha do Windows para instalar o serviço.
Caso não informe, o serviço será instalado para o usuário System (Windows).
Caso informe, o serviço será instalado para este usuário específico. - Clique na guia NFe.
- Clique no botão .
Depois de configurada, a API terá suas informações preenchidas como o exemplo exibido a seguir:
Para configurar a API FiscAllFlex, siga os passos abaixo:
- Volte à pasta raiz do Hotal Full e clique duas vezes no arquivo WSPluginFiscAllFlex.exe. A seguinte janela irá abrir:
- Após a instalação do plugin, retorne à tela API FiscAllFlex e clique no botão .
Observação: não é necessário informar o usuário e senha do Windows para instalar o serviço.
Caso não informe, o serviço será instalado para o usuário System (Windows).
Caso informe, o serviço será instalado para este usuário específico. - Selecione o tipo de banco utilizado pelo Hotal Full (Oracle ou SQL Server).
- Preencha o campo Host com o endereço de rede do servidor do banco de dados do Hotal Full.
- Preencha o campo Alias com o nome do banco de dados do Hotal Full.
- Preencha o campo Usuário com o nome de usuário que é utilizado para login no FiscAll Flex.
- Preencha o campo Senha com a senha do usuário que é utilizado para login no FiscAll Flex.
- Preencha o campo Porta com a porta que será utilizada por esta aplicação. A porta é configurável e deve estar liberada tanto no Firewall quanto na rede.
- Clique no botão .
Para instalar o ambiente do banco de dados MongoDB, siga os passos abaixo:
- Acesse a pasta raiz do Hotal Full e clique duas vezes no arquivo WSPluginDocFiscal.exe. A seguinte janela irá abrir:
- Clique no botão e aguarde o download. Neste momento, estão sendo baixados os instaladores do MongoDB e do Robo3T, que é uma aplicação gratuita para gerenciamento e manipulação do banco de dados MongoDB.
- Terminado o download dos dois instaladores, avance com a instalação dos dois, sem ordem pré-definida.
Para configurar o Robot, siga os passos abaixo:
- Na pasta raiz do Hotal Full, execute o arquivo PluginRobot.exe.
- No campo Intervalo Geral
- Na janela Robot, que será aberta, clique na guia Conexão.
- Selecione o tipo de banco utilizado pelo Hotal Full (Oracle ou SQL Server).
- Preencha o campo Host com o endereço de rede do servidor do banco de dados do Hotal Full.
- Preencha o campo Alias com o nome do banco de dados do Hotal Full.
- Preencha o campo Usuário com o nome de usuário que é utilizado para login no FiscAll Flex.
- Preencha o campo Senha com a senha do usuário que é utilizado para login no FiscAll Flex.
- Mantenha os campos Limpar Sessão, Expirar Sessão e Máximo de Conexões com o valor padrão (zero - 0) e as opções Multiplas Conexões e Usuário Fixo desmarcadas.
- Retorne à guia Serviços.
- Clique no botão .
- Na janela que abrirá, clique no botão . Será aberta uma janela como esta:
- Clique duas vezes sobre uma linha. Neste exemplo, a linha DocFiscal Sincroniza Empresas recebeu dois cliques. Em seguida, é exibida esta tela:
- Clique, então, no botão .
- Repita os passos 10, 11, 12 e 13 até que todos os serviços tenham sidos selecionados.
Após a realização do passo 14, clique no botão .
- Clique no botão e será exibido o seguinte pop-up no canto inferior direito de sua tela:
- A partir deste momento, o serviço Robot já está funcionando corretamente.