====== Gollum ======

O Gollum é um aplicativo que fica ligado em um computador da loja (normalmente o mesmo do Ello Retaguarda ou um servidor) e trabalha "nos bastidores". Ele foi criado para atender o PDV (frente de caixa), mas hoje também cuida de outras tarefas, como a comunicação com serviços de terceiros (iFood, Ello Delivery, Scanntech, etc.).

Sem o Gollum em funcionamento, o PDV continua vendendo, mas deixa de receber atualizações de produtos e preços, de emitir notas fiscais e de enviar suas vendas para a Retaguarda.

[[wiki:changelog:Gollum|Registro de atualizações]]

Veja também: [[ello_pdv|Ello PDV]] (frente de caixa, Gollum e módulo PDV do Ello) e [[ello_pos|Ello POS]] (aplicativo das maquininhas, que usa o Gollum para registrar os recebimentos).

===== O que o Gollum faz =====

==== Atendimento aos PDVs ====

Os PDVs "conversam" com o Gollum pela rede da loja. Quando precisam de algo, fazem um pedido e o Gollum responde. Os pedidos mais comuns são:

  * **Emitir nota fiscal** de uma venda feita no PDV (NFC-e), enviando-a para a SEFAZ.
  * **Registrar operações** feitas no caixa, como vendas, sangrias e suprimentos.
  * **Consultar clientes** cadastrados na Retaguarda.
  * **Enviar cargas**: levar ao PDV as informações atualizadas (produtos, preços, formas de pagamento, etc.).
  * **Informar data e hora do servidor**, para manter o PDV com o horário correto.
  * **Verificar se uma venda pode ser cancelada** ou se um caixa pode ser reaberto.
  * **Reenviar vendas** que precisam ser reprocessadas.

==== Atendimento a maquininhas com Ello POS ====

  * Reservar cobrança
  * Liberar cobrança
  * Confirmar cobrança
  * Cancelar cobrança

==== Transferência de cargas ====

Sempre que algo muda na Retaguarda (um preço, um produto novo, uma forma de pagamento), o Gollum percebe e prepara os arquivos de carga atualizados. O PDV então pede esses arquivos e avisa o Gollum quando terminou de aplicá-los. Assim, o Gollum sabe quais PDVs já estão com os dados em dia.

==== Emissão e transmissão de notas fiscais ====

  * Emite as notas das vendas feitas no PDV e as envia para a SEFAZ.
  * Transmite em lote as notas que ficaram pendentes.
  * Consulta as notas que foram enviadas mas ainda não tiveram resposta da SEFAZ.
  * Verifica de tempos em tempos se a SEFAZ está disponível. Quando a //contingência automática// está ligada e a SEFAZ fica fora do ar, o Gollum passa a emitir as notas em contingência (modo offline) e volta ao normal quando o serviço retorna.
  * Importa automaticamente os XMLs de notas de entrada de uma pasta, para clientes com o módulo Contador.

==== Registro de operações na Retaguarda ====

As vendas, sangrias, suprimentos e demais movimentos feitos nos PDVs são gravados pelo Gollum na Retaguarda, onde aparecem nos relatórios e no financeiro. Se algum movimento falhar, ele tenta novamente depois.

==== Integrações com serviços de terceiros ====

De acordo com os módulos liberados no Ello Retaguarda, o Gollum liga automaticamente as integrações correspondentes, mantendo os dados sincronizados em segundo plano:

  * **Delivery e pedidos online**: iFood, Ello Delivery, aiqfome, Delivery Much e Nuvem Shop.
  * **Scanntech**: envio das vendas e recebimento das promoções (o intervalo entre as sincronizações é configurável, no mínimo 1 minuto).
  * **Pix**: acompanha o pagamento das cobranças Pix geradas.
  * **Maquininha integrada (POS)**: acompanha os pagamentos feitos nas maquininhas.
  * **Notificações**: envia avisos por WhatsApp e e-mail, como boletos a vencer.

===== A tela do Gollum =====

A tela principal tem uma aba para cada atividade (por exemplo: rede, emissão de notas, registro na Retaguarda, geração de cargas, Pix, delivery). Em cada aba aparece o registro (log) do que o Gollum está fazendo, útil para descobrir por que algo não funcionou.

Ao ser minimizado, o Gollum fica na bandeja do Windows, ao lado do relógio. Clique duas vezes no ícone para abrir a tela de novo, ou clique com o botão direito para ver as opções.

===== Como saber se está funcionando =====

  - Confirme que o Gollum está aberto no computador (ícone na bandeja ou janela).
  - Na tela principal, verifique se o servidor está **ativo**. Se estiver parado, os PDVs não conseguem se comunicar.
  - Se o PDV não recebe atualizações ou não emite notas, abra a aba correspondente e leia as últimas mensagens do registro.
  - Se o Gollum não abre ou reclama da versão, ele está em uma versão diferente da do banco de dados. Atualize o Gollum junto com o Ello Retaguarda.

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

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

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

As configurações básicas ficam no arquivo [[gollum:gollum.ini]], que está na mesma pasta do Gollum. Os principais itens são:

^ Seção ^ O que controla ^
| Conexão | Qual banco de dados (empresa) o Gollum atende. |
| Servidor | Se os servidores de comunicação com os PDVs ligam sozinhos ao abrir o Gollum, e as portas de rede usadas (7000 para os pedidos dos PDVs e 5000 para a localização do Gollum na rede). |
| NFCe | Contingência automática e os monitores de notas, movimentações e Scanntech (1 liga, 0 desliga). |
| Debug | Nível de detalhe dos registros (log). Aumente só para investigar problemas. |

Se o Gollum estiver atrás de um firewall, as portas informadas acima precisam estar liberadas para os PDVs conseguirem se conectar.