Pular para o conteúdo principal

DE-PARA Variações

A tela DE-PARA Variações é a tabela de tradução entre as variações (cor, tamanho, voltagem, etc.) que cada canal de venda usa no anúncio e as variações cadastradas no idworks. Cada linha amarra um par "Integração + Categoria + Variação do canal" a uma "variação interna" — permitindo o sistema entender corretamente os atributos do produto na hora de criar pedidos vindos do canal, emitir nota fiscal e gerar etiquetas.

Sem essa amarração, as variações chegam dos marketplaces com nomes não padronizados (ex.: o canal usa "M", "Medium", "39" para tamanho; cor pode vir como "Azul Marinho", "AZUL MARINHO", "ml-blue") e o idworks não sabe que esses valores são equivalentes às variações cadastradas internamente.

A tela usa um modal com encadeamento de seletores: o usuário escolhe a integração, depois a categoria do canal (cuja lista depende da integração) e finalmente a variação do canal (cuja lista depende da categoria). Do lado direito, escolhe-se a variação interna correspondente.

Índice​

Conceito

Cadastro e edição

Busca e visualização

Regras de negócio

Referência rápida

O que é a tela DE-PARA Variações?​

É a tela onde você cria a tabela de tradução entre os valores de variação (cor, tamanho, voltagem, sabor, etc.) que cada canal de venda usa nos anúncios e as variações cadastradas como atributos de produto no idworks. O propósito é garantir que pedidos vindos dos marketplaces casem corretamente com o SKU certo mesmo quando o canal usa nomes diferentes para o mesmo atributo.

📍 Onde: menu lateral → Integrações (HUB) → DE-PARA Variações.

Por que preciso fazer esse DE-PARA?​

Cada canal de venda tem seu próprio vocabulário para variações de produto. Um SKU chamado "Camiseta Azul - Tamanho M" no idworks pode ser anunciado em diferentes canais como:

  • Mercado Livre — Cor: Azul, Tamanho: M.
  • Shopee — Cor: BLUE, Tamanho: Medium.
  • VTEX — Cor: azul-marinho, Tamanho: 38.

Quando o pedido chega do canal, o XML/JSON cita esses valores brutos. Sem o DE-PARA:

  • O idworks não sabe que BLUE (Shopee) e Azul (idworks) são a mesma cor — pode criar SKU duplicado ou falhar ao casar o estoque.
  • A NF emitida pode sair com descrição errada do produto.
  • A etiqueta de envio pode ficar com nomenclatura do canal em vez da padronizada da empresa.

Com o DE-PARA configurado, o sistema substitui o valor do canal pelo valor interno antes de processar o pedido.

O que é Categoria do canal e por que preciso dela?​

Cada canal organiza os produtos em categorias (Eletrônicos, Roupas, Calçados, etc.) — e os atributos disponíveis para variação dependem da categoria. Por exemplo:

  • Categoria "Calçados" → atributos típicos: Numeração, Cor, Material.
  • Categoria "Eletrônicos" → atributos típicos: Voltagem, Cor, Capacidade.

Por isso o DE-PARA exige escolher a categoria do canal antes de listar as variações disponíveis — assim você só vê os atributos válidos para aquele tipo de produto, evitando confundir, por exemplo, "voltagem 110V" com "tamanho M".

A lista de categorias vem do próprio canal (carregada via API quando você escolhe a integração).

Como adicionar um novo DE-PARA?​

Clique em Adicionar no topo da tela. O modal abre dividido em dois blocos com seletores encadeados à esquerda:

  1. Integração — selecione o canal de venda. A lista mostra apenas integrações ativas.
  2. Categoria — selecione a categoria do canal (carregada do canal após escolher a integração).
  3. Variação canal — selecione o valor da variação como vem do canal (carregado após escolher a categoria). Se não aparecer, use o campo Adicionar no rodapé do seletor para incluir manualmente.

Do lado direito:

  1. Variação (idworks) — selecione a variação interna correspondente (lista carregada de Estoque → Tipo de Variação).

Clique em Salvar. O DE-PARA passa a ser aplicado em pedidos chegando do canal a partir desse momento.

Pré-requisito: privilégio Criar hub variações.

Como cadastrar uma variação do canal que ainda não está na lista?​

No seletor Variação canal, role até o final — há um campo Digite... com botão Adicionar. Digite o valor exato como aparece nos pedidos do canal (sensível a maiúsculas/minúsculas) e clique em Adicionar. O valor é incluído na lista e selecionado automaticamente.

Use essa opção quando o canal devolve um valor que não está na lista de atributos pré-cadastrada (vocabulário customizado, gírias, atributos descontinuados que ainda aparecem em pedidos antigos).

Como editar ou remover um DE-PARA?​

  • Editar — clique no ícone Editar (lápis) na linha. Modal abre com os campos preenchidos.
  • Remover — clique no ícone Remover (lixeira). Confirmação aparece com o nome completo do DE-PARA (integração + variação canal + variação idworks).

Pré-requisitos: privilégios Editar hub variações e Deletar hub variações.

Como filtrar os DE-PARA cadastrados?​

Clique em Filtros para abrir o painel lateral. Os filtros disponíveis:

  • Conta — separa por conta (subdomínio).
  • Integração — filtra por canal de venda.
  • Categoria — filtra por categoria do canal (depende da integração).
  • Variação (idworks) — filtra por valor interno.

Clique em Aplicar para atualizar.

Por que a Categoria fica desabilitada antes de eu escolher a Integração?​

A lista de categorias depende do canal — Mercado Livre, Shopee, VTEX e cada canal tem seu próprio conjunto. O sistema só consegue carregar a lista certa depois que você escolhe a integração, por isso o campo fica desabilitado até esse momento.

Ao trocar a Integração, o sistema limpa automaticamente os valores de Categoria e Variação canal — você precisa escolher de novo para a integração nova.

Por que a Variação do canal fica desabilitada antes de eu escolher a Categoria?​

Mesma lógica do campo anterior: os valores de variação são específicos da categoria dentro do canal. Eletrônicos têm voltagem; roupas não. O sistema só consegue carregar a lista certa depois que a categoria foi selecionada.

Ao trocar a Categoria, o sistema limpa o valor de Variação canal — escolha de novo para a categoria nova.

De onde vem a lista de Variações (idworks)?​

A lista vem do cadastro em Estoque → Tipo de Variação (e seus valores possíveis em Estoque → Variação). Cada tipo de variação (Cor, Tamanho, Voltagem, etc.) tem uma lista de valores válidos cadastrados — esses são os valores que aparecem no seletor Variação (idworks) desta tela.

Para incluir um valor que está faltando, cadastre primeiro em Estoque → Variação e volte aqui para criar o DE-PARA.

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.

PrivilégioLibera
Visualizar hub variaçõesAcesso à tela e à lista.
Criar hub variaçõesBotão Adicionar.
Editar hub variaçõesÍcone Editar (lápis) na linha.
Deletar hub variaçõesÍcone Remover (lixeira) na linha.