Tempo aproximado para leitura: 6 minutosCONTEÚDO
- Visão Geral
- Requisitos e pré-requisitos
- Regras de utilização do ERP
- Dicionário de Campos
- 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
O IPAAS as imagens e especificações de SKUs referente aos produtos no ERP através do endpoint: GET SmPedidoVenda/api/v1/Cadastros/ProdutoSkuEspecificacao.
IMPORTANTE!
Para 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.
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.
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.
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
Configurações do Projeto
Variáveis do Projeto
Importante Destacar!
Importante 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
03. REGRAS DE UTILIZAÇÃO DO ERP
Configurações necessárias no ERP
1. O status da embalagem, deve estar ativo na família . (Map_Famembalagem.Status)
2. O status de venda do produto, de acordo com sua embalagem, deve estar ativo no cadastro de produto (Mrl_Prodempseg.Statusvenda)
3. A integração de produto com o E-Commerce, deve estar ativo no cadastro de produto. (Map_Produto.Indintegraecommerce)
4. A URL Imagem E-commerce, deve estar preenchida com a respectiva URL da imagem do produto. (Map_Produtoimagem.Urlecommerceimg)
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 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” |
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 | 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. | 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
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas