Dados e sincronização — solução de problemas#
Produto que não aparece no PDV, preço divergente entre a retaguarda e o caixa, venda que não sobe, estoque errado e carga que não atualiza. Para o gestor, o estoquista e o suporte de primeiro nível.
Antes de começar — a pergunta que resolve a maior parte dos casos desta página: o preço ou o produto foi enviado pela Carga PDV? O caixa não lê a retaguarda. Ele trabalha com o pacote que recebeu. Enquanto o envio não acontece, o terminal continua com o dado antigo — e isso não é defeito, é o desenho.
Passo a passo#
- Identifique o seu sintoma na tabela abaixo.
- Antes de qualquer outra coisa, confirme o estado da Carga PDV para a loja.
- Execute a ação segura.
- Se o sintoma for de estoque, confirme primeiro qual local você está olhando: o saldo da loja é a soma dos locais.
- Se precisar escalar, use Como abrir um chamado.
Sintomas e ações#
O produto não aparece no PDV#
O caminho mais direto é a fila de decisão do cadastro de produtos. Ela separa os produtos em fila e diz o motivo e o que fazer.
- Abra Operação e PDV > Produtos.
- Olhe os chips da fila de decisão: Prontos, Cadastro, Fiscal, Operação, Liberar venda, Vínculo, Unidade e Fora do PDV.
- Clique no chip correspondente ao seu caso e leia o motivo do produto.
| O que você vê | Causa provável | O que fazer |
|---|---|---|
| O produto está em Fora do PDV com o motivo produto inativo | "Produto inativo. Mantém histórico, mas não compra nem vende no PDV." | Reative o produto. |
| O produto está em Fora do PDV com o motivo venda bloqueada | "Venda bloqueada. Produto fica na retaguarda e não desce ao caixa." | Desbloqueie a venda, se for o caso. |
| O produto está em Fora do PDV por finalidade | "Fora do PDV = itens que não vendem no caixa (uso/consumo, insumo, embalagem, ativo)." | Se ele deve vender, mude a Finalidade na aba Dados. |
| O produto está em Fora do PDV e fora de linha e sem estoque | "Fora de linha e sem estoque. Não comprar novamente e não enviar ao PDV." | Decida: dar baixa definitiva ou repor. |
| O produto está na fila Fiscal, aguardando revisão do NCM | "Aguardando revisão fiscal do NCM. O responsável fiscal deve conferir a tributação e usar Resolver por NCM antes de liberar para o PDV." | Encaminhe ao responsável fiscal. Isso costuma acontecer com produto que entrou pela Entrada de NF-e. |
| O produto está na fila Liberar venda | "O fiscal já foi resolvido; falta liberar para venda. Enquanto isso o produto continua inativo e o caixa não o vende." | Use Liberar venda — exige o direito de gerenciar produto. |
| O produto está Prontos mas com o sinal Aguardando Carga PDV | O cadastro está ok e falta enviar | Publique a Carga PDV para a loja. |
| O produto está Prontos, a carga foi enviada, e ele não aparece no caixa | O terminal ainda não baixou o pacote, ou o produto não tem preço para aquela loja | Confira o estado do caixa em Checkout — caixas (pode estar carga atrasada) e confirme o preço do produto para a loja. |
| O produto existe em outra loja e não nesta | Catálogo e preço são por loja | Confirme que o produto está disponível para a loja certa. |
| O produto tem estoque zero e não aparece | Alguns fluxos escondem item sem saldo | Confirme o saldo no local correto. |
O preço diverge entre a retaguarda e o caixa#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Mudei o preço na retaguarda e o caixa continua cobrando o antigo | A Carga PDV não foi enviada depois da mudança | Abra Carga PDV, escolha a loja, veja Preços pendentes e envie a carga. "Só então o caixa passa a cobrar o preço novo." |
| Enviei a carga e o caixa continua com o preço antigo | O terminal está como carga atrasada e ainda não baixou o pacote | Ele baixa na próxima conexão. Confirme a conexão do terminal em Checkout — caixas. |
| A prateleira mostra um preço e o caixa cobra outro | As etiquetas da gôndola não foram trocadas junto com o envio | A confirmação de conferência existe exatamente para isso. Imprima as etiquetas, troque na gôndola e só então envie. |
| O preço no caixa está diferente do que eu cadastrei na ficha do produto | O preço pode vir da Precificação, não da ficha | Confira Operação e PDV > Precificação. |
| Uma loja cobra um preço e a outra, outro | Preço é por loja | Confirme o preço da loja específica. Preço diferente por loja é esperado em rede. |
| Uma loja nova nasceu com preço e eu não queria | Na criação foi escolhido Espelhar preços de | O espelhamento só é escolhido na criação. Ajuste os preços da loja nova. |
| Uma loja nova nasceu sem preço em produto algum | Na criação, Espelhar preços de ficou como "Nenhuma" | Cadastre os preços, ou crie outra loja espelhando. |
| O produto tem promoção ativa e o caixa não aplica | A promoção também precisa ir na carga | Publique a carga e confira o período da promoção. |
A venda não sobe para a retaguarda#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| As vendas do dia não aparecem na retaguarda | A fila de sincronização do terminal ainda não subiu | Verifique a conexão do terminal com a retaguarda. O caixa continua vendendo; a venda espera na fila. |
| A venda está pendente e a retaguarda rejeitou a sincronização | A retaguarda recusou aquele envio | A venda continua pendente e não é descartada. Corrija a causa apontada na mensagem: a fila reenvia. |
| Mensagem sobre produto não encontrado | "Atualize a carga/catalogo do PDV ou confira se o produto foi cadastrado na retaguarda antes de repetir a operacao." | Cadastre o produto e publique a carga. |
| Mensagem sobre venda sem itens | "A venda foi recusada porque nao possui itens. Cancele o cupom vazio no PDV ou refaca a venda com os produtos corretos." | Trate no PDV. |
| Mensagem sobre pagamento inconsistente | "A venda so pode sincronizar quando o total pago cobre o total do cupom." | Confira a forma de pagamento no cupom. |
| Mensagem sobre UUID local ou lote incompleto | Falha de identificação do envio | Mantenha o caixa vendendo e escale com a mensagem exata. |
| Mensagem sobre contexto de loja divergente | "O servidor protegeu a empresa contra envio no contexto errado." | Escale: reativar o caixa com o código correto é ato de quem administra os terminais. |
| O caixa está sem sinal | Aplicativo fechado ou máquina sem rede | Abra o 3A PDV e confirme a conexão. |
| A retaguarda não mostra a venda mesmo com o caixa comunicando | Pode haver fila grande ou a venda específica pendente | Confira se a venda aparece como pendente no terminal. Se o volume for grande, escale. |
O estoque está errado#
Antes de concluir que o estoque está errado, confirme qual local você está olhando.
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O saldo da loja não bate, mas cada local bate | O saldo da loja é a soma dos locais | Some os locais antes de concluir que há erro. |
| O saldo do Depósito está certo e o da Gôndola, não | Cada local tem o próprio saldo | Olhe o local certo. |
| O estoque caiu sem venda | Pode ter havido perda por validade, perda de balcão, transferência, reposição entre locais ou produção | Verifique os movimentos do período nas telas correspondentes. |
| O estoque subiu sem compra | Pode ter havido inventário processado com sobra, transferência recebida ou produção | Idem. |
| O estoque está errado depois de uma contagem rápida | A Contagem do inventário (contagem rápida) registra a divergência e não aplica ajuste no saldo | Se o objetivo é corrigir o estoque, use a sessão de Inventário e Processar. Ver Fechamento do mês. |
| A entrada de NF-e lançou quantidade diferente da física | Pode haver conferência física em 2 passos ligada, e a conferência ainda não foi feita | Verifique o parâmetro de conferência em 2 passos e conclua a conferência. |
| O conferente repetiu a quantidade da nota | A conferência cega pode estar desligada, ou ele viu o esperado antes de contar | Confira o parâmetro de conferência cega. Ele existe para "evitar que o conferente repita a quantidade da nota sem contar". |
| O saldo mudou depois de uma venda que estava pendente | A venda sincronizou e baixou o estoque | O estoque é baixado na retaguarda quando a venda sincronizada é recebida. Vendas na fila ainda não baixaram. |
| O inventário ajustou o saldo de um item que eu não contei | O processamento ajusta apenas os itens contados | Se isso aconteceu, é defeito: escale com o período e o item. |
| O furo do inventário parece alto demais | Vendas ocorridas entre a abertura e o processamento | O furo desconta as vendas do intervalo. Confira-as antes de tratar como perda. |
A carga não atualiza#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| A tela Carga PDV continua mostrando Preços pendentes | A carga foi preparada e não enviada, ou o envio foi recusado | Confirme o envio. A tela mostra "pronta para revisar" ou "tudo enviado". |
| O envio é recusado | A confirmação de conferência das etiquetas e dos preços da gôndola está desmarcada | Marque a confirmação. A mensagem é "Confirme que as etiquetas e os preços da gôndola foram conferidos antes de enviar a Carga PDV". |
| "seu usuário não possui uma loja disponível para receber a Carga PDV" | O seu usuário não tem loja vinculada | Peça a quem administra usuários o vínculo com a loja. |
| "selecione a loja que receberá esta Carga PDV" | A loja não foi escolhida | Escolha a loja antes de enviar. |
| Enviei e o caixa não atualizou | O terminal não baixou o pacote ainda | Confirme o estado do terminal: carga atrasada significa que ele vai baixar na próxima conexão. |
| Um caixa atualizou e o outro não | Cada terminal baixa por conta própria | Confirme o estado de cada terminal em Checkout — caixas. |
| "Tudo em dia" mas o caixa está com preço velho | O indicador se refere aos preços pendentes de envio, não ao que cada terminal já baixou | Confira o estado do terminal, não só a tela de carga. |
Campos e o que significam#
| Campo | O que é | Observação |
|---|---|---|
| Preços pendentes | quantos preços alterados ainda não foram enviados aos caixas | "vão na próxima Carga PDV". |
| Carga PDV (indicador) | o estado do envio | "pronta para revisar" ou "tudo enviado". |
| Fora do PDV | produtos que não vendem no caixa | Uso/consumo, insumo, embalagem, ativo — ou inativo, ou com venda bloqueada. |
| Aguardando Carga PDV | sinal de produto pronto que ainda não foi enviado | O caso mais comum de "produto não aparece no caixa". |
| Finalidade | para que o produto serve | Mude para venda se ele deve vender. |
| Local (de estoque) | onde o saldo vive | O saldo da loja é a soma dos locais. |
| Espelhar preços de (só na criação) | a loja de origem dos preços de uma loja nova | Só existe na criação. Vazio = nasce sem preço em produto algum. |
| Status da impressão / fila local | o estado do que ainda não subiu do terminal | A fila é do terminal; a retaguarda não a vê. |
Resultado esperado#
- O produto aparece na fila Prontos, sem sinal de espera, e depois no caixa.
- O preço da retaguarda e o preço do caixa são o mesmo, e a etiqueta da gôndola confere com os dois.
- A venda aparece na retaguarda, e o estoque baixou.
- A tela Carga PDV mostra tudo enviado e os terminais estão comunicando.
- O inventário do período está processado, com o furo registrado.
Se algo der errado#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Fiz tudo e o produto continua fora do caixa | Pode haver uma segunda fila de pendência (fiscal e depois liberação) | Releia o motivo na fila de decisão: ele muda de dono conforme a etapa é resolvida. |
| O terminal não baixa a carga | Terminal sem rede, ou aplicativo fechado | Verifique a conexão e se o aplicativo está aberto. |
| A carga vai para a loja errada | A loja escolhida no envio estava errada | Carga é por loja. Envie para a loja certa. |
| Divergência de estoque grande e sem explicação | Pode envolver entrada, inventário, perda ou transferência no mesmo período | Reúna o período e os movimentos e escale. Não ajuste o estoque "no olho". |
| Preciso corrigir um dado direto no banco | — | Não faça. Nada nesta documentação autoriza alterar banco de dados. Ver Como abrir um chamado. |
Como funciona por dentro#
- O caixa não consulta a retaguarda para vender. Ele trabalha com o catálogo e o preço que já estão no terminal, grava localmente e cria o evento na fila.
- A carga é o único caminho de dado novo. Produto, preço, promoção, usuário do PDV e parâmetros chegam ao caixa pelo pacote.
- O estoque tem dois momentos. A venda baixa o estoque quando a retaguarda recebe a venda sincronizada. Venda na fila ainda não baixou — e isso explica boa parte das divergências de estoque do dia.
- O inventário é por local e aplica a diferença.
ajuste = contado − congelado, aplicado sobre o saldo atual do local. Vendas no meio da contagem continuam valendo. - A fila local é encadeada e idempotente. Cada evento carrega sequência e o hash do anterior. O reenvio do mesmo evento não duplica nada.
- O produto passa por filas com donos diferentes. Um produto que entra pela nota pode nascer inativo esperando o fiscal; resolvido o fiscal, a pendência muda de dono e vai para quem tem o direito de liberar a venda. Ela nunca desaparece em silêncio.
O que é de fábrica e o que a sua loja pode ter mudado#
| Ponto | Padrão de fábrica | Como fica diferente |
|---|---|---|
| Entrada de NF-e | 1 passo (dar entrada já lança estoque, custo e contas) | com entrada.exige_conferencia_fisica ligado, vira 2 passos e a conferência passa a bloquear a conclusão |
| Conferência de recebimento | cega por padrão | desligada, o esperado da nota aparece antes da contagem |
| Propagação da carga até os terminais | a carga é publicada na retaguarda e o caixa a busca no próximo ciclo | o tempo depende da rede e do ciclo de sincronização da loja; não há promessa de tempo real |
| Nomes dos chips e dos motivos | os textos desta documentação foram lidos do produto | a apresentação pode variar entre versões — o que muda a fila é o fato, não o rótulo |
Os valores vigentes da sua loja ficam em Administração › Parâmetros; a tabela completa está em Parâmetros e valores padrão.
Onde aprofundar#
- Como o caixa trabalha sem internet: Operar offline.
- Cadastro de produto, preço e carga: Produtos e preços.
- Compras, recebimento e inventário: Compras e estoque.
- Periféricos que leem código e peso: Hardware e periféricos.
- Fechamento do mês, com o inventário na ordem: Fechamento do mês.