Integração TOTVS Colaboração NF-e/CT-e Logix 

Contexto de negócio 

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. 

Sistemas Envolvidos

• ERP Logix;

• TOTVS Service Sped (TSS);

• Portal Neogrid;

• ERP do fornecedor (pode ou não ser TOTVS).

Integração

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.

Escopo

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.

Pré-requisitos instalação/implantação/utilização

Os pré-requisitos (técnicos ou de negócio) para o funcionamento da integração são: 

• Logix versão 10.02 ou superior instalado;
• Pacote de liberação 1/2012 instalado;
• Versão JAVANFE 4.7.7 ou superior, Jdom, Itext;
• TSS versão 2.04 ou superior com base de dados dedicada (ambiente homologação e produção);
• Neogrid NF-e com a configuração do TSS;
• Serviço do JOB Logix deve estar startado (JOB0003).

Instalação/Atualizaçã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: 

• Criar atalho do “Totvsappserver.exe” na área de trabalho;
• Acionar o botão direito do mouse e selecionar a opção “Propriedades”;
• Alterar o caminho do atalho incluindo a opção no final: “-console”.

Incluir os programas no menu na área de Recebimento: 

• SUP34201 (Cadastro de processos NFE-Entrada);
• SUP34202 (Regras Dinâmicas NFE-Entrada);
• SUP34204 (Monitor de Notas NFE-Entrada);
• SUP20128 (Fornecedor EDI NFE-Entrada).

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: 

• Identificar os processos que serão integrados;
• Indicar a forma de integração;
• Aproximar arquivos XML do documento;
• Permite desativar um determinado processo;
• Cadastrar NF-e e CT-e em diretórios diferentes.

Parametrização do VDP9109 (Parâmetros de Processamento da NF-e) – Obrigatório

Os objetivos da parametrização do VDP9109 são: 

• Habilitar integração com Neogrid
• Determinar volume de retorno

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: 

• Identificar a forma da baixa de saldo no módulo de Compras;
• Flexibilizar as negociações com o fornecedor;
• Baixar pedido com programação própria.

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: 

• Permitir que todas as etapas de integração sejam automáticas isto é, sem a intervenção do usuário;
• Registrar as ações executadas no monitor de integração;
• Foco na gestão e no fluxo das informações.

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:

• Linha Logix > Agendador de Tarefas Logix > Anexos> AgendatorTarefasLogix.pdf.

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:

• Permitir maior liberdade na configuração do sistema;
• Minimizar impacto de implantação;
• Aumentar aderência de solução.

Variáveis

Regras

Retorno

Uso e Controle

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:

Suporte

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.

Fluxo das Informações

O fluxo de recebimento do XML dar-se-á da seguinte forma:

Fluxograma do Processo NF-e de entrada:

Situações comuns

• A mensagem de “Invalid HTTP Connection” no log do TSS (console.log) pode significar “Access Denied”, ou seja, o usuário que foi informado para autenticação HTTP, no portal da Neogrid pode estar inválido.
• A mensagem de “10060 : Connection timed out.” no log do TSS (console.log) significa que a URL de conexão com a Neogrid pode estar incorreta ou o serviço do portal da Neogrid não está disponível.

Checklist de suporte da aplicação

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”.