Dinzo

Cadastra 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_conta

Cria 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_lancamento

Cria 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_lembrete

Cria 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_meta

Cria uma tag (etiqueta livre para lançamentos).

criar_tag

Define 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_pessoa_cartao

Preferê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 é...".

definir_preferencia

Use 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.

detalhar_investimento

Muda 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_assinatura

Edita uma categoria do usuário (nome, ícone, cor, hierarquia) ou arquiva/desarquiva (`archived`). Categorias do sistema só arquivam/desarquivam; as protegidas, nem isso.

editar_categoria

Edita uma conta: nome, tipo, ícone, limite/fechamento/vencimento de cartão, arquivar/desarquivar (`archived`). Contas Open Finance têm campos bancários bloqueados.

editar_conta

Oculta 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_emprestimo

Arquiva/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_investimento

Edita 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_lancamento

Atualiza 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_lancamentos_em_lote

Altera 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_lembrete

Edita uma meta ou ajusta o valor guardado (não movimenta dinheiro): `add_amount` soma, `remove_amount` subtrai (metas INCOMING sem acompanhamento automático).

editar_meta

Atualiza 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_perfil

Edita 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_recorrencia

Edita o nome e/ou a cor de uma tag.

editar_tag

Possíveis lançamentos duplicados (mesmo valor/descrição em dias próximos) no período: pares para o usuário revisar; nada é apagado.

encontrar_duplicados

Use 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.

evolucao_investimentos

Carteira 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.

resumo_investimentos

Limite usado, limite total e disponível de um cartão de crédito. Valor da fatura: listar_faturas.

limite_cartao

Assinaturas (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_assinaturas

Categorias do usuário e do sistema (`system: true`), hierarquia via `parent_id`; arquivadas vêm com `archived: true`.

listar_categorias

Conexõ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_conexoes_open_finance

Contas (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_contas

Empré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_emprestimos

Faturas 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_faturas

Importaçõ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_importacoes

Use 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_investimentos

Lanç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_lancamentos

Lembretes 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_lembretes

Metas (INCOMING, juntar dinheiro) e limites de gasto (OUTGOING).

listar_metas

Notificações (fatura, metas, sincronização), mais recentes primeiro, paginadas por `cursor`/`next_cursor`. Marcar lida: marcar_notificacao_lida.

listar_notificacoes

Planos 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_parcelamentos

Preferê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_preferencias

Use 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_proventos

Regras 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_recorrencias