A oferta TOTVS Colaboração, compreende toda integração entre os ERPs TOTVS com a solução NeoGrid. Este documento tem por objetivo a definição das especificações e critérios técnicos necessários para a integração da recepção de nota fiscal de serviço eletrônica entre o ERP DATASUL e a Neogrid para atender a solução TOTVS Colaboração 2.0.
A integração referente à recepção de Notas Fiscais de Serviços Eletrônicas (NFS-e) de fornecedores abrange a utilização dos dados do XML da NFS-e recebido dos fornecedores para geração de informações para automatização do recebimento (digitação) de notas fiscais dentro do ERP.
Entre as vantagens que esta integração proporciona, estão:
A recepção de NFS-e, contempla a recepção, validação e tradução das informações inerentes ao negócio do fornecedor para informações de negócio do cliente.
O projeto TOTVS Colaboração 2.0 tem como objetivo a implantação de um modelo único e performático para possibilitar o relacionamento entre os clientes TOTVS que adquirem a solução TOTVS Colaboração.
O TOTVS Colaboração foi lançado em 2010 com a integração da solução ERP x TSS x Neogrid utilizando Web Services. Em julho de 2014 iniciou-se o projeto de reestruturação da arquitetura utilizada, passando a realizar a integração direta do ERP com a Neogrid através da troca de arquivos em diretório (filesystem).
Na versão 1.0 do TOTVS Colaboração a integração entre ERP e Neogrid era realizada via WebService com a utilização do TSS como produto fiscal único. Os XMLs eram gerados conforme padrões disponíveis no TSS.
Na versão 2.0, a integração será realizada diretamente entre ERP e Neogrid, sem o intermédio do TSS. Essa comunicação passa a ser feita com a utilização de troca de arquivos em diretório (filesystem).
Nessa arquitetura a comunicação é feita através da utilização de um ClientEDI que deve ser instalado no cliente, o qual ficará responsável por realizar a comunicação com a Neogrid.
A integração entre a Neogrid e a TOTVS tem as seguintes premissas:
Abaixo exemplo de comunicação na nova arquitetura:
A nomenclatura dos arquivos nos diretórios, tanto para envio como para retorno, deve seguir a padronização “[Tipo do Documento]_[Timestamp]_[Número sequencial].xml”, onde:
Exemplo de nome de arquivo para um documento de recepção de NFS-e: “319_20140627154700123_0001.xml”.
O envio de documentos pelo Client NeoGrid possui um controle de documentos duplicado. Arquivos enviados pelos ERPs TOTVS com o mesmo nome serão rejeitados.
A solução NeoGrid está preparada para que os ERPs enviem os arquivos de recebimento de NFS-e para validação com o código EDI 319:
Projeto | Fluxo | Cód EDI | Leiaute |
NFS-e Recebimento | Recebimento de NFS-e (Neogrid -> ERP) | 319 | XML padrão NeoGrid |
O padrão de comunicação utilizado entre ERP e Neogrid é por troca de arquivos em diretórios (filesystem) com a utilização do Client da Neogrid.
O ClientEDI é um JOB em JAVA onde é parametrizado o tempo de monitoramento do diretório e do WebEDI. Ele acessa o WebEDI utilizando WebServices onde é utilizado um método para envio e outro para buscar as mensagens processadas.
Dentro do diretório de instalação do Client existem duas subpastas denominadas IN e OUT, onde todos os arquivos a serem integrados devem ser depositados.
No ERP Datasul existe um JOB responsável por monitorar a subpasta IN e processar o retorno de todos os arquivos que forem depositados neste diretório.
A integração envolve o ERP (Datasul), a Neogrid e a Prefeitura e prevê dois fluxos: recebimento iniciado pelo ERP e recebimento iniciado pelo Neogrid, detalhados na sequência.
Recebimento iniciado pelo ERP:
Obs.: Neste caso o cliente recebe o XML por e-mail e importa a NFS-e para o ERP.
Passos:
Recebimento iniciado pelo Neogrid:
Obs.: Caso o cliente não utilize a emissão de NF-e/NFS-e pelo TOTVS Colaboração, a etapa “JOB Fiscal” pode ser retirada do fluxo, pois há a possibilidade de parametrizar a busca dos documentos diretamente do diretório do client Neogrid (IN).
Passos:
Contempla a recepção de notas fiscais de serviços prestados dentro do município.
Não está contemplada a recepção da mensagem de cancelamento/substituição da NFS-e.
Pré-requisitos (técnicos ou de negócio) para o funcionamento da integração:
Acessar o programa de configuração de diretórios do Colaboração 2.0 (CD0360A) e configurar os diretórios do Client Neogrid, conforme figura que segue.
No campo “Diretório Recepção Documentos” deve ser informado o diretório onde o ERP irá buscar os documentos.
Configurar a execução do JOB Fiscal que realiza a leitura dos documentos da pasta “IN”.
Este JOB pode ser executado de 2 formas:
OBS: Para mais detalhes sobre o JOB Fiscal devem ser acessados os manuais de emissão de NF-e no TOTVS Colaboração 2.0.
Configurar os parâmetros do conversor de documentos de entrada (RE0119);
Habilitar a funcionalidade para receber Conhecimento de Transporte, parâmetro “Habilita NFS-e”, nos parâmetros do Conversor (RE0119);
Configurar o engine de regras: O Engine de Regras possibilita configurar as condições externalizando a regra de negócio. Utilizar os programas CD0024 para cadastro das regras, CD0025 para cadastros de tipos de operação e CD0026 para testes.
As seguintes operações devem ser traduzidas pela Engine:
Para traduzir essas operações, deve ser possível passar as seguintes variáveis:
Para esta integração é necessária a instalação do Client Neogrid no servidor do cliente. Esta instalação não será detalhada neste documento pois é de responsabilidade da equipe Neogrid.
Nota:
- Podem ocorrer outros erros de negócio, no momento da efetivação da NFS-e no recebimento fiscal, porém a solução a ser adotada é a mesma utilizada para o recebimento no produto (sem que seja o conversor).
Pontos importantes para o funcionamento e atendimento da integração.
Verificações:
- Client Neogrid deverá estar em execução (lembrando que a parametrização deste é de responsabilidade da equipe Neogrid);
- JOB Fiscal (CD0590) deverá estar rodando em RPW ou via agente;
- Importador de notas (RE0522) do módulo de recebimento deve estar rodando em RPW;
- Demais Parametrizações do tópico 8 devem ser verificadas.