Objetivo
Este documento tem como objetivo explicar o funcionamento da integração das embalagens do sistema TOTVS Varejo Supermercados Linha Consinco com o e-commerce Vtex, utilizando o Serviço Integrador.
Integração
A integração de embalagens para o E-commerce Vtex, consiste em enviar todas as embalagens que deverão ser utilizadas no e-commerce.
São integradas os dados da embalagem como:
- Código Referência (no formato P + Código Produto + E + Quantidade na Embalagem; por exemplo: Um produto código 10 e embalagem 5 fica com a referência P10E5).
- Unidade Medida
- Nome Embalagem
- Peso Bruto
- Peso Liquido
- EAN
- Status
- Fator Multiplicador
- Altura
- Profundidade
- Largura
- Identificador do Fabricante no ERP
- Quantidade na Embalagem
- Identificador da Família no ERP
- Identificador da Divisão no ERP
- Ativo
Os registros que serão integrados são influenciados pela configuração Diferencia Preço por Embalagem no módulo Parametros -> Dealer -> Segmento. Caso essa opção esteja marcada, o integrador irá retornar apenas a embalagem padrão de venda. Caso essa opção não esteja marcada, o integrador o integrador irá integrar todas as embalagens vinculadas a família do produto.
Os registros que serão integrados também são influenciados pela configuração Painel de Integração > Configurações > Conta VTEX > Campo "Preço a partir de". Caso essa opção esteja marcada, o integrador irá retornar apenas a embalagem padrão de venda da Conta VTEX em questão. Caso essa opção não esteja marcada, o integrador o integrador irá integrar todas as embalagens vinculadas a família do produto.
Para que seja realizada uma nova integração atualizando um registro já integrado, o sistema verifica a data de última atualização do registro. Portanto, ao realizar alguma alteração no registro de embalagem, ele será encaminhado novamente para a view para manter a integridade dos dados do ERP com o E-commerce Vtex.
Detalhamento dos campos
Campo | ERP TOTVS (Linha Consinco) | Catalogo VTEX |
|---|---|---|
| Código Referência | Cadastro > Produto > Produto > Aba Geral > Campo "Código" Cadastro > Família > Família > Aba Embalagens Observação: Formato P + Código Produto + E + Quantidade na Embalagem; por exemplo: Um produto código 10 e embalagem 5 fica com a referência P10E5 | Catálogo > Produtos e SKUs > Coluna SKU |
| Unidade de medida no ERP | Cadastro > Família > Família > Aba Geral > Campo "É Pesável". Caso esse campo esteja marcado, o integrador irá enviar o SKU como kg, caso contrario, o integrador irá enviar o SKU como un. | Catálogo > Produtos e SKUs > Coluna SKU > Unidade de medida |
| Nome Embalagem | Cadastro > Produto > Produto > Aba E-Commerce > Desc. E-Commerce. Observação 1: Se a embalagem não for a padrão de venda a descrição do produto será no formato “Embalagem Quantidade”, por exemplo: “CX 1”. Observação 2: Se não preenchermos o campo "Desc. 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. A "Descrição Genérica" ou "Descrição Completa" irão com a primeira letra maiúscula de acordo com o PD "USA_PRIMEIRA_LETRA_MAISC". | Catálogo > Produtos e SKUs > Coluna SKU > Nome |
| Peso Bruto | Cadastro > Família > Família > Aba Embalagens > Coluna Peso Bruto (kg). | Catálogo > Produtos e SKUs > Coluna SKU > Peso para frete |
| Peso Liquido | Cadastro > Família > Família > Aba Embalagens > Coluna Peso Líq. (kg). | Catálogo > Produtos e SKUs > Coluna SKU > Peso real |
| EAN | Cadastro > Produto > Produto > Aba Códigos. Observação, o tipo do código cadastrado precisa ser EAN/UUC. | Catálogo > Produtos e SKUs > Coluna SKU > EAN |
| Status | Cadastro > Produto > Produto > Aba E-Commerce > Integra Produto com E-Commerce Cadastro > Produto > Produto > Aba Empresa / Segmento Observação 1: Caso o campo Integra Produto com E-Commerce esteja desmarcado, o Status enviado será Inativo. Observação 2: Para o SKU ser enviado como Ativo no integrador é necessário que na aba Empresa / Segmento no cadastro produto a embalagem esteja ativa para pelo menos uma das Empresas / Segmentos cadastradas no Painel de Integração > Configurações > Conta VTEX. Caso contrario, ele será enviado como Inativo. Observação 3: Esse campo ativa o produto assim que for possível ativa-lo, caso no momento da integração de SKU o SKU tenha alguma informações pendentes na VTEX e essa informação é corrigida no futuro, o produto é ativo após a correção. | Catálogo > Produtos e SKUs > Coluna SKU > "Ativar o SKU, se possível" |
| Fator Multiplicador | Cadastro > Produto Produto > Aba E-Commerce > Múltiplo de Venda Observação, se o produto for pesável, Cadastro > Família > Família > Aba Geral > Campo "É Pesável", o integrador irá enviar o conteúdo do campo Múltiplo de Venda, caso contrário, o integrador irá enviar o campo 1 fixo na view de integração. | Catálogo > Produtos e SKUs > Coluna SKU > Multiplicador de unidade |
| Altura | Cadastro > Família > Família > Aba Embalagens > Coluna Altura (cm). | Catálogo > Produtos e SKUs > Coluna SKU > Altura para frete Catálogo > Produtos e SKUs > Coluna SKU > Altura real |
| Profundidade | Cadastro > Família > Família > Aba Embalagens > Coluna Profundidade (cm). | Catálogo > Produtos e SKUs > Coluna SKU > Comprimento para frete Catálogo > Produtos e SKUs > Coluna SKU > Comprimento real |
| Largura | Cadastro > Família > Família > Aba Embalagens > Coluna Largura (cm). | Catálogo > Produtos e SKUs > Coluna SKU > Largura real Catálogo > Produtos e SKUs > Coluna SKU > Largura para frete |
Identificador do Fabricante | Cadastro > Família > Aba Fornecedores > Fornecedor Principal | Catálogo > Produtos e SKUs > Coluna SKU > Código do fabricante |
| Quantidade na Embalagem | Cadastro > Família > Família > Aba Embalagens Observação, o SKU é a combinação de produtos e embalagens cadastradas na Família, por exemplo, um produto com 3 embalagens cadastradas irá gerar 3 SKUs. | - |
Identificador da Família no ERP | Cadastro > Família > Família > Aba Geral > Identificador da Família no ERP | - |
| Identificador da Divisão no ERP | Parâmetros > Parâmetros > Empresa > Campo "Divisão" Observação, o integrador apenas trabalha com as divisões que estão cadastradas no Painel de Integração > Configurações > Conta VTEX. | - |
| Data hora da última alteração | Data da ultima alteração do cadastro do produto ou da embalagem do ERP. | - |
| Ativo | Envia "Falso" fixo na Pelo integrador. Observação, não é todos os casos que é SKU é possível ser ativo no momento da integração, sendo assim, trabalhamos com o campo Catálogo > Produtos e SKUs > Coluna SKU > "Ativar o SKU, se possível" | Catálogo > Produtos e SKUs > Coluna SKU > "SKU ativo?" |
Inativação do SKU
A inativação de um produto/SKU na Vtex irá respeitar a configuração no ERP, no módulo Cadastros > Produto > Produto > aba E-commerce e marcar o checkbox Integra Produto com E-commerce ou acessar o módulo Cadastro > Produto > Produto > Aba Empresa / Segmento e desmarcar e desmarcar a embalagem de todas as Empresas e Segmentos que estão cadastrados no ERP.
Os dados de controle do produto será gravado numa estrutura de controle do Integrador. Ao desmarcar o checkbox, o produto/SKU é inativado na Vtex.
Pré-Requisitos e Restrições
É necessário que o produto esteja ativo.
O produto precisa estar vinculado a pelo menos uma marca, uma família e pelo menos um fornecedor.
O fornecedor precisa estar marcado como principal.
- O produto referente a essa embalagem precisa ter sido integrado com sucesso para o E-commerce Vtex pela integração de Produtos e inserido corretamente na tabela de controle.
- A embalagem precisa estar ativa para venda em pelo menos um das Empresas e Segmentos cadastrados no painel da Painel de Integração > Configurações > Conta VTEX. Essa ativação pode ser feita no módulo Cadastro > Produto > Produto > Aba Empresa / Segmento.
- O produto deve estar com o campo Integra Produto com E-Commerce marcado. Essa ativação pode ser feita no módulo Cadastro > Produto > Produto > Aba E-Commerce.
- O SKU só é ativo depois que as Imagens são enviadas com sucesso para o SKU.
- O SKU só é ativo após a Categoria Global ser cadastrada no produto.
Recomendações de agendamento
Campo | Recomendação |
|---|---|
Lote | 200 |
| Tempo | 10 Minutos |
Criticas conhecidas
Exemplos de críticas efetuadas durante o processo da carga de SKU |
Descrição: Transaction (Process ID 123456) was deadlocked on lock resources with another process and has been chosen as the deadlock victim. Rerun the transaction. Detalhe: De acordo com um chamado aberto na VTEX, essa mensagem de erro é um bloqueio por conta de outra chamada já ter sido feita, provavelmente num intervalo de tempo muito curto. Em outras palavras muitas requisições sendo feitas em um curto perído de tempo. A solução para isso é reduzir o tamanho do LOTE da carga nas configurações de agendamento. |
Descrição: Altura inválida Detalhe: Verifique se a Altura (cm) foi informada previamente em Cadastro > Família > Família > Aba Embalagens > Coluna Altura (cm) para a embalagem. |
Descrição: Profundidade inválida Detalhe: Verifique se a Profundidade (cm) foi informada previamente em Cadastro > Família > Família > Aba Embalagens > Coluna Profundidade (cm) para a embalagem. |
Descrição: Largura inválida Detalhe: Verifique se a Largura (cm) foi informada previamente em Cadastro > Família > Família > Aba Embalagens > Coluna Largura (cm) para a embalagem. |
Descrição: Peso bruto inválido Detalhe: Verifique se o Peso Bruto (kg) foi informada previamente em Cadastro > Família > Família > Aba Embalagens > Coluna Peso Bruto (kg) para a embalagem. |
Descrição: Product not found Detalhe: Verifique se o campo Cadastro > Produto > Produto > Aba Geral > Identificador do Produto no ERP consta na tabela de controle de integração de produto e se esse Produto consta no cadastro de produtos da VTEX Catálogo > Produtos e SKUs com o mesmo identificador do ERP. |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas