Exibir origem

CONTEÚDO

Visão Geral
Regras de utilização no Totvs Ipass
Regras de utilização do ERP
Dicionário de Campos
1. Outras Ações / Ações relacionadas
Acompanhamento das cargas no Hubecommerce
1. Principais Campos e Parâmetros
Link úteis

01. VISÃO GERAL

Esta documentação tem como objetivo descrever como funciona o envio de SKU do ERP TOTVS Varejo Supermercados para a plataforma de E-commerce Shopify utilizando a plataforma TOTVS iPaaS como middleware de comunicação.
O SKU ou Unidade de Manutenção de Estoque, é utilizado como forma de identificação e rastreio de cada produto pertencente ao estoque de uma empresa, que por sua vez, tem como objetivo facilitar o controle e gestão de cada produto, sendo, atribuído com base em suas características, das quais podem ser destacadas:

Peso
Tamanho
Embalagem
Quantidade
Código ou descrição do Produto
Além de outras informações, das quais também podem ser incluídas com o objetivo de identificar e facilitar o controle do produto no sistema, distinguindo variações, similaridades, e informações de cada produto.

02. REGRAS DE UTILIZAÇÃO NO TOTVS IPASS

O IPAAS consulta os SKUs referente aos produtos no ERP através do endpoint: GET SmPedidoVenda/api/v1/Cadastros/ProdutoSku.

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

DtaHorAlteracao - O iPaaS faz o controle por data e hora do envio das cargas, dessa forma, consegue gerenciar para obter as alterações ou inclusões à respeito do SKU. 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: SKU. Desta forma, este campo, será configurado à partir de qual data e hora serão enviadas as cargas que sofreram alterações ou criações acerca de SKUs, 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 > SKU > Campo: Página, nela será possível a escolha da página ao qual quer fazer a busca das informações no ERP.

Nrosegmento - Utilizada para obtenção do segmento em que será utilizado para busca do SKU no ERP, ao qual será enviado ao Shopify (variável no Ipass: nrosegmento)
NroDivisao - Utilizada para obter a divisão do segmento em que será utilizado para busca do SKU no ERP, ao qual será enviado ao Shopify (variável no Ipass: nro_divisao)
PageSize - Utilizada para definir o número máximo de registros que poderão ser retornados por página em uma requisição para retorno das informações de SKU do ERP, as quais serão enviadas ao Shopify (variável no Ipass: sku_pagesize)
Versão da API do Shopify - A configuração de qual versão da Api de integração do Shopify está sendo utilizada, é definido através das variáveis de projeto no Ipass, representada pela variável shopify_api_version. Importante ressaltar que a variável deve ser alterada apenas pela Totvs, pois, uma alteração sem aviso prévio poderá ocasionar problemas na integração com a plataforma Shopify

Para alterar variáveis de projeto no Ipass, basta, no aplicativo Totvs Ipass, ir à barra de navegação na lateral esquerda e selecionar a opção Integrações. Após esse passo, selecione o projeto no qual está localizada a integração com o Shopify e clique na opção Configurar Projeto, localizada na parte superior da tela. Feito isso, aparecerá a seção de Variáveis, na qual será possível alterar cada variável conforme a necessidade de configuração da integração.

Detalhamento do fluxo de configuração de variáveis
Menu Integrações

Configurações do Projeto

Variáveis do Projeto

03. REGRAS DE UTILIZAÇÃO DO ERP

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/ProdutoSku, e suas respectivas referências no ERP e na plataforma Shopify

Campo	ERP (Linha Consinco)	Shopify
productSKUId	Cadastros > Aba Produto > Produto > Aba Geral > Campo: 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: “erpReferenceKey” Shopify: sku
createDate	Será um Default com a data 01-Jan-2000.	Hub: “createDate” Shopify: created_at
lastChange	Última Data e Hora de alteração no Cadastro de produto (mrl_prodempseg.dtaalteracao), ou a última data e hora de alteração do preço da embalagem no Cadastro de família em Cadastro de família, em Cadastros > Aba Família > Família> Aba Embalagens > Campo: Data Alteração (map_famembalagem.dtahoraltembpreco), caso não tenha alterações, retornará como default a mesma data utilizada no campo createDate.	Hub: “lastChange” Shopify: updated_at
name	Refere-se ao campo Nome Produto E-Commerce, localizado em Cadastros > Aba Produto > Produto > Aba E-Commerce > Campo: Nome Produto E-Commerce (prod.nomeprodutoecomm), ou então, caso este campo não esteja preenchido, pois, é opcional no cadastro do produto, é utilizado o campo Descrição Reduzida em Cadastros > Aba Produto > Produto > Aba Geral > Campo: Descrição Reduzida (map_produto.descreduzida).	Hub: “name” Shopify: title
width	Largura da embalagem no Cadastro de família, em Cadastros > Aba Família > Família> Aba Embalagens > Campo: Largura (cm).	Hub: “width” Shopify: não existe
realWidth	Largura da embalagem no Cadastro de família, em Cadastros > Aba Família > Família> Aba Embalagens > Campo: Largura (cm).	Hub: “realWidth” Shopify: não existe
weightKg	Peso bruto da embalagem no Cadastro de família, em Cadastros > Aba Família > Família> Aba Embalagens > Campo: Peso Bruto (kg).	Hub: “weightKg” Shopify: weight
RealWeightKg	Peso bruto da embalagem no Cadastro de família, em Cadastros > Aba Família > Família> Aba Embalagens > Campo: Peso Bruto (kg).	Hub: “RealWeightKg” Shopify: weight
length	Profundidade da embalagem no Cadastro de família, em Cadastros > Aba Família > Família> Aba Embalagens > Campo: Profund. (cm).	Hub: “length” Shopify: não existe
realLength	Profundidade da embalagem no Cadastro de família, em Cadastros > Aba Família > Família> Aba Embalagens > Campo: Profund. (cm).	Hub: “realLength” Shopify: não existe
height	Altura da embalagem no Cadastro de família, em Cadastros > Aba Família > Família> Aba Embalagens > Campo: Altura (cm).	Hub: “height” Shopify: não existe
realHeight	Altura da embalagem no Cadastro de família, em Cadastros > Aba Família > Família> Aba Embalagens > Campo: Altura (cm).	Hub: “realHeight” Shopify: não existe
unitMultiplier	Caso no cadastro da família do produto, esta, esteja selecionada como pesável em Cadastros > Aba Família > Família > Aba Geral > Características > Campo: É pesável, será utilizado o campo Múltiplo de Venda localizado em Cadastros > Aba Produto > Produto > Aba E-Commerce > Campo: Múltiplo de Venda (map_produto.qtdmultiplovdaecommerce), ou caso não tenha valor atribuído para este campo, será utilizado o valor default 1.00, como unidade de multiplicação.	Hub: “unitMultiplier” Shopify: não existe

05. ACOMPANHAMENTO DAS CARGAS NO HUBECOMMERCE

Painel de monitoramento: https://hubecommerce.totvs.app/product-sku

06. LINKS ÚTEIS

Link: Detalhamento do fluxo