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.
Itens disponibilizados nesta etapa:
Envio do Pedido de Compra/Programação de Entrega para Fornecedor:
Recebimento do Pedido/Programação de Entrega no Fornecedor:
Envio do Complemento de Nota Fiscal de Venda para Fornecedor:
A integração de pedidos e programação de entrega tem o objetivo de permitir que o cliente com ERP Logix realize o envio de pedidos de compra e programações de entrega para fornecedores via TOTVS Colaboração. Permite também que um fornecedor com ERP Logix (ou outro ERP TOTVS) receba um pedido automaticamente de clientes TOTVS Colaboração via integração de arquivo XML, criando assim um pedido de venda no seu ERP e posteriormente receba as programações de entrega, alterando ou criando itens neste pedido.
Já o envio de complemento de nota fiscal de venda tem o objetivo de permitir que o fornecedor com ERP Logix realize o envio do complemento de uma nota fiscal de venda para seu cliente, depos de já ter validado previamente a NF-e na Sefaz. A integração deste complemento de nota fiscal de venda é utilizada para clientes que possuem ERP fora da base TOTVS.
O escopo desta integração compreende:
Não faz parte do escopo:
A estrutura das mensagens foi elaborada para que o receptor possa realizar primeiramente a implantação de um pedido de venda tendo as informações principais que podem ser complementadas no próprio ERP, e posteriormente, alterando os itens deste pedidos de acordo com as programações de entrega.
Pré-requisitos (técnicos ou de negócio) para o funcionamento da integração:
Versões mínimas de produto:
Pré-requisitos de negócio:
Este tópico tem por objetivo orientar na instalação da integração, visando o seu funcionamento completo.
Instalação do aplicativo servidor do TSS (TOTVS Service Sped) versão 2.14 ou superior.
Não faz parte do escopo deste documento detalhar a instalação/atualização do TSS no ambiente.
Atualização da biblioteca Java
Para iniciar a atualização da biblioteca Java será necessário efetuar o download no portal do cliente/Download, em (http://suporte.totvs.com/download).
Pesquisar por:
Linha = Logix;
Tipo = Outros;
Filtrar por Java conforme tela abaixo:
Mover os arquivos baixados do java (JAVANFE 4.7.7, Jdom, Itext) para a 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: Verificar as variáveis de ambiente, procurando pela variável CLASSPATH.
Setar as variáveis de ambiente:
CLASSPATH - acrescentar o caminho dos 3 .jar baixados: itext205.jar, nfeletronica.jar e jdom1.1.jar.
PROXY_NFE - setar o caminho do servidor TSS.
Em caso de dúvidas ao realizar a atualização, pesquisar o FAQ abaixo, publicado no TDN:
Parametrização do SUP34201 (Obrigatório) - Estrutura de diretórios por processo de importação
Identificar os processos que serão integrados, diretórios utilizados para armazenamento dos arquivos XML e se estes processos estão ativos. É importante manter como ativos somente os processos realmente utilizados, evitando assim processamento desnecessário no envio/busca de arquivos XML.
Os processos em funcionamento até a criação deste documento são:
Para cada processo serão informados os diretórios onde serão armazenados os arquivos XML, de acordo com a situação dos mesmos: Pendentes, Processados e Com Erro. Deve-se cadastrar cada qual em diretórios diferentes, organizando assim o armazenamento dos arquivos XML provenientes da integração.
Parametrização do VDP9109 (Obrigatório) – Parâmetros de Processamento da NF-e
Acessar opção de menu “tOtvs_colab” e assinalar o campo “Utilizar TOTVS Colaboração”. Cadastrar o usuário, senha do repositório e o tipo do ambiente (Homologação ou Produção), conforme informações disponibilizadas pela NeoGrid no momento da contratação da oferta do TOTVS Colaboração.
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.
O parâmetro “Produtos” serve para indicar se há emissão de algum documento eletrônico pelo TOTVS Colaboração. Quando o cliente tem emissão de Pedidos, Programação de Entrega ou Complemento de NF-e, estes devem ser assinalados.
Depois da parametrização é necessário configurar os dados no TSS, utilizando para isso a opção “Configurar TSS”. Esta opção enviará todas as configurações informadas nesta tela ao TSS, permitindo desta forma a integração dos processos informados, para os CNPJs liberados.
O parâmetro para indicar que utiliza TOTVS Colaboração também pode ser acessado através do LOG00087.
Parametrização do SUP20128 (Parâmetros por Fornecedor EDI/TOTVS Colaboração)
Observação: Corresponde à parametrização do SUP9990 (versão 10.02).
Identificar quais fornecedores trabalham com recebimento de pedido de compra ou programação de entrega via TOTVS Colaboração (“Enviar pedido de compra (XML)” e “Enviar programação de entrega(XML)”). Acessar por meio da opção “Parâmetros Fornecedor” no SUP34201 (Estrutura de Diretórios por Processo de Importação) ou “Parâmetros EDI/TOTVS Colaboração” no VDP10000 (Cadastro de Cliente e Fornecedor).
Parametrizacao do VDP90247 (Parâmetros por Cliente TOTVS Colaboração)
Identificar quais clientes trabalham com envio de complemento de nota fiscal via TOTVS Colaboração. Acessar por meio da opção “Parâmetros Cliente” no SUP34201 (Estrutura de Diretórios por Processo de Importação) ou “Parâmetros TOTVS Colaboração” no VDP10000 (Cadastro de Cliente e Fornecedor).
Parametrização do JOB0003 (Agendador de Tarefas Logix)
O TOTVS Colaboração permite a integração automática dos arquivos com extensão XML, utilizando agendamento (JOB). Ou seja, há uma rotina para enviar os pedidos de compra e programações de entrega aos fornecedores e os complementos de NF-e aos clientes, assim como receber os pedidos de compra e programações de entrega dos clientes, criar os pedidos de venda e atualizar os itens destes pedidos periodicamente. Este procedimento evita que o usuário tenha que executar uma rotina adicional para enviar seu pedido de compra ao fornecedor, por exemplo.
Os principais objetivos do agendamento são:
A rotina que deve ser agendada é o SUP34203, responsável por todo o processamento da integração via TOTVS Colaboração. É importante agendá-la para cada empresa que utiliza a integração, pois o envio e a busca de arquivos XML junto ao TSS é realizada por empresa (entidade, para o TSS).
Importante: Em caso de dúvidas na utilização do Agendador de Tarefas, consultar o TDN:
Linha Logix > Agendador de Tarefas Logix > Anexos > AgendadorTarefasLogix.pdf
Parâmetros para agendamento do SUP34203:
Para validar o cadastro de execução do Job, acesse o JOB0005 e consulte pelo código de gatilho cadastrado.
Parametrização do SUP34202 (Opcional, mas importante) - Regras Dinâmicas
O objetivo das regras dinâmicas é manter a flexibilidade e minimizar inconsistências na importação das mensagens, no caso atual, o recebimento do pedido e das programações de entrega por parte do fornecedor. Assim, quando satisfeitas as condições definidas na regra dinâmica, o conteúdo de alguns campos pode ser alterado antes da inclusão do pedido de venda ou alteração dos itens deste pedido no ERP do fornecedor, adaptando-se aos padrões da empresa.
Na primeira execução, o sistema cria a matriz com os campos que poderão ser utilizados para elaborar as condições e os retornos das regras dinâmicas.
O primeiro passo consiste em cadastrar a regra dinâmica para a empresa, na opção “Regras”.
Depois do cadastro da regra dinâmica, deverão ser definidas as condições para aplicação da regra, na opção “Condições”.
Definidas as condições para aplicação da regra dinâmica, é o momento de informar quais campos terão seus valores alterados quando as condições forem satisfeitas, além do novo conteúdo que será movido para estes campos. Esta tarefa é realizada na opção “Retornos”.
Incluir os programas no menu na área de Compras (caso for trabalhar com envio de Pedidos/Programações de Entrega)
SUP34201 (Estrutura de Diretórios por Processo de Importação)
SUP34204 (Monitor de Integração)
SUP20128 (Parâmetros por Fornecedor EDI/TOTVS Colaboração)
SUP34095 (Envio Avulso de Pedidos de Compra)
Incluir os programas no menu na área de Vendas (caso trabalhar com recebimento de Pedidos/Programações de Entrega)
SUP34201 (Estrutura de Diretórios por Processo de Importação)
SUP34202 (Regras Dinâmicas)
SUP34204 (Monitor de Integração)
VDP90247 (Parâmetros por Cliente TOTVS Colaboração)
Como estes programas foram desenvolvidos na tecnologia metadados, o tipo de processo no MEN0050 deverá ser 2.
Depois de cadastrar no menu, deverá ser realizada a liberação dos programas para o usuário pelo LOG05050 (Administração Logix) opção “Permissão de Acesso”.
Envio do Pedido de Compra pelo Cliente
O envio do pedido de compra poderá ocorrer de duas formas:
O segundo caso poderá ser utilizado quando um pedido de compra já foi incluído no ERP do cliente, porém o JOB ainda não foi processado e por algum motivo, há a necessidade de acelerar o processo e enviar o pedido imediatamente.
Importante:
A estrutura do TOTVS Colaboração somente contempla a integração da inclusão do pedido de compra, não considerando qualquer alteração das informações do pedido.
A integração de programação de entrega, que será explicada a seguir, consiste no envio das alterações das programações de entrega de um pedido previamente incluído, o que possibilitará ajustes em algumas informações dos itens dos pedidos de venda, especialmente a data de entrega e a quantidade.
Itens com mais de uma entrega serão transformados em vários itens no pedido de venda, cada qual com sua respectiva data, por característica do modulo de Vendas do ERP Logix.
Envio da Programação de Compra pelo Cliente
O envio da programação de entrega de compra pode ocorrer de duas formas:
O segundo caso pode ser utilizado quando há necessidade de acelerar o processo e enviar a alteração da programação imediatamente.
Importante:
O envio da programação de entrega somente pode ocorrer depois do envio prévio do pedido de compra. Além disso, a programação somente será enviada caso tenha sido alterada alguma informação depois do envio do pedido.
E vale lembrar que o envio é sempre total, ou seja, sempre são enviadas todas as ordens do pedido com suas respectivas programações de entrega. Ainda que seja alterada apenas uma das programações todo o pedido é reenviado, com todos os itens do pedido que ainda tenham saldo em aberto.
Recebimento do Pedido de Compra no Fornecedor
O recebimento do pedido de compra no fornecedor ocorre sempre por integração automática via JOB. Todos os XMLs de pedidos disponibilizados pela NeoGrid/TSS são importados para o ERP, gerando um pedido de venda com situação “Análise”. Depois disso, o pedido de venda entra no fluxo normal do pedido no módulo de Vendas, passando por todas as consistências, aprovações e processos posteriores.
Recebimento da Programação de Entrega no Fornecedor
O recebimento da programação de entrega no fornecedor também ocorre sempre por integração automática via JOB. Todos os XMLs de programações disponibilizados pela NeoGrid/TSS são importados para o ERP, alterando ou incluindo itens em um pedido de venda previamente incluído.
Importante:
É obrigatória a existência do pedido de venda previamente criado no ERP do fornecedor.
No momento do recebimento da programação de entrega, como são enviados todos os itens do pedido que ainda têm saldo em aberto, é realizada uma busca pelo código do item e data de entrega, visando atualizar a quantidade solicitada. Caso esta pesquisa retorne mais de um item, estes terão seus saldos cancelados e as novas quantidades solicitadas gerarão novos itens no pedido, assim como aqueles itens não encontrados no pedido atual.
Itens com mais de uma entrega serão transformados em vários itens no pedido de venda, cada qual com sua respectiva data, por característica do modulo de Vendas do ERP Logix.
Envio do complemento de nota de venda pelo fornecedor
O envio de complemento de nota fiscal de venda pelo fornecedor ocorre sempre por integração automática via JOB, depois de certificar-se que a NF encontra-se validada junto à Sefaz e o cliente em questão trabalha com a integração via TOTVS Colaboração.
Monitoramento da Integração
Para controle das integrações do TOTVS Colaboração no ERP Logix existe o Monitor de integração (SUP34204).
O objetivo do monitor de integração é gerenciar os arquivos com extensão XML integrados via TOTVS Colaboração. Até então, abrangia notas fiscais/conhecimento de fretes eletrônicos e agora passa também a gerir os pedidos/programações de entrega enviados e recebidos pelo processo, além dos complementos de notas enviados.
A principal informação deste monitor é o status de cada arquivo XML integrado. Além disso, é possível acompanhar todas as ações realizadas para o documento e inconsistências dos arquivos apontadas durante o processo de integração, visualizar os arquivos XML, enviar e-mails ao cliente/fornecedor, reprocessar arquivos que apresentaram as inconsistências e consultar os documentos integrados com sucesso.
Status possíveis para um processo de Pedido/Programação de Entrega de Compra ou Complemento de Nota Fiscal:
Depois de finalizado o processamento do Job ou o envio avulso (no caso de pedido/programação de entrega), caso não tenha nenhum erro, o status ficará como “9”-Enviado.
Status possíveis para um processo de Pedido/Programação de Entrega de Venda:
Rastreabilidade das ações realizadas e erros (caso existam):
Funcionalidades:
Importante:
Para identificar se um pedido de venda foi criado via integração pelo TOTVS Colaboração, basta consultá-lo no VDP20000 e acionar o botão “Detalhe”. Será exibida a tela “Detalhes do pedido” (VDP90055) e o campo “Origem”, quando informado “TOTVSCOLAB”, indicará que o pedido de venda foi incluído via integração via TOTVS Colaboração.
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.
Auxílio na execução dos programas do SUP ou parametrização do JOB para executar esta rotina deverá ser aberto chamado para o produto Gestão de Materiais.
A mensagem de pedido padrão foi definida em conjunto com as quatro marcas TOTVS, conforme layout da mensagem única de pedido (versão 2.0). Desta forma, o layout que é enviado pelo cliente é o mesmo recebido pelo fornecedor.
Tabela 1 – Layout do arquivo XML de pedido:
<BusinessContent> | Pedido (1 ocorrência) |
<VendorGovInfo> | Identificação do fornecedor – CNPJ/CPF (1 ocorrência) |
<CustomerGovInfo> | Identificação do comprador – CNPJ/CPF (1 ocorrência) |
<BillingLocationGovInfo> | Identificação do local de cobrança da fatura – CNPJ/CPF (de 0 a 1 ocorrência) |
<DeliveryCustomerGovernmentalInformation> | Identificação do local de entrega das mercadorias – CNPJ/CPF (de 0 a 1 ocorrência) |
<CarrierGovInfo> | Identificação da transportadora – CNPJ/CPF (de 0 a 1 ocorrência) |
<OTHER> | Campos livres do pedido (de 0 a 1 ocorrência) |
<ADDFIELDS> | Campos livres do pedido (1 ocorrência) |
<ADDFIELD> | Campo livre do pedido (de 0 a 20 ocorrências) |
<PAYMENTPLAN> | Parcelas de pagamentos (de 0 a 1 ocorrência) |
<TERM> | Parcela de pagamento (de 0 a N ocorrências) |
<LISTOFTAXESDOCUMENT> | Encargos/Descontos do pedido (de 0 a 1 ocorrência) |
<VALUESANDTAXES> | Encargo/Desconto do pedido (de 0 a N ocorrências) |
<SalesOrderItens> | Itens do pedido (1 ocorrência) |
<Item> | Item do pedido (de 1 a N ocorrências) |
<CROSSDOCKING> | Entregas do item (de 0 a 1 ocorrência) |
<CROSSDOCKING_ITEM> | Entrega do item (de 0 a N ocorrências) |
<LISTOFTAXESITEM> | Encargos/Descontos do item do pedido (de 0 a 1 ocorrência) |
<VALUESANDTAXES> | Encargo/Desconto do item do pedido (de 0 a N ocorrências) |
<OTHER> | Campos livres do item do pedido (de 0 a 1 ocorrência) |
<ADDFIELDS> | Campos livres do item do pedido (1 ocorrência) |
<ADDFIELD> | Campo livre do item do pedido (de 0 a 20 ocorrências) |
<SUMMARY> | Resumo do pedido (1 ocorrência) |
<OTHER> | Campos livres do pedido (de 0 a 1 ocorrência) |
<ADDFIELDS> | Campos livres do pedido (1 ocorrência) |
<ADDFIELD> | Campo livre do pedido (de 0 a 20 ocorrências) |
Os campos OTHER/ADDFIELDS/ADDFIELD são campos livres. O Logix envia o texto do pedido no primeiro grupo (no bloco <BusinessContent>) e textos dos itens no segundo grupo (no bloco <Item>), possibilitando, por exemplo, a identificação de uma compra de material de débito direto com item genérico.
Importante:
Não serão replicados cadastros de uma ponta a outra de forma integrada. Para que a integração seja concretizada de forma correta, os cadastros deverão existir nas duas pontas ou deverá ser criada alguma regra dinâmica no recebimento do pedido.
Ainda com relação aos cadastros, cabe salientar a prioridade que define a origem dos códigos dos itens no arquivo XML de pedido de compra enviado ao fornecedor:
· Tag <itemcode>
§ Item barra – código de barras, informado no MAN9922/MAN10021 (Cadastro de Itens) – Tag <typecodprod> = “EN".
§ Item – código do item no comprador, informado no MAN9922/MAN10021 (Cadastro de Itens) – Tag <typecodprod> = “BP"
· Tag <prodcoderpbuy>
§ Item – código do item no comprador, informado no MAN9922/MAN10021 (Cadastro de Itens).
· Tag <itemcodeprovider>
§ Item fornecedor – código do item no fornecedor, informado no SUP0090/ (SUP21011Credenciamento de Fornecedores).
Assim como no envio do pedido de compra, os códigos dos itens no arquivo XML de pedido recebido pelo fornecedor também seguem uma ordem para definir onde devem estar cadastrados:
· Tag <itemcode>
§ Item barra – código de barras do VDP, informado no MAN9922/MAN10021 (Cadastro de Itens), aba “Comercial” – Tag <typecodprod> = “EN"
§ Item no cliente – código do item no comprador, informado no MAN9922/MAN10021 (Cadastro de Itens), aba “Comercial 3” – Tag <typecodprod> = “BP"
· Tag <prodcoderpbuy>
§ Item no cliente – código do item no comprador, informado no MAN9922/MAN10021 (Cadastro de Itens), aba “Comercial 3”.
· Tag <itemcodeprovider>
§ Item – código do item no fornecedor, informado no MAN9922/MAN10021 (Cadastro de Itens).
A mensagem de programação de entrega foi definida em conjunto com as 4 marcas TOTVS. O mesmo layout que é enviado pelo cliente é o layout recebido pelo fornecedor.
Tabela 2 – Layout do arquivo XML de programação de entrega:
<BusinessContent> | Programação de Entrega (1 ocorrência) |
<LISTOFITENSDELIVERYSCHEDULING> | Pedidos/Itens do pedido (1 ocorrência) |
<ITENSDELIVERYSCHEDULINGINFORMATION> | Pedidos/Itens do pedido (de 1 a N ocorrências) |
<DELIVERIES> | Entregas do item (1 ocorrência) |
<DELIVERY> | Entregas do item (de 1 a N ocorrências) |
<OTHER> | Campos livres do item do pedido (de 0 a 1 ocorrência) |
<ADDFIELDS> | Campos livres do item do pedido (1 ocorrência) |
<ADDFIELD> | Campos livres do item do pedido (de 0 a 20 ocorrências) |
Os campos OTHER/ADDFIELDS/ADDFIELD são campos livres. O Logix envia o texto das ordens de compra nos itens no bloco <LISTOFITENSDELIVERYSCHEDULING >), possibilitando por exemplo, a identificação de uma compra de material de débito direto com item genérico.
A mensagem de complemento de nota fiscal de venda foi definida em conjunto com as 4 marcas TOTVS. Ela consiste no layout da NF-e adicionado de algumas tags adicionais.
Tabela 3 – Layout do complemento de nota:
< INVOIC_NFE_COMPL> | Principal(1 ocorrência) |
<NFE_SEFAZ> | Estrutura conforme XML padrão Nota Fiscal Eletrônica versão 2.00. (1 ocorrência) |
<COMPLEMENT_NFE> | Complemento da nota fiscal (1 ocorrência) |
<HEADER> | Cabeçalho(1 ocorrência) |
<OTHER> | Campos livres do item da nota(de 0 a 1 ocorrência) |
<ADDFIELDS> | Campos livres do item da nota(de 0 a 1 ocorrência) |
<ADDFIELD> | Campos livres do item da nota(de 0 a 20 ocorrências) |
<PAYMENT> | Condição de pagamento (de 0 a 1 ocorrência) |
<CONDITIONPAY> | Parcelas da condição de pagamento (de 0 a N ocorrências) |
<ITENS> | Itens da nota (1 ocorrência) |
<ITEM> | Itens da nota (de 1 a N ocorrências) |
<RETURNINDUSTRIALIZATION> | Informações sobre retorno de industrialização (de 0 a 1 ocorrência) |
< INVOICE_REFERENCED> | Notas de remessa para industrialização (de 0 a 1 ocorrência) |
< INVOICE_REFERENCED> | Notas de remessa para industrialização (de 0 a N ocorrências) |
<SUMMARY> | Resumo da nota (1 ocorrência) |
Fluxo completo do envio de pedido de compra do cliente (ERP Logix) para o fornecedor:
O cliente envia o pedido de compra para o fornecedor:
Fluxo completo do envio das programações de entrega do cliente (ERP Logix) para o fornecedor:
Cliente envia nova programação de entrega de um pedido de compra previamente enviado ao fornecedor:
Fluxo completo do recebimento do pedido de compra/programação de entrega do cliente pelo fornecedor (ERP Logix):
O recebimento de pedido e o de programação de entrega por parte do fornecedor funcionam de forma semelhante.
Fornecedor recebe pedido de compra ou programação de entrega do cliente:
Fluxo completo do envio do complemento de nota fiscal do cliente (ERP Logix) para o fornecedor:
Fornecedor envia complemento de nota para cliente:
Abaixo estão os check-lists de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.
Instalação/Configuração
Checklist de Verificações de negócio:
