Pular para o conteúdo principal

Snapshot do caixa aberto (resumo financeiro + ZPL)

GET 
/store-front/cashier/:idbankaccount

Retorna o caixa aberto com cálculos financeiros completos da sessão atual + dois recibos ZPL prontos para impressão (usados no fechamento e na conferência diária).

Campos calculados​

  • Balance — saldo atual do caixa (soma de todos os créditos menos débitos em AccountsPayableReceivableBankStatement até agora).
  • Income — soma de créditos desde a abertura do caixa (IDTypeAccount=0) menos o que foi pago em dinheiro nos pedidos (porque o dinheiro do cliente já entrou pela venda; evita contagem dupla).
  • Outcome — soma de débitos desde a abertura.
  • AdjustIn — reforços (créditos sem IDAccountPayableReceivable vinculado).
  • AdjustOut — sangrias (débitos sem IDAccountPayableReceivable vinculado).
  • TotalValueCancelled — diferença entre Income original e a soma dos pagamentos em dinheiro (usada para conciliar quando há vendas canceladas).
  • PaymentSummary — vendas da sessão agrupadas por tipo de pagamento (com descrição), incluindo os tipos zerados habilitados para PDV (EnableFrenteCaixa=1).
  • PaymentCategorySummary — vendas agrupadas por categoria de pagamento (Crédito, Débito, Dinheiro, Pix etc.).
  • InvoiceSummary — vendas agrupadas por modelo de NF emitida (NfeModelo = 55 NFe, 65 NFCe, ou null para pendentes).

Recibos ZPL​

  • ReceiptBase64Encode — "Fechamento de caixa" para conferência (Saldo Anterior + Total Vendas por tipo + Reforço + Sangria + Saldo Final).
  • ReceiptFiscalBase64Encode — "Resumo Fiscal" (Total NFCe, Total NFe, Pendentes + quantidade de cada).

Ambos os ZPL vêm codificados em base64 + cp850 (encoding necessário para a maioria das impressoras térmicas Bematech/Daruma/Epson). Use o PrintService (com QzTray) para enviá-los para a impressora padrão (LabelReceiptDefaultPrinter).

Quando o caixa está fechado​

Mesmo com o caixa fechado, o endpoint retorna o BankAccount com Balance corrente — apenas os campos da sessão (RecordTimestampOpen, Income, Outcome, etc.) vêm vazios.

Tipo de pedido padrão​

Quando a BankAccount.IDTypeOrder está nula, o handler busca o tipo de pedido marcado como padrão para Frente de Caixa (TypeOrder.DefaultFrenteCaixa=1). Se também não houver, retorna [BadRequest] - Não existe tipo de pedido padrão para frente de caixa.

Request​

Responses​

Snapshot do caixa.