1. Definição do Escopo
A integração do ERP-Datasul com a plataforma Vtex utilizará o produto IPaas da TOTVs. A documentação abaixo foi desenvolvida com base na execução das mensagens parametrizada
2. Acessos a plataforma IPaas
2.1. Usuários
Os usuários que utilizarão a plataforma deverão ser cadastrados para acessar o produto:
URL de configuração => https://manager.totvs.app/page-forbidden
Ao acessar o link acima, digitar o e-mail cadastrada (responsável da empresa) com a senha, selecionar a empresa desejada e cadastrar os usuários que utilizarão também a integração.
Será necessário associar para o usuário criado, os aplicativos necessários, conforme figura abaixo:
2.2. Acesso ao aplicativo HubECommerce
Estando posicionado na empresa desejada, clicar no ítem (vermelho) abaixo para acessar o aplicativo HubECommerce. Esse aplicativo é o responsável para digitar as informações contidas no documento de requisitos do projeto:
Abrirá a tela abaixo para inserir as informações necessários para o bom funcionamento da integração:
Configurações de contas ERP:
Configurações de contas ECommerce:
Após incluir as informações na tela acima, clicar no botão <Avançar> para cadastrar os próximos itens:
Contatos;
Configuração de estoques;
Configuração de tabelas de preço;
Condições de pagamento;
Estratégia de envio;
Configuração de vendedores;
Configuração de pedidos;
Configuração de pedidos cliente;
Configuração de pedidos Marketplace.
2.3. Acesso ao aplicativo TOTVS-Datasul
Ao acessar o aplicativo da TOTVs-Datasul será necessário criar o ambiente para utilização da integração:
Cadastrando dados do ambiente ERP-Datasul:
3. Estratégias de Implementação
3.1. Requisitos mínimos
- APIs web disponíveis para todos os produtos e módulos envolvidos.
- Colaboradores com acesso ao Connector Monitor.
3.2. Tecnologia utilizada
- Plugin Connector para IDE
- JOLT para transformações de mensagens JSON.
3.3. Publicação de Diagramas.
No ipaas.totvs.app, o projeto será iniciado como rascunho.
Para prosseguir, siga a sequência descritos nos itens 3.3.1, 3.3.2 e 3.3.3: edite cada diagrama e associe as contas e ambientes do ERP, iPaaS e VTEX, previamente configurados. Após a edição, publique o diagrama correspondente.
Para mais detalhes sobre os componentes, utilize os links abaixo:
- Diagramas - https://tdn.totvs.com/pages/viewpage.action?pageId=777267974
- Aplicativos -https://tdn.totvs.com/display/public/IPAAS/Aplicativos
- Componentes - https://tdn.totvs.com/display/public/IPAAS/Componentes
3.3.1. Diagrama ERP - Ipaas
00 – Robô – Erp > IpaaS -> Realiza busca nas API´S do ERP
02 - Envio Categoria - Erp > IpaaS -> Consulta no ERP as categorias e grava no IpaaS TOTVS.
04 - Envio Produto - Erp > IpaaS -> Consulta no ERP os produtos(grupo) e grava no IpaaS TOTVS.
06 - Envio SKU e Preço - Erp > IpaaS Consulta no ERP os SKUs e Preços e grava no IpaaS TOTVS.
08 - Envio Estoque - Erp > IpaaS -> Consulta no ERP os estoques dos SKUs e grava no IpaaS TOTVS.
10 - Envio Tabela de Preço - Erp > IpaaS -> Consulta no ERP as tabelas de preço e grava no IpaaS TOTVS.
12 - Envio Tabela de Preço FIliais - Erp > IpaaS -> Consulta no ERP as tabelas de preço das filiais e grava no IpaaS TOTVS.
3.3.2 – Diagrama Ipaas – Ecommerce
01 - Envio Marca - IpaaS > Ecommerce -> Consulta no IpaaS TOTVS as marcas gravadas e envia para a Plataforma ECommerce.
03 - Envio Categoria - IpaaS > Ecommerce -> Consulta no IpaaS TOTVS as categorias gravadas e envia para a Plataforma ECommerce.
05 - Envio Produto - IpaaS > Ecommerce -> Consulta no IpaaS TOTVS os produtos(grupo) gravados e envia para a Plataforma ECommerce.
07 - Envio SKU e Preço - IpaaS > Ecommerce -> Consulta no IpaaS TOTVS os SKUs e Preços gravados e envia para a Plataforma ECommerce.
09 - Envio Estoque - IpaaS > Ecommerce -> Consulta no IpaaS TOTVS os estoques dos SKUs gravados e envia para a Plataforma ECommerce.
11 - Envio Tabela de Preço Principal - IpaaS > Ecommerce -> Consulta no IpaaS TOTVS as tabelas de preço gravadas e envia para a Plataforma ECommerce.
13 - Envio Tabela de Preço FIliais - IpaaS > Ecommerce-> Consulta no IpaaS TOTVS as tabelas de preço das filiais gravadas e envia para as tabelas ou políticas comerciais criadas na Plataforma ECommerce.
3.3.3 Diagramas de pedido
14 - Envio Configurações - IpaaS > Ecommerce -> Envia as informações para a Plataforma ECommerce com as configurações para recebimento dos pedidos e status pré-definidos que serão aplicados na Plataforma ECommerce para que gere a fila de pedidos a serem integrados no ERP.
15 - Recebendo Pedido Ecommerce - Ecommerce > IpaaS -> Grava as informações básicas do pedido no IpaaS TOTVS e coloca o pedido na fila para ser integrado.
16 - Confirmação Recebido Pedido Ecommerce – Ecommerce > IpaaS -> Envia a informação para Plataforma ECommerce informando que o pedido já foi integrado com o TOTVS Ipaas para enviar o pedido para o ERP.
17 - Montagem e validação Pedido Ecommerce - Ecommerce > IpaaS -> Consulta os pedidos na Plataforma ECommerce e grava as informações dos pedidos no IpaaS TOTVS.
20 - Envio Cadastro do Cliente Ecommerce - IpaaS > ERP -> Consulta os clientes gravados dos pedidos no IpaaS TOTVS e realiza a integração no ERP.
18 - Envio Pedido Ecommerce - IpaaS > ERP -> Consulta os pedidos gravados no IpaaS TOTVS e realiza a integração no ERP.
21 - Envio Faturamento - Erp > IpaaS -> Consulta os pedidos faturados no ERP e grava no IpaaS TOTVS.
22 - Envio Faturamento Principal - IpaaS > Ecommerce -> Consulta os pedidos faturados no IpaaS TOTVS e envia para a Plataforma ECommerce alterando o status dos pedidos na Plataforma ECommerce para faturado.
23 - Envio Cancelamento Principal - Erp > IpaaS -> Consulta os pedidos cancelados no ERP e grava no IpaaS TOTVS.
24 - Envio Cancelamento Principal - IpaaS > Ecommerce -> Consulta os pedidos cancelados no IpaaS TOTVS e envia para a Plataforma ECommerce alterando o status dos pedidos na Plataforma ECommerce para cancelado.
3.4 – Monitor
Utilize a seguinte documentação para monitorar o fluxo de mensagens de cada diagrama publicado.
https://tdn.totvs.com/display/public/IPAAS/Monitor