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, enviado da shopify para o ERP. Visualização disponível em Pedido de Venda > Campo: F11 Obs. | observation |
| obsNotaFiscal | Não é enviado ao ERP, pois não há informações acerca deste campo no Shopify. | Não Existe |
| vlrTotFrete | Valor total do Frete, enviado ao cabeçalho do pedido do Shopify para o ERP. Visualizado em Pedido de Venda > Campo: Vlr. Frete. | freightValue |
| tipoRateioFretePedido | Informação pertinente ao modo de rateio de frete no pedido de Venda, ao integrar no ERP. | variável tipoRateioFretePedido
Observação: Informação sobre configuração da variável tipoRateioFretePedido no Ipass está presente no item 2 - Regras de Utilização no Totvs Ipass. |
| tipoFreteDocAuxiliar | Não é enviado ao ERP, pois não há informações acerca deste campo no Shopify. | Não Existe |
| indIntermediador | É enviado ao ERP como Default N, pois o Shopify não trata operação de intermediador de negociação. | Não Existe |
| dtaHorIniPrevEntrega | Data e Hora de início de janela de previsão de entrega. | extraText1 |
| dtaHorFimPrevEntrega | Data e Hora fim de janela de previsão de entrega. | extraText2 |
| clienteDto.cpfCnpj | CPF ou CNPJ do Cliente no Shopify.
Cliente > Cliente > Pessoa > Caso seja Pessoa Física o Campo é: CFP, caso seja Pessoa Jurídica, o Campo é: CNPJ. | customerDocument |
| clienteDto.inscEstadualRg | Não é enviado ao ERP, pois não existe esta informação no Shopify.
Cliente > Cliente > Pessoa > Caso seja Pessoa Física o Campo é: RG, caso seja Pessoa Jurídica, o Campo será: IE. | Não Existe |
| clienteDto.nomeRazaoSocial | Nome ou Razão Social do cliente no Shopify, ao qual é enviado ao ERP.
Cliente > Cliente > Pessoa > Campo: Nome/Razão. | customerFullName |
| clienteDto.nomeFantasia | Nome Fantasia do cliente no Shopify, ao qual é enviado ao ERP.
Cliente > Cliente > Pessoa > Campo: Fantasia. | customerFullName |
| clienteDto.sexo | Não é enviado ao ERP, pois não há informações acerca deste campo no Shopify. | Não Existe |
| clienteDto.cidade | Cidade do cliente no Shopify, ao qual será enviada ao ERP.
Cliente > Cliente > Pessoa > Campo: Cidade. | customerAddressCity |
| clienteDto.uf | UF do cliente no Shopify, ao qual será enviada ao ERP.
Cliente > Cliente > Pessoa > Campo: UF. | customerAddressState |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
05. ACOMPANHAMENTO DAS CARGAS NO HUBECOMMERCE
Painel de monitoramento: https://hubecommerce.totvs.app/product-sku
06. LINKS ÚTEIS
Link: Detalhamento do fluxo