Exibir origem

CONTEÚDO

Visão Geral
Regras de utilização no Totvs Ipass
Regras de Utilização no ERP
Dicionário de Campos
Cadastro de-para entre ERP e Shopify no HUBECOMMERCE
Links úteis

01. VISÃO GERAL

Esta documentação tem como objetivo descrever como funciona o envio de preço referente à múltiplas lojas do ERP TOTVS Varejo Supermercados para a plataforma de E-commerce Shopify utilizando a plataforma TOTVS iPaaS como middleware de comunicação.

02. REGRAS DE UTILIZAÇÃO NO TOTVS IPASS

O IPAAS consulta os preços das lojas no ERP através do endpoint: GET SmPedidoVenda/api/v1/Cadastros/TabelaPreco e SmPedidoVenda/api/v1/Cadastros/TabelaPrecoItem.
O envio é realizado da seguinte maneira, o endpoint TabelaPreco, trata cada empresa como uma tabela de preço, devido ao preço ser enviado por empresa, é tratado desta forma afim, de simplificar os envios de preço.
O endpoint TabelaPrecoItem é responsável por enviar cada Produto por SKU, com seus respectivos preços, já vinculado à uma tabela de preço que no caso, como explicado acima, será uma empresa. Neste endpoint haverá o filtro por segmento, para que seja escolhido qual o segmento da empresa, será utilizado para envio do preço. O controle deste filtro é feito através de uma variável no IPASS.

Especificações e configurações para envio da carga de Tabela de Preço do ERP para o Shopify:

DtaHorAlteracao - O iPaaS faz o controle de data e hora do envio das cargas, dessa forma, consegue gerenciar para obter as alterações ou inclusões à respeito da Tabela de Preço. De modo que, a definição de à partir de qual data e hora de inclusão ou alterações, é controlada no IPASS, através do HubeEcommerce( Integration Backoffice (totvs.app) ), em Aba de Configurações > SyncControl > SyncControl por Matriz > Campo: Tabela de Preço. Desta forma, este campo, será configurado à partir de qual data e hora serão enviadas as cargas que sofreram alterações ou criações em tabela de preço, neste período.
Page - A paginação é realizada e controlada no IPASS, através do HubeEcommerce( Integration Backoffice (totvs.app) ), em Aba de Configurações > SyncControl > SyncControl por Matriz > Tabela de Preço > Campo: Página, nela será possível a escolha da página ao qual quer fazer a busca das informações no ERP.

Especificações e configurações para envio da carga de Tabela de Preço Item(Preço Por Produto) do ERP para o Shopify:
Nrosegmento - Utilizada para obtenção do segmento da empresa em que será utilizado para busca do preço no ERP, ao qual será enviado ao Shopify (variável: nrosegmento)
DtaHorAlteracao - O iPaaS faz o controle de data e hora do envio das cargas, dessa forma, consegue gerenciar para obter as alterações ou inclusões à respeito do Preço por Produto. De modo que, a definição de à partir de qual data e hora de inclusão ou alterações, é controlada pelo IPASS, através do HubeEcommerce( Integration Backoffice (totvs.app) ), em Aba de Configurações > SyncControl > SyncControl por Matriz > Campo: Item da Tabela de Preço. Desta forma, este campo, será configurado à partir de qual data e hora serão enviadas as cargas que sofreram alterações ou criações em itens da tabela de preço, neste período.
Page - A paginação é realizada e controlada no IPASS, através do HubeEcommerce( Integration Backoffice (totvs.app) ), em Aba de Configurações > SyncControl > SyncControl por Matriz > Item da Tabela de Preço > Campo: Página, nela será possível a escolha da página ao qual quer fazer a busca das informações no ERP.

03. REGRAS DE UTILIZAÇÃO DO ERP

Regras para envio do Preço do ERP para o Shopify

- O status da embalagem, deve estar ativo na família . (Map_Famembalagem.Status)
- O status de venda do produto de acordo com sua embalagem, deve estar ativo no cadastro de produto (Mrl_Prodempseg.Statusvenda)
- A integração de produto com o E-Commerce, deve estar ativo no cadastro de produto . (Map_Produto.Indintegraecommerce)

04. DICIONÁRIO DE CAMPOS

Campos utilizados na integração do endpoint GET SmPedidoVenda/api/v1/Cadastros/TabelaPreco e suas respectivas referências no ERP e na plataforma Shopify

Campo	ERP (Linha Consinco)	Shopify
Id	Parâmetros > Parâmetros > Empresa> Aba Geral > Empresa (max_empresa.nroempresa)	Hub: “Id” Shopify: não mapeado
CompanyId	Parâmetros > Parâmetros > Empresa> Aba Geral > Empresa (max_empresa.nroempresa)	Hub: “CompanyId” Shopify: não mapeado
BranchId	Será cadastrado no HUBECOMMERCE como filial, porém o código será Parâmetros > Parâmetros > Empresa> Aba Geral > Empresa (max_empresa.nroempresa)	Hub: “BranchId” Shopify: não mapeado
InitialDate	Será um Default com a data 01-Jan-2000	Hub: “InitialDate” Shopify: não mapeado
FinalDate	Será um Default com a data 31-Dec-2099	Hub: “FinalDate” Shopify: não mapeado
LastChange	Última Data de alteração no Cadastro da empresa (Max_Empresa.Dtaultalteracao), caso não haja alterações, retornará a data e hora atual.	Hub: “LastChange” Shopify: não mapeado
Name	Nome Reduzido da empresa em Parâmetros > Parâmetros > Empresa> Aba Geral > Nome Reduzido Empresa (max_empresa.Nomereduzido)	Hub: “Name” Shopify: não mapeado
PriceTableItems	Retornará um array vazio, pois a lista de produtos com seus respectivos preços, será mandado à parte pelo endpoint: SmPedidoVenda/api/v1/Cadastros/TabelaPrecoItem	Hub: “PriceTableItems” Shopify: não mapeado
UpdateTable	Retornará como Default: S	Hub: “UpdateTable” Shopify: não mapeado
PolicyId	Código da política de Preço no ERP: Parâmetros > Parâmetros > Empresa> Aba Geral > Empresa (max_empresa.nroempresa)	Hub: “PolicyId” Shopify: não mapeado
EcommerceReferenceKey	Será nulo no ERP, pois este campo será populado entre HUBECOMMERCE e Shopify para controle apenas entre ambos, será o código política comercial ou nome da tabela de preço no E-Commerce(Shopify)	Hub: “EcommerceReferenceKey” Shopify: não mapeado
NroEmpresa	Campo presente apenas no ERP, para filtro de empresa	Hub: “Não existente” Shopify: Não existente

Campos utilizados na integração do endpoint GET SmPedidoVenda/api/v1/Cadastros/TabelaPrecoItem e suas respectivas referências no ERP e na plataforma Shopify

Campo	ERP (Linha Consinco)	Shopify
CompanyId	Parâmetros > Parâmetros > Empresa> Aba Geral > Empresa (max_empresa.nroempresa)	Hub: “CompanyId” Shopify: não mapeado
BranchId	Deve ser cadastrado no HUBECOMMERCE como filial, porém o código será Parâmetros > Parâmetros > Empresa> Aba Geral > Empresa (max_empresa.nroempresa)	Hub: “BranchId” Shopify: não mapeado
PriceTableItemId	Cadastros > Aba Produto > Produto > Aba Geral > Código (Código do Produto) concatenado com a quantidade da embalagem do produto (map_produto.seqproduto e map_famembalagem.qtdembalagem). Exemplo: SeqProduto 919 e QtdEmbalagem 12, sendo assim, o PriceTableItemId será 91912, portanto, trata-se da junção de código do produto com a quantidade da embalagem do produto, então, caso esse produto tenha várias embalagens, será a mesma regra para as demais embalagens, como SeqProduto 919 e QtdEmbalagem 6. o PriceTableItemId será 9196	Hub: “PriceTableItemId” Shopify: não mapeado
CreateDate	Default com a data 01-jan-2000	Hub: “CreateDate” Shopify: não mapeado
LastChange	É a última data de validação do Preço no ERP (mrl_prodempseg.dtavalidacaopreco)	Hub: “LastChange” Shopify: não mapeado
PriceTableId	É o Campo Id do Endpoint GET SmPedidoVenda/api/v1/Cadastros/TabelaPreco, ou seja, será o Nro da Empresa. Parâmetros > Parâmetros > Empresa> Aba Geral > Empresa (max_empresa.nroempresa)	Hub: “PriceTableId” Shopify: não mapeado
ProductSkuId	Cadastros > Aba Produto > Produto > Aba Geral > Código (Código do Produto) concatenado com a quantidade da embalagem do produto (map_produto.seqproduto e map_famembalagem.qtdembalagem). Porém, terão as identificações P antes do SeqProduto, e E antes de QtdEmbalagem. Exemplo: SeqProduto 919 e QtdEmbalagem 12, sendo assim, o ProductSkuId será P919E12	Hub: “ProductSkuId” Shopify: não mapeado
PriceTableItems	Retornará um array vazio, pois a lista de produtos com seus respectivos preços, será mandado à parte pelo endpoint: SmPedidoVenda/api/v1/Cadastros/TabelaPrecoItem	Hub: “PriceTableItems” Shopify: não mapeado
IsActive	Indica status do preço do produto, variando entre ativo e inativo. Caso seja ativo retornará S, caso esteja inativo, retornará N. A regra de status deste campo é referente à 3 informações, descritas abaixo: Status da embalagem, na família . (Map_Famembalagem.Status) Status de venda do produto de acordo com sua embalagem, no cadastro de produto (Mrl_Prodempseg.Statusvenda) Status de Integração de produto com o E-Commerce, no cadastro de produto . (Map_Produto.Indintegraecommerce) As informações estão detalhadas no tópico 3 - Regras de Utilização no ERP	Hub: “UpdateTable” Shopify: não mapeado

05. CADASTRO DE-PARA ENTRE ERP E SHOPIFY NO HUBECOMMERCE

Painel de monitoramento: https://hubecommerce.totvs.app/price-table

06. LINKS ÚTEIS

Link: Detalhamento do fluxo