¶ Carteiras de produtos — Fornecedor
Cadastro de grupos de SKUs do catálogo ERP do fornecedor, para atribuir a gestores e delimitar o que cada um opera no portal.
Caminho: Administração → Cadastros → Carteiras
Portal: Fornecedor
Esta tela existe só no portal do fornecedor (indústria ou distribuidor). Não confundir com a carteira do Comprador Varejo, que vem do ERP do varejo.
¶ Visão geral
Para que serve: montar recortes do sortimento (ex.: uma linha, uma categoria, uma região comercial) e entregar esse recorte a um usuário com perfil Gestor de Carteira.
Quando usar: quando a equipe do fornecedor não deve ver o catálogo inteiro — gerentes de categoria, especialistas de linha ou responsáveis por um bloco de SKUs.
Quem usa: administrador do tenant fornecedor (Master ou Admin Cliente, com permissão menu.admin.avancado.carteiras). O gestor não administra carteiras: ele recebe o escopo em Usuários.
Problema que resolve: evita misturar responsabilidades. Sem carteira, o recorte seria “todo o catálogo” ou o recorte do Vendedor (RCA) — que é outra lógica (código de vendedor + varejo/filial).
Resultado esperado: carteira ativa, com SKUs importados do ERP, atribuída a pelo menos um gestor. Aí o login desse gestor opera só aqueles produtos.
¶ Conceito em uma frase
Uma carteira é um conjunto nomeado de códigos de produto do seu ERP. Não cria pedido, não cria DE-PARA e não altera o cadastro no Winthor/outro ERP: só organiza o acesso no Terus.
Fluxo: catálogo → importar Excel na carteira → atribuir em Usuários → DE-PARA ativo → Alert, Order, Strategy.
Três peças precisam existir juntas:
- SKUs no catálogo do fornecedor (integração / cadastro de produtos).
- Carteira com esses SKUs (esta tela).
- Usuário com perfil Gestor de Carteira e a carteira marcada.
Faltar qualquer uma: a tela fica vazia, a importação não vincula, ou o gestor entra bloqueado.
¶ Carteira do fornecedor × carteira do comprador
| Esta tela (fornecedor) | Portal do varejo | |
|---|---|---|
| Quem cadastra | Admin do fornecedor | ERP do varejo (carga DE-PARA) |
| Grain | SKU do seu catálogo | Comprador + fornecedor + SKU varejo + SKU fornecedor |
| Como entra o produto | Excel VINCULAR = S (aditivo) | Integração periódica do varejo |
| Quem usa o recorte | Perfil Gestor de Carteira | Perfil Comprador Varejo |
| Onde atribui pessoa | Administração → Usuários → aba Carteira | Usuários → aba Comprador |
Manual do outro lado: Carteira de produtos — Comprador.
¶ Como acessar
- Entre no portal do fornecedor (ex.: JSB, D'Origem, JA).
- Abra Administração.
- Em CADASTROS, clique em Carteiras.
Não é necessário selecionar varejo na barra lateral: o cadastro é do tenant fornecedor, não de um varejo parceiro.
Se o item Carteiras não aparecer: o usuário não tem a permissão de menu (Admin Cliente recebe por padrão; perfis customizados precisam de menu.admin.avancado.carteiras).
Legenda: lista vazia com o botão + Nova carteira e a busca. O texto sob o título resume o fluxo: cadastrar, importar SKUs e atribuir em Usuários.
¶ Conhecendo a tela
| # | Elemento | Descrição |
|---|---|---|
| 1 | Título | Carteiras de produtos |
| 2 | Texto de apoio | Cadastre carteiras, importe SKUs do ERP via Excel e atribua aos gestores em Usuários. |
| 3 | + Nova carteira | Abre o formulário de código + nome |
| 4 | Buscar carteira... | Filtra a lista por nome ou código |
| 5 | Cards | Uma carteira por card: nome, código, quantidade de SKUs, Ativa/Inativa |
| 6 | Ícone de lápis no card | Edita nome (o código não muda depois de criado) |
| 7 | Clique no card | Abre o painel Produtos daquela carteira |
| 8 | Estado vazio | Nenhuma carteira cadastrada. |
¶ Painel de produtos (depois de clicar numa carteira)
| # | Elemento | Descrição |
|---|---|---|
| 1 | Título | Produtos — {nome} ({código}) e total de SKUs |
| 2 | Modelo Excel | Baixa o catálogo ativo para marcar o que entra |
| 3 | Importar | Envia o .xlsx preenchido |
| 4 | Busca | Código, descrição ou EAN já vinculados à carteira |
| 5 | Tabela | Código, descrição, EAN, origem (IMPORT ou MANUAL) |
| 6 | Ícone de lixeira | Remove só o vínculo com a carteira — o produto continua no catálogo |
Estado vazio do painel: Nenhum produto. Baixe o modelo Excel, marque VINCULAR=S e importe.
¶ Passo a passo
¶ 1. Criar a carteira
- Clique em + Nova carteira.
- Preencha Código (único no tenant; depois não edita) e Nome.
- Salvar.
O código é a chave estável (ex.: BEBIDAS, SECA-N, LINHA-LIMPEZA). O nome é o rótulo que o time vê em Usuários.
Se o código já existir: Já existe carteira com código '…'.
¶ 2. Importar SKUs do ERP
A importação não cria produto. Só vincula códigos que já existem no catálogo do fornecedor e estão ativos.
- Clique no card da carteira.
- Modelo Excel — arquivo
carteira_{codigo}_modelo.xlsx. - Na aba PRODUTOS, marque VINCULAR = S nas linhas desejadas (também vale
SIM,Y,1,X). - Importar e escolha o arquivo.
- Confira o resumo: quantos vinculados e quantos não encontrados.
Regras da planilha:
| Coluna | Uso |
|---|---|
| VINCULAR | Só entram linhas com S/SIM/Y/1/X. As outras são ignoradas. |
| CODIGO_PRODUTO | Código ERP do fornecedor — obrigatório e precisa existir no catálogo. |
| DESCRICAO_PRODUTO / EAN / SITUACAO | Informativos; a importação não os altera. |
A importação é aditiva: não remove SKUs já vinculados. Para tirar um item, use a lixeira na tabela.
O modelo traz até 50 mil produtos ativos do catálogo. Se o SKU não estiver na planilha, confirme se ele existe e está ativo no cadastro de produtos do fornecedor.
¶ 3. Ajustar produtos pontuais
- Busque no painel (Enter) para achar um SKU já vinculado.
- Remova com a lixeira se o item não deveria estar na carteira.
- Reimporte para incluir novos códigos — os já presentes permanecem.
¶ 4. Atribuir aos gestores
A tela de Carteiras não atribui pessoa. Isso é em Administração → Usuários:
- Abra o usuário.
- Na aba de perfis, marque Gestor de Carteira (
GESTOR_CARTEIRA). - Não marque Vendedor Fornecedor no mesmo usuário — os dois são excludentes.
- Vá à aba Carteira e selecione uma ou mais carteiras ativas.
- Salve. O sistema exige pelo menos uma carteira para esse perfil.
Se ainda não houver carteira ativa, a aba avisa: Nenhuma carteira ativa. Cadastre em Administração → Carteiras antes de vincular usuários.
Gestor sem carteira atribuída: o portal bloqueia o escopo (Perfil Gestor de Carteira sem carteiras configuradas).
¶ Gestor de Carteira × Vendedor Fornecedor
São dois recortes diferentes. Não combine no mesmo login.
| Gestor de Carteira | Vendedor Fornecedor (RCA) | |
|---|---|---|
| Recorte | Lista de SKUs (carteiras) | Código de vendedor + varejos/filiais |
| Cadastro do recorte | Esta tela + aba Carteira do usuário | Aba Vendedor do usuário + DE-PARA |
| Serve para | Gerente de linha / categoria / bloco de produtos | Representante comercial por loja/rede |
| Sem vínculo | Acesso bloqueado | Acesso bloqueado |
Master e Admin Cliente não entram nesse recorte: veem o portfólio completo.
¶ A que funcionalidades está vinculada
| Área | Papel da carteira |
|---|---|
| Catálogo do fornecedor | Fonte dos SKUs. Sem produto no catálogo, o Excel não vincula. |
| Administração → Usuários | Onde o gestor recebe a(s) carteira(s). |
| DE-PARA | Liga o SKU da carteira ao SKU do varejo. Sem DE-PARA ativo e relacionamento comercial válido, o item não aparece em Alert, pedidos, reversa etc. — a carteira sozinha não “liga” o produto no varejo. |
| Módulos operacionais | O escopo do gestor é a interseção carteira ∩ DE-PARA. Alertas, strategy e pedidos passam a considerar só esses produtos. |
| Varejo na sidebar | Continua valendo para as telas operacionais. A carteira restringe produto; o varejo restringe rede/loja. |
A carteira não substitui:
- o DE-PARA (mapeamento comercial);
- o Vendedor por filial (RCA por loja);
- a carteira do comprador no portal do varejo.
¶ Situações comuns
¶ “Nenhuma carteira cadastrada”
Ainda não existe card. Use + Nova carteira. Enquanto isso, nenhum gestor pode ser vinculado.
¶ A importação vinculou 0 e listou “não encontrados”
O CODIGO_PRODUTO da planilha não bate com o catálogo (espaço, zero à esquerda, código do varejo em vez do código do fornecedor). Use o Modelo Excel desta tela — ele já traz os códigos corretos.
¶ O SKU não aparece no modelo
Produto inexistente, inativo ou fora do limite do modelo. Regularize no cadastro/integração de produtos e baixe o modelo de novo.
¶ Importei de novo e os SKUs antigos sumiram?
Não deveriam: a carga é aditiva. Se um item sumiu, alguém removeu pela lixeira ou a carteira não é a mesma.
¶ O gestor não vê nada nos módulos
Checklist:
- Perfil Gestor de Carteira e carteira ativa na aba Carteira.
- SKUs de fato importados na carteira.
- DE-PARA ativo desses SKUs no varejo selecionado.
- Relacionamento comercial ativo com o varejo.
- Não misturar com perfil Vendedor Fornecedor.
¶ Não acho o menu Carteiras
Portal errado (varejo em vez de fornecedor) ou falta a permissão de Administração avançada. Master/Admin Cliente no tenant fornecedor devem ver o item em CADASTROS.