O catálogo é a tela que o vendedor mais usa, e é onde três informações de origens diferentes se encontram: o cadastro do produto, o preço da lista e o saldo do estoque. Este artigo explica o que entra no catálogo, como preço e disponibilidade são apurados, o que acontece com o produto que ainda não tem estoque, como o depósito é escolhido e de onde vem o imposto.
Índice
O que entra no catálogo
Por padrão, apenas os tipos de produto considerados vendáveis são importados. Isso evita que matéria-prima, embalagem e itens de consumo interno apareçam para o vendedor.
O conjunto de tipos é configurável. Ampliar é possível, mas pense duas vezes: catálogo com item que não deveria ser vendido gera pedido errado, e pedido errado gera retrabalho no backoffice.
Levante com o cliente, ainda na configuração, quais tipos de produto a força de vendas pode oferecer. É mais barato acertar isso antes da primeira carga do que depurar depois por que um insumo apareceu no aplicativo.
Produto sem registro de estoque
Nem todo produto do ERP tem registro de saldo em toda filial: o registro costuma nascer no primeiro movimento de estoque. Isso não tira o produto da venda.
Produto sem registro de estoque na filial aparece no catálogo normalmente, com saldo zero e com o preço da lista. O vendedor pode incluí-lo no pedido, e o pedido é aceito pelo ERP como qualquer outro. É o fluxo natural da venda sob encomenda: vende primeiro, compra ou produz depois.
Ao gravar o pedido, o próprio Protheus cria o registro de estoque zerado do produto naquela filial. Dali em diante o fluxo é o padrão do ERP: a linha fica retida no faturamento enquanto não houver saldo e é liberada quando o estoque entra. O faturamento parcial cuida do resto: as linhas com saldo saem na nota, e as demais aguardam.
Versões da integração anteriores a agosto de 2026 ocultavam do catálogo o produto sem registro de estoque, e o sintoma confundia: parecia problema de preço, de lista ou de permissão. Se um catálogo apresentar esse comportamento, atualize a integração.
Produto ativo e inativo
O estado do produto reflete o bloqueio no cadastro do Protheus: produto bloqueado no ERP entra como inativo no Vendelo.
Existe também a possibilidade de o Vendelo gerir o status por conta própria, ignorando o ERP. Use com critério: nesse modo, bloquear um produto no Protheus deixa de tirá-lo do aplicativo, e alguém precisa lembrar de fazer isso nos dois lugares.
Preços
Os preços vêm das listas do Protheus. A lista aplicada a cada cliente segue o cadastro do ERP, e a manutenção é sempre lá.
- Alteração de preço no ERP chega pela sincronização normal.
- Produto sem preço em nenhuma lista aparece sem preço, e não impede o restante do catálogo.
- Descontos e regras comerciais do Vendelo se aplicam sobre esse preço, conforme a política configurada.
Saldo de estoque
O saldo não é replicado. Ele é consultado no ERP no momento em que a tela é aberta, o que significa que o vendedor vê o número atual, não uma cópia da última sincronização.
| Comportamento | Configurável |
|---|---|
| Exibir saldo por depósito ou totalizado | Sim |
| Bloquear a venda por falta de saldo | Sim. É possível operar ignorando o saldo, para venda sob encomenda |
A contrapartida da consulta em tempo real é a dependência: se o ERP estiver fora do ar, a tela de estoque não responde. Explique isso ao cliente antes do primeiro incidente.
Como o depósito é escolhido
Toda venda precisa sair de algum depósito, e a escolha segue uma cascata:
Uma regra específica do cliente, quando configurada. Ela pode considerar o tipo da operação, a filial, o cliente e o produto.
O depósito padrão da filial, quando definido.
O depósito padrão do produto, no cadastro do ERP.
Se nada resolver em toda a cascata, a operação é bloqueada. Isso é intencional: escolher um depósito arbitrário geraria movimento de estoque no lugar errado, o que é bem pior do que um erro visível.
Impostos
O imposto do documento é calculado pelo Protheus, com a parametrização fiscal do cliente. O Vendelo não tem motor fiscal próprio e não tenta reproduzir a regra.
O cálculo é feito sem faturar: o vendedor vê o valor final antes de fechar o pedido, e nenhum documento fiscal é gerado por causa disso.
A regra fiscal aplicada segue uma cascata parecida com a do depósito: a finalidade do item, depois a do documento, depois a regra padrão configurada. Sem nenhuma delas, vale o gatilho do próprio produto no ERP.
Divergência de imposto entre Vendelo e ERP quase nunca é problema de integração. Compare a regra fiscal aplicada: normalmente é a finalidade do item ou do documento que está diferente do esperado.
Unidades, grupos e código de barras
| Informação | Origem | Observação |
|---|---|---|
| Unidade de medida | Cadastro do ERP | Sincronizada com o catálogo |
| Grupo de itens | Cadastro do ERP | Usado na organização do catálogo |
| Código de barras | Campo padrão do produto | Pode vir de uma regra própria do cliente, quando configurada |
| Imagem | Arquivo no servidor do ERP | Importação desligada por padrão |
Sintomas e causas
| Sintoma | Causa provável |
|---|---|
| Produto não aparece no catálogo | Tipo não considerado vendável, ou produto bloqueado no cadastro do ERP |
| Produto aparece com saldo zero | Sem saldo na filial, ou sem registro de estoque nela (venda sob encomenda: o pedido é aceito normalmente) |
| Produto aparece sem preço | Sem preço em nenhuma lista aplicável |
| Produto aparece inativo | Bloqueado no cadastro do ERP |
| Saldo diferente do ERP | Depósito consultado é outro. Conferir a regra de depósito |
| Operação bloqueada por depósito | Nenhum nível da cascata resolveu |
| Linha retida por estoque no faturamento | Pedido de produto sem saldo (venda sob encomenda). A linha é liberada quando o estoque entra; as demais saem por faturamento parcial |
| Imposto diferente do esperado | Regra fiscal aplicada é outra. Conferir a finalidade do item e do documento |
| Tela de estoque não responde | ERP indisponível. O saldo é consultado em tempo real |
Perguntas frequentes
Por que um produto que existe no ERP não aparece no aplicativo?
As causas comuns são tipo de produto fora do conjunto considerado vendável e produto bloqueado no cadastro do ERP. Falta de estoque não esconde produto: sem saldo, ou mesmo sem registro de estoque na filial, ele aparece com saldo zero.
Saldo zero é diferente de não ter registro de estoque?
Para o catálogo, não: nos dois casos o produto aparece com saldo zero e pode entrar no pedido. A diferença fica no ERP, que cria o registro de estoque zerado quando o pedido referencia o produto pela primeira vez naquela filial.
O saldo que o vendedor vê é do momento?
É. O saldo é consultado no ERP quando a tela abre, e não replicado. Por isso depende do ERP estar no ar.
Posso deixar o vendedor vender sem saldo?
Pode, é configurável, e faz sentido para operações sob encomenda. Combine com o cliente, porque muda o comportamento do bloqueio na venda.
De onde vem o preço aplicado ao cliente?
Da lista de preços do Protheus associada a ele. A manutenção é no ERP; ajustar preço no Vendelo tende a ser sobrescrito.
O imposto bate exatamente com o ERP?
Bate, porque quem calcula é o próprio ERP. Se houver diferença, compare a regra fiscal aplicada em cada caso antes de suspeitar da integração.
Como sei qual depósito foi usado numa venda?
Pela cascata configurada: regra específica, depois padrão da filial, depois padrão do produto. Na homologação, confirme com uma venda real qual nível está respondendo.
Bloquear o produto no ERP tira ele do aplicativo?
Tira, no comportamento padrão. Se o status estiver sob gestão do Vendelo, não: nesse modo a mudança precisa ser feita nos dois lugares.
Próxima leitura
Vendedores, carteiras e licenças: Configure quem vende: vínculo de vendedores, carteiras de clientes e licenças de acesso na integração.
