# 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[​](#what-works-offline "Link direto para 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[​](#what-requires-a-connection "Link direto para 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](/pt-BR/orders/refunds.md))

## Como o Banco de Dados Local Funciona[​](#how-the-local-database-works "Link direto para 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](/pt-BR/reference/architecture.md).

## Indicador de Conectividade[​](#connectivity-indicator "Link direto para 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[​](#what-happens-during-connectivity-loss "Link direto para 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[​](#when-connection-restores "Link direto para 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[​](#tips-for-unreliable-connections "Link direto para 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.
