Nesta documentação focamos em apresentar como funciona o envio de produtos do ERP TOTVS Varejo Supermercados para a plataforma de E-commerce Shopify utilizando a plataforma TOTVS iPaaS como middleware de comunicação.
O iPaaS consulta os produtos do ERP através do endpoint: GET SmPedidoVenda/api/v1/Cadastros/Produto/ passando como variáveis:
Para funcionamento é necessário ter o módulo web SmPedidoVendaAPI a partir da versão 24.01.026 e 24.07.001 instalados no cliente. |
Campo | ERP (Linha Consinco) | Shopify |
Código identificador do produto no ERP | Cadastro > Produto > Produto > Código (map_produto.seqproduto) | Hub: “erpReferenceKey” Shopify: não mapeado |
Data e hora da criação do produto | Data da criação do cadastro de produto do ERP (map_produto.dtahorinclusao) | Hub: “erpCreateDate” Shopify: product>created_at |
Data de hora da alteração do produto | Data da ultima alteração do cadastro de produto do ERP (map_produto.dtahoralteracao) | Hub: “erpLastChange” Shopify: product>updated_at |
Código da marca | Cadastro > Família > Aba Geral > Marca (map_marca.seqmarca) | Hub: “brandId” Shopify: não mapeado |
Código da categoria | Cadastro > Família > Categoria (map_categoria.seqcategoria) | Hub: “categoryId” Shopify: não mapeado |
Descrição completa do produto | Cadastro > Produto > Aba Geral > Especificação detalhada (map_produto.desccompleta) Observação, se não preenchermos o campo "Desc. E-Commerce" da Aba e-commerce, mandamos o campo "Descrição Genérica" ou "Descrição Completa" da aba Geral de acordo com o PD EXPORTA_DESC_GENERICA_PROD e concatenamos com o valor do PD DESC_ECOMMERCE | Shopify > Menu lateral > Produtos > Clicar no produto desejado > Campo ‘Descrição’ Shopify: "product">"updated_at" |
Descrição reduzida do produto | Cadastro > Produto > Aba geral > Descrição Reduzida (map_produto.descreduzida) Observação, se não preenchido mandamos o campo "Descrição Completa" da aba Geral e concatenamos com o valor do PD DESC_ECOMMERCE | Hub: “descriptionShort” Shopify: não mapeado |
Indicador se o produto integra com plataforma e-commerce | Cadastro > Produto > Aba e-commerce > Integra Produto com E-commerce (map_produto.indintegraecommerce) Caso esteja como S enviamos como Ativo na Shopify, caso contrário, enviamos com status de Inativo | Shopify > Menu lateral > Produtos > Clicar no produto desejado > Campo ‘Status’ Hub: “isActive” Shopify: "product">"status" |
Indicador se o produto deve estar visível na plataforma e-commerce | Cadastro > Produto > Aba e-commerce > Integra Produto com E-commerce (map_produto.indintegraecommerce) Caso esteja como S enviamos como Ativo na Shopify, caso contrário, enviamos com status de não visível | Hub: “isVisible” Shopify: não mapeado |
Palavra chave e-commerce | Cadastro > Produtos > Aba e-commerce > Palavra Chave (map_produto.palavrachaveecommerce) | Hub: “keywords” Shopify: não mapeado |
TAG description no e-commerce | Cadastro de produtos > Aba e-commerce > Desc. E-Commerce (map_produto.descecommerce) | Hub: “metaTagDescription” Shopify: não mapeado |
TAG name no e-commerce | Cadastro de produtos > Aba e-commerce > Nome Produto E-Commerce (map_produto.nomeprodutoecomm) Observação, se não preenchido, será enviado map_produto.descecommerce ou map_produto.descreduzida | Hub: “name” Shopify: não mapeado |
TAG title no e-commerce | Cadastro > Produto > Aba e-commerce > Título E-Commerce (map_produto.tituloecommerce) Observação, se não preenchido será enviado map_produto.descreduzida | Shopify > Menu lateral > Produtos > Clicar no produto desejado > Campo ‘Título’. Hub: “title” Shopify: "product">"title" |
Nome da marca | Cadastro > Família > Aba Geral > Marca (map_marca.marca) | Shopify > Menu lateral > Produtos > Clicar no produto desejado > Campo ‘Fornecedor’ Shopify: "product">"vendor" |
Nome da categoria | Cadastro > Família > Categoria (map_categoria.categoria) | Shopify > Menu lateral > Produtos > Clicar no produto desejado > Campo ‘Tipo de produto’ Shopify: "product">"product_type" |
Nome do fabricante | Nome da coluna na API: manufacturer Valor fixo: null | Hub: products.manufacturer Shopify: não mapeado |
Data de lançamento | Nome da coluna na API: releaseDate Valor fixo: null | Hub: products.releaseDate Shopify: não mapeado |
Código do grupo | Nome da coluna na API: groupCode Valor fixo: null | Hub: products.groupCode Shopify: não mapeado |
Link: https://hubecommerce.totvs.app/product-root