Histórico da Página
CONTEÚDO
- Visão Geral
- Exemplo Regras de utilização
- Tela XXX
- Outras Ações / Ações relacionadas
- Outras Ações / Ações relacionadas
- Tela XXX
- Principais Campos e Parâmetros
- Principais Campos e Parâmetros
- no Totvs Ipass
- Regras de Utilização no ERP
- Dicionário de Campos
- Cadastro de-para entre ERP e Shopify no HUBECOMMERCE
- Links úteisTabelas utilizadas
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.
...
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 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, especificada abaixo.
Card documentos Informacao Cada informação enviada pelo endpoint /api/v1/Cadastros/TabelaPrecoItem, tem como "Pai", uma tabela de preço que tem seu cadastro enviado pelo endpoint /api/v1/Cadastros/TabelaPreco, que este, como mencionado anteriormente é uma abstração do conceito de envio de preço de cada produto por empresa e segmento. Então, podemos dizer que cada produto tem seu envio de preço por empresa/segmento. Titulo Importante Destacar!
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ça obtenção do segmento da empresa em que será utilizado para busca do preço no ERP, ao qual será enviado ao Shopify (variablevariável: nrosegmento)
03. TELA XXXXX
Outras Ações / Ações relacionadas
...
- 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.
Card documentos Informacao Para funcionamento é necessário ter o módulo web SmPedidoVendaAPI instalado a partir da versão 24.01.026 e 24.07.001 instalados no cliente. Titulo IMPORTANTE!
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)
- O status da embalagem, deve estar ativo na família . (Map_Famembalagem.Status)
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). | 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), caso não haja, retornará como default 01-jan-2000 | 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. | 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.
As informações estão detalhadas no tópico 3 - Regras de Utilização no ERP | Hub: “IsActive” Shopify: não mapeado |
| ItemValidity | É a última data de validação do Preço no ERP (mrl_prodempseg.dtavalidacaopreco), caso não haja, retornará como default 01-jan-2000. | Hub: “ItemValidity” Shopify: não mapeado |
| DiscountValue | Preço De. Representa o preço normal do produto (mrl_prodempseg.precovalidnormal) | Hub: “DiscountValue” Shopify: não mapeado |
| MinimunSalePrice | Preço Por. Preço Promocional (mrl_prodempseg.minimunsaleprice), caso não haja preço promocional, retornará 0 | Hub: “MinimunSalePrice” Shopify: não mapeado |
| DiscountFactor | Refere-se ao fator de desconto, é calculado durante a integração, caso haja, valor no campo MinimunSalePrice, que é o campo de preço promocional, o sistema no momento da consulta ao endpoint, retornará o percentual de desconto. | Hub: “DiscountFactor” Shopify: não mapeado |
| ItemStartDate | Default com a data e hora atual em relação ao momento da consulta no endpoint. | Hub: “ItemStartDate” 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
04. TELA XXXXX
Principais Campos e Parâmetros
...
| Card documentos | ||||
|---|---|---|---|---|
|
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas