CONTEÚDO
- Visão Geral
- Regras de utilização no Totvs Ipass
- Regras de Utilização no ERP
- Dicionário de Campos
- Tela XXX
- Principais Campos e Parâmetros
- 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.
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 |

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
|

05. TABELAS UTILIZADAS
Coloque o link das tabelas relacionadas