Pular para o conteúdo principal

Histórico Caixa

A tela de Histórico Caixa mostra todas as sessões de caixa do PDV — cada linha é uma abertura/fechamento de um dos caixas da loja (ex.: "Caixa 1", "Caixa 2", "Maquininha Stone"). A tela traz quem abriu o caixa, quando, quando fechou, e os comentários (saldo declarado na abertura, sobras/quebras no fechamento). Ao clicar em uma linha, abre o extrato detalhado da sessão — com todos os pedidos atendidos no caixa, todos os lançamentos bancários gerados (sangrias, suprimentos, recebimentos) e o resumo por tipo de pagamento.

A tela tem um modo de visualização único, em lista. O detalhe é uma modal (não uma tela separada). Dentro da modal, é possível editar um recebimento individual (corrigir tipo de pagamento, NSU, TID, parcelas), exportar o extrato em Excel ou PDF, e imprimir o extrato.

A tela atende dois cenários principais: (1) Conferência diária do caixa — o supervisor abre a sessão do dia, confere o extrato contra o dinheiro físico/cupons da maquininha, e identifica divergências; (2) Correção de erros do operador — quando o operador do PDV registrou o tipo de pagamento errado (ex.: marcou "Crédito" em vez de "Débito"), o supervisor abre o extrato e corrige a transação específica sem precisar cancelar a venda inteira.

Índice​

Conceito

Visualização e exportação

Correção de transações

Busca

Regras de negócio

Referência rápida

O que é a tela de Histórico Caixa?​

É a tela onde você vê todas as aberturas e fechamentos do caixa do PDV, separadas por caixa (qual maquininha/caixa físico) e por operador (quem abriu). Cada linha da lista representa uma sessão de caixa — uma janela de tempo em que o caixa estava aberto. Clicando na linha, abre o extrato detalhado com todas as movimentações do período.

A tela é usada principalmente para conferência diária e correção de erros do operador (tipo de pagamento errado, parcelamento errado).

📍 Onde: menu lateral → PDV → Histórico Caixa.

O que é uma "sessão de caixa" no idworks?​

Uma sessão de caixa é o período entre a abertura e o fechamento de um caixa do PDV. Ela tem:

  • Caixa — qual caixa físico (ex.: "Maquininha Cielo", "Caixa Loja 1").
  • Operador — o usuário que abriu o caixa (com o login dele).
  • Data Abertura — quando o caixa foi aberto.
  • Data Fechamento — quando o caixa foi fechado. Fica vazio enquanto a sessão segue aberta.
  • Comentário Abertura — texto livre da abertura (geralmente o saldo inicial declarado, mais observações).
  • Comentário Fechamento — texto livre do fechamento (sobras/quebras, observações).

Cada venda do PDV feita enquanto a sessão está aberta fica vinculada à sessão. Cada lançamento bancário gerado (recebimento, sangria, suprimento) também fica vinculado. No fechamento, o sistema fixa a data e impede novas vendas naquele caixa até a próxima abertura.

Qual a diferença entre "caixa" e "banco"?​

No idworks, caixa do PDV e conta bancária são cadastrados no mesmo lugar (em Financeiro → Contas Bancárias) — a diferença é a finalidade. Um caixa de PDV é uma conta bancária configurada para ser aberta/fechada pelo PDV (geralmente uma maquininha ou um caixa físico com saldo em espécie). Uma conta bancária comum não tem esse comportamento.

Na tela de Histórico Caixa, só aparecem as contas que foram efetivamente abertas pelo PDV — contas que nunca tiveram sessão não aparecem na lista de filtros (o filtro Banco mostra apenas os caixas, não a lista geral de bancos).

O que aparece no extrato detalhado?​

Ao clicar em uma linha, abre uma modal grande com 5 blocos:

BlocoO que mostra
CabeçalhoCaixa, Operador, Data Abertura, Data Fechamento, Comentários Abertura, Comentários Fechamento.
VendasPedidos válidos do caixa (status diferente de Cancelado). Cada linha é um recebimento — pedidos parcelados aparecem em uma única linha com o valor total e a quantidade de parcelas.
Vendas CanceladasPedidos do caixa com status Cancelado. Vêm com a coluna Comentários para identificar o motivo do cancelamento.
SangriasLançamentos bancários que contêm a palavra sangria na descrição. Veja a próxima FAQ.
TransaçõesTodos os lançamentos bancários do caixa: recebimentos, sangrias, suprimentos. Lançamentos de débito (saídas de dinheiro) aparecem com valor negativo.
Total por Tipo de PagamentoSoma das vendas válidas agrupadas por tipo de pagamento.

Cada tabela tem R$ Total na última linha. O extrato pode ser exportado em Excel ou PDF, ou impresso direto.

O que é a seção "Sangrias" do extrato?​

Sangria é o ato de retirar dinheiro do caixa físico durante o expediente, para reduzir o volume guardado na maquininha/gaveta. Na prática, é um lançamento bancário do tipo "saída de caixa" — o dinheiro físico vai para o cofre ou para outra conta da empresa.

No extrato, o sistema isola as sangrias em uma seção dedicada (todo lançamento cuja descrição contém a palavra "sangria") para facilitar a conferência: o supervisor confere o total das sangrias contra os comprovantes/relatórios da segurança/transporte de valores.

O que é o "Total por Tipo de Pagamento"?​

É o resumo das vendas válidas do caixa, agrupadas por tipo de pagamento. Mostra, por exemplo, "R$ 5.000 em Crédito, R$ 3.200 em Débito, R$ 850 em Dinheiro". A lista parte dos tipos de pagamento ativos no PDV (cadastrados em Financeiro → Tipo Pagamento com o switch Habilitar Frente de Caixa = SIM) com valor zero, e é incrementada conforme as vendas são processadas — então um tipo de pagamento que não teve venda aparece com R$ 0,00.

Esse resumo é o que o supervisor usa para conferir contra os relatórios das maquininhas (extrato Cielo, extrato Stone, etc.) — os totais devem bater. Se não baterem, é hora de procurar a transação específica no bloco Vendas e corrigir.

Como abrir o extrato de uma sessão?​

Existem 2 maneiras:

  1. Botão de visualizar (ícone de olho à direita) na linha da sessão.
  2. Duplo-clique na linha (mais rápido).

A modal abre carregando o extrato (pode demorar alguns segundos para sessões com muitas vendas). Use Fechar ou ESC para sair.

Como exportar o extrato para Excel?​

Com a modal de extrato aberta, clique em Exportar Excel no rodapé. O navegador baixa um arquivo .xlsx com uma aba por bloco (Cabeçalho, Vendas, Vendas Canceladas, Sangrias, Transações, Total por Tipo de Pagamento). Use o Excel para fazer conferências cruzadas com planilhas próprias.

Como exportar/imprimir o extrato em PDF?​

Dois botões no rodapé da modal:

  • Exportar PDF — baixa o arquivo .pdf direto.
  • Imprimir PDF — abre uma nova aba com o PDF formatado para impressão e dispara o diálogo de imprimir do navegador.

Use o Imprimir quando precisa de comprovante físico para arquivar (ex.: protocolo de conferência diária). O conteúdo é o mesmo do Excel, formatado em A4.

Como ver os comentários completos da abertura/fechamento?​

Na lista (tela principal), os comentários aparecem truncados (com reticências). Para ver o texto completo:

  1. Expandir a linha — clique na seta à esquerda da linha. Aparece um bloco abaixo com os comentários completos (em formato <pre> se o conteúdo for JSON estruturado, ou texto livre caso contrário).
  2. Ou abrir o extrato — o cabeçalho da modal mostra os comentários em duas caixas de texto grandes (com até 4 linhas visíveis sem rolagem).

A coluna Comentários do caixa é onde o operador costuma anotar saldo inicial (na abertura) e divergências (no fechamento, ex.: "faltou R$ 5 no dinheiro").

Como abrir um pedido a partir do extrato?​

Nas tabelas Vendas, Vendas Canceladas e Transações, a coluna CÓD. PEDIDO mostra o número do pedido com um ícone de olho. Clique no ícone para abrir o pedido em uma nova aba (sem fechar a modal de extrato).

Use isso para investigar uma venda específica — ver os itens, o cliente, o vendedor, o status atual etc.

Como corrigir o tipo de pagamento de uma venda do PDV?​

Cenário comum: o operador marcou Crédito no PDV quando o cliente pagou em Débito. Para corrigir:

  1. Abra o extrato da sessão de caixa em que a venda foi feita.
  2. Localize a linha do recebimento na tabela Vendas.
  3. Clique no ícone de lápis (ações, à direita da linha).
  4. Na janela Editar, mude o campo Tipo Pagamento para o tipo correto.
  5. Clique em Salvar.

O sistema atualiza o recebimento, regrava o resumo por tipo de pagamento e fecha a janela. As outras parcelas do mesmo agrupamento (se houver) também são atualizadas para o novo tipo.

⚠️ Não é possível editar vendas já conciliadas (fechamento bancário feito). Veja a FAQ sobre o erro "Recebimento já foi conciliado".

Pré-requisito: privilégio Alterar detalhes de transação PDV. Sem o privilégio, o sistema pede senha de gerente (ver FAQ).

Como informar/corrigir o NSU e TID de uma transação?​

Cenário: a venda foi feita com a maquininha, mas o NSU/TID não foi capturado automaticamente (ex.: integração offline). Para informar manualmente:

  1. Abra o extrato → localize o recebimento → clique no lápis.
  2. Preencha os campos TID e NSU com os números do comprovante da maquininha.
  3. Salvar.

O NSU e TID ficam gravados no recebimento e são usados depois na conciliação adquirente para casar com o extrato bancário recebido da operadora.

Como alterar a quantidade de parcelas de uma venda?​

Cenário: o cliente pediu para parcelar em 3x, mas o operador registrou em 1x (à vista). Para corrigir:

  1. Abra o extrato → localize o recebimento → clique no lápis.
  2. Altere o campo Parcelas para o novo número (ex.: 3).
  3. Salvar.

⚠️ Atenção: alterar parcelas é mais pesado que alterar tipo de pagamento. O sistema:

  1. Apaga os recebimentos atuais do agrupamento.
  2. Chama o worker PHP para recalcular o parcelamento (dividir o valor total no novo número de parcelas, com as datas de vencimento corretas).
  3. Recria os recebimentos com os novos valores e datas.

Se algo falhar no worker, a operação é abortada com mensagem de erro. Por isso, faça essa edição apenas quando necessário — para corrigir tipo de pagamento/NSU/TID sem mudar parcelas, deixe o campo Parcelas com o valor que já está lá.

Por que não consigo editar uma transação? "Recebimento já foi conciliado"​

Quando o recebimento já passou pela conciliação bancária (foi baixado/conciliado contra o extrato bancário), a tela bloqueia a edição com a mensagem:

Recebimento já foi conciliado e não pode ser editado

São aceitos apenas recebimentos nos status em aberto, parcial ou agendado. Qualquer outro status (baixado, parcial conciliado, etc.) bloqueia.

Como resolver: a alteração precisa ser feita antes da conciliação. Se o caixa do dia já foi conciliado, a correção precisa passar por desfazer a conciliação primeiro (na tela de Conciliação Bancária ou Conciliação Adquirente), editar o recebimento, e conciliar de novo. Isso geralmente exige privilégio elevado e deve ser tratado pela equipe financeira.

Como autorizar a edição quando não tenho privilégio?​

Se o operador clica no lápis sem ter o privilégio Alterar detalhes de transação PDV, o sistema abre o modal de senha do gerente — pede para um usuário com o privilégio digitar login + senha para liberar a ação pontualmente.

Quem aprovar precisa:

  • Ter o privilégio Alterar detalhes de transação PDV no perfil de acesso.
  • Saber o próprio login e senha.

Depois da autorização, a janela de edição abre normalmente. O log da edição fica no nome do operador (não do gerente), mas a aprovação fica registrada via o registro de verificação de senha.

Como filtrar as sessões de caixa?​

Abra o painel de filtros (botão de funil no topo direito da tabela). Os filtros disponíveis:

FiltroO que filtra
ContaAparece quando a empresa tem mais de uma conta cadastrada. Filtra pela conta dona do caixa.
EmpresaAparece quando a conta tem filiais. Filtra pelas sessões cujo caixa pertence à filial.
UsuárioFiltra pelo operador que abriu o caixa.
BancoFiltra por caixa específico (ex.: só "Maquininha Cielo"). Lista populada a partir dos caixas com sessão.
Data AbertoIntervalo de datas da abertura do caixa.

Combine os filtros à vontade. Em seguida, clique em Buscar. Para resetar, clique em Limpar.

Além dos filtros, cada coluna da tabela tem busca interna (clique na lupa do cabeçalho).

Como achar uma sessão específica pelo código?​

Cada sessão tem dois códigos visíveis:

  • CÓD. CAIXA — o id único da sessão.
  • CÓD. BANCO — o id do caixa físico (conta bancária).

Se você tem o CÓD. CAIXA (ex.: copiado de outro relatório ou de uma URL antiga), use a busca interna na coluna CÓD. CAIXA (clique na lupa do cabeçalho).

O que acontece quando altero o número de parcelas?​

A alteração de Parcelas é a operação mais complexa da edição. O sistema executa esses passos:

  1. Localiza todas as parcelas atuais da venda no mesmo tipo de pagamento (agrupadas por pedido, tipo de pagamento, NSU e TID).
  2. Apaga essas parcelas atuais.
  3. Recalcula o parcelamento passando o valor total da venda e a nova quantidade de parcelas.
  4. Recria os recebimentos divididos em N parcelas, com as datas de vencimento corretas (de acordo com as regras do tipo de pagamento).

Se o recálculo falhar (ex.: rede, tipo de pagamento mal configurado), a edição é abortada com mensagem de erro — mas os recebimentos antigos já foram apagados, gerando um estado inconsistente. Em produção, evite alterar parcelas em horários de pico e tenha o financeiro pronto para corrigir manualmente caso algo dê errado.

Quando você não muda o número de parcelas (deixa o campo com o valor atual), o sistema apenas atualiza os campos Tipo Pagamento, TID e NSU de todas as parcelas do agrupamento — operação simples e rápida.

Por que o valor da sangria aparece negativo no extrato?​

É uma convenção da tela: lançamentos de débito (saída de dinheiro) aparecem com sinal negativo na coluna R$ VALOR. Lançamentos de crédito (entrada) mantêm o valor positivo.

Isso facilita a leitura visual: o operador vê de relance o que entrou (positivo, azul) e o que saiu (negativo, vermelho). O R$ Total das transações reflete esse sinal — uma sessão com muita sangria pode ter total de transações negativo.

O valor original do lançamento está sempre positivo no sistema; o sinal é só uma decoração visual da apresentação.

Onde vejo o histórico das edições feitas no extrato?​

Toda edição de recebimento (tipo de pagamento, NSU, TID) gera um log de auditoria registrando o valor antigo e o novo. Exemplo:

{
  "Tipo Pagamento": "DE: Crédito Visa PARA: Débito Visa",
  "NSU": "DE:  PARA: 123456"
}

O log preserva o usuário que fez a alteração, a data/hora e o conteúdo da mudança em JSON. Não há tela dedicada para visualizar esse log — a consulta é via banco. Edições de parcelas (que chamam o worker PHP) não geram log nesse formato (o worker apaga e recria os recebimentos, então não há "DE/PARA").

Privilégios da tela​

PrivilégioLibera
Visualizar Histórico fechamento caixaAcesso à tela e à lista de sessões. Sem isso, a tela nem aparece no menu.
Alterar detalhes de transação PDVEdição de recebimentos diretamente. Sem isso, o sistema pede senha de gerente quando o operador tenta editar.

Não há privilégios separados para exportar Excel/PDF ou imprimir — quem tem acesso à tela tem acesso a essas ações.