Itens Alternativos

Itens alternativos são produtos que podem atender o cliente quando o produto pedido não tem saldo suficiente ou quando existe uma opção equivalente. O cadastro desses vínculos é feito no ERP (SAP Business One ou TOTVS Protheus) e chega ao Vendelo pela integração. Este artigo é para vendedores, gestores e administradores: ao final da leitura, você saberá consultar os alternativos de um produto, trocar linhas de uma cotação ou de um pedido por alternativos, copiar uma cotação para pedido aproveitando os alternativos nas faltas de estoque e entender as regras que o Vendelo aplica em cada etapa.

O que são itens alternativos

Um item alternativo é um vínculo direcional entre dois produtos: o item original (o que o cliente pediu) e o item alternativo (o que pode substituí-lo). Direcional quer dizer que o vínculo vale em um sentido só. Se o ERP cadastrou que o produto A tem o produto B como alternativo, uma linha com A sugere B, mas uma linha com B não sugere A. O Vendelo não cria o vínculo inverso nem encadeia vínculos (A para B e B para C não fazem de C um alternativo de A).

Um mesmo produto pode ter vários alternativos, e um mesmo alternativo pode servir a vários produtos originais.

O Vendelo nunca substitui um produto sozinho. Ele mostra os alternativos, sugere quantidades e aplica a troca somente depois que você seleciona e confirma. Se você cancelar, o documento fica exatamente como estava.

De onde vêm os vínculos

Os vínculos são lidos do ERP integrado. Cada ERP guarda informações um pouco diferentes, e o Vendelo mostra o que o ERP fornece:

ERP	Tabela de origem	Informações trazidas para o Vendelo
SAP Business One	OALI (itens alternativos)	Item original, item alternativo, Correspondência (percentual) e Observações.
TOTVS Protheus	SGI (produtos alternativos, mantidos no cadastro de produtos)	Item original, item alternativo, Ordem de utilização, Conversão (tipo Multiplicar ou Dividir e o fator) e Observações.

Algumas regras valem para os dois ERPs:

• Manutenção somente no ERP: incluir, alterar ou excluir um vínculo é feito no ERP. No Vendelo não há tela de cadastro; os vínculos são apenas consultados e usados na venda.
• Vale para todas as filiais: o vínculo não tem filial. No Protheus, quando a tabela de alternativos é exclusiva por filial, o mesmo par de produtos aparece uma vez para cada filial e o Vendelo guarda um único vínculo. Todos os alternativos de um produto valem para qualquer filial.
• Recurso somente on-line: a consulta e a seleção de alternativos precisam de conexão com a internet. Sem conexão, o Vendelo mostra a mensagem “Itens alternativos exigem conexão com a internet”.

A Correspondência do SAP indica o quanto o alternativo corresponde ao original; ela não converte quantidades. A Conversão do Protheus é exibida como referência e não é aplicada automaticamente: quando existe conversão diferente de 1, você informa as quantidades à mão (veja A tela de seleção de alternativos).

Permissões e portfólio

O acesso aos alternativos é controlado por duas regras de permissão diferentes, uma para a consulta do cadastro e outra para o uso na venda:

Onde	Permissão que controla	Comportamento
Seção “Itens alternativos” nos detalhes do produto	Modelo de dados Item alternativo, no grupo Item (Produto ou Serviço)	Visível por padrão e sem permissão de gravação (a manutenção é do ERP). Sem visibilidade nesse modelo, a seção não aparece.
Tela de seleção de alternativos (ação da lista de itens, alerta de saldo e cópia para pedido)	Modelos Item (Produto ou Serviço) e Itens do documento	A tela abre para quem pode ver produtos; as colunas de linha, quantidade e preço seguem as permissões de itens do documento. A ação na lista exige que o documento possa ser editado.

As colunas de saldo e de preço seguem ainda as permissões dos campos de estoque disponível e preço unitário do produto. Quem não enxerga esses campos no produto também não os vê nas telas de alternativos.

Os dois produtos precisam estar no portfólio do usuário. Quando o usuário tem portfólio por grupo de itens, um vínculo só aparece se o item original e o item alternativo estiverem, ambos, no portfólio dele. Basta um dos dois ficar de fora para o vínculo não aparecer, porque não faria sentido oferecer um alternativo que o usuário não pode vender. Usuários sem portfólio por grupo de itens veem todos os vínculos.

Consulta nos detalhes do produto

Ao abrir os detalhes de um produto (por exemplo, pela lista Produtos & Serviços, na seção Itens do menu), o Vendelo mostra a seção expansível Itens alternativos logo abaixo das informações do produto. No computador ela já vem aberta; no celular vem recolhida, basta tocar no título para abrir.

A seção lista apenas os alternativos do produto aberto (sentido original para alternativo) e só exibe produtos ativos e visíveis para o seu perfil. Não há botões de incluir, alterar ou excluir: a manutenção é do ERP.

Coluna	O que mostra
(ícone de abrir)	Abre os detalhes do produto alternativo (dica “Detalhes”). No celular, o card inteiro abre os detalhes.
SKU	Código do produto alternativo no ERP.
Item alternativo	Nome do produto alternativo.
Unidade de medida	Unidade do alternativo.
Estoque disponivel	Saldo disponível do alternativo.
Preço unitário	Preço do alternativo, com a moeda.
Correspondência (%)	Fator de correspondência (SAP Business One).
Ordem	Ordem de utilização (TOTVS Protheus).
Conversão	Tipo e fator de conversão, como “Multiplicar 2” (TOTVS Protheus).
Observações	Observações do vínculo no ERP.

O saldo e o preço exibidos dependem do contexto. Se você abriu o produto a partir de um documento em edição, eles seguem o documento (cliente, filial, lista de preço, condição de pagamento e moeda). Sem documento aberto, valem os parâmetros padrão da consulta de produtos.

A seção também informa quando não há o que mostrar: “Nenhum item alternativo cadastrado” (nenhum vínculo para exibir), “Itens alternativos exigem conexão com a internet” (sem conexão) ou “Erro ao consultar itens alternativos” (falha na consulta).

Na cotação e no pedido

Em cotações de venda e pedidos de venda há dois caminhos para chegar aos alternativos: a ação na lista de itens, quando você mesmo quer revisar as trocas, e o alerta de saldo insuficiente, que aparece ao confirmar uma quantidade maior do que o saldo.

Ação “Itens alternativos” na lista de itens

Na barra de ações da lista de itens do documento há o ícone de troca com a dica Itens alternativos. Ele aparece quando o documento é uma cotação ou um pedido de venda, pode ser editado, não está em processamento e já tem pelo menos uma linha.

1. Abra a cotação ou o pedido em modo de edição e vá para a lista de itens.

2. Clique em Itens alternativos. O Vendelo reúne todas as linhas editáveis cujo produto tem pelo menos um alternativo elegível, com ou sem saldo suficiente. Linhas de kit e seus componentes ficam de fora.

3. Revise as sugestões na tela de seleção: marque os alternativos, ajuste as quantidades e, se quiser, ligue o filtro “Somente linhas sem saldo” para ver apenas as linhas que o estoque não atende.

4. Confirme. O Vendelo aplica todas as escolhas de uma vez, mostra “Alternativos aplicados” e recalcula os totais do documento.

5. Salve o documento. As trocas ficam no documento em edição; elas só são gravadas quando você salva a cotação ou o pedido.

Pela ação da lista, o limite de troca de cada linha é a quantidade da própria linha, mesmo que o produto original tenha saldo. As regras atuais de venda sem estoque continuam valendo: a tela não impede escolher mais do que o saldo do alternativo, mas a coluna “Saldo restante” fica em vermelho quando a escolha passa do disponível.

Alerta de saldo insuficiente

Ao confirmar a inclusão de um item ou a alteração de quantidade na tela da linha (botão Confirmar e fechar ou Salvar), o Vendelo compara a quantidade com o saldo disponível do produto, descontando o que as outras linhas do mesmo produto já usam no documento (a linha que você está editando não é contada duas vezes). Se o saldo não atende, aparece o aviso:

Saldo insuficiente (disponível: X, necessário: Y). Deseja ver itens alternativos?

• Não: a linha é gravada no documento como você digitou, sem nenhuma troca.
• Sim: abre a tela de seleção só com essa linha. As escolhas confirmadas são aplicadas assim que a linha volta para a lista do documento.

O alerta vale sempre para cotações e pedidos de venda, sem parâmetro de empresa para ligar ou desligar. Ele não se repete para a mesma linha com a mesma quantidade, não aparece para kits e, sem conexão, é substituído pela mensagem “Itens alternativos exigem conexão com a internet”.

O aviso considera apenas o saldo; os vínculos são consultados quando você responde Sim. Se o produto não tiver alternativos elegíveis, a tela de seleção abre sem linhas para escolher. Nesse caso, basta cancelar.

Copiar cotação para pedido com sugestão de alternativos

Na cotação de venda salva e sem alterações pendentes, com status “Aberto” ou “Em preparação”, o botão Copiar para PV abre a pergunta “O que deseja fazer?” com três opções:

Opção	O que faz
Copiar todos os itens?	Leva todas as quantidades em aberto para o pedido, sem olhar o estoque.
Copiar apenas itens com estoque disponivel?	Leva só o que o saldo atende, limitando cada linha ao saldo disponível e descontando o saldo já usado por outras linhas do mesmo produto.
Copiar itens com saldo em estoque e sugerir alternativos	Faz o mesmo que a opção anterior e, para o que faltar, abre a tela de alternativos para você completar o pedido com outros produtos.

Como funciona a terceira opção:

1. Alocação do saldo dos originais: o Vendelo considera as quantidades em aberto da cotação, consulta os saldos no contexto do documento e distribui o saldo de cada produto na ordem das linhas.

2. Cálculo das faltas: cada linha fica com a quantidade atendida pelo próprio produto e a quantidade faltante, mesmo quando o produto não tem saldo algum.

3. Tela de alternativos: se alguma linha tem falta, abre a tela de seleção somente com essas linhas. Ela abre mesmo que nenhuma falta tenha alternativo, mostrando “Sem alternativos cadastrados para este item” na linha. Se nenhuma linha tem falta, a cópia segue direto.

4. Revisão: escolha os alternativos e as quantidades. Aqui a quantidade de cada alternativo nunca passa do saldo disponível dele, e a soma das escolhas de uma linha nunca passa da falta daquela linha. Confirmar sem escolher nada copia apenas o saldo dos originais.

5. Pedido montado: o novo pedido de venda abre para revisão com as quantidades atendidas dos originais e, logo depois de cada original, as linhas dos alternativos escolhidos.

O que não foi atendido nem pelo original nem por alternativos não é copiado. O Vendelo avisa com a mensagem “Quantidades sem atendimento (não copiadas)”, seguida do SKU e da quantidade de cada linha. Se, no fim, não sobrar nenhuma quantidade para copiar, aparece “Nenhuma quantidade a copiar” e nenhum pedido vazio é aberto.

Cancelar a tela de alternativos cancela esta tentativa de cópia inteira; a cotação não é alterada. E, como na cópia por estoque, se houver qualquer kit entre os itens a terceira opção não prossegue e mostra o aviso “Não é possível verificar apenas itens com estoque disponível quando há kits/combos/estruturas entre os itens”.

A tela de seleção de alternativos

A mesma tela, com o título Itens alternativos, é usada nos três caminhos: ação da lista, alerta de saldo e cópia para pedido. Cada linha da tela representa uma relação entre uma linha do documento e um candidato. Um produto original com três alternativos aparece em três linhas; duas linhas do documento com o mesmo produto aparecem separadas, cada uma com os seus candidatos.

Colunas

No computador as três primeiras colunas ficam fixas ao rolar para o lado.

Os candidatos de cada linha vêm ordenados pela Ordem (crescente) quando o ERP a informa, depois pela Correspondência (maior primeiro) e, por fim, pelo código.

No alto da tela, um resumo mostra quantos candidatos estão marcados (“Selecionado”) e, na cópia para pedido, quantas linhas ainda têm falta (“Quantidades sem atendimento (não copiadas)”).

No celular a tela vira uma lista de cards. Cada card mostra “Original” e “Substituto” no topo, os campos “Qtd. do alternativo” e “Qtd. original substituída”, a caixa “Selecionado” e, abaixo, as mesmas informações das colunas.

Filtros

Na barra de ações da tela há dois filtros que ligam e desligam com um clique:

• Somente com estoque: esconde os candidatos que já não têm saldo restante, a não ser que já estejam marcados.
• Somente linhas sem saldo: mostra apenas as linhas originais que têm quantidade faltante.

Quantidades e divisão entre vários alternativos

Ao marcar um candidato com a mesma unidade do original (e sem conversão diferente de 1), o Vendelo sugere como quantidade o que ainda falta substituir naquela linha; na cópia para pedido, a sugestão também respeita o saldo restante do candidato. Nesse caso a “Qtd. original substituída” acompanha a “Qtd. do alternativo” automaticamente.

Quando a unidade é diferente ou existe conversão diferente de 1, o Vendelo não deduz equivalência: as duas quantidades começam em zero e você informa quanto do alternativo vai usar e quanto da linha original ele substitui.

Você pode dividir a quantidade de uma linha entre vários alternativos, cada um com a sua quantidade. Os limites são:

Regra	Ação da lista e alerta de saldo	Cópia para pedido
Soma substituída por linha original	Até a quantidade da linha	Até a quantidade faltante
Quantidade de cada alternativo	Sem limite de saldo (valem as regras de venda sem estoque)	Até o saldo restante do alternativo

O saldo de cada produto é controlado em conjunto em todas as escolhas da tela, inclusive quando o mesmo produto é original em outra linha. Assim o mesmo saldo não é oferecido duas vezes. Isso é só um controle da tela: nenhum estoque é reservado.

Confirmação e o que muda no documento

Ao clicar em Confirmar e fechar, o Vendelo valida as escolhas e consulta novamente saldos e elegibilidade no servidor. Se algo mudou, os candidatos que deixaram de ser elegíveis são desmarcados, aparece “Saldo ou elegibilidade mudou, revise a seleção” e você continua na tela para revisar. Cancelar fecha a tela sem mudar nada.

Outras mensagens de validação que podem aparecer:

• “Informe a quantidade do alternativo e a quantidade original substituída”: um candidato marcado está com quantidade zerada.
• “Quantidade substituída excede o limite da linha original”: a soma das escolhas passou do limite da linha.
• “Quantidade do alternativo excede o saldo disponível”: na cópia para pedido, a escolha passou do saldo.

Com a confirmação, as escolhas são aplicadas em lote:

• Linha nova logo após a original: cada alternativo vira uma linha comum do produto escolhido, inserida logo depois da linha original. As linhas do documento são renumeradas.
• Mesmo alternativo para várias linhas: vira uma única linha com a soma das quantidades, posicionada depois da primeira linha original, desde que as linhas originais tenham a mesma finalidade e a mesma data de entrega. Se forem diferentes, cada uma gera a sua linha.
• Preço recalculado: a linha nova usa o preço e o desconto do alternativo pela política comercial do documento (cliente, filial, lista de preço, condição de pagamento e moeda). Nenhum ajuste comercial feito na linha original é transportado. Descontos, totais e tributos do documento são recalculados.
• O que a linha nova herda: apenas a finalidade e a data de entrega da linha original.
• Substituição parcial (ação da lista e alerta): a linha original continua com a quantidade que sobrou. Se ela tinha programação de entrega, a programação é descartada e deve ser refeita sobre a nova quantidade.
• Substituição total (ação da lista e alerta): quando a quantidade substituída cobre toda a linha, a linha original é removida do documento.

A linha do alternativo não guarda nenhuma referência ao produto original, nem no Vendelo nem no ERP. Para o ERP, ela é uma linha comum do produto escolhido.

Restrições

• Kits: linhas de kit e seus componentes não entram na ação da lista nem no alerta de saldo; kits nunca aparecem como candidatos; e qualquer kit no documento bloqueia a terceira opção da cópia para pedido.
• Candidatos inelegíveis: não aparecem como candidatos os produtos inativos, os que não estão visíveis para o seu perfil ou fora do seu portfólio e os que não têm preço na política comercial do documento.
• Sem conexão: nenhuma das telas de alternativos funciona off-line. A seção dos detalhes, a ação da lista, o alerta e a cópia mostram “Itens alternativos exigem conexão com a internet”.
• Documentos: a ação e o alerta existem apenas em cotações e pedidos de venda.

Sincronização e carga inicial

Os vínculos chegam ao Vendelo pela fila de integração, no mesmo ciclo em que a integração processa os produtos, logo depois deles. Inclusões, alterações e exclusões feitas no ERP são refletidas no Vendelo: um vínculo que deixa de existir no ERP é removido também no Vendelo. Se a leitura no ERP falhar, nada é apagado e a linha da fila fica com erro para nova tentativa.

Para o vínculo ser importado, os dois produtos precisam existir no Vendelo. Se um deles não foi importado, a fila de integração registra o erro “O item ‘código‘ não está no Vendelo: o vínculo de item alternativo não foi importado”.

As alterações só chegam sozinhas se os gatilhos da integração instalados no ERP incluírem a tabela de alternativos (OALI no SAP Business One, SGI no TOTVS Protheus). Confirme com a equipe de implantação se o seu ambiente já foi atualizado.

Carga inicial

Não existe varredura periódica dos vínculos. Para alinhar tudo de uma vez (na implantação do recurso, por exemplo), use a carga de dados do ERP da fila de integração (Carregar dados do ERP) e selecione o grupo Itens alternativos, descrito como “Vínculos de itens alternativos, reconciliados depois dos produtos”, na categoria Produtos e preços. Os vínculos são enfileirados depois dos produtos.

Somente o usuário master da empresa pode criar uma carga inicial. Como a carga pode pesar no Vendelo e no ERP, programe a execução para fora do horário de uso.

Resumo dos campos

Campo	SAP Business One	TOTVS Protheus	Uso no Vendelo
Item original	Sim	Sim	Produto que recebe a sugestão.
Item alternativo	Sim	Sim	Produto sugerido.
Correspondência (%)	Sim	–	Informação e ordenação dos candidatos.
Ordem	–	Sim	Informação e ordenação dos candidatos.
Conversão	–	Sim	Referência; exige quantidades informadas à mão quando diferente de 1.
Observações	Sim	Sim	Informação.

Perguntas frequentes

Posso cadastrar um item alternativo pelo Vendelo?

Não. Os vínculos são mantidos somente no ERP (tabela OALI no SAP Business One, tabela SGI no TOTVS Protheus). O Vendelo apenas consulta e usa os vínculos na venda.

Cadastrei B como alternativo de A. Por que a linha com B não sugere A?

Porque o vínculo é direcional: vale do original para o alternativo. Para B sugerir A, o ERP precisa ter o vínculo nesse sentido também.

O Vendelo troca o produto sozinho quando falta estoque?

Não. Ele avisa e sugere, mas a troca só acontece depois que você marca os alternativos e confirma. Respondendo Não ao aviso, a linha fica como você digitou.

Por que um alternativo cadastrado no ERP não aparece para mim?

As causas mais comuns são: um dos dois produtos está fora do seu portfólio; o alternativo está inativo, não está visível para o seu perfil ou não tem preço na política comercial do documento; o alternativo é um kit; ou o vínculo ainda não chegou pela integração (confira a fila de integração).

Posso dividir a falta de uma linha entre dois ou mais alternativos?

Sim. Marque os candidatos e informe a quantidade de cada um. A soma substituída não pode passar da quantidade da linha (ação da lista e alerta) ou da falta (cópia para pedido).

O preço do alternativo segue o preço negociado no item original?

Não. A linha do alternativo recebe o próprio preço e as próprias regras pela política comercial do documento. Descontos, totais e tributos são recalculados.

Os alternativos valem para qualquer filial?

Sim. O vínculo não tem filial. O que muda de acordo com o documento é o saldo e o preço exibidos, que seguem o contexto do documento.

Funciona sem internet?

Não. É um recurso somente on-line. Sem conexão, o Vendelo mostra “Itens alternativos exigem conexão com a internet”.

Por que a terceira opção de cópia não prossegue na minha cotação?

Porque há kits entre os itens. Assim como na cópia apenas de itens com estoque, a verificação de saldo não é feita quando há kits, combos ou estruturas no documento.

O que acontece com a quantidade que nem o original nem os alternativos atendem na cópia?

Ela não é copiada para o pedido. O Vendelo lista essas quantidades na mensagem “Quantidades sem atendimento (não copiadas)” para você decidir o que fazer.

A troca fica registrada no ERP como substituição?

Não. A linha do alternativo é uma linha comum do produto escolhido, sem referência ao produto original no Vendelo nem no ERP.

Alterei um vínculo no ERP. Quando ele aparece no Vendelo?

Quando a integração processar o evento, no mesmo ciclo dos produtos. Se o vínculo não chegar, verifique a fila de integração; para alinhar todos os vínculos de uma vez, o usuário master pode criar uma carga inicial do grupo Itens alternativos.

Próxima leitura

Avaliações de Produtos e Serviços: deixe os clientes avaliarem produtos e serviços e acompanhe as avaliações em um relatório gerencial.