Hub Política Comercial
A tela Hub Política Comercial — também conhecida como DE-PARA Política Comercial — faz a ponte entre o código de política comercial usado pelo canal de venda externo (Mercado Livre, Vtex, Magalu, Tray Commerce, etc.) e a política comercial cadastrada no idworks. Cada linha é uma regra de tradução: quando um pedido ou uma oferta chega de uma determinada integração com um determinado código de canal (mais opcionalmente filtros de frete grátis e tipo de pedido), o sistema sabe qual política comercial interna usar para precificar o item, montar a oferta a ser enviada ao marketplace ou aplicar regras fiscais ao pedido recebido.
O nome "DE-PARA" vem do conceito clássico de integração: DE = o lado externo (canal de venda) → PARA = o lado interno (ERP idworks). A tela é uma lista CRUD bem simples (4 endpoints, 4 privilégios — Visualizar, Criar, Editar, Deletar) com um modal de cadastro que mostra os dois lados separados por uma seta. O mapeamento é consumido principalmente durante a importação de ofertas/anúncios e o envio de preços para os marketplaces — o cadastro de pedido em si não consulta esta tela diretamente.
Esta tela não tem parametrizações próprias em Configurações → Parametrizações. As regras específicas por integração (campo "Frete grátis" só aparece para Mercado Livre, "Código canal" obrigatório para Vtex) são fixas no comportamento do sistema.
Índice
Conceito
- O que é a tela Hub Política Comercial?
- O que significa "DE" e "PARA" no mapeamento?
- Para que serve esse mapeamento na prática?
- Onde o mapeamento é consumido pelo sistema?
Cadastro e edição
- Como criar um novo mapeamento DE-PARA?
- Quais campos são obrigatórios?
- Cadastros que você precisa ter antes
- Como adicionar um código de canal que não está na lista?
- Como editar um mapeamento existente?
- Como excluir um mapeamento?
Busca
Casos especiais por integração
- Por que o campo "Frete grátis" só aparece para Mercado Livre?
- Por que "Código canal" é obrigatório para Vtex?
- O que acontece quando nenhum mapeamento bate?
Regras de negócio
- Por que não consigo excluir um tipo de pedido ou uma política comercial usada aqui?
- Posso ter dois mapeamentos com a mesma integração e mesmo código de canal?
- O que acontece quando uma integração é excluída?
Referência rápida
O que é a tela Hub Política Comercial?
É a tela onde você cadastra a tradução entre o código de política comercial usado pelo canal de venda externo (Mercado Livre, Vtex, etc.) e a política comercial cadastrada no idworks. Cada linha responde à pergunta "quando uma oferta chegar do canal X com o código de política Y, qual política comercial interna usar?". A tela é puramente um catálogo de regras de tradução — não tem fluxo de aprovação, não dispara processos, é só CRUD.
📍 Onde: menu lateral → Integrações → Hub Política Comercial.
O que significa "DE" e "PARA" no mapeamento?
| DE (canal externo) | PARA (ERP idworks) | |
|---|---|---|
| Origem do código | O canal de venda (Mercado Livre, Vtex, Magalu, Shopee, etc.). | Cadastrado em Configurações → Política Comercial. |
| Identificação | Integração (qual canal) + Código canal (o código que o canal usa). | Política comercial (qual política interna usar). |
| Filtros extras | Frete grátis (Sim/Não/Ambos) — só para Mercado Livre. | Tipo de pedido — quando o pedido cair nessa regra, qual tipo de pedido aplicar. |
A direção do mapeamento é sempre canal → ERP: quando uma informação chega do canal com determinado código, o sistema procura nesta tela qual política interna corresponde. O caminho inverso (ERP → canal) é feito por outra tela: Configurações → Política Comercial ao vincular uma política a uma integração específica.
Para que serve esse mapeamento na prática?
Marketplaces usam códigos próprios de política comercial: o Mercado Livre tem "Clássico", "Premium", "Loja Oficial"; a Vtex tem códigos numéricos por trading policy; a Magalu trabalha com "promoção dia das mães". Cada um desses códigos pode ser:
- Um tipo de anúncio (Clássico × Premium no Meli) — exige preço diferente, comissão diferente, regra de frete diferente.
- Um canal de venda (Vtex Trade Policy) — usado para segmentar B2B × B2C × mercado preferencial.
- Uma promoção sazonal que afeta margem.
Sem o DE-PARA, o idworks não saberia que política aplicar quando recebe uma oferta ou um pedido daquele código. O mapeamento permite ter uma única política interna ("Mercado Livre Clássico") consumida por múltiplos códigos externos — e o sistema automaticamente sabe qual usar baseado no contexto.
Onde o mapeamento é consumido pelo sistema?
O mapeamento é usado em 3 momentos principais do ciclo de venda multi-canal:
- Importação de ofertas/anúncios do canal — quando um anúncio é importado (Mercado Livre, Vtex, etc.), o sistema usa o código de política do canal + a integração para descobrir qual política comercial interna aplicar à oferta.
- Envio de preços para o marketplace — quando o preço de um SKU muda no idworks, o sistema verifica em quais integrações esse SKU está mapeado (via política comercial interna) e dispara o envio de preço para cada uma.
- Cálculo de preço da oferta — durante o cálculo do preço a ser enviado ao canal (com comissão, frete embutido, promoção), o sistema usa a política mapeada para descobrir quais regras aplicar.
O cadastro de pedido (importação de pedido do canal) não consulta esta tela diretamente — usa outras regras para definir a política comercial do pedido. Esta tela serve principalmente para a precificação e o catálogo, não para o pedido em si.
Como criar um novo mapeamento DE-PARA?
- Acesse Integrações → Hub Política Comercial.
- Clique em Novo.
- Na janela que abre, preencha os campos do lado DE (esquerda):
- * Integração — selecione a integração configurada (ex.: "Mercado Livre - Loja A").
- Código canal — escolha o código de política do canal na lista, ou digite manualmente (campo aberto). Para alguns canais (Mercado Livre), a lista vem direto da API do canal; para outros, fica em branco e você digita.
- Frete grátis (apenas Mercado Livre) — Sim / Não / Ambos. Define se este mapeamento se aplica a anúncios com frete grátis, sem frete grátis ou ambos.
- No lado PARA (direita):
- * Política comercial — política interna do idworks que deve ser usada para esse código canal.
- Tipo de pedido — opcional; quando preenchido, vincula a regra a um tipo de pedido específico.
- Clique em Salvar.
Pré-requisito: privilégio Criar hub política comercial.
Quais campos são obrigatórios?
São obrigatórios:
- Integração — qual canal de venda.
- Política comercial — qual política interna do ERP.
Os demais campos são opcionais, com uma exceção: para a integração Vtex, o Código canal também é obrigatório (veja a pergunta específica sobre Vtex). Para o Mercado Livre, o campo Frete grátis está disponível e tem efeito; para qualquer outra integração, mesmo se o campo for preenchido o sistema ignora o valor.
Cadastros que você precisa ter antes
O formulário usa listas de seleção que dependem de cadastros feitos em outras telas. Antes de criar o primeiro mapeamento, certifique-se de já ter:
- Integração — em Configurações → Integrações. A integração precisa estar ativa para aparecer na lista.
- Política comercial (ERP) — em Configurações → Política Comercial.
- Tipo de pedido (opcional) — em Configurações → Tipo Pedido.
Como adicionar um código de canal que não está na lista?
Em algumas integrações, o Código canal vem carregado direto da API do canal (lista pré-populada). Em outras, ele aparece vazio ou incompleto. Para adicionar um código manualmente:
- Com a janela de cadastro aberta, clique no campo Código canal.
- No final do dropdown, há um campo Digite... com um botão Adicionar.
- Digite o código exatamente como o canal usa e clique em Adicionar.
- O código aparece preenchido no campo principal.
- Continue preenchendo os outros campos e salve.
Útil para canais que usam códigos arbitrários (ex.: "TRADE_2024", "VIP_GOLD") ou quando a API do canal está temporariamente indisponível.
Como editar um mapeamento existente?
- Na lista, clique no ícone de lápis na linha do mapeamento que quer alterar (ou dê duplo clique).
- Edite os campos desejados.
- Clique em Salvar.
As mesmas regras de obrigatoriedade valem (Integração e Política comercial sempre; Código canal obrigatório quando a integração é Vtex). O Frete grátis continua tendo efeito apenas em Mercado Livre — em outras integrações o valor é forçado para vazio mesmo se o operador preencher.
Pré-requisito: privilégio Editar hub política comercial.
Como excluir um mapeamento?
- Na lista, clique no ícone de lixeira na linha.
- Confirme na janela "Confirma remover '<Integração> - <Código canal>'?".
- O mapeamento é apagado imediatamente.
Não há restrições de exclusão neste lado — qualquer mapeamento pode ser apagado a qualquer momento. As outras telas (Política Comercial, Tipo Pedido) é que bloqueiam exclusões quando há mapeamentos vinculados (veja Regras de negócio).
Pré-requisito: privilégio Deletar hub política comercial.
Como buscar e filtrar os mapeamentos?
A tela tem um filtro simples por Conta (visível apenas quando a empresa tem mais de uma conta). Para encontrar um mapeamento específico, use a busca direta nas colunas da lista (clique no cabeçalho da coluna para ordenar/filtrar):
- Integração — nome amigável da integração ("Mercado Livre - Loja A").
- Política (integração) — código de política do canal (lado DE).
- Frete grátis — Sim / Não / em branco.
- Política (erp) — nome da política interna (lado PARA).
- Tipo pedido — quando preenchido.
- Cod. (erp) — identificador interno da política do ERP.
- Conta — quando há multi-conta.
Por que o campo "Frete grátis" só aparece para Mercado Livre?
O Mercado Livre tem um filtro adicional de política comercial baseado em frete grátis: o anunciante pode ter uma política específica para anúncios com frete grátis (frete subsidiado pelo Meli) e outra para anúncios sem frete grátis. Por isso, dois mapeamentos para a mesma integração + mesmo código canal são permitidos quando diferem no Frete grátis — um para "Sim", outro para "Não".
Para outras integrações (Vtex, Magalu, Shopee, Tray Commerce, etc.), o conceito de "política diferente por frete grátis" não se aplica. Mesmo se o operador preencher o campo, o sistema o força para vazio antes de salvar — para evitar inconsistências na regra de consumo da política.
Por que "Código canal" é obrigatório para Vtex?
A Vtex usa o conceito de Trade Policy — códigos numéricos que separam o catálogo em "vitrines" diferentes (B2B, B2C, mercado preferencial, etc.). Em uma operação Vtex, um único SKU pode aparecer em múltiplas trade policies, cada uma com preço e disponibilidade próprios.
Como o catálogo Vtex sempre vem associado a uma trade policy, o idworks exige que o mapeamento DE-PARA tenha o código canal preenchido para integrações Vtex — sem ele, o sistema não consegue distinguir qual trade policy aplicar e a importação de oferta falha.
A mensagem de erro quando o operador tenta salvar sem código canal numa integração Vtex é: "Campo política integração é obrigatório para integração Vtex".
O que acontece quando nenhum mapeamento bate?
Quando o sistema precisa precificar uma oferta ou enviar preço ao canal e não encontra um mapeamento DE-PARA correspondente:
- O sistema procura uma política comercial padrão da empresa (a política marcada como Padrão em Configurações → Política Comercial).
- Se há política padrão → usa ela como fallback (e segue o fluxo de precificação normalmente).
- Se não há política padrão cadastrada → a operação falha com o aviso "Não foi localizado política comercial...".
Por isso, é boa prática sempre ter uma política padrão ativa: ela cobre os casos não mapeados, evitando que ofertas/preços falhem em produção.
Por que não consigo excluir um tipo de pedido ou uma política comercial usada aqui?
O sistema protege os mapeamentos contra exclusão acidental da origem:
- Tentativa de excluir tipo de pedido: se algum mapeamento usa esse tipo, aparece o aviso "Tipo de pedido tem de/para de política comercial e não pode ser excluído".
- Tentativa de excluir política comercial (ERP): se algum mapeamento aponta para essa política, aparece "Existem de/para vinculados a essa política comercial".
Para destravar:
- Vá à tela Hub Política Comercial.
- Filtre pelos mapeamentos que usam o item bloqueado.
- Exclua os mapeamentos (ou aponte-os para outro item).
- Volte e exclua o tipo de pedido / política comercial.
Posso ter dois mapeamentos com a mesma integração e mesmo código de canal?
Sim, e isso é permitido propositalmente. Por exemplo:
- Mercado Livre + código "Clássico" + Frete grátis = Sim → política "Meli Clássico com FG".
- Mercado Livre + código "Clássico" + Frete grátis = Não → política "Meli Clássico sem FG".
Esses dois mapeamentos coexistem para que o sistema escolha a política correta dependendo se o anúncio tem ou não frete grátis. A combinação Integração + Código canal + Frete grátis + Tipo de pedido pode aparecer mais de uma vez, mas é boa prática evitar duplicatas com a mesma combinação completa — quando há ambiguidade, o sistema usa o primeiro registro encontrado (sem garantia de ordem), o que pode levar a comportamento imprevisível.
Sempre que possível, garanta que cada combinação seja única.
O que acontece quando uma integração é excluída?
Quando uma integração é excluída em Configurações → Integrações, todos os mapeamentos vinculados a ela são apagados automaticamente em cascata — não é necessário limpar manualmente esta tela. A exclusão da integração também remove preços, ofertas e outros vínculos do canal.
Útil quando você cancela o uso de um canal de venda: basta excluir a integração e o sistema limpa todos os DE-PARAs órfãos.
Resumo de parametrizações
Esta tela não tem parametrizações próprias em Configurações → Parametrizações. As regras específicas por integração são fixas no comportamento do sistema:
| Integração | Comportamento especial |
|---|---|
| Mercado Livre | O campo Frete grátis está ativo e funciona como filtro adicional do mapeamento. |
| Vtex | O campo Código canal (Trade Policy) é obrigatório — sem ele a operação falha. |
| Outras (Magalu, Shopee, Tray Commerce, Magento, etc.) | Mapeamento simples por código canal. Frete grátis é forçado para vazio mesmo se preenchido. |
A configuração relevante para esta tela não vive em Parametrizações, mas sim:
- Configurações → Política Comercial — para criar/editar as políticas internas e definir qual é a Padrão (usada como fallback).
- Configurações → Integrações — para criar/editar as integrações que aparecem no campo Integração.
- Configurações → Tipo Pedido — para criar/editar os tipos de pedido vinculáveis.
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égio | Libera |
|---|---|
| Visualizar hub política comercial | Acesso à tela, à lista e à visualização dos mapeamentos. |
| Criar hub política comercial | Botão Novo e o cadastro de um novo mapeamento. |
| Editar hub política comercial | Edição de um mapeamento existente (lápis ou duplo clique). |
| Deletar hub política comercial | Exclusão de um mapeamento (ícone de lixeira). |