Fluxo+

Abastecimentos registrados nas bombas: litros, quantidade de abastecimentos e litros por abastecimento. Use para bico mais ou menos movimentado, abastecimentos de um combustível num dia, ticket médio em volume, ranking e média dos frentistas (agrupar_por ['frentista'], nas duas visões), horário de pico da pista, o movimento por dia da semana e hora (agrupar_por ['dia_da_semana', 'hora'], o período inteiro numa chamada), aferições (afericao 'somente') e abastecimentos sem baixa (sem_baixa, litros_sem_baixa). Para faturamento, margem e o ticket médio em reais (por venda), vendas; para os sem baixa um a um, transacoes com situacao 'sem_baixa'; para o encerrante contra o vendido e as perdas de tanque, estoque_combustivel. Para total anual, informe o ano inteiro sem agrupar; para evolução mensal, agrupe por ['mes']; para os dias de um mês, por ['dia']. Dia de maior volume do ano: ano inteiro, agrupar_por ['dia'], ordenar_por 'litros', ordem 'desc', limite 1. Agregação e totais usam todo o período antes do limite, mesmo quando as linhas são truncadas; para o melhor dia por faturamento, use vendas.

abastecimentos

A prestação de contas de cada operador de caixa por dia e turno (no posto, o frentista): vendas, recebido por forma de pagamento, sangrias, despesas, sobra ou falta, se foi conferida ou está bloqueada; e os vales de funcionário em aberto. Sobra e falta só existem onde o sistema faz a conferência do caixa: sem ela, a prestação traz o movimento do dia de quem recebeu, com sobra_falta vazio, que não é caixa batido nem caixa com problema. Use para "o caixa do frentista bateu?", quem mais teve falta no mês (por_operador), prestações sem conferência ou bloqueadas, sangrias e quanto cada um deve de vale. Até 366 dias. As formas de pagamento das vendas: pagamentos.

caixa

Clientes cadastrados na unidade: nome, CNPJ (de pessoa física, o CPF mascarado como no cupom), situação, convênio e cartão frota liberados, placas da frota e preços especiais; com um período, quanto cada um comprou (vendas, valor, litros, placas usadas, última compra). Use para a lista de clientes, achar um cliente pelo nome, CNPJ ou placa, quais clientes compraram e quanto, quais clientes de convênio abasteceram este mês (somente_convenio com o período) e quem parou de comprar (sem_consumo). Na WebPosto API, a busca por placa usa somente as vendas dos períodos consultados; informe um período. Para clientes que reduziram abastecimento, informe os dois períodos, metrica=litros, variacao=reducao e ordenar_por=reducao: inclui quem caiu a zero. Totais e comparação contam todos os clientes antes de limitar as linhas; continue pelo proximo_cursor. Para evolução anual use mes; mensal, dia; para total mantenha cliente. Melhor dia do ano da unidade: vendas com agrupar_por=["dia"] e ordenar_por=faturamento, sobre o ano inteiro. Quem está devendo: contas_receber. As vendas de um cliente uma a uma: transacoes.

clientes

Parcelas a pagar com fornecedor, documento, vencimento e valor, e os totais de vencidas e a vencer. Use para quanto a rede tem a pagar até uma data, o que já venceu sem baixa e a relação das contas de um período. Para as notas de compra, compras; para o que já saiu como despesa, despesas. Exemplo: a pagar até o fim do mês = vencimento_ate no último dia do mês, situacao 'abertas'. Na ACS, retorna o setor da parcela; setores filtra códigos exatos, sem buscar a placa no texto. valor mantém o valor documental. Quando disponível, saldo é o restante atual, após ajustes e baixas parciais; não é uma posição histórica na data de vencimento. Saldo desconhecido não é zero.

contas_pagar

Faturas a receber, como as de convênio e nota a prazo: cliente (com o CNPJ, ou o CPF mascarado como no cupom), vencimento, documento, valor e situação, com os totais, também por cliente (por_cliente). Use para quanto a rede tem a receber até uma data, quanto já venceu sem pagamento e quais clientes estão devendo, do maior valor documental ao menor. Quando disponível, saldo e saldo_vencido mostram o restante atual após ajustes e baixas; valor e vencido preservam os valores documentais. Saldo desconhecido não é zero. Para o cadastro e o consumo dos clientes, clientes.

contas_receber

Despesas e receitas lançadas no financeiro da unidade, pelo plano de contas: grupo, conta, histórico, documento, fornecedor e valor, com os totais agrupados (agrupar_por grupo, conta, mês ou unidade). Use para quanto a rede gastou no mês e com o quê (pessoal, administrativas, tributárias, financeiras, gerais, retiradas dos sócios) e uma conta ao longo dos meses (busca 'energia', agrupar_por 'mes'). Até 366 dias. O que falta pagar: contas_pagar. Na ACS, inclui código e nome do setor. Busca encontra um veículo quando ele está identificado no nome da conta, setor ou histórico; esses textos não comprovam vínculo entre veículos nem rentabilidade por veículo. setores filtra códigos exatos; agrupar_por 'setor' separa unidade e setor, inclusive GERAL e sem setor.

despesas

Estoque dos produtos que não são combustível (loja, conveniência, lubrificantes, pista), com o giro: saldo no sistema, vendido na janela, média por dia, para quantos dias dá, última venda, valor em estoque e a situação de cada um (negativo, zerado, parado, cobertura_baixa, ok, giro_indisponivel), mais o resumo de quantos estão em cada situação. Quando disponível, saldos_por_local detalha o mesmo saldo por local de estoque; não são saldos adicionais nem filiais. Nulo significa que a fonte não informa essa distribuição. Use para o que está parado e quanto dinheiro tem ali, o que vai faltar, o que vende e está zerado, e os saldos negativos, que mostram erro no estoque do sistema (venda sem entrada lançada). O saldo é o do sistema: quando o aviso diz que muitos estão negativos, a cobertura e o parado dependem de corrigir o estoque. Combustível nos tanques: tanques e estoque_combustivel. Preço e cadastro: produtos. Exemplo: o que está parado em bebidas = situacao 'parado', grupos ['bebidas'].

estoque_produtos

Movimentação dos combustíveis no formato do LMC, por dia ou somada: abertura, recebido, vendido, escritural, fechamento medido, perdas ou ganhos, dias acima da tolerância, e o vendido pelos encerrantes contra o registrado (vendido_encerrante, diferenca_encerrante). Dias sem fechamento declarado aparecem em dias_sem_fechamento; nesse caso, as perdas do período ficam indisponíveis. Sem nenhum fechamento, dias_acima_tolerancia também fica indisponível. Use para conferir se os encerrantes batem com o vendido, achar perdas e sobras de tanque, comparar as vendas com o estoque e ver se as descargas entraram (agrupar_por ['dia'] para o LMC dia a dia). Para as notas de compra, compras; para o nível atual dos tanques, tanques; para quem mexeu na medição, ocorrencias.

estoque_combustivel

Notas de compra recebidas no período, item a item (nota, fornecedor, produto, quantidade, valor, custo unitário), com os totais por produto, fornecedor, mês ou unidade (agrupar_por) e as notas emitidas contra o CNPJ da unidade que não entraram no sistema (notas_nao_lancadas). Use para quanto se comprou de cada distribuidora, o custo de compra por produto, se cada descarga entrou no estoque (com estoque_combustivel) e nota faturada sem compra lançada. Para o que falta pagar, contas_pagar. Exemplo: por fornecedor no mês = agrupar_por 'fornecedor'.

compras

O registro de auditoria do próprio sistema da unidade: quem fez o quê e quando, com o detalhe que o sistema grava. Use para cancelamentos de venda, medições de tanque alteradas à mão (tipos ['medicao']), trocas de preço, aferições, notas e cartões excluídos, caixas liberados e cadastros alterados; para investigar uma perda do LMC, as medições do dia. Até 366 dias. As vendas canceladas em si, com valor e nota: transacoes. Exemplo: quem alterou a medição dos tanques em 18/08 = tipos ['medicao'], data_inicial e data_final 2026-08-18.

ocorrencias