====== Processamento de Vendas pelo Gollum ======

Quando um operador finaliza uma venda no terminal de caixa, ela é enviada ao Gollum para ser integrada ao Ello ERP e, se necessário, ter o cupom fiscal emitido.

> Voltar: [[ello_pdv:gollum|Gollum — Serviço de Retaguarda]]

===== Fluxo de processamento =====

<uml>
actor Operador
participant "Terminal PDV" as PDV
participant "Gollum\n(Servidor)" as G
participant "SEFAZ" as S
database "Ello ERP" as ERP

Operador -> PDV: Finaliza venda
PDV -> G: Envia dados da venda
G -> ERP: Registra pedido de venda
G -> ERP: Lança contas a receber
G -> ERP: Registra pagamento\n(cartão, PIX etc.)
G -> ERP: Cria rascunho da NFC-e
G -> S: Transmite NFC-e
S --> G: Retorna autorização
G -> ERP: Atualiza nota como autorizada
G --> PDV: Envia dados da nota autorizada
PDV -> Operador: Imprime cupom fiscal
</uml>

===== O que o Gollum faz com cada venda =====

Ao receber uma venda do terminal, o Gollum realiza as seguintes ações no Ello ERP:

  - **Cria o pedido de venda** com todos os itens, preços e descontos
  - **Gera lançamentos financeiros** conforme a forma de pagamento:
    - Dinheiro e PIX: baixa imediata no fluxo de caixa
    - Cartão: registra a transação com dados da maquininha
    - Crediário: cria parcelas em contas a receber vinculadas ao cliente
    - Cheque: registra o cheque recebido com data de depósito
  - **Emite a NFC-e** e transmite à SEFAZ em tempo real
  - Se o cupom for emitido com sucesso, devolve os dados para o terminal imprimir

===== Emissão de NFC-e =====

  - A emissão é feita de forma imediata: o terminal aguarda a resposta antes de imprimir
  - Erros de validação da SEFAZ são tratados automaticamente quando possível
  - Em caso de falha de comunicação com a SEFAZ, a nota é emitida em **modo de contingência** (com autorização posterior)
  - Um processo em segundo plano monitora continuamente as notas pendentes e as transmite assim que possível

===== Transmissão contínua =====

Além da emissão em tempo real, o Gollum mantém um processo contínuo que:
  - Verifica notas emitidas em contingência e as transmite à SEFAZ
  - Inutiliza faixas de numeração não utilizadas (requisito fiscal)
  - Consulta o status de notas que ficaram sem resposta

===== Situações de erro =====

^ Situação ^ Causa provável ^ O que fazer ^
| Venda não aparece no ERP | Falha de comunicação entre terminal e Gollum | Verificar se o Gollum está ativo; reenviar pela tela [[ello_erp:modulos:pdv:vendas_processadas|PDV610]] |
| NFC-e rejeitada pela SEFAZ | Dados inválidos ou serviço SEFAZ instável | Verificar os detalhes da rejeição nos registros do Gollum |
| Venda em contingência há muito tempo | SEFAZ indisponível por período prolongado | Aguardar retorno do serviço; as notas serão transmitidas automaticamente |