relatorio-diario

Os dois envios diarios do financeiro do Grupo Ragga, no WhatsApp:

1. gerar_relatorio.py — venda bruta por forma de pagamento (quadrinho em PNG) e a entrada prevista, a partir do PDF Vendas por forma de pagamento - por dia do Cloud Commerce.
2. gerar_entradas.py — o recebimento real do dia contra aquela previsao.

Envio 1 — venda bruta e entrada prevista

# uso normal: PDF do periodo + PDF do mesmo intervalo do mes anterior
python3 gerar_relatorio.py setembro.pdf --mes-anterior agosto.pdf --saida saida

# apenas um dia
python3 gerar_relatorio.py setembro.pdf --dia 04/09/2026 --saida saida

# forcando a data da entrada prevista e informando o B2B
python3 gerar_relatorio.py setembro.pdf --mes-anterior agosto.pdf \
    --dia-previsto 14/09/2026 --b2b 1177.80 --saida saida

O --mes-anterior alimenta a parcela de voucher (liquida em D+30). A data prevista e, por padrao, o dia seguinte ao ultimo dia do relatorio.

Saidas em saida/: vendas_card.png, texto_whatsapp.txt e formas_agrupadas.csv.

Entrada prevista

Quatro parcelas, somadas no total:

Parcela	Origem
Cartao + Pix	credito + debito + pix do periodo atual, liquidos de taxa
Voucher D+30	voucher do PDF de --mes-anterior
Repasse do iFood	valor informado em --ifood-valor, ja liquido, por entidade; cai na quarta
Vendas a prazo	titulos de vendas_a_prazo.csv que vencem na data prevista
B2B iKI	so com --b2b (sem base ainda)

PAGAMENTO ONLINE e o iFood: fica fora da parcela diaria de cartao + Pix porque o repasse e semanal. Ele cai na quarta-feira, referente a semana fechada de segunda a domingo anterior (quarta 09/09 -> 31/08 a 06/09):

python3 gerar_relatorio.py setembro.pdf --mes-anterior agosto.pdf \
    --dia-previsto 09/09/2026 --ifood semana1.pdf --ifood semana2.pdf

A semana fecha no domingo e o repasse entra na quarta. Entao:

• na segunda o valor ja da para calcular a partir do faturado do Cloudfy (--ifood, com as taxas), mas e so uma previa: sai num bloco separado do texto e nao entra no total do dia;
• na quarta o dinheiro entra de verdade e vira parcela do total, com o valor real informado em --ifood-valor.

As duas datas apontam para a mesma semana, por isso a previa de segunda fica fora da soma -- somar nas duas contaria o mesmo dinheiro duas vezes.

O valor real do repasse nao sai do Cloudfy: o PAGAMENTO ONLINE de la e a venda, nao o repasse (diferenca medida de 24,72%). Informe na mao:

python3 gerar_relatorio.py 08-09.pdf --mes-anterior 08-08.pdf \
    --ifood-valor "Grupo Ragga=401827.58" --ifood-valor "Dell Iris=22224.02"

--ifood-valor aceita [ROTULO=]VALOR, pode repetir e soma. Esse valor ja e liquido — o script nao aplica taxa em cima. O repasse chega por entidade (Grupo Ragga, Dell Iris), com CNPJs diferentes. A Dell Iris e so iFood: nao tem cartao nem voucher entrando no previsto.

A flag --ifood <pdf> continua servindo como estimativa a partir do Cloudfy, com a taxa de 12,02%, mas --ifood-valor tem precedencia. O script calcula a janela seg-dom a partir da data prevista de qualquer jeito.

Taxas

A entrada prevista sai liquida, como estimativa. As taxas estao em TAXAS e TAXA_IFOOD, no topo de gerar_relatorio.py:

Forma	Taxa
Credito	2,63%
Debito	0,99%
Pix	0%
Voucher	5% (ficticio, so para ter base)
iFood	12,0215% efetivos, em dois estagios

A taxa do iFood nao e uma soma: comissao (8%) e transacao (2,60%) incidem sobre o bruto, e a antecipacao (1,59%) incide sobre o liquido que sobra — bruto x (1 - 0,1060) x (1 - 0,0159).

A taxa de 5% do voucher e ficticia, so para ter uma base -- nao e taxa negociada. Trocar em TAXA_VOUCHER quando a real aparecer. Venda a prazo e B2B saem brutos: sao boleto, sem adquirente no meio. Use --bruto para desligar todas as taxas e comparar.

vendas_a_prazo.csv

Recebiveis B2B a prazo, no formato RAZAO SOCIAL;CNPJ;VALOR;VENCIMENTO;ORIGEM DO CONSUMO. Cada titulo entra na entrada prevista apenas no dia do seu vencimento. Para forcar outra data de apuracao, use --dia-previsto.

Requisitos

pip install pdfplumber pillow

Mais Chromium para o PNG (opcional: sem ele o script salva um .html).

As regras de agrupamento estao no dicionario GRUPOS, no topo de gerar_relatorio.py. Detalhes do processo em CLAUDE.md.

Painel Sangria x Extrato

index.html na raiz e uma pagina unica que cruza as retiradas para deposito do relatorio de sangrias do Cloudfy com os creditos do extrato bancario, loja a loja. Roda inteira no navegador: os arquivos que a pessoa sobe nao saem do computador dela, e o que fica guardado (arquivos lidos, flags, observacoes, vinculos de loja) vive no localStorage daquele navegador.

Para publicar: Settings -> Pages -> Deploy from a branch -> main / (root). O endereco fica https://hylaryfarias.github.io/relatorio-diario/.

Dependencias externas: SheetJS 0.18.5 (cdnjs) para ler o xlsx e Instrument Sans (Google Fonts). As quatro logos vao embutidas como data URI. A Dotties Vanilla Heavy, reservada ao H1 pelo manual, e da Lost Type e ainda nao esta embutida — ate la o H1 cai em Instrument Sans 700.

Envio 2 — entradas do dia

python3 gerar_entradas.py --data 04/09/2026 --previsao 110000 \
    --pix 24739.28 --debito 44730.61 --credito 46217.25 \
    --voucher 6730.53 --b2b 1045.86 --saida saida

Gera saida/texto_entradas.txt. A --previsao e a que foi mandada para aquele dia no envio 1. Formas: --pix, --debito, --credito, --voucher, --b2b, --dinheiro, --online — so as informadas aparecem no texto.

O VALOR RECEBIDO e sempre a soma das formas. Se voce tiver o total na mao, passe em --total-informado: o script confere e avisa quando nao fecha, em vez de mandar um numero que nao soma.

Tambem aceita --dados recebimentos.json:

{
  "data": "04/09/2026",
  "previsao": 110000.00,
  "recebido": {"PIX": 24739.28, "Débito": 44730.61, "Crédito": 46217.25,
               "Voucher": 6730.53, "B2B": 1045.86},
  "total_informado": 128115.36
}