Pular para o conteúdo principal
Versão: 1.x

Funcionalidade Offline

O WCPOS armazena os dados de produtos e clientes localmente em cada dispositivo usando um banco de dados baseado no navegador (IndexedDB). 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 em cache
  • 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
  • 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​

  • Finalizar a compra — processar o pagamento e criar o pedido no WooCommerce requer comunicação com o servidor
  • Aplicar cupons de desconto — a validação de cupons acontece no servidor
  • 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)

Como o Banco de Dados Local Funciona​

Quando você abre o WCPOS pela primeira vez, ele começa a baixar seus produtos e clientes do WooCommerce em segundo plano. Esse processo é progressivo — quanto mais você usa o POS, mais completos ficam os seus dados locais.

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 — cada dispositivo mantém sua própria cópia local
  • Permanece sincronizado — o WCPOS verifica periodicamente se há alterações no servidor e baixa as atualizações

Para mais detalhes técnicos, consulte a referência de Arquitetura.

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 à navegação de dados em cache

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 em cache.
  2. É possível continuar montando carrinhos e editando itens.
  3. A finalização do pedido falhará se tentada — o POS precisa se comunicar com o servidor WooCommerce para processar o pedido.
  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.
  • Você pode prosseguir para o checkout e finalizar os pedidos estacionados.
  • A sincronização em segundo plano é retomada, baixando quaisquer alterações de produtos ou clientes que ocorreram enquanto você estava offline.
  • Nenhuma ação manual é necessária — o WCPOS gerencia a reconexão automaticamente.

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.
  • Sincronize regularmente — se a conectividade é intermitente, sincronize o catálogo de produtos enquanto houver uma boa conexão para que os dados locais estejam atualizados.
  • Considere os aplicativos nativos — os aplicativos para desktop e dispositivos móveis (quando disponíveis) podem oferecer maior resiliência offline do que a versão no navegador.