apagar_categoria
ChatGPTApaga uma categoria do usuário com seus lançamentos, recorrências e metas (irreversível); categorias do sistema são só arquivadas. Esconder sem apagar: editar_categoria archived: true.
apagar_conta
ChatGPTApaga uma conta do Dinzo e TODOS os seus lançamentos, recorrências e vínculos (irreversível; o banco não é afetado). Arquivar sem apagar: editar_conta com archived: true.
apagar_lancamento
ChatGPTApaga um lançamento (real ou projetado; projeções viram exceção). Em séries, scope define o alcance. Parcelamento: hide_series oculta o plano inteiro (também do banco); um manual se encerra com scope future no id da próxima parcela. Desfaz um pagamento de fatura (no transaction_id dele). Transferência digitada entre contas sai das duas (a outra perna vai junto), salvo se o banco já mostra a mesma movimentação na conta do lançamento. Fatura projetada (mocked-bill): apagar é permanente, nenhuma tela restaura.
apagar_meta
ChatGPTApaga uma meta financeira (os lançamentos ficam intactos).
apagar_notificacao
ChatGPTApaga uma notificação (ids de listar_notificacoes). Só marcar como lida: marcar_notificacao_lida.
apagar_tag
ChatGPTApaga uma tag e remove a etiqueta de todos os lançamentos (que ficam intactos).
cancelar_lembrete
ChatGPTCancela um lembrete AGENDADO (não será mais enviado). Lembretes não são lançamentos. Localiza pelo id ou, sem id, pelo title entre os agendados.
converter_moeda
ChatGPTConverte um valor entre moedas pela cotação oficial do dia (PTAX do Banco Central pra dólar e euro, fallback aberto pras outras). Devolve a cotação, a data e a fonte usadas.
criar_assinatura
ChatGPTAcompanha no Dinzo uma assinatura do usuário (serviço cobrado todo mês): entra confirmada e soma no total mensal de assinaturas. Não assina nem contrata nada; não cria lançamentos (criar_lancamento com recurrence).
criar_categoria
ChatGPTCria uma categoria do usuário, opcionalmente como subcategoria (parent_category_id).
criar_conta
ChatGPTCadastra no Dinzo uma conta manual: bancária (BANK) ou cartão de crédito (CREDIT, com dia de fechamento e vencimento). Não abre conta nem cartão em banco. Contas Open Finance: só pelo app/web.
criar_lancamento
ChatGPTCria um lançamento: gasto ou entrada comum, compra parcelada (installments) ou recorrência (recurrence). Transferência entre contas próprias: registrar_transferencia; fatura: registrar_pagamento_fatura.
criar_lembrete
ChatGPTCria um lembrete financeiro ("me lembra de pagar o boleto dia 10"), entregue por WhatsApp ou push do app na data-hora marcada. Sem hora citada, use 09:00 em Brasília. Não é lançamento nem recorrência (criar_lancamento).
criar_meta
ChatGPTCria uma meta: INCOMING = juntar dinheiro (guardado via editar_meta add_amount), OUTGOING = limite de gasto por categoria. Sem category_id e sem account_id = limite geral (todas as despesas).
criar_tag
ChatGPTCria uma tag (etiqueta livre para lançamentos).
definir_pessoa_cartao
ChatGPTDefine quem usa um FINAL (4 últimos dígitos) de um cartão de crédito Open Finance ("Quem usa este cartão?"). Vale para TODAS as compras daquele final, passadas e futuras; nunca para uma compra avulsa. Cartões manuais não têm finais.
definir_preferencia
ChatGPTPreferência permanente do usuário para o Dino: conta padrão (default_account_id), cartão padrão (default_card_id) ou regra livre (rule:<n>, ex.: "Responder sempre em poucas linhas"). Use quando o usuário disser "sempre..."/"meu cartão principal é...".
detalhar_investimento
ChatGPTUse quando o usuário perguntar sobre um investimento específico: taxa, vencimento, custo, lucro e o histórico de movimentações (compras, vendas, juros, amortizações, impostos e transferências). Obtenha o id em listar_investimentos.
editar_assinatura
ChatGPTMuda a situação de uma assinatura só no Dinzo (não cancela nem contrata o serviço): CONFIRMED (confirma uma detectada ou reativa uma cancelada), CANCELLED (o usuário já cancelou o serviço) ou REJECTED (não é assinatura; definitivo).
editar_categoria
ChatGPTEdita uma categoria do usuário (nome, ícone, cor, hierarquia) ou arquiva/desarquiva (archived). Categorias do sistema só arquivam/desarquivam; as protegidas, nem isso.
editar_conta
ChatGPTEdita uma conta: nome, tipo, ícone, limite/fechamento/vencimento de cartão, arquivar/desarquivar (archived). Contas Open Finance têm campos bancários bloqueados.
editar_emprestimo
ChatGPTOculta ou mostra um empréstimo ou financiamento Open Finance (hidden). Ocultos saem da lista e dos totais de listar_emprestimos; os dados seguem sincronizando do banco. Ids: listar_emprestimos.
editar_investimento
ChatGPTArquiva/desarquiva uma posição de investimento Open Finance (archived). Posições arquivadas saem do total investido; os dados seguem sincronizando do banco. Ids: listar_investimentos.
editar_lancamento
ChatGPTEdita um lançamento (real ou projetado; projeções materializam ao editar). Em séries, scope define o alcance. Open Finance: só categoria, descrição, notas e tags. Regra inteira: editar_recorrencia.
editar_lancamentos_em_lote
ChatGPTAtualiza ou apaga vários lançamentos por ids ou filtros (período, categoria, conta, busca). Máximo 500 linhas. Em modo filtro, expected_count (o total confirmado pelo usuário) é obrigatório e a operação falha se o total divergir.
editar_lembrete
ChatGPTAltera um lembrete AGENDADO (nova data-hora, título e/ou recorrência) em uma única operação, sem recriá-lo. Campos ausentes ficam como estão.
editar_meta
ChatGPTEdita uma meta ou ajusta o valor guardado (não movimenta dinheiro): add_amount soma, remove_amount subtrai (metas INCOMING sem acompanhamento automático).
editar_perfil
ChatGPTAtualiza o perfil financeiro: nome, renda mensal (wage), custo de vida mensal, cônjuge, filhos, empreendedor. Campos ausentes ficam como estão; null limpa o campo.
editar_recorrencia
ChatGPTEdita uma regra de recorrência (id de listar_recorrencias): valores, categoria, descrição, intervalo e conta. UMA ocorrência: editar_lancamento no id dela.
editar_tag
ChatGPTEdita o nome e/ou a cor de uma tag.
encontrar_duplicados
ChatGPTPossíveis lançamentos duplicados (mesmo valor/descrição em dias próximos) no período: pares para o usuário revisar; nada é apagado.
evolucao_investimentos
ChatGPTUse quando o usuário perguntar como o patrimônio investido evoluiu no tempo. Série diária do total e por tipo (padrão: últimos 12 meses; janela máxima de 366 dias). Valor atual: resumo_investimentos ou listar_investimentos.
limite_cartao
ChatGPTLimite usado, limite total e disponível de um cartão de crédito. Valor da fatura: listar_faturas.
listar_assinaturas
ChatGPTAssinaturas (detectadas nos lançamentos ou criadas à mão): subscriptions traz cada uma com id (o que editar_assinatura recebe), status, source, valor, cadência, dia da cobrança, conta e final do cartão. forecast: as ativas com previsão das cobranças no período. Regras recorrentes: listar_recorrencias.
listar_categorias
ChatGPTCategorias do usuário e do sistema (system: true), hierarquia via parent_id; arquivadas vêm com archived: true.
listar_conexoes_open_finance
ChatGPTConexões Open Finance: instituição, saúde, última e próxima sincronização, validade do consentimento e contas importadas. Sincronizar agora: sincronizar_conexao_open_finance; conectar/desconectar só pelo app ou web.
listar_contas
ChatGPTContas (bancárias, cartões de crédito, dinheiro) com saldo atual. balance de cartão = limite em uso (fatura aberta + parcelas futuras), o limite usado do app, não a fatura; valor da fatura: listar_faturas. Sem investimentos (resumo_investimentos). Limite disponível: limite_cartao; totais: visao_geral.
listar_emprestimos
ChatGPTEmpréstimos e financiamentos via Open Finance: saldo devedor, parcelas pagas/total, próxima parcela, CET, taxa e datas. totals: saldo devedor, installments_this_month (próximas parcelas do mês atual BRT; installments_unknown_count = sem valor) e count. Saldo devedor fora do patrimônio e do saldo previsto.
listar_faturas
ChatGPTFaturas de cartão por ciclo no período (fechamento ou vencimento dentro dele): status "aberta", "fechada", "vencida", "paga" ou "credito" (fatura fechada a favor do cliente, valor negativo: nada a pagar, o crédito é descontado da próxima) (settled_payment_ids = pagamentos casados), projected_bill_id usável em registrar_pagamento_fatura quando ainda em aberto, amount_is_estimate true = valor estimado (cartão Open Finance sem fatura transmitida), amount_due = quanto ainda falta pagar.
listar_icones
ChatGPTÍcones para contas, cartões e categorias; id vai em criar_conta/editar_conta/criar_categoria/editar_categoria.
listar_importacoes
ChatGPTImportações de extratos e faturas (PDF, CSV, OFX, Excel) com status, motivo da falha (error_code) e free_imports_remaining (null = plano pago). Enviar arquivos: só app ou web.
listar_investimentos
ChatGPTUse quando o usuário perguntar quais investimentos tem, quanto em cada um, por banco ou tipo, ou o que vence até uma data. Todas as posições (sem limite) com custo, lucro e totais por tipo e conexão. Só um panorama (totais, top 12): resumo_investimentos. Investimentos não são contas e não aparecem em listar_contas.
listar_lancamentos
ChatGPTLançamentos do período (padrão: mês atual BRT) na visão canônica do app, com as projeções de recorrências, parcelamentos e faturas (projected: true, ids mocked-*). Máximo 366 dias. Totais: somar_lancamentos; um id: obter_lancamento.
listar_lembretes
ChatGPTLembretes financeiros: título, data/hora, recorrência e canal. Padrão: os agendados, mais próximos primeiro. Alterar: criar_lembrete, editar_lembrete, cancelar_lembrete.
listar_metas
ChatGPTMetas (INCOMING, juntar dinheiro) e limites de gasto (OUTGOING).
listar_notificacoes
ChatGPTNotificações (fatura, metas, sincronização), mais recentes primeiro, paginadas por cursor/next_cursor. Marcar lida: marcar_notificacao_lida.
listar_parcelamentos
ChatGPTPlanos de parcelamento (no cartão ou à mão): parcelas totais, pagas, restantes, valor restante (R$) e mês final, atrasado/oculto. Quitados, estornados e de contas arquivadas não aparecem. id = parcela mais recente (pode ser projeção mocked-*): vale para hide_series em apagar_lancamento, não para encerrar um parcelamento manual. Criar: criar_lancamento com installments.
listar_preferencias
ChatGPTPreferências do Dino (assistente do Dinzo): conta e cartão padrão (default_account_id, default_card_id) e regras personalizadas (rule:<n>). Alterar: definir_preferencia.
listar_proventos
ChatGPTUse quando o usuário perguntar sobre proventos: dividendos, JCP, rendimentos e juros. recebidos = creditados pelo banco via Open Finance, por mês e por ativo (padrão: mês atual); anunciados = dividendos e JCP futuros dos ativos em carteira, com valor por cota, data-com e pagamento (padrão: próximos 90 dias).
listar_recorrencias
ChatGPTRegras de lançamentos recorrentes (salário, contas fixas, parcelamentos manuais) com tags, ocorrências projetadas na janela (padrão: mês anterior até 3 meses à frente) e exceções (ocorrências suprimidas). Fora: contas arquivadas e a regra de pagamento de fatura (já projetada como fatura). Id da regra: editar_recorrencia; assinaturas detectadas: listar_assinaturas.
listar_tags
ChatGPTTags do usuário (etiquetas livres para lançamentos).
marcar_notificacao_lida
ChatGPTMarca uma notificação como lida (id) ou todas de uma vez (all: true).
marcar_transferencia
ChatGPTMarca um lançamento (e opcionalmente a contraparte) como transferência entre contas próprias: agrupa e oculta dos relatórios. unmark: true desfaz.
obter_lancamento
ChatGPTUm lançamento pelo id (de listar_lancamentos), com tags e dados da projeção.
projetar_patrimonio
ChatGPTPatrimônio projetado com juros compostos ("quando chego a R$ 1 milhão?"). Sem present_value usa o total investido. Exige target_amount ou horizon_months. Estimativa, não recomendação.
registrar_pagamento_fatura
ChatGPTNão movimenta dinheiro: só registra no Dinzo. Anota o pagamento de uma fatura de cartão: cria o débito "Pagamento de Fatura <cartão>" na conta pagadora, vinculado ao cartão. Cartão manual: qualquer ciclo (antecipação). Cartão Open Finance: só depois que o banco publicar a fatura (o banco confirma sozinho). Recebe projected_bill_id (de listar_faturas) OU card_id + cycle_date. Desfazer: apagar_lancamento no transaction_id devolvido.
registrar_transferencia
ChatGPTNão movimenta dinheiro: só registra no Dinzo. Transferência entre duas contas do próprio usuário: cria as duas pernas ocultas dos relatórios (convenção do app). Fatura de cartão: registrar_pagamento_fatura.
relatorio
ChatGPTRelatórios do período (padrão: mês atual BRT): kind "summary" = receitas, despesas e resultado; "breakdown" = totais por categoria, tag ou conta; "series" = série mensal (últimos N meses). Somar um filtro: somar_lancamentos.
resumo_investimentos
ChatGPTCarteira de investimentos: total investido, posições (holdings, até 12 maiores) e totais por tipo, via Open Finance. Cada posição traz id (editar_investimento). Todas as posições e filtros: listar_investimentos.
saldo_diario_conta
ChatGPTSaldo de fechamento de cada dia de uma conta bancária (o "saldo do dia" do extrato), do saldo atual para trás; padrão 30 dias, máximo 366. Sem dias futuros. Saldo atual: listar_contas; futuro: saldo_previsto.
saldo_previsto
ChatGPTSaldo previsto do mês: saldo base, abertura, entradas esperadas, committed_out (faturas, parcelas, assinaturas, agendados), resultado, explain e o livre por dia (reserved_for_goals = parcela mensal das metas com prazo, free_per_day; null em mês passado). Com horizon_days ou target_date projeta a curva por dias. Passado: somar_lancamentos ou relatorio.
simular_compra
ChatGPTImpacto de uma compra (à vista ou parcelada) no saldo projetado: amount e opcionalmente installments. Projeção informativa, sem veredito de compra.
sincronizar_conexao_open_finance
ChatGPTAtualização imediata de uma conexão Open Finance (ids de listar_conexoes_open_finance) quando o usuário quer os dados agora; a automática roda todo dia. Não conecta bancos (só app/web).
somar_lancamentos
ChatGPTSoma lançamentos por período/filtros na visão ledger (a soma canônica): totais de débito, crédito e líquido, contagem e maiores lançamentos. "Quanto gastei com <categoria>": category_id de listar_categorias; "no iFood": search. Agrupar por categoria/tag/conta: relatorio; saldo futuro: saldo_previsto.
ver_perfil
ChatGPTPerfil do usuário: nome, renda declarada, custo de vida mensal, dados familiares, plano (Premium/Ultra), escopos desta conexão e limites de uso.
visao_geral
ChatGPTResumo financeiro: entradas e saídas do mês atual (BRT), saldo previsto, patrimônio líquido, total investido e faturas dos próximos 30 dias. card_debt = limite em uso dos cartões (fatura aberta + parcelas futuras), o termo do net_worth; open_bills_total = faturas em aberto, o número do app. Investimentos: resumo_investimentos; saldo por conta: listar_contas.