Á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 Geral
  2. Regras de utilização no Totvs Ipass
  3. Regras de utilização do ERP
  4. Dicionário de Campos
  5. Links úteis

...

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. REGRAS DE UTILIZAÇÃO NO TOTVS IPASS

Sugestão: 02. REQUISITOS E PRÉ-REQUISITOS

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

1. 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 das especificações de SKUs e imagens. 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 > Especificação do 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 Especificações de SKUs, neste período.
Image Modified

2. 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 > Especificação do SKU > Campo: Página, nela será possível a escolha da página ao qual quer fazer a busca das informações no ERP.

Image Modified

3. 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 Especificações de SKUs do ERP, as quais serão enviadas ao Shopify (variável no Ipass: productskuespecification_pagesize)

4. 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
          Image Removed Image Added
       Configurações do Projeto
       Image Modified
       Variáveis do Projeto
       Image Modified

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

Sugestão: ERP

1. O status da embalagem, deve estar ativo na família . (Map_Famembalagem.Status)
Image Modified

2. O status de venda do produto de acordo com sua embalagem, deve estar ativo no cadastro de produto (Mrl_Prodempseg.Statusvenda)
Image Modified

3. A integração de produto com o E-Commerce, deve estar ativo no cadastro de produto. (Map_Produto.Indintegraecommerce)
Image Modified

4. A URL Imagem E-commerce, deve estar preenchida com a respectiva URL da imagem do produto. (Map_Produtoimagem.Urlecommerceimg)
Image Modified

04. DICIONÁRIO DE CAMPOS

Campos utilizados na integração do endpoint GET SmPedidoVenda/​api​/v1​/Cadastros​/ProdutoSkuEspecificacao, e suas respectivas referências no ERP e na plataforma Shopify

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?) 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

...