Exibir origem

CONTEÚDO

Visão Geral
Regras de utilização no Totvs Ipass
Regras de Utilização no ERP
Dicionário de Campos
Acompanhamento das Cargas
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. ACOMPANHAMENTO DAS CARGAS

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