¶ DE-PARA
Caminho: Terus Order → DE-PARA → DE-PARA
Portal: Fornecedor
Cadastro e manutenção dos mapeamentos de produto entre o seu catálogo e o varejo selecionado. É a tela principal para criar, editar, ativar, desativar e importar DE-PARAs.
Volte à visão geral do módulo para entender o papel do DE-PARA no Terus.
¶ 3.1 Visão geral
Para que serve: manter o vínculo produto fornecedor ↔ produto varejo, com fator, múltiplo, tipo de carga e vendedor padrão.
Quando usar: sempre que um produto novo entrar no sortimento do varejo, quando precisar corrigir parâmetros ou quando quiser desativar um vínculo sem apagar o histórico.
Quem usa: equipe comercial, cadastro ou operação do fornecedor. O Vendedor (RCA) enxerga e edita apenas os mapeamentos do próprio código.
Problema que resolve: permite que o Terus reconheça pedidos, alertas e relatórios usando o código correto de cada lado.
Resultado esperado: linha na tabela com status Ativo, produtos visíveis nos demais módulos.
¶ 3.2 Como acessar
Terus Order → DE-PARA → DE-PARA
- Selecione o varejo na barra lateral.
- Abra o menu Terus Order.
- Expanda DE-PARA e clique em DE-PARA.
Legenda: cabeçalho com ações, filtros Ativos/Inativos, busca e tabela de mapeamentos. Dados sensíveis podem aparecer borrados na documentação.
Atalhos no cabeçalho da mesma tela:
| Botão | Destino |
|---|---|
| Vendedor por filial | DE-PARA Vendedor Filial |
| DE-PARA do Varejo | DE-PARA do Varejo |
| Importar Planilha | Painel de importação na própria tela |
| Novo Mapeamento | Formulário de criação na própria tela |
¶ 3.3 Conhecendo a tela
| # | Elemento | Descrição |
|---|---|---|
| 1 | Título | DE-PARA de Produtos + quantidade de mapeamentos |
| 2 | Busca | Placeholder "Buscar código, descrição..." |
| 3 | Filtro | Ativos / Inativos |
| 4 | Tabela | Mapeamentos do varejo selecionado |
| 5 | Coluna Produto Fornecedor | Código e descrição do seu catálogo |
| 6 | Ícone de vínculo | Indica se há ligação ativa entre os códigos |
| 7 | Coluna Produto Varejo | SKU e descrição no varejo |
| 8 | Fator | Fator de conversão |
| 9 | Múlt. | Múltiplo de venda |
| 10 | Carga | SECA, FRIA ou REFRIGERADA |
| 11 | Vendedor | Código RCA padrão + botão por filial / N filial(is) |
| 12 | Editar | Edição inline na linha |
| 13 | Ativo / Inativo | Alterna o status do mapeamento |
Estados da tela (mensagens):
- "Selecione o varejo na barra lateral para começar."
- "Sem relacionamentos ativos." — contate a Terus.
- "Nenhum mapeamento encontrado" — use Novo Mapeamento.
¶ 3.4 Passo a passo das operações
¶ Pesquisar e filtrar
- Selecione o varejo na sidebar.
- Digite na busca (código ou descrição — fornecedor ou varejo).
- Alterne Ativos ou Inativos conforme necessário.
¶ Cadastrar um novo DE-PARA
- Clique em Novo Mapeamento.
- Em Produto do Catálogo, busque por código ou descrição e selecione o item.
- Informe Cód. Produto Varejo.
- Ajuste Fator Conversão (padrão 1) e Múltiplo Venda (padrão 1).
- Escolha Tipo de Carga — Seca ou Fria.
- Informe Vendedor (obrigatório; perfil vendedor já vem preenchido).
- Clique em Criar Mapeamento.
¶ Editar um mapeamento
- Na linha desejada, clique em Editar.
- Altere código fornecedor, fator, múltiplo, carga ou vendedor.
- Confirme com o ícone de salvar.
Validações ao editar o código fornecedor:
- "Verificando no catálogo..."
- "Código válido"
- "Não encontrado no catálogo"
- "Já vinculado e ativo"
¶ Ativar ou inativar
- Clique no badge Ativo ou Inativo na linha.
- O status muda imediatamente.
Atenção: inativar equivale a remover o produto da operação nos módulos que dependem do DE-PARA.
¶ Importar planilha
- Clique em Importar Planilha.
- Baixe Baixar Modelo (
modelo_depara.xlsx). - Preencha as colunas (ver tabela de campos abaixo).
- Arraste o
.xlsxou clique para selecionar. - Clique em Enviar e Processar.
- Revise Resultado da Importação: Linhas Lidas, Criados, Atualizados, Rejeitados.
¶ Exceção de vendedor por filial (um produto)
- Na coluna Vendedor, clique em por filial ou N filial(is).
- No modal Vendedores por filial, veja o vendedor padrão e as exceções.
- Em Adicionar exceção, escolha a filial (somente ativas) e informe Cód. vendedor.
- Clique em Adicionar ou remova com o ícone de lixeira.
Requer flag Vendedor por filial ativa na Configuração de Pedido. Detalhes no manual DE-PARA Vendedor Filial.
¶ 3.5 Explicação dos campos
¶ Formulário Novo Mapeamento
| Campo | Para que serve | Obrigatório | Exemplo | Observações |
|---|---|---|---|---|
| Varejo destino | Varejo da sidebar | Sim | São Luiz | Somente leitura |
| Produto do Catálogo | Produto do seu ERP | Sim | 100234 — Refrigerante 2L |
Busca com popup |
| Cód. Produto Varejo | SKU no varejo | Sim | 456789 |
|
| Fator Conversão | Unidades varejo por 1 unidade sua | Sim | 24 |
Padrão 1 |
| Múltiplo Venda | Lote mínimo de venda | Sim | 1 |
Pedido arredonda ao múltiplo |
| Tipo de Carga | Seca ou Fria | Sim | Seca | Refrigerada via planilha |
| Vendedor | RCA responsável | Sim | 4975 |
Fixo para perfil vendedor |
¶ Colunas da tabela
| Coluna | Para que serve |
|---|---|
| Produto Fornecedor | Identificação no seu catálogo |
| Produto Varejo | SKU e descrição no varejo |
| Varejo | Nome do varejo |
| Fator | Conversão pedido |
| Múlt. | Múltiplo comercial |
| Carga | Logística (SECA / FRIA / REFRIGERADA) |
| Vendedor | Padrão + atalho para exceções por filial |
¶ Planilha de importação
| Coluna | Para que serve | Obrigatório |
|---|---|---|
| PRODUTO_VAREJO | SKU no varejo | Sim |
| DESCRICAO_PRODUTO | Descrição (referência) | Não |
| PRODUTO_FORNECEDOR | Código no seu catálogo | Sim |
| EAN | Código de barras | Não |
| EMBALAGEM | Unidade de venda | Não |
| MULTIPLO_VENDA | Múltiplo | Não |
| CONVERSAO_PEDIDO | Fator | Não |
| ID_VENDEDOR | Código RCA | Sim |
| NOME_VENDEDOR | Nome (referência) | Não |
| TIPO_CARGA | SECA / FRIA / REFRIGERADA | Não |
¶ 3.6 Regras e validações
Importante: é necessário relacionamento comercial ativo com o varejo.
Importante: Vendedor é obrigatório ao criar ou importar (exceto fluxos específicos documentados em outros manuais).
Atenção: não é possível sobrescrever um DE-PARA ativo de outro vendedor sem tratamento adequado — o sistema retorna conflito.
Atenção: usuários comuns pela planilha só criam novos registros; alterar DE-PARA ativo existente via planilha é restrito ao administrador Terus.
Dica: mantenha fator e múltiplo alinhados à embalagem real — erros afetam pedidos e devoluções.
Outras regras:
- Produto fornecedor deve existir e estar ativo no catálogo.
- Produto varejo deve existir na base do varejo (
dw.dim_produtos). - Não pode haver dois vínculos ativos do mesmo produto fornecedor para o mesmo código varejo.
- Perfil Vendedor Fornecedor: não importa planilha; edita só DE-PARAs do próprio código.
Mensagens comuns:
| Mensagem | Significado |
|---|---|
| Selecione um produto do catálogo | Falta escolher produto no popup |
| Informe o código do produto no varejo | Campo SKU vazio |
| Este produto do fornecedor já está vinculado e ativo | Duplicidade |
| Código do produto do fornecedor não encontrado no seu catálogo | SKU fornecedor inválido na edição |
¶ 3.7 Resultado esperado
- Mensagem de sucesso ao criar ou importar.
- Linha visível na tabela com badge Ativo.
- Produto passa a aparecer em alertas, pedidos e demais módulos (conforme permissões).
- Importação: cartões Criados / Atualizados > 0; rejeitados listados com Motivo.
¶ 3.8 Erros comuns e solução
| Problema | Possível causa | Como resolver |
|---|---|---|
| Tela vazia | Varejo não selecionado | Escolha o varejo na sidebar |
| Sem relacionamentos ativos | Par comercial inativo | Acione comercial / Terus |
| Produto não aparece nos alertas | DE-PARA inativo ou ausente | Ative ou crie o mapeamento |
| Planilha com muitos rejeitados | Código inexistente ou vendedor vazio | Corrija linha a linha pelo motivo |
| Não consigo importar | Perfil vendedor | Use usuário com acesso pleno |
| Conflito de vendedor | DE-PARA ativo de outro RCA | Inative o antigo ou ajuste com admin |
| Botão Vendedor por filial desabilitado | Sem varejo ou perfil restrito | Selecione varejo; use acesso pleno |
¶ 3.9 Perguntas frequentes
Posso alterar um DE-PARA depois de cadastrado?
Sim — use Editar na linha (respeitando validações de duplicidade).
O que acontece se eu inativar?
O vínculo deixa de ser usado; o produto some dos módulos operacionais.
Por que o produto do varejo não aparece na busca?
O SKU precisa existir no cadastro do varejo no Terus.
Como saber se já está mapeado?
Busque pelo código na tela ou consulte Lacunas DE-PARA para o que falta.
O cadastro vale para todas as filiais?
O vendedor padrão vale para toda a rede. Para exceções por loja, use DE-PARA Vendedor Filial.
Um vendedor pode ser diferente por filial?
Sim — via exceções (modal ou atribuição em massa), com a flag de pedido ativa.