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
Tabelas 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.

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

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

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