====== Sincronização de Dados no PDV ======

O terminal de caixa precisa de uma cópia local dos dados do Ello ERP para funcionar — como o catálogo de produtos, preços e formas de pagamento. Esta página explica como essa sincronização funciona.

> Voltar: [[ello_pdv:pdv_app|Aplicativo PDV]]

===== O que é sincronizado =====

O servidor (Gollum) mantém uma versão atualizada dos seguintes dados e os distribui para os terminais:

^ Categoria ^ Exemplos ^
| Produtos | Nome, código de barras, preço, impostos |
| Promoções | Descontos ativos, itens promocionais |
| Clientes | Nome, CPF, limite de crediário |
| Formas de pagamento | Finalizadoras configuradas no ERP |
| Usuários e permissões | Operadores habilitados e o que cada um pode fazer |
| Parâmetros do sistema | Configurações gerais do PDV |
| Bandeiras de cartão | Visa, Mastercard, Elo etc. e suas operadoras |
| Configurações de PIX | Contas PIX habilitadas para recebimento |

===== Como funciona =====

A sincronização ocorre em dois sentidos:

**Do servidor para o terminal (dados de consulta):**
  - O servidor detecta quando um dado foi alterado no ERP (ex.: um preço de produto foi ajustado)
  - Prepara um pacote com os dados atualizados e o disponibiliza para download
  - O terminal verifica periodicamente se há novidades e baixa o pacote mais recente
  - Após baixar, o terminal aplica os dados localmente

**Do terminal para o servidor (vendas):**
  - A cada venda finalizada, o terminal a coloca em uma fila interna
  - Um processo em segundo plano envia essa fila para o servidor a cada poucos segundos
  - O servidor processa cada venda (integra ao ERP, emite nota se necessário)
  - O terminal recebe a confirmação e marca a venda como processada

===== Status da sincronização =====

Cada pacote de dados passa pelos seguintes estados:

^ Status ^ Significado ^
| Aguardando geração | O ERP registrou uma alteração, mas o pacote ainda não foi preparado |
| Arquivo disponível | O pacote foi preparado e está pronto para os terminais baixarem |
| Recebido pelo terminal | O terminal confirmou que recebeu o pacote |
| Aplicado pelo terminal | O terminal aplicou os dados localmente com sucesso |
| Erro no processamento | O terminal encontrou um problema ao aplicar os dados |

===== Monitorando a sincronização =====

No Ello ERP, acesse a tela **PDV600 — Replicação** para ver o status de cada categoria de dados em cada terminal. Mais detalhes: [[ello_erp:modulos:pdv:replicacao|Replicação de Dados para os Terminais PDV]].

===== O que fazer quando um terminal está desatualizado =====

  - Acesse a tela PDV600 no Ello ERP
  - Identifique qual categoria está com status de erro ou desatualizada
  - Use a opção de forçar reenvio manualmente
  - Se o problema persistir, verifique se o serviço Gollum está ativo no servidor e reinicie o aplicativo PDV no terminal