Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Sugestão para o título do Documento: Integração de Imagens do ERP TOTVS com o Shopify

CONTEÚDO

  1. Visão GeralRegras de utilização no Totvs Ipass
  2. Requisitos e pré-requisitos
  3. Regras de utilização do ERP
  4. Dicionário de Campos
  5. Links úteis


01. VISÃO GERAL

Esta documentação tem como objetivo descrever como funciona o envio da carga de Imagem do ERP TOTVS Varejo Supermercados para a plataforma de E-commerce Shopify utilizando a plataforma TOTVS iPaaS como middleware de comunicação. Nesta integração são enviadas imagens, e especificações acerca do SKU.

02.

...

REQUISITOS E PRÉ-REQUISITOS

Configurações necessárias no Totvs IPaaS

Nota
O IPAAS as imagens e especificações de SKUs referente aos produtos no ERP através do endpoint: GET SmPedidoVenda/​api​/v1​/Cadastros​/ProdutoSkuEspecificacao.


Card documentos
InformacaoPara funcionamento é necessário ter o módulo web SmPedidoVendaAPI instalado a partir da versão 24.01.026 e 24.07.001 instalados no cliente. Caso não esteja na versão mencionada, favor efetuar a atualização para uma versão mais recente do ERP.
TituloIMPORTANTE!
Para a informação acima, caso não tenha, ele não funciona? tem algum risco ou impacto? o que ele deve fazer?


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

...

Card documentos
InformacaoImportante ressaltar que a variável shopify_api_version deve ser alterada apenas pela Totvs, pois, uma alteração sem aviso prévio poderá ocasionar problemas na integração com a plataforma Shopify
TituloImportante Destacar!


03. REGRAS DE UTILIZAÇÃO DO ERP

Configurações necessárias no ERP

...

Campo

ERP (Linha Consinco)

Shopify

CompanyId

Parâmetros > Parâmetros >  Empresa> Aba Geral > Empresa (max_empresa.nroempresa)

Hub: “CompanyId

Shopify: não existe

BranchId

Será cadastrado no HUBECOMMERCE (O QUE É O HUBCOMMERCE, UM USUÁRIO LEIGO SABERIA?) TOTVS IPAAS 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 existe

productSpecificationId

Código da Imagem no ERP, localizado em Cadastros > Aba Produto >  Produto > Aba Imagem> Campo: Código de Imagem.(map_produtoimagem.seqprodutoimagem)

Hub: “erpReferenceKey”

Shopify: id
Observações: O campo productSpecificationId é integrado apenas até o Hub, para controle do código de imagem do erp, sendo que no Hub ele será o campo erpReferenceKey, porém ao integrar a imagem no Shopify, ele irá trazer como devolutiva para o Hub, o Id da Imagem no shopify, que no Hube será o campo eCommerceReferenceKey.

createDate

Refere-se à Data e Hora de inclusão do Cadastro de Produto (map_produto.dtahorinclusao), caso não haja, será enviado um Default com a data 01-Jan-2000.

Hub: “createDate”

Shopify: created_at

lastChange

Última Data e Hora de alteração no Cadastro da imagem do Produto em Cadastros > Aba Produto >  Produto > Aba Ecommerce e Aba Imagem
ou caso não haja, será utilizado a última Data e Hora de inclusão no Cadastro de produto (map_produto.dtahorinclusao). Como default caso não exista data e hora nestes campos será enviado 01-jan-2000.

Hub: “lastChange”

Shopify: updated_at

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: variant_ids

name

Campo Descrição, localizado em Cadastros > Aba Produto >  Produto > Aba Ecommerce > Campo na Grid: Descrição.

Hub: “name”

Shopify: não existe

listOfAvailableValues

Lista de Url de imagens.

Hub: “listOfSpecificationValue”

Shopify: não existe

listOfAvailableValues.value

Campo Url Imagem-Ecommerce, localizado em Cadastros > Aba Produto >  Produto > Aba Ecommerce > Campo na Grid: Url Imagem-Ecommerce.

Hub: “value”

Shopify: src


05. LINKS ÚTEIS

         Link: Detalhamento do fluxo