MedFIN

Estima quanto os plantões pagam, a partir do SEU histórico: média geral, por hospital (com quantos plantões e o último valor) e por tipo (presencial/sobreaviso). Responde "quanto costumo receber de plantão?" ou "quanto paga o Hospital X?". Filtre por hospital ou tipo. Cancelados ficam fora. Read-only.

estimar_valor_plantao

Ranking das cirurgias de um ano por nome de procedimento: quantidade, total cobrado, total recebido, ticket médio e convênios envolvidos. Responde "qual procedimento me rende mais?" e "quanto costumo cobrar por X?". Cirurgias canceladas ficam fora. Read-only.

faturamento_por_procedimento

Glosa (valor que o convênio/plano de saúde negou do líquido) e recuperado, por convênio — visão rápida. Para a análise completa (taxa, tempo médio, motivos, por procedimento, tendência) use glosa_analytics. Read-only.

glosas_por_convenio

Registra uma cirurgia. Data futura agenda a cirurgia (fica agendada e aparece em ver_agenda); data de hoje ou passada entra como pendente (a receber). Não marca recebida. Grava de verdade. Calcula o valor do seu histórico só quando o match é FORTE; se for fraco ou inexistente, pede o valor (value_charged) em vez de gravar um número errado.

lancar_cirurgia

Registra uma consulta. Data futura agenda para a frente (fica agendado, aparece em ver_agenda); data de hoje ou passada entra como pendente (a receber). Não marca recebido. Grava de verdade. Confirme com o médico antes. Valores são POR UNIDADE quando quantity > 1.

lancar_consulta

Registra uma despesa. Grava de verdade. Respeita a cota do plano (erro claro se estourar).

lancar_despesa

Registra uma despesa em 2–48 parcelas mensais (uma transação por parcela, agrupadas — igual ao app). Grava de verdade, tudo ou nada. Confirme com o médico antes; use preview_lancar_despesa_parcelada primeiro.

lancar_despesa_parcelada

Registra um exame. Data futura agenda para a frente (fica agendado, aparece em ver_agenda); data de hoje ou passada entra como pendente (a receber). Não marca recebido. Aceita cbhpm_codes (opcional) do exame. Grava de verdade. Confirme com o médico antes. Valores são POR UNIDADE quando quantity > 1.

lancar_exame

Registra um plantão. Data futura agenda pra frente (status agendado, aparece em ver_agenda até você marcar realizado); data de hoje ou passada entra como realizado (aconteceu, já em "a receber"). Nunca marca pago (quitar = receber_plantao). Grava de verdade. Confirme com o médico antes.

lancar_plantao

Registra uma receita NÃO-médica (salário, investimentos, presente, outros) no Histórico. Grava de verdade. Confirme com o médico antes. Receita de cirurgia/plantão/consulta/exame: use o fluxo de produção (lançar → receber), que mantém a Produção e o financeiro batendo.

lancar_receita

Lista cirurgias/consultas/exames pendentes ou parciais E plantões agendados/realizados, COM o id de cada um — use o id em preview_receber/receber_recebivel (cirurgia/consulta/exame) ou realizar_plantao/receber_plantao (plantão). Read-only. Valores são TOTAIS; a_receber_liquido_total já desconta imposto retido do convênio. Itens parciais só listam (baixa deles é pelo app).

listar_pendentes

Lista as transações JÁ LANÇADAS no Histórico (receitas e despesas registradas), da mais recente para a mais antiga, com descrição, categoria e valor. Responde "quais foram meus últimos lançamentos?", "minhas despesas de julho", "o que registrei esse mês?". Filtra por mês (YYYY-MM) e/ou tipo (receita/despesa). É o dinheiro que JÁ entrou ou saiu — NÃO o que falta receber/pagar (use listar_pendentes) nem o que está agendado pra frente (use ver_agenda). Read-only.

listar_transacoes

Marca um plantão AGENDADO como realizado (o plantão aconteceu). Não mexe em dinheiro — o recebimento é outro passo (preview_receber_plantao → receber_plantao). Pegue o id em listar_pendentes (tipo plantao). Grava de verdade.

realizar_plantao

Orçamento 50/30/20 de um mês: gasto REALIZADO vs ALVO em essenciais e desejos (alvo = renda × percentual configurado; renda = a recebida no mês, ou a de referência se o mês não tem receita lançada), e a poupança real vs a meta. Mesma matemática da aba Orçamento do app. Se o médico nunca configurou o Orçamento, avisa em vez de inventar. Read-only.

orcamento_do_mes

Quanto o médico PRODUZIU num mês (YYYY-MM) ou ano: nº e valor cobrado de cirurgias, consultas e exames + nº e valor de plantões (com contagem por status). É produção (o que foi feito na data), não caixa (o que entrou) — pra caixa use resumo_do_mes. Canceladas ficam fora. No mês CORRENTE inclui projecao_fim_de_mes (recebido + a receber, pelo ritmo até aqui). Read-only.

producao_do_periodo

Projeta o SALDO dia a dia pros próximos 30/60/90 dias combinando: recebíveis pendentes (líquidos de imposto e da taxa histórica de glosa do convênio), plantões a receber e recorrentes (contas e rendas fixas). Devolve saldo hoje, saldo em 30/60/90 dias, menor e maior saldo do período com a data, o primeiro dia em que o saldo fica NEGATIVO (null = não fica) e os totais de entradas/saídas previstas. Cenários: realistic (default, aplica glosa histórica), optimistic (sem glosa), pessimistic (glosa maior + recebimentos atrasam). É projeção, não promessa. Read-only, agregado.

projecao_de_caixa

Mostra como um aporte (guardar) ou resgate (tirar) mudaria o saldo da reserva (emergência ou residência) SEM gravar: saldo antes → depois. Read-only. Use antes de ajustar_reserva.

preview_ajustar_reserva

Valida e calcula o valor da cirurgia a partir do seu histórico (sem gravar). Use antes de lancar_cirurgia. Se não houver histórico, ou só houver estimativa fraca, pede o valor. Read-only.

preview_lancar_cirurgia

Valida e mostra a consulta que SERIA lançado, sem gravar. Read-only. Use antes de lancar_consulta.

preview_lancar_consulta

Valida e mostra a despesa que SERIA lançada, sem gravar. Use antes de lancar_despesa. Read-only.

preview_lancar_despesa

Valida e mostra as parcelas que SERIAM lançadas (total, valor de cada, primeira e última data), sem gravar. Read-only. Use antes de lancar_despesa_parcelada.

preview_lancar_despesa_parcelada

Valida e mostra a despesa recorrente MENSAL que SERIA criada, sem gravar. Read-only. Use antes de lancar_despesa_recorrente.

preview_lancar_despesa_recorrente

Mostra como ficaria a correção de valor e/ou data de uma cirurgia/consulta/exame/plantão que ainda NÃO foi recebido, SEM gravar (valor/data antes → depois). Read-only. Use antes de editar_producao.

preview_editar_producao

Valida e mostra o exame que SERIA lançado, sem gravar. Read-only. Use antes de lancar_exame.

preview_lancar_exame

Valida e mostra o plantão que SERIA lançado, sem gravar. Read-only. Use antes de lancar_plantao.

preview_lancar_plantao

Mostra o que receber_recebivel gravaria (novo status, glosa, receita no Histórico) SEM gravar. Read-only. Compara contra o líquido esperado (cobrado − imposto retido do convênio) — receber menos = glosa parcial. Use antes de receber_recebivel.

preview_receber

Mostra o que receber_plantao gravaria (status pago + receita no Histórico, líquida do imposto do hospital quando configurado) SEM gravar. Read-only. Use antes de receber_plantao. Plantão recebe o valor integral — pagamento parcial: use o app.

preview_receber_plantao

Valida e mostra a receita (não-médica: salário, investimentos, presente, outros) que SERIA lançada, sem gravar. Read-only. Use antes de lancar_receita.

preview_lancar_receita

O a-receber distribuído no TEMPO: agrupado por mês de vencimento esperado (expectedDate, ou data+30d) e por pagador. Use para "quando/quanto vou receber nos próximos meses"; para o total use recebiveis. Read-only, agregado.

proximos_recebimentos

Total líquido a receber (cirurgias/consultas/exames + plantões realizados), por convênio (plano de saúde pagador) e tipo. Esta é a VISÃO GERAL do a-receber; para o ranking de pagadores use convenios, para a distribuição por mês use proximos_recebimentos. Plantões são pagos por hospital (não têm convênio) e ficam fora de por_convenio. Read-only, sem PII.

recebiveis

Dá baixa num recebível PENDENTE (cirurgia/consulta/exame): grava valor recebido, data, o status correto (received/partial, imposto-aware, mesma regra do app) e cria a receita correspondente no Histórico. Grava de verdade — confirme com o médico antes. Item parcial ou glosa total (recebeu zero): use o app.

receber_recebivel

Dá baixa num plantão REALIZADO: marca pago e cria a receita correspondente no Histórico (líquida do imposto do hospital quando configurado, mesma regra do app). Grava de verdade — confirme com o médico antes. Plantão agendado: marque realizado primeiro.

receber_plantao

Muda a data (e opcionalmente a hora) de um item AGENDADO. Só funciona em item agendado: item já realizado, recebido ou pago é ajuste pelo app. Se a nova data for hoje ou passada, cirurgia/consulta/exame viram "pendente" (a receber) e plantão vira "realizado" (feito, a receber); data futura mantém tudo agendado. nova_hora só vale para cirurgia e plantão. Pegue o id em ver_agenda. Grava de verdade — confirme com o médico antes.

remarcar_agendamento

Situação das reservas configuradas no app (emergência e/ou residência): quanto já guardou, a meta, quanto falta, quantos meses de cobertura o guardado atual representa (emergência) e quanto guardar por mês pra chegar lá no prazo. Se nenhuma reserva foi configurada, avisa. Read-only.

reservas

Resumo anual em regime caixa: faturamento (TODA receita recebida no ano, inclui não-médicas como salário), despesas, saldo, taxa_poupanca_pct, imposto retido na fonte, variação vs ano anterior (null se o ano anterior não tem dado) e top categorias de receita E de despesa. Read-only.

resumo_do_ano

Recebido, despesas e saldo do mês (regime caixa: saldo = recebido − despesas), mais o imposto retido no mês. O campo a_receber_total_hoje é um snapshot de HOJE (igual em qualquer mês consultado), não do mês. Reconcilia com o Dashboard.

resumo_do_mes

Evolução mês a mês de um ano (regime caixa): recebido, despesas, saldo e imposto retido por mês, só meses com movimento. Use para comparar meses, achar tendência ou localizar em qual mês algo aconteceu — evita chamar resumo_do_mes várias vezes. Read-only.

serie_mensal

O que está AGENDADO para a frente: cirurgias, consultas, exames e plantões marcados que ainda não aconteceram (status agendado), em ordem de data e com a hora quando houver. Responde "o que tenho marcado essa semana/esse mês?". Cada item vem com o id (use em remarcar_agendamento/cancelar_agendamento). atrasado_no_sistema=true significa agendado cuja data já passou — abra o app para dar baixa (a transição automática roda no app). Read-only. Para o que JÁ aconteceu e falta receber, use listar_pendentes.

ver_agenda