MedFIN

Estima quanto você costuma cobrar por uma cirurgia a partir do SEU histórico (mesmo motor do preview de lançamento), SEM gravar nada. Responde "quanto cobrar por X na Unimed?". Devolve o valor + a confiança: bom = match forte no mesmo convênio; incerto = de outro convênio ou papel diferente; parcial = soma incompleta de códigos. Sem histórico, avisa. Read-only.

estimar_valor_cirurgia

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. Exige a confirmação descartável devolvida pela prévia.

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. Exige a confirmação descartável devolvida pela prévia.

lancar_consulta

Registra uma despesa JÁ PAGA (realizada — entra direto no saldo do mês da data; NÃO existe despesa pendente aqui, então nada a "marcar como paga" depois). Conta que vence todo mês: use lancar_despesa_recorrente. Grava de verdade. Respeita a cota do plano (erro claro se estourar). Exige a confirmação descartável devolvida pela prévia.

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. Exige a confirmação descartável devolvida pela prévia.

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. Exige a confirmação descartável devolvida pela prévia.

lancar_exame

Grava as linhas NOVAS de um lote lido de EXTRATO BANCÁRIO ou recibo de despesa (as que já existem são puladas sozinhas). Chame preview_lancar_lote antes e confirme com o médico — são muitas transações de uma vez. Repetir a mesma chamada NÃO duplica. NÃO use para guia ou demonstrativo de convênio. Exige a confirmação descartável devolvida pela prévia.

lancar_lote

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. Exige a confirmação descartável devolvida pela prévia.

lancar_plantao

Registra uma receita NÃO-médica (salário, investimentos, presente, outros) JÁ RECEBIDA no Histórico (entra direto no saldo do mês — não é agendamento). 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. Exige a confirmação descartável devolvida pela prévia.

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 (ou desmarca) a conduta do mês de um sinal do diagnóstico como FEITA — o mesmo check da aba Saúde do app, agora valendo em todos os aparelhos. Pegue o `sinal` na conduta_do_mes de diagnostico_financeiro (ex.: folego, protecao, recebimento). A marca vale só para o mês corrente e some na virada (marcar não melhora o sinal; fazer melhora). Não altera a nota nem qualquer valor. Use feita:false para desfazer. Grava de verdade. Exige a confirmação descartável devolvida pela prévia.

marcar_conduta_feita

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. Exige a confirmação descartável devolvida pela prévia.

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 Saúde do app. Se o médico nunca configurou o orçamento, avisa em vez de inventar. Read-only.

orcamento_do_mes

Mostra e vincula os argumentos exatos de uma operação que não possui prévia dedicada. Não grava nada. Depois de mostrar ao médico, use a confirmação retornada na tool de escrita correspondente.

preparar_escrita

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, recorrentes (contas e rendas fixas) e uma estimativa do custo de vida do médico (mediana do gasto mensal dos últimos meses completos, descontando o que já está previsto — nada é somado em dobro). 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

Confere um lote de transações lidas de um EXTRATO BANCÁRIO ou recibo de despesa (você leu o documento; mande as linhas aqui) SEM gravar: diz quantas são novas, quantas já estão no MedFIN, quantas vieram repetidas no próprio lote e quais parecem repetidas. Use SEMPRE antes de lancar_lote e mostre o resumo ao médico. NÃO use para guia ou demonstrativo de convênio (têm nome de paciente). Read-only.

preview_lancar_lote

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. Exige a confirmação descartável devolvida pela prévia.

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. Exige a confirmação descartável devolvida pela prévia.

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. Exige a confirmação descartável devolvida pela prévia.

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