====== Gollum — Serviço de Retaguarda do PDV ======

O **Gollum** é o serviço responsável por conectar os terminais de caixa (PDV) ao Ello ERP. Ele fica instalado no servidor da loja e atua como intermediário entre a frente de caixa e o banco de dados do ERP.

> Veja também: [[ello_pdv|Ecossistema PDV]]

===== Para que serve =====

  * Recebe as vendas dos terminais e as integra ao Ello ERP
  * Emite os cupons fiscais (NFC-e) e transmite para a SEFAZ
  * Disponibiliza produtos, preços e configurações para os terminais baixarem
  * Gerencia integrações com plataformas de delivery (iFood, DeliveryMuch etc.)
  * Processa pagamentos via PIX e integração com terminais de pagamento (ElloPOS)
  * Envia notificações por WhatsApp para clientes e equipe

===== Configuração =====

O Gollum é configurado por um arquivo de configuração no mesmo computador onde está instalado. As principais configurações são:

^ Configuração ^ Descrição ^
| Banco de dados | Caminho para o arquivo do banco de dados do Ello ERP |
| Porta de comunicação | Porta de rede usada pelos terminais para se conectar (padrão: 7000) |
| Emissão de NFC-e | Ambiente de emissão (produção ou homologação) e comportamento em contingência |

===== Como iniciar e monitorar =====

  - O Gollum deve estar em execução antes de qualquer terminal de caixa ser aberto
  - Ao iniciar, o serviço exibe uma janela com abas de registro mostrando as atividades em tempo real:
    - **Operações**: vendas recebidas e processadas
    - **Emissão Fiscal**: NFC-e emitidas e transmitidas
    - **Cargas**: pacotes de dados enviados para os terminais
    - **Delivery**: pedidos recebidos de plataformas de entrega

===== Documentação relacionada =====

  * [[ello_pdv:gollum:processamento_vendas|Processamento de Vendas pelo Gollum]]
  * [[ello_pdv:gollum:geracao_de_cargas|Geração de Cargas para os PDVs]]
  * [[ello_pdv:gollum:integracoes|Integrações (iFood, Scanntech, PIX etc.)]]
  * [[ello_erp:modulos:pdv:replicacao|Monitorar replicação de dados no ERP]]