A oferta TOTVS Colaboração, compreende toda integração entre os ERP’s TOTVS com a solução NeoGrid. A responsabilidade do TSS (TOTVS Service SPED) no TOTVS Colaboração é de integrar os ERP’s 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 1:
A oferta TOTVS Colaboração Compras compreende a integração da emissão de pedidos de compra e programação de entrega do ERP Datasul com a solução NeoGrid, possibilitando o envio de pedidos de compra e programação de entrega para o fornecedor, conforme fluxo da figura 2:
Seu negócio, sua gestão, complexidade, o que está envolvido (em demais áreas), processos, etc. Tais explanações não precisam citar ferramentas (softwares) e sim as expectativas e resultados do uso de um sistema informatizado.
Interessante citar as tendências e necessidades de mercado, o quê, em geral, os software proporcionam (destinam/propósito), principais recursos, etc, e motivos que levaram a criar a integração (em outros termos, o porquê de integrar).
Para os processos de envio de pedido de compra e programação de entrega de clientes:
ERP Datasul (Módulo de compras/contratos), TOTVS Service Sped (TSS), Portal Neogrid e ERP do fornecedor.
Para o processo de recebimento de pedidos de venda para fornecedores:
ERP Datasul (Módulo de Pedidos/Pedido de Venda), TOTVS Service Sped (TSS), Portal Neogrid e ERP do cliente.
Para o processo de envio de aviso de embarque para cliente:
ERP Datasul (Módulo de Faturamento), TOTVS Service Sped (TSS), Portal Neogrid e ERP do cliente.
A integração tem o objetivo de permitir que o cliente com ERP Datasul realize o envio de pedidos de compra e programação de entrega para fornecedores via oferta do TOTVS Colaboração, ou caso o cliente usuário do ERP Datasul ter a função de fornecedor, realize o recebimento e implantação de pedidos de venda enviados via TOTVS Colaboração, e posteriormente envie o aviso de embarque das notas fiscais.
O escopo desta integração é o envio da entidade pedido de compra e programação de entrega do cliente para o fornecedor, ou o recebimento de pedido de venda enviado por meio da oferta TOTVS Colaboração ao ERP Datasul do fornecedor. Não faz parte do escopo o envio de mensagens com as entidades relacionadas ao pedido de compra/programação de entrega, como por exemplo: Informações específicas do Item (Produto) e cadastro do Cliente. A estrutura da mensagem foi montada para que o receptor possa realizar a implantação de um pedido de venda tendo as informações principais.
Pré-requisitos (técnicos ou de negócio) para o funcionamento da integração:
Este tópico tem por objetivo orientar a instalação da integração, visando o seu funcionamento completo.
Módulos ou programas (ERP Datasul) que geram informações necessárias a integração:
Configurações importantes para a integração (folder “Colaboração” exibida na figura 5):
Estão detalhadas aqui as entidades e transações que serão enviadas no documento XML de pedido de compra, 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 base deverão existir nas duas pontas. Segue considerações:
Vínculos feitos a partir do CNPJ (ERP que recebe o documento XML deve encontrar as informações baseado no CNPJ):
Entidade Item (identificação do Produto):
Para o envio da tag <itemcode>, o sistema irá realizar a seguinte validação: Caso exista código EAN cadastrado na manutenção de itens materiais (CC0103), ele será enviado ao fornecedor, caso contrário, será enviado o código de item interno do EMS.
No caso da tag <prodcodsuplli>, será enviado sempre o código de item do fornecedor, cadastrado na manutenção item fornecedor (CC0105).
Outras entidades/cadastros:
Moeda – Caso a moeda seja Real, será enviado o código 1 na tag <CurrencyId>, caso contrário, será enviado 6 e a descrição da moeda na tag <Currencydesc>.
Unidade de Medida – Será enviada a unidade de medida interna do ERP na tag <internalmensuunit> e a unidade de medida do fornecedor (CC0105) na tag <supllimensuunit>.
Programação de Entrega – Envio
Na tag referente à quantidade da entrega (quantrequest) sempre será enviado o saldo da parcela da ordem de compra. Conforme consta no manual do produto: “As quantidades e datas da programação de entrega serão parcelas não recebidas dos pedidos de compra selecionados”.
Estrutura da mensagem única de pedido de compra (Order) que será trafegada:
Estrutura da mensagem única de programação de entrega (DeliverySchedule) que será trafegada:
Importante: A equipe de suporte do TSS mantém o documento detalhado com as informações dos Layouts padrões TOTVS Colaboração que são utilizados por todos os produtos TOTVS. Acima consta apenas a estrutura da mensagem, não estão contempladas todas as tags da cada mensagem.
Estrutura da mensagem única do aviso do envio de embarque (tss_tc_tipos_aviso) que será trafegada:
Pedido de Venda
Para o recebimento de pedido de venda será necessário o cadastramento de Engine de Regras para que as informações padrão do XML sejam recebidas e transformadas em valores equivalentes na base do cliente. Informações como moeda, condição de pagamento, tipo de frete e tipo de preço:
Deve-se utilizar o Engine de Regras para adequar aos dados da base do fornecedor as seguintes informações padronizadas pela EANCOM para integrações entre sistemas. Para que as informações a seguir listadas sejam alteradas foram criados tipos de operação para transformação, (citados ao lado de cada campo) que deverão ser cadastradas no Engine de Regras:
Código | Descrição |
1 | Real |
2 | Dólar |
3 | UFIR |
4 | EURO |
5 | IENE |
6 | Outras |
Código | Descrição |
1 | Básico |
3 | Data Fixa (Pagamento realizado na data ou período estipulado no pedido) |
20 | Multa |
21 | Pagamento Parcelado |
22 | Desconto por antecipação de Pagamento |
B01 | Pagamento com Data de Concentração |
JRM | Juros de Mora |
Código | Descrição |
1 | CIF – Custo, Seguro, Frete por conta do vendedor até o destino designado. |
2 | FOB – Posto a bordo. Porto de embarque designado |
3 | SFT - Sem Frete |
Código | Descrição |
1 | Preço Informado |
2 | Preço Data de Implantação |
3 | Preço Data de Faturamento |
Para o cadastramento das regras no Engine de Regras é necessário utilizar os programas a seguir apresentados:
Observação: Para cada tipo de operação, será necessário uma variável com a mesma nomenclatura.
Programação de Entrega
Para o recebimento da programação de entrega será necessário o cadastramento de Engine de Regras para que as informações padrão do XML sejam recebidas e transformadas em valores equivalentes na base do cliente. Informações como freqüência do fornecimento:
Deve-se utilizar o Engine de Regras para adequar aos dados da base do fornecedor as seguintes informações padronizadas pela EANCOM para integrações entre sistemas. Para que as informações a seguir listadas sejam alteradas foram criados tipos de operação para transformação, (citados ao lado de cada campo) que deverão ser cadastradas no Engine de Regras:
Código | Descrição |
A | Anual (ano calendário). Código definindo uma previsão anual. |
F | Intervalo flexível (da data X até a data Y). Código definindo uma previsão de utilização planejada entre duas datas especificadas. |
M | Mensal (meses calendário). Código definindo uma previsão mensal. |
Q | Trimestral (trimestres calendário). Código definindo uma previsão trimestral. Por ex. Jan-Mar, Abr- Jun, Jul-Set, Out-Dez. |
S | Semestral (ano calendário). Código definindo uma previsão para os 1ºs ou últimos seis meses do ano. |
W | Semanal. Código definindo uma previsão para intervalos semanais. |
Y | Diário. Código definindo uma previsão para intervalos diários. |
T | Quinzenal |
D | Descêndial |
Para o cadastramento das regras no Engine de Regras, é necessário utilizar os programas a seguir apresentados:
Observação: Para cada tipo de operação, será necessário uma variável com a mesma nomenclatura.
Cliente (montadora ou indústria) deseja enviar pedido de compra para o fornecedor:
O ERP do fornecedor busca as informações da solução NeoGrid.
Fornecedor busca pedido de compra do cliente (varejo, indústria, montadora):
Cliente (montadora ou indústria) deseja enviar programação de entrega para o fornecedor:
Fornecedor busca programação de entrega do cliente (varejo, indústria, montadora):
Cliente (montadora ou indústria) deseja enviar Aviso de Embarque para o fornecedor:
Check-list 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: