Use esta página quando alguém relatar que o menu lateral está incompleto no portal de um fornecedor (D'Origem, JA, Opção, Brava, etc.).
Importante: o menu do fornecedor nunca será igual ao menu do varejo. Mesmo com usuário Master, várias telas existem somente no portal do varejo (São Luiz como tenant varejo, Pinheiro, etc.).
| Pergunta | Resposta |
|---|---|
Master tem restrição de permissão menu.*? |
Não — Master (e Admin) enxergam todos os itens permitidos no portal fornecedor. |
| Master enxerga o menu completo do varejo? | Não — o tipo de tenant (DISTRIBUIDOR / INDUSTRIA) define o portal fornecedor. |
| Master precisa selecionar varejo? | Sim — a maior parte dos módulos operacionais exige varejo ativo na barra lateral. |
| Master enxerga Terus Unitization sem configuração? | Não — o módulo só aparece se usa_unitizacao ou usa_api_logistica estiver ativo no par fornecedor × varejo. |
Caso D'Origem × São Luiz com Master: se Terus Strategy → Vendas mostra apenas Vendas Varejo, isso é o comportamento esperado no portal do fornecedor. Itens como Faturamento por Filial, Vendas YoY e Hierarquia de Produtos são exclusivos do portal do varejo.
Marque cada item ao investigar um chamado.
| # | Verificação | Como conferir | Se falhar |
|---|---|---|---|
| ☐ | Acesso é pelo subdomínio do fornecedor | URL: https://{slug-fornecedor}.portal.terus.tec.br |
Menu será de fornecedor, não de varejo |
| ☐ | Tenant é DISTRIBUIDOR ou INDUSTRIA |
/api/auth/me → tipo_cliente |
Tenants VAREJO usam outro menu |
| ☐ | Não é caso de comparar com portal do varejo | Abrir São Luiz como tenant varejo em outra aba | Expectativa incorreta — ver tabela abaixo |
| # | Verificação | Como conferir | Se falhar |
|---|---|---|---|
| ☐ | Dropdown Varejo preenchido | Barra lateral superior | Selecionar varejo parceiro |
| ☐ | Relacionamento comercial ativo | /api/auth/me → varejos_autorizados não vazio |
Cadastrar/reativar relacionamento |
| ☐ | Varejo persistido no navegador | DevTools → Application → terus_varejo |
Selecionar novamente e recarregar |
| ☐ | Escopo de vendedor não bloqueado | /api/auth/me → escopo_vendedor.bloqueado = false |
Vincular código RCA e varejos (perfil Vendedor) |
Itens que ficam ocultos sem varejo ativo (mesmo para Master):
Itens visíveis sem varejo (Master e demais perfis com permissão):
| # | Verificação | Como conferir | Se falhar |
|---|---|---|---|
| ☐ | Usuário é Master (username=master) ou Admin |
/api/auth/me → is_master / perfil admin |
Seguir seção de permissões |
| ☐ | Possui permissões menu.* explícitas ou legado |
/api/auth/me → permissoes |
Usuários com menu.* parcial não recebem pacote aberto |
| ☐ | Perfil Vendedor Fornecedor com varejos autorizados | escopo_vendedor.id_tenants_varejo |
Restringir ou ampliar escopo RCA |
Master e Admin ignoram esta seção — todas as permissões
menu.*são concedidas automaticamente.
| # | Verificação | Como conferir | Se falhar |
|---|---|---|---|
| ☐ | Par fornecedor × varejo usa unitização | GET /api/fornecedor/varejo/{id_varejo}/pedidos/config → usa_unitizacao ou usa_api_logistica |
Módulo Terus Unitization inteiro fica oculto |
| ☐ | Configuração em Administração → Config. Pedidos | Menu Administração → Avançado | Ativar unitização para o par |
Aplica-se a todos os usuários, inclusive Master.
| Item | Condição |
|---|---|
| E-commerce (Integrações) | Somente Master |
| Bloco MASTER (BETA) → Importar pedido PDF | Master (duplicata de atalho beta) |
Use como checklist positivo: expanda cada módulo e confira se os itens abaixo aparecem.
| Item | Requer varejo? |
|---|---|
| AlertBoard | Sim |
| Comportamento | Sim |
| Grupo / item | Requer varejo? |
|---|---|
| Pedido Venda | Sim |
| Sugestão de Pedido | Sim |
| Importar pedido PDF | Não |
| Negociação de Margem | Sim |
| E-commerce (Integrações) | Sim — somente Master |
| Performance no Varejo | Sim |
| Ruptura & Atendimento | Sim |
| Relatório Sell-Out | Sim |
| Relatório Sell-In | Sim |
| Reversa → Devolução Excesso, Programação Devolução | Sim |
| Cadastro Comercial → Relacionamento de Varejo, Meu Catálogo, Indústrias | Não |
| DE-PARA → DE-PARA, Lacunas, DE-PARA do Varejo, DE-PARA por EAN, DE-PARA Vendedor Filial | Parcial* |
* Lacunas, EAN e Vendedor Filial exigem varejo ativo.
| Item | Requer varejo? |
|---|---|
| Rastreio | Sim |
| Comparativo Picking | Sim |
| Imprimir Etiqueta | Não |
| Configurações → Parâmetros do Armazém, Impressoras | Parcial |
| Item | Portal |
|---|---|
| Atividades Task | Fornecedor |
| Efetividade Operacional | Fornecedor |
| Relatório Operador | Fornecedor |
| Prevenção de Perdas | Fornecedor |
| Grupo | Itens no fornecedor | Itens só no varejo |
|---|---|---|
| Metas | — | Desempenho de Metas, Cadastro de Metas |
| Vendas | Vendas Varejo (1 item) | Faturamento por Filial, Vendas YoY, Hierarquia de Produtos |
| Compras | — | Entradas |
| Estoques | Estoque Varejo, Ranking de Estoque | Divergência Inventário vs ERP, Ruptura (visão varejo) |
| Comportamento | — | Comportamento de Produtos (visão varejo) |
Este é o ponto central do caso D'Origem: Strategy no fornecedor não lista dezenas de telas — isso é arquitetura do produto, não falta de permissão.
| Grupo | Itens no fornecedor |
|---|---|
| Cadastros | Empresas, Usuários, Entidades |
| Configurações | Parâmetros, Integrações |
| Avançado | Completude captura, Config. Pedidos |
| Item |
|---|
| Importar pedido PDF (beta) |
Estes módulos/intens são exclusivos do portal varejo:
| Módulo / tela | Motivo |
|---|---|
| Terus Production (cozinha, ordens, KDS…) | portals: ["varejo"] |
| Terus Chain (score, saúde integração…) | portals: ["varejo"] |
| Painel Comprador, Carteira, Lacunas sortimento | Escopo comprador varejo — manual |
| AlertBoard / Atividades / Briefing / CheckMe (visão loja) | Rotas do tenant varejo |
| Metas, Compras, Comportamento (Strategy) | Grupos só varejo |
| Administração → Compradores, Turnos, Fornecedores (gestão rede) | Cadastros da rede varejo |
Com sessão autenticada no portal do fornecedor:
GET /api/auth/me
Campos relevantes:
| Campo | O que indica |
|---|---|
is_master |
true → sem bloqueio de permissão |
tipo_cliente |
DISTRIBUIDOR / INDUSTRIA = portal fornecedor |
varejos_autorizados |
Varejos disponíveis no dropdown |
escopo_vendedor |
Bloqueio ou lista de varejos (perfil RCA) |
permissoes |
Lista efetiva (Master ignora na prática) |
modulos_ativos |
Módulos do tenant (pouco impacto no menu fornecedor) |
Unitização do par ativo:
GET /api/fornecedor/varejo/{id_tenant_varejo}/pedidos/config
Não há regra especial por CNPJ ou slug. Todos os fornecedores usam a mesma árvore de menu:
| Fornecedor (exemplo) | Slug | id_tenant (ref.) |
|---|---|---|
| D'Origem Distribuidora | dorigem |
10 |
| JA | ja |
8 |
| Opção | opcao |
9 |
| Brava | brava |
21 |
Ambiente de referência para testes e manuais: D'Origem (10) × São Luiz (12).
Abra ticket técnico apenas se todas as condições abaixo forem verdadeiras:
varejos_autorizadosusa_unitizacao ou usa_api_logistica = true e módulo ainda ausenteAnexe: slug do fornecedor, varejo selecionado, print do menu expandido e JSON resumido de /api/auth/me.
Consulte também a tabela de perfis e módulos para validar expectativa por perfil.