CONTEÚDO

  1. Visão Geral
  2. Regras de utilização no Totvs Ipass
  3. Regras de utilização do ERP
  4. Dicionário de Campos
    1. Outras Ações / Ações relacionadas
  5. Acompanhamento das cargas no Hubecommerce
    1. Principais Campos e Parâmetros
  6. Links ú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:

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:


03. REGRAS DE UTILIZAÇÃO DO ERP


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


measurementUnit

Embalagem no Cadastro de família, em Cadastros > Aba Família >  Família> Aba Embalagens > Campo: Embalagem, concatenado com o campo Quantidade em Cadastro de família, em Cadastros > Aba Família >  Família> Aba Embalagens > Campo: *Quantidade. 
Exemplo: Embalagem UN(unitária), e quantidade 1, sendo assim, o valor de measurementUnit será UN-1

Hub: “measurementUnit

Shopify: weight_unit
Observação: No shopify as unidades disponíveis para utilização são: lb, oz, kg e g.


manufacturer

Referência do Fabricante(map_produto.reffabricante), localizado em Cadastros > Aba Produto >  Produto > Aba Geral > Campo: Referência do Fabricante.

Hub: “manufacturer

Shopify: não existe


productRootTitle

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: “productRootTitle

Shopify: option1


companyId

Será nulo, pois, no conceito de SKU para integração shopify, não será tratado com diferenciais por empresa, e sim no âmbito geral de integração, porém, caso houvesse, este campo seria responsável pelo campo nroempresa, localizado em Parâmetros > Parâmetros >  Empresa> Aba Geral > Empresa (max_empresa.nroempresa).

Hub: “companyId

Shopify: não existe


branchId

Será nulo, pois, no conceito de SKU para integração shopify, não será tratado com diferenciais por empresa, e sim no âmbito geral de integração, porém, caso houvesse, este campo seria responsável pelas empresas filiais, representado pelo campo nroempresa, localizado em Parâmetros > Parâmetros >  Empresa> Aba Geral > Empresa (max_empresa.nroempresa).

Hub: “branchId

Shopify: não existe


isAvaiable

Enviado como default true.

Hub: “isAvaiable

Shopify: não existe


price

Este preço será o valor default caso não tenha tabela de preço para o produto. O preço é definido por produto, segmento e quantidade da embalagem.

Hub: “price

Shopify: price


listPrice

Será enviado como default 0, pois não será enviada uma lista de preço pelo SKU.

Hub: “listPrice

Shopify: presentment_prices


modalType

Será enviado como nulo, pois, não é utilizado tanto no HubEcommerce, quanto, no Shopify.

Hub: “modalType

Shopify: não mapeado


modalId

Será enviado como 0, pois, não é utilizado tanto no HubEcommerce, quanto, no Shopify.

Hub: “modalId

Shopify: não existe


cubicWeight

Será enviado como 0, pois, não é utilizado tanto no HubEcommerce, quanto, no Shopify.

Hub: “cubicWeight

Shopify: não existe



commercialConditionId

Será enviado como 0, pois, não é utilizado tanto no HubEcommerce, quanto, no Shopify.

Hub: “commercialConditionId

Shopify: não existe



groupCode

Será enviado como nulo, pois, não é utilizado tanto no HubEcommerce, quanto, no Shopify.

Hub: “groupCode

Shopify: não existe


inventoryItemId

Será enviado como nulo, pois este campo é originado e populado pelo Shopify, após o retorno da integração. Refere-se ao número de identificação deste produto no inventário da plataforma Shopify. Após a integração do SKU no Shopify, o campo inventoryItemId do HubEcommerce é atualizado, recebendo o valor de inventory_item_id do Shopify.

Observação: Este campo não deve ter valor retornado ao ERP; é apenas um controle entre o HubEcommerce e o Shopify.

Hub: “inventoryItemId

Shopify: inventory_item_id


disableStock

Enviado como default false.

Hub: “disableStock

Shopify: não existe


updateBrand

Enviado como default false.

Hub: “updateBrand”

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