TOTVS Colaboração
O TOTVS Colaboração é um projeto que permite a integração de cliente x fornecedor com os produtos TOTVS. A primeira fase disponibiliza o leiaute de importação de nota fiscal eletrônica (NF-e) e conhecimento de transporte eletrônico (CT-e), por meio da extensão XML, validado pela Secretaria da Fazenda (Sefaz).
O recebimento dos arquivos de entrada extensão XML pode ocorrer por ERP ou pelo produto da Neogrid, empresa parceira da TOTVS.
ERP
No modelo de gerenciamento dos arquivos extensão XML por ERP, o armazenamento dos arquivos é realizado na própria empresa, posteriormente enviados por JOB para validação da Sefaz e integrado para inclusão no sistema.
Neogrid
No modelo de gerenciamento dos arquivos extensão XML pela Neogrid, o armazenamento dos arquivos é realizado no banco da Neogrid. Os arquivos podem compor um grande volume e tratando-se de documentos legais, devem ser armazenados de forma que permita a localização rápida para uma auditoria, por exemplo.
ERP Logix;
TOTVS Service Sped (TSS);
Portal Neogrid;
ERP do fornecedor (pode ou não ser TOTVS).
Esta integração tem o objetivo de permitir que o cliente com ERP TOTVS realize o envio de NF-e e CT-e via TOTVS Colaboração. Permite também que um fornecedor com ERP TOTVS receba esses documentos automaticamente de clientes TOTVS Colaboração via integração de arquivo XML.
A proposta do TOTVS Colaboração compreende toda a integração entre os ERPs TOTVS com a solução Neogrid. A responsabilidade do TOTVS Service SPED (TSS) no TOTVS Colaboração é de integrar os ERPs com a Neogrid, provendo serviços que possibilitem a comunicação e transmissão de documentos entre as partes, conforme pode ser visto na figura abaixo.
Os pré-requisitos (técnicos ou de negócio) para o funcionamento da integração são:
Este tópico tem por objetivo orientar a instalação da integração, visando o seu funcionamento completo.
Atualização do TSS
Para iniciar a atualização do TSS e da biblioteca Java será necessário efetuar o download no portal do cliente/Download (http://suporte.totvs.com/download).
Pesquisar pela Linha = Logix, Tipo = Outros e filtrar por nfe_ conforme tela abaixo:
Salvar o arquivo do TSS no C:/, do servidor onde será instalado o TSS.
Fazer backup da pasta atual do TSS. E descompactar o arquivo .ZIP baixado do portal do cliente/download.
Copiar a pasta “certs” e o arquivo “totvsappserver.ini” para a nova versão baixada.
No arquivo “TotvsAppServer.ini” no parâmetro “JOBS”, deverá ser acrescentado “JOBDOCSCOL” e definido esta seção para realizar o recebimento de XML.
Exemplo:
[ONSTART]
JOBS=JOB_WS,JOBNFE,JOBDOCSCOL
[JOBDOCSCOL]
main=DOCSWFCOL
environment=SPED
Se o cliente for emitir nota fiscal pelo TOTVS Colaboração, deverá ser alterado no parâmetro “JOBS” o “JOBNFE” por “JOBNFECOL” e definir este novo JOB.
Exemplo:
[ONSTART]
JOBS=JOB_WS, JOBNFECOL,JOBDOCSCOL
[JOBNFECOL]
main=SPEDWFCOL
environment=SPED
Na seção [sped] colocar o parâmetro “DOCS_WF_DEBUG=1” para exibir a execução dos “JOBS” do “JOBDOCSCOL” e verificar se há o parâmetro “NFESPED_WF=1”, se não, incluir para exibir a execução dos “JOBs” do “JOBNFE” ou “JOBNFECOL”.
Se o cliente for emitir conhecimento eletrônico pelo TOTVS Colaboração, deverá ser alterado o parâmetro “JOBS” o “CTEWF” por “JOBCTECOL” e definir este novo JOB.
Exemplo:
[ONSTART]
JOBS=JOB_WS, JOBCTECOL,JOBDOCSCOL
[JOBCTECOL]
main=CTEWFCOLAB
environment=SPED
Se o cliente for emitir nota fiscal de serviço pelo TOTVS Colaboração, deverá ser alterado o parâmetro “JOBS” o “NFSE_WF” por “JOBNFSECOL” e definir este novo JOB.
Exemplo:
[ONSTART]
JOBS=JOB_WS, JOBNFSECOL,JOBDOCSCOL
[JOBNFSECOL]
main=NFSEWFCOL
environment=SPED
Salvar os arquivos baixados do Java (JAVANFE 4.7.7, Jdom, Itext) na pasta de javanfe do servidor logix, pasta que está setada o classpath dentro do servidor de aplicação.
Para descobrir o local instalado:
Linux: ps -ef |grep JAVA ou ps -ef |grep CLASSPATH
Win: Ir nas variáveis de ambiente.
Como executar o TSS como console:
Incluir os programas no menu na área de Recebimento:
Como estes programas foram desenvolvidos na tecnologia metadados a execução processo no MEN0050 deverá ser 2 conforme tela abaixo:
Depois de cadastrar no menu deverá ser realizada a liberação dos programas para o usuário pelo MEN0060.
Parametrização do SUP34201 (Estrutura de diretórios por processo de importação) – Obrigatório
Os objetivos da parametrização do SUP34201 são:
Parametrização do VDP9109 (Parâmetros de Processamento da NF-e) – Obrigatório
Os objetivos da parametrização do VDP9109 são:
Para efetuar a parametrização, deve-se acessar a opção de menu “tOtvs_colab” que exibirá a tela “Parâmetros Totvs Colaboração”.
Na tela abaixo, assinalar o campo “Utilizar TOTVS Colaboração”. Cadastrar o usuário, senha do repositório e o tipo do ambiente, conforme foram disponibilizados pela Neogrid.
O cadastro do usuário sempre deve estar no formato 99999999999999#tss, sendo “99999999999999” um CNPJ válido nos cadastros da Neogrid e “tss” o usuário disponilizado pela Neogrid.
A Neogrid trabalha apenas em ambiente de produção para realização do envio do XML para o ERP, pois sempre trabalha com NF-es válidas. Desta maneira, deverá sempre ser informado o ambiente NF-e e ambiente CT-e como “1”, que indica ser o ambiente de “Produção”.
O parâmetro “Produtos” serve para indicar se há emissão de algum documento eletrônico pelo TOTVS Colaboração. Quando o cliente tem apenas recebimento de XML este parâmetro deverá estar como “Nenhum”.
Parametrização do SUP20128 (Parâmetros por Fornecedor EDI/TOTVS Colaboração)
Os objetivos da parametrização do SUP20128 são:
Observação: Corresponde à parametrização do SUP9990 (Parâmetros EDI) da versão 10.02.
Parametrização do JOB0003 (Agendador de Tarefas Logix) - Opcional, mas importante
Os objetivos da parametrização do JOB0003 são:
Importante:
No JOB deve ser configurado o programa sup34203 para execução.
Para efetuar a parametrização no SUP34203 para execução via JOB, conforme documentação do TDN:
Informar valor = empresa
Usuário informado no JOB
Para validar o cadastro de execução do JOB, acesse o JOB0005 e consulte pelo código de gatilho.
Parametrização do SUP34202 (Regras Dinâmicas) – Opcional, mas importante
Os objetivos da parametrização do SUP34202 são:
Variáveis
Regras
Retorno
Processo Monitor de NF-e de entrada:
Os objetivos do processo monitor de NF-e são:
Permite acompanhar todas as ações realizadas para o documento;
Registro dos erros durante o processo de integração.
Rastreabilidade
Os objetivos da rastreabilidade são:
Permitir acompanhar todas as ações realizadas para o documento;
Registro dos erros durante o processo de integração.
Funcionalidades
Integrações:
Caso necessite de auxílio na configuração do TSS para conectar com a Neogrid e nas parametrizações do VDP9109 deverá ser aberto chamado para o produto Gestão Fiscal.
Auxilio na execução dos programas do SUP ou parametrização do JOB deverá ser aberto chamado para o produto Gestão de Materiais.
O fluxo de recebimento do XML dar-se-á da seguinte forma:
Fluxograma do Processo NF-e de entrada:
Abaixo está o check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.
Instalação/Configuração
1. Verificar se o serviço do TSS está disponível via HTTP (Navegador Web), normalmente a URL é “HTTP:\SERVIDOR:PORTA\SPED”;
2. Verificar se o serviço da Neogrid está disponível via HTTP (Navegador Web);
3. Verificar no log do TSS (console.log) se ocorrem mensagens de erro na execução dos JOBs;
4. Em caso de retorno negativo do TSS para o Logix a mensagem será exibida no relatório de erros do JOB.
5. Em caso de inconsistências da mensagem já no ERP elas poderão ser consultadas no monitor de integração Logix (SUP34204).
Checklist de Verificações de negócio:
1. Habilitar o parâmetro “Utiliza TOTVS Colaboração” no VDP9109, opção de menu opção “tOtvs_colab” ou LOG00087;
2. Parametrizar no VDP9109, opção de menu “tOtvs_colab”, o usuário, senha e o tipo do ambiente, e enviá-los ao TSS, opção “Configurar TSS”.
