P12 - TOTVS Colaboração 2.0

Essa melhoria altera as formas de transmissão e de recebimento dos documentos via TOTVS Colaboração.

Atualmente, o TOTVS Colaboração utiliza o TSS (TOTVS® Service SOA) para realização do tráfego dos documentos entre o ERP Microsiga Protheus® e a plataforma NeoGrid por meio do emprego da tecnologia Web Service. Nesta versão do TOTVS Colaboração, denominada 2.0, foi empregado o uso do Client NeoGrid - que será o responsável pelo tráfego dos arquivos gerados pelo Microsiga Protheus® - e dos sistemas da NeoGrid em substituição a utilização do TSS.

A proposta do Client NeoGrid é facilitar e agilizar o processo de transmissão dos documentos fiscais, pois trabalha completamente integrado aos serviços disponíveis no TOTVS Colaboração no que se refere à plataforma NeoGrid. Basicamente, trata-se de um software que deve ser instalado no servidor de aplicação ERP, capaz de monitorar um diretório de saída de documentos alimentado pelo ERP Microsiga Protheus® e de realizar a transmissão para os serviços disponíveis do TOTVS Colaboração sob plataforma NeoGrid. Este software também tem como finalidade verificar junto a plataforma NeoGrid a existência de documentos pendentes de retorno, e em caso afirmativo, atualizar um diretório de entrada para leitura do ERP Microsiga Protheus.

Para melhor entendimento, seguem abaixo as etapas do processo padrão de envio de arquivos via TOTVS Colaboração 2.0:

     Envio

1. O Protheus® gera o arquivo com extensão *.xml no diretório de saída do Client NeoGrid.
2. O Client NeoGrid faz uma busca no diretório de saída e envia o arquivo para os serviços web do TOTVS Colaboração na NeoGrid.
3. Após concluir o envio, o arquivo do diretório de saída é movido para o diretório de documentos enviados.

     Recebimento

1. O Client NeoGrid analisa, em um determinado intervalo de tempo, a existência de documentos disponíveis para recebimento. Em caso afirmativo, será gravado no diretório de entrada o arquivo .xml correspondente ao documento de entrada.
2. Após esta gravação, o ERP Microsiga Protheus® executa, via Schedule de importação, a leitura do arquivo e a sua importação para o sistema.
3. O ERP Microsiga Protheus® executa também, via Schedule de importação, a movimentação do arquivo lido (que está no diretório de entrada) para o diretório de arquivos lidos/processados.

Lista de documentos

Abaixo está a lista de documentos disponíveis no produto TOTVS Colaboração 2.0, referente a linha Microsiga Protheus®.

Procedimento para Implementação

• Tabela CKP – Parâmetros TOTVS Colaboração

• Tabela CKQ – Monitor de documentos TOTVS Colaboração

• Tabela CKO – Controle de arquivos TOTVS Colaboração

Importante

A tabela CKO deve ser única para todas as empresas do sistema, desta forma o campo X2_ARQUIVO deve estar preenchido obrigatoriamente com o conteúdo CKOCOL, para que a importação de arquivos funcione corretamente.

1. Criação de Campos no arquivo SX3 – Campos:

• Tabela CKP – Parâmetros TOTVS Colaboração

• Tabela CKQ – Monitor de Documentos TOTVS Colaboração

• Tabela CKO – Controle de Arquivos TOTVS Colaboração

1. Criação de Índices no arquivo SIX – Índices:

• Tabela CKP – Parâmetros TOTVS Colaboração

• Tabela CKQ – Monitor de Documentos TOTVS Colaboração

• Tabela CKO - Controle de arquivos TOTVS Colaboração

Importante

O tamanho dos campos que possuem grupo pode variar conforme o ambiente em uso.

Procedimento para Configuração  

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:  

Importante

O conteúdo deste parâmetro deve ser informado separado pelo caractere de vírgula (,), para que seja possível informar a utilização de mais de um tipo de documento. Exemplo: Será utilizado apenas NF-e e CT-e, o conteúdo informado será: 1,2.

Importante

É de extrema importância para o funcionamento correto da solução que os caminhos dos diretórios sejam informados corretamente, conforme a instalação do Client da NeoGrid. Obrigatoriamente, o Client deve ser instalado a partir do RootPath de instalação do Microsiga Protheus®, para que o Schedule de importação possa localizar os arquivos recebidos e integrar de forma automática para a base do Protheus.

Procedimento para Utilização  

Schedule de Importação

Após a atualização, será necessário apenas a configuração do Schedule de importação. Este Schedule será o responsável pela importação dos arquivos XML que serão recebidos via Client Neogrid no diretório “IN”, localizado dentro da instalação do Client (este é o diretório que deve ser configurado no parâmetro MV_NGINN). Os arquivos serão importados para a Tabela CKO - Controle de arquivos TOTVS Colaboração. Após a gravação do arquivo na tabela, o Schedule move o arquivo da pasta IN para a pasta configurada no parâmetro MV_NGLIDOS.

1. No Configurador (SIGACFG), acesse Ambiente/ Schedule/ Schedule.
2. Clique em Agent/ Cadastro.
3. Em Detalhes clique em Incluir.
4. Informe um nome para o agente.
5. No campo IP e Porta informe os mesmos dados do Microsiga Protheus®.

 O ambiente é preenchido automaticamente.

1. Informe o grupo de empresas.
2. No campo Número de Threads, informe a opção 4.
3. Confira dos dados e confirme.
4. Clique em Agendamentos/Cadastro.
5. Em Detalhes clique em Incluir.
6. Informe o nome da rotina (colAutoRead).
7. Selecione a empresa/ filial desejada e o módulo correspondente.
8. Clique na opção Recorrência e marque Sempre Ativo.
9. Clique em Confirmar para o agendamento.
10. Clique em Agent e clique em Iniciar Todos os Serviços.

É recomendável reiniciar o Server.

Importante

Não é necessária a configuração do Schedule para todas empresas e filiais cadastradas, podendo ser configurado para uma única empresa. Como a tabela CKO é única para todas empresas/ filiais e os arquivos que serão recebidos via Client também, se o Schedule for iniciado para uma empresa/ filial, processará todas as existentes.

Caso deseje que seja apresentado no console da aplicação o procedimento que o Schedule realiza, é possível habilitar o parâmetro abaixo no arquivo appserver.ini na seção “Enviroment”:

COLAUTOREAD_DEBUG=1

Emissão de NF-e e CC-e – TOTVS Colaboração 2.0

Importante

Para informações sobre a utilização da Nota Fiscal Eletrônica, é fundamental a leitura do Manual para Documentos Eletrônicos, disponível no portal TDN pelo link: http://tdn.totvs.com, em: Softwares de Gestão/ Linha Microsiga Protheus®/ Fiscal/ Notas Fiscais Eletrônicas/ Banco de Conhecimento/ Documentos Eletrônicos.

Abaixo estão informadas as alterações realizadas na Nota Fiscal Eletrônica e na Carta de Correção Eletrônica da NF-e, quando configuradas para TOTVS Colaboração 2.0:

1. Foi retirado o Wizard de Configuração, que não será necessário pois a configuração do certificado deverá ser feita na NeoGrid. Os e-mails informativos também serão enviados por meio da plataforma NeoGrid.
2. Foram retirados o Status Sefaz, a Consulta Chave e a Consulta Contribuinte, visto que estes serviços não estão disponíveis via TOTVS Colaboração 2.0, pois se tratam de serviços Síncronos.
3. Usualmente, os processos de Transmissão, Cancelamento/ Inutilização e Monitor continuam da mesma forma. Internamente foram realizados tratamentos para que trabalhem corretamente via TOTVS Colaboração 2.0.
4. Foi retirada a validação de Schema, pois esta será realizada após a transmissão do arquivo para a NeoGrid, que retornará com o problema descrito de schema, caso exista.

MD-e – TOTVS Colaboração 2.0

Importante  Para informações sobre utilização da Manifestação do Destinatário Eletrônica, é fundamental a leitura do Boletim Técnico COM_BT_Manifestacao do Destinatario, disponível no portal TDN pelo link: http://tdn.totvs.com, em: Softwares de Gestão/ Linha Microsiga Protheus® /Materiais/ Compras e Suprimentos/ Boletim técnico/ Versão 11.

Abaixo seguem as alterações realizadas na Manifestação do Destinatário, quando configurados para TOTVS Colaboração 2.0:

1. Foi retirado o Wizard de Configuração, que não será necessário pois a configuração do certificado deverá ser feita na NeoGrid. Os e-mails informativos também serão enviados por meio da plataforma NeoGrid.
2. Foi alterada a funcionalidade Sincronizar. Como se tratava de um serviço síncrono, foi necessário o ajuste para trabalhar de forma assíncrona. Assim, esta funcionalidade trabalhará junto com a funcionalidade Atualizar.
3. Foi inserida a funcionalidade Atualizar, que será responsável por atualizar a tela para que quando os documentos forem sincronizados apareçam em tela.
4. Foi retirada a funcionalidade Baixar Zip e esta foi substituída pela funcionalidade Exportar para o TOTVS Colaboração 2.0. A Alteração foi realizada para que o processo funcione de forma assíncrona.
5. Inserida a opção Exportar com duas funcionalidades: Solicitar e Monitorar.
6. A funcionalidade Solicitar realiza a solicitação do download do XML para a NeoGrid.
7. A funcionalidade Monitorar abre um monitor para controle das solicitações de downloads, no qual é possível realizar o download por meio do botão Baixar, apenas quando estiver disponível.
8. Usualmente os processos de Configurar, Manifestar e Monitorar continuam da mesma forma. Internamente foram realizados tratamentos para que trabalhem corretamente via TOTVS Colaboração 2.0.

Emissão de NFS-e – TOTVS Colaboração 2.0

Importante Para informações sobre a utilização da Nota Fiscal Eletrônica, é fundamental a leitura do Manual para Documentos Eletrônicos disponível no portal TDN pelo link: http://tdn.totvs.com, em: Softwares de Gestão/ Linha Microsiga Protheus®/ Fiscal/ Notas Fiscais Eletrônicas/ Banco de Conhecimento/ Documentos Eletrônicos.

Abaixo seguem as alterações realizadas na Nota Fiscal de Serviços Eletrônica, quando configurados para TOTVS Colaboração 2.0:

1. Foi retirada a opção Wizard de Configuração, que não será necessário pois a configuração do certificado deverá ser feita na NeoGrid. Os e-mails informativos também serão enviados por meio da plataforma NeoGrid.
2. Foram retiradas as opções Imp.Retorno, Abrir URL e Tabela AIDF, visto que estes serviços não estão disponíveis via TOTVS Colaboração 2.0, pois se tratam de serviços Síncronos.
3. Usualmente os processos de Transmissão, Cancelamento e Monitor continuam da mesma forma. Internamente foram realizados tratamentos para que trabalhem corretamente via TOTVS Colaboração 2.0.
4. Foi retirada a validação de Schema. Esta será realizada após a transmissão do arquivo para a NeoGrid, que retornará com o problema descrito de Schema, caso exista.
5. A geração do arquivo conforme layout definido pela NeoGrid será realizada por meio da rotina customizável (NFSEXMLUni.prw).
6. Caso utilize uma condição de pagamento superior em duas vezes ou mais o parâmetro MV_1DUP deve conter o conteúdo igual a 01 (numérico) pois no acordo firmado com a Neogrid as parcelas devem ser geradas somente com conteúdo númerico.

MDF-e – TOTVS Colaboração 2.0

Importante Para informações sobre a utilização do Manifesto Eletrônico de Documentos Fiscais, é fundamental a leitura do Manual para Documentos Eletrônicos disponível no portal TDN pelo link: http://tdn.totvs.com, em: Softwares de Gestão/ Linha Microsiga Protheus®/ Fiscal/ Notas Fiscais Eletrônicas/ Banco de Conhecimento/ Documentos Eletrônicos.

Abaixo seguem as alterações realizadas na Manifestação do Destinatário, quando configurados para TOTVS Colaboração 2.0:

1. Foi retirado o Wizard de Configuração que não será necessário pois a configuração do certificado deverá ser feita na NeoGrid. Os e-mails informativos também serão enviados por meio da plataforma NeoGrid.
2. Foi retirado o Status Sefaz, visto que este serviço não está disponível via TOTVS Colaboração 2.0, pois se trata de serviço Síncrono.
3. Usualmente os processos de Transmissão, Cancelamento, Encerramento e Monitorar continuam da mesma forma. Internamente foram realizados tratamentos para que trabalhem corretamente via TOTVS Colaboração 2.0.
4. Retirada a validação de Schema, esta validação será realizada após a transmissão do arquivo para a NeoGrid, que retornará com o problema descrito de schema, caso exista.

CT-e – TOTVS Colaboração 2.0

Importante Para informações sobre a utilização do Conhecimento de Transporte Eletrônico de Documentos Fiscais, é fundamental a leitura do Manual para Documentos Eletrônicos, disponível no portal TDN pelo link: http://tdn.totvs.com, em: Softwares de Gestão/ Linha Microsiga Protheus®/ Fiscal/ Notas Fiscais Eletrônicas/ Banco de Conhecimento/ Documentos Eletrônicos.

Abaixo seguem as alterações realizadas no Conhecimento de Frete Eletrônico, quando configurados para TOTVS Colaboração 2.0:

1. Foi retirada a opção Status, visto que este serviço não está disponível via TOTVS Colaboração 2.0, pois se trata de serviço Síncrono.
2. Usualmente os processos de Transmitir, Cancelamento, Inutilização e Monitor continuam da mesma forma. Internamente foram realizados tratamentos para que trabalhem corretamente via TOTVS Colaboração 2.0.

EDI-Pedido – TOTVS Colaboração 2.0

Abaixo seguem as alterações realizadas nas rotinas de Geração de Pedido de Venda e Programação de Entrega, quando configuradas para TOTVS Colaboração 2.0:

1. Configurar uma job que acione a função MA411Job(), utilizando o SIGACFG, no menu Ambiente/ Schedule/ Schedule.
2. Configurar uma job que acione a função MA412Job(), utilizando o SIGACFG, no menu Ambiente/ Schedule/ Schedule.
3. Configurar o parâmetro MV_TCNEW igual a 6.
4. Configurar o parâmetro MV_NGINN com o caminho da pasta para recebimento do XML da neogrid.
5. Configurar o parâmetro MV_NGLIDOS com o caminho da pasta para mover os arquivos XML já processados da neogrid.
6. Usualmente os processos de Geração do Pedido de Venda e Geração da Programação de Entrega continuam da mesma forma. Internamente foram realizados tratamentos para que trabalhem corretamente via TOTVS Colaboração 2.0.

Informações Técnicas