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.

Registro de atualizações

Veja também: Ello PDV (frente de caixa, Gollum e módulo PDV do Ello) e 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

Configuração

As configurações básicas ficam no arquivo 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.