atualizar_lancamentos
ChatGPTAltera campos de lançamentos que já existem. Só mexe no mês informado — se a despesa se repete, rode buscar_lancamentos antes e trate os outros meses também. Pode ser desfeito por 7 dias.
buscar_lancamentos
ChatGPTVarre o ano inteiro procurando por descrição e/ou faixa de valor, e devolve em que meses cada despesa aparece. É o passo obrigatório antes de alterar ou excluir algo que se repete: mostra o alcance real da mudança.
criar_lancamentos
ChatGPTGrava um ou mais lançamentos num mês. Mande o lote inteiro numa chamada só. Para uma despesa que se repete, crie no primeiro mês e depois use replicar_lancamento. Pode ser desfeito por 7 dias.
desfazer_ultima_alteracao
ChatGPTReverte a última escrita feita por aqui — recria o que foi excluído, apaga o que foi criado, devolve os valores anteriores. Só funciona dentro de 7 dias e só alcança alterações feitas por este conector.
excluir_lancamentos
ChatGPTApaga lançamentos. Só chame depois de o usuário confirmar explicitamente ('sim', 'pode excluir') — nunca por iniciativa própria. Com e_futuros apaga a série toda até dezembro. Pode ser desfeito por 7 dias.
guia_financeiro
ChatGPTLEIA ANTES de criar, alterar ou excluir qualquer lançamento. Traz as regras do FinPilot (débito × crédito, conta × cartão, receita × despesa, status por período, saldo acumulado, parcelamento), o formato exato de um lançamento campo a campo com exemplo, o passo a passo de uma despesa recorrente — mais as contas e cartões deste usuário. Chame uma vez por conversa.
listar_contas
ChatGPTContas bancárias e cartões de crédito do usuário. Ponto de partida: é daqui que saem os account_id. Um cartão sempre aponta para a conta que o paga em settlement_account_id.
listar_lancamentos
ChatGPTLançamentos do período, com filtros opcionais. Para o ano inteiro, omita mes — mas prefira buscar_lancamentos quando estiver atrás de uma despesa específica.
marcar_status
ChatGPTMarca como PAGO ou PENDENTE todos os lançamentos com uma descrição, num intervalo de meses. Fecha o fluxo da despesa recorrente: criar → replicar → marcar os meses futuros como PENDENTE.
panorama_mes
ChatGPTDossiê de um mês: todos os lançamentos mais os totais consolidados e o saldo por conta. Use quando a pergunta for sobre um mês específico.
replicar_lancamento
ChatGPTCopia um lançamento do mês de origem até dezembro — é assim que se cria uma despesa recorrente. Se for parcelado (3/12), respeita as parcelas restantes. Meses futuros entram como PENDENTE. Se já houver lançamentos com a mesma descrição, exige confirmação antes de sobrescrevê-los.
resumo_anual
ChatGPTOs 12 meses do ano numa chamada: receita, despesa de conta, despesa de cartão, saldo do mês e saldo acumulado — no total e quebrado por conta. Responde 'quanto gastei no cartão em março' sem varrer lançamento.
validar_lancamentos
ChatGPTConfere os lançamentos SEM gravar nada: descrição repetida no mês, conta inexistente, receita e despesa preenchidas juntas, valor ausente. Rode antes de criar_lancamentos — ela recusa pelos mesmos motivos, e aqui a correção sai de graça.