CONTEÚDO
- Visão Geral
- Regras de utilização no Totvs Ipass
- Regras de utilização do ERP
- Dicionário de Campos
- Acompanhamento das cargas no Hubecommerce
- Links úteis
01. VISÃO GERAL
Esta documentação tem como objetivo descrever como funciona a integração de envio de Pedidos de Venda da plataforma de E-commerce Shopify para o ERP TOTVS Varejo Supermercados, utilizando a plataforma TOTVS iPaaS como middleware de comunicação.
02. REGRAS DE UTILIZAÇÃO NO TOTVS IPASS
O fluxo de integração via Ipass, contempla a seguinte estrutura, o Pedido de Venda vindo do Shopify é recepcionado no Ipass via webhook, para envio dos dados do pedido do ERP para o Hub, após inserção no mesmo, o Ipass seguirá no fluxo de montagem e validação do pedido, onde atenderá premissas como confirmação de pagamento, para que este siga o processo de integração, após este este passo, o Ipass seguirá para o recepcionamento do pedido no ERP onde este será feito via API SmPedidoVenda/api/v1/PedidoVenda, onde ao atender as regras de negócio do ERP, o pedido terá sua integração concluída.
Especificações e configurações para envio da carga de Pedido de Venda do Shopify para o ERP:
- Nrosegmento - Utilizada para obtenção do segmento padrão, em que será utilizado para busca do SKU no ERP, ao qual será enviado ao Shopify (variável no Ipass: nrosegmento)
- Seqcanalvenda - Utilizada para obter o canal de venda que está sendo utilizado pelo ERP, para integração de pedidos de e-commerce, neste caso, deverá ser criado um Canal de Venda específico para o Shopify. O código deste canal de venda será encontrado no ERP no Módulo Vendas > Pedido de Venda/Transferência > Integração Api > Cadastro Canal de Venda > Campo: Sequência (variável no Ipass: seqcanalvenda)
- Codgeraloper - Utilizada para definir o CGO padrão, no qual será realizada a integração do pedido no ERP. (variável no Ipass: codgeraloper)
- Nrorepresentante - Utilizada para obter qual o representante padrão para a integração de pedidos de venda, vindos do Shopify. (variável no Ipass: nrorepresentante)
- Nrotabvenda - Utilizada para obtenção da tabela de venda padrão, para a integração de pedidos de venda, vindos do Shopify. (variável no Ipass: nrotabvenda)
- Tiporateiofretepedido - Utilizada para definição do tipo e forma de rateio de frete padrão no pedido, ao qual será empregado na integração, caso haja frete. (variável no Ipass: tiporateiofretepedido)
- Versão da API do Shopify - A configuração de qual versão da Api de integração do Shopify está sendo utilizada, é definido através das variáveis de projeto no Ipass, representada pela variável api_version. Importante ressaltar que a variável deve ser alterada apenas pela Totvs, pois, uma alteração sem aviso prévio poderá ocasionar problemas na integração com a plataforma Shopify
Para alterar variáveis de projeto no Ipass, basta, no aplicativo Totvs Ipass, ir à barra de navegação na lateral esquerda e selecionar a opção Integrações. Após esse passo, selecione o projeto no qual está localizada a integração com o Shopify e clique na opção Configurar Projeto, localizada na parte superior da tela. Feito isso, aparecerá a seção de Variáveis, na qual será possível alterar cada variável conforme a necessidade de configuração da integração.
Detalhamento do fluxo de configuração de variáveis
Menu Integrações
Configurações do Projeto
Variáveis do Projeto
03. REGRAS DE UTILIZAÇÃO DO ERP
- O canal de venda no qual, será utilizado para a integração com o Shopify, deverá estar cadastrado em Vendas > Pedido de Venda/Transferência > Integração Api > Cadastro Canal de Venda. (mad_canalvenda.seqcanalvenda)
Exemplo:
04. DICIONÁRIO DE CAMPOS
Campos utilizados no fluxo de integração de pedidos do Shopify para o Hub.
Campo no Hub | Campo no Shopify |
| eCommerceReferenceKey | order.id |
| orderId | order.id |
| sequenceId | order.id |
| orderStatusECommerceReferenceKey | order.financial_status |
| eCommerceCreateDate | order.created_at |
| eCommerceLastChange | order.updated_at |
| totalValue | order.total_price |
| listOfTotal.Items.value | order.total_line_items_price |
| listOfTotal.Discounts.value | order.current_total_discounts |
| listOfTotal.Shipping.value | order.shipping_lines.price |
| listOfTotal.Tax.value | order.current_total_tax |
| totalValue | order.total_price |
| listOfOrderPayment.paymentMethodECommerceReferenceKey | order.payment_gateway_names |
| customer.eCommerceReferenceKey | order.customer.id |
| customer.firstName | order.customer.first_name |
| customer.lastName | order.customer.last_name |
| customer.email | order.customer.email |
| customer.phone | order.customer.phone |
| customer.addressInfo.street | order.shipping_address.address1 |
| customer.addressInfo.receiverName | order.shipping_address.name |
| customer.addressInfo.postalCode | order.shipping_address.zip |
| customer.addressInfo.city | order.shipping_address.city |
| customer.addressInfo.state | order.shipping_address.province_code |
| customer.addressInfo.country | order.shipping_address.country_code |
| customer.addressInfo.complement | order.shipping_address.address2 |
| listOfOrderItem.eCommerceReferenceKey | order.line_items.id |
| listOfOrderItem.productSKUECommerceReferenceKey | order.line_items.variant_id |
| listOfOrderItem.quantity | order.line_items.quantity |
| listOfOrderItem.price | order.line_items.price |
| listOfOrderItem.listPrice | order.line_items.listPrice |
| listOfOrderItem.sellingPrice | order.line_items.sellingPrice |
| listOfOrderItem.isGift | order.line_items.gift_card |
| listOfOrderItem.discontValue | order.line_items.discount_allocations.amount |
| salesChannel | order.order_status_url |
| extraText1 | fulfillment.fulfillment_orders.delivery_method.min_delivery_date_time |
| extraText2 | fulfillment.fulfillment_orders.delivery_method.max_delivery_date_time |
Campos utilizados no fluxo de integração de pedidos do Hub para o ERP, através do endpoint GET SmPedidoVenda/api/v1/Cadastros/ProdutoSku, e suas respectivas referências no Hub e no ERP.
Campo | ERP (Linha Consinco) | Hub |
seqCanalVenda | Vendas > Pedido de Venda/Transferência > Integração Api > Cadastro Canal de Venda > Campo: Sequência. | variável seqcanalvenda
Observação: Informação sobre configuração da variável seqcanalvenda no Ipass está presente no item 2 - Regras de Utilização no Totvs Ipass. |
| idPedidoCanalVenda | Será o Id do pedido de Venda vindo da plataforma Shopify. | orderId |
| dtaHorPedidoCanalVenda | Será populado com a data de criação do pedido na plataforma Shopify. | eCommerceCreateDate |
| nroEmpresa | Parâmetros > Parâmetros > Empresa> Aba Geral > Empresa (max_empresa.nroempresa) | erpCompanyId |
| nroSegmento | Utilizada para obtenção do segmento em que será utilizado para a inserção do Pedido no ERP.
Parâmetros > Aba Dealer > Segmento > Campo: Código. | variável nrosegmento
Observação: Informação sobre configuração da variável nrosegmento no Ipass está presente no item 2 - Regras de Utilização no Totvs Ipass. |
| codGeralOper | Parâmetros > Aba Parâmetros > Código Geral de Operação > Campo: C.G.O | variável codGeralOper
Observação: Informação sobre configuração da variável codGeralOper no Ipass está presente no item 2 - Regras de Utilização no Totvs Ipass. |
| nroTabVenda | Parâmetros > Aba Dealer > Tabela de Venda > Campo: Código | variável nroTabVenda
Observação: Informação sobre configuração da variável codGeralOper no Ipass está presente no item 2 - Regras de Utilização no Totvs Ipass. |
| seqTransportador | Não é enviado ao ERP, pois não há informações acerca deste campo no Shopify. | Não Existe. |
| tipoEntrega | Representa o tipo de expedição, é informado em Pedido de Venda > Campo: Exped.
E - Entrega, R - Retira. | orderCarrierERPReferenceKey |
| obsPedido | Observações acerca do pedido. | observation |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
05. ACOMPANHAMENTO DAS CARGAS NO HUBECOMMERCE
Painel de monitoramento: https://hubecommerce.totvs.app/product-sku
06. LINKS ÚTEIS
Link: Detalhamento do fluxo