Funcionalidade Offline

O WCPOS armazena os dados de produtos e clientes em um banco de dados local em cada dispositivo. Isso significa que partes do POS funcionam sem conexão com a internet, enquanto outras exigem conectividade.

O que Funciona Offline

• Navegar por produtos — pesquisar, filtrar e visualizar detalhes de produtos a partir dos dados locais
• Navegar por clientes — consultar nomes, e-mails e endereços de clientes
• Montar um carrinho — adicionar itens, alterar quantidades, editar preços e aplicar descontos do POS
• Aplicar cupons (Pro) — os códigos são validados localmente com os dados de cupons sincronizados; o servidor revalida quando o pedido enfileirado chega até ele
• Salvamento de um pedido — mantenha um pedido em espera ou salve-o no dispositivo; ele entra na fila de envio e chega ao WooCommerce quando a conexão voltar
• Leitura de código de barras — escanear códigos de barras para encontrar produtos no banco de dados local
• Visualizar relatórios — o tipo de relatório padrão (offline) gera relatórios a partir dos pedidos armazenados localmente

O que Requer Conexão

• Recebimento do pagamento — ao finalizar a compra, é exibida uma página de pagamento hospedada pelo seu servidor; portanto, não é possível concluir a etapa de pagamento offline. Você ainda pode montar e salvar o pedido enquanto estiver offline e receber o pagamento quando voltar a ficar online.
• Ações de checkout que dependem do servidor — o Checkout Web, os gateways online ou de terminal integrados e o Salvar no Servidor precisam que seus respectivos serviços estejam acessíveis
• Sincronizar dados — baixar novos produtos, preços atualizados ou novos clientes do WooCommerce
• Fazer login — a autenticação inicial requer conexão com o seu site WordPress
• Ativação de licença — as verificações de licença Pro precisam acessar o servidor de licenças do WCPOS
• Processar reembolsos — os reembolsos não podem ser enfileirados offline; o gateway e a sua loja precisam estar acessíveis (veja Reembolsos)

É preciso ter conexão para concluir uma venda

Você pode montar e salvar um pedido offline, mas a etapa de pagamento precisa aguardar uma conexão. A possibilidade de concluir uma venda offline — começando com dinheiro — está no roteiro.

Como o Banco de Dados Local Funciona

Quando você abre o WCPOS pela primeira vez, ele faz a carga inicial do seu catálogo de produtos em segundo plano e busca os demais dados conforme você usa o POS — você pode começar a vender assim que os primeiros produtos estiverem no dispositivo. A partir daí, uma verificação de mudanças em segundo plano (a cada 60 segundos por padrão, ajustável em Saúde da loja) busca apenas o que mudou no servidor.

O banco de dados local:

• Persiste entre sessões — os dados são mantidos após reiniciar o navegador ou o dispositivo
• É individual por dispositivo (e por operador de caixa) — cada dispositivo mantém sua própria cópia local; os operadores não compartilham dados locais
• Permanece sincronizado — as verificações de mudanças em segundo plano trazem as atualizações; suas alterações são enfileiradas localmente e enviadas ao servidor

Você pode ver exatamente o que está no dispositivo — e o que ainda está aguardando envio — em Saúde da loja → Banco de dados. Para mais detalhes técnicos, consulte Como funciona o motor de sincronização.

As Alterações Feitas Offline São Enfileiradas

Toda alteração que você faz no WCPOS — um pedido salvo, um cliente novo ou editado, um cupom, uma alteração de estoque ou preço (Pro) ou um e-mail de recibo — é salva primeiro no dispositivo e colocada na fila de envio. Enquanto você estiver offline, a fila simplesmente aguarda; perder a conexão durante o turno não faz com que nada seja perdido. A fila também é mantida após reinicializações e falhas: se o aplicativo exibir uma tela de erro, escolher Tentar novamente recarrega o aplicativo sem descartar as vendas que ainda não foram enviadas.

Quando a conexão volta, a fila é drenada automaticamente. Se o seu servidor recusar uma alteração de forma definitiva (algo raro — por exemplo, um registro que o servidor considera inválido), o POS não fica tentando de novo em silêncio para sempre: a alteração é estacionada em Saúde da loja → Banco de dados, sob "alterações que nunca chegaram ao seu servidor", com o motivo informado pelo servidor e as ações explícitas Enviar novamente / Descartar. Veja Saúde da loja.

Indicador de Conectividade

O cabeçalho do POS exibe um ponto colorido indicando o status da conexão:

• Verde — conectado ao servidor, todos os recursos disponíveis
• Amarelo — conexão intermitente, algumas operações podem ficar lentas
• Vermelho — offline, limitado aos dados locais

O Que Acontece Durante a Perda de Conectividade

Se a conexão com a internet for perdida durante o uso do POS:

1. Produtos e clientes permanecem navegáveis a partir dos dados locais.
2. É possível continuar montando carrinhos e editando itens — cada alteração é enfileirada localmente.
3. Você pode montar e salvar pedidos, mas não receber pagamentos — carrinhos e alterações entram na fila local, e um pedido pode ser salvo para envio posterior. A conclusão do pagamento precisa aguardar o retorno da conexão, pois a finalização da compra é renderizada pelo seu servidor.
4. Pedidos em aberto são preservados no banco de dados local até que a conectividade seja restabelecida.

Quando a Conexão é Restabelecida

Quando a conexão for restabelecida:

• O indicador de conectividade fica verde.
• As alterações enfileiradas são drenadas para o seu servidor automaticamente — vendas e edições feitas offline são enviadas sem nenhuma ação manual.
• Os gateways de pagamento que dependem do servidor e o Salvar no Servidor voltam a ficar disponíveis.
• A sincronização em segundo plano é retomada, baixando quaisquer alterações de produtos ou clientes que ocorreram enquanto você estava offline.

Dicas para Conexões Instáveis

• Use "Salvar no Servidor" em pedidos importantes — isso envia o pedido para o WooCommerce imediatamente, evitando perdas caso o banco de dados local do dispositivo seja limpo.
• Verifique a Saúde da loja após uma queda — o bloco alterações aguardando envio em Saúde da loja → Banco de dados confirma quando tudo já chegou ao seu servidor.
• Sincronize enquanto houver sinal — se você sabe que a conectividade será intermitente, deixe a carga inicial do catálogo terminar enquanto houver uma boa conexão.