{ "info": { "name": "Organizze — mcp.ai", "description": "REST API for the Organizze MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.mcp.ai/api/organizze", "type": "string" }, { "key": "apiKey", "value": "sk_live_...", "type": "string" } ], "item": [ { "name": "organizze_add_transactions_tags", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/add/transactions/tags", "host": [ "{{baseUrl}}" ], "path": [ "add", "transactions", "tags" ] }, "description": "Adiciona tags a VÁRIAS transações em uma chamada (acumula sobre as existentes; máx. 200). Cada item: transaction_id ou transaction_uuid + tags (string com vírgulas ou lista).", "body": { "mode": "raw", "raw": "{\n \"items\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_clone_budgets", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/clone/budgets", "host": [ "{{baseUrl}}" ], "path": [ "clone", "budgets" ] }, "description": "Clona os orçamentos do mês anterior para o mês de destino (não sobrescreve um mês que já tenha orçamentos). Padrão: mês atual.", "body": { "mode": "raw", "raw": "{\n \"month\": 0,\n \"year\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_create_account", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/create/account", "host": [ "{{baseUrl}}" ], "path": [ "create", "account" ] }, "description": "Cria uma conta bancária manual.", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"institution_id\": \"\",\n \"initial_balance\": 0,\n \"description\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_create_budget", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/create/budget", "host": [ "{{baseUrl}}" ], "path": [ "create", "budget" ] }, "description": "Cria um limite de gastos (orçamento) para uma categoria. Padrão: despesa; use activity_type 'earning' para meta de receita. Prefira o NOME da categoria.", "body": { "mode": "raw", "raw": "{\n \"category\": \"\",\n \"amount\": 0,\n \"activity_type\": \"\",\n \"month\": 0,\n \"year\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_create_category", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/create/category", "host": [ "{{baseUrl}}" ], "path": [ "create", "category" ] }, "description": "Cria uma categoria de despesa ou receita (raiz ou subcategoria via parent_id).", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"kind\": \"\",\n \"group_id\": \"\",\n \"color\": \"\",\n \"parent_id\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_create_credit_card", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/create/credit/card", "host": [ "{{baseUrl}}" ], "path": [ "create", "credit", "card" ] }, "description": "Cria um cartão de crédito MANUAL (automáticos vêm da conexão bancária). As faturas são geradas automaticamente após a criação.", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"billing_due_day\": 0,\n \"billing_cycle_day\": 0,\n \"flag\": \"\",\n \"limit\": 0,\n \"payment_account_id\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_create_transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/create/transaction", "host": [ "{{baseUrl}}" ], "path": [ "create", "transaction" ] }, "description": "Cria uma transação (receita ou despesa). Prefira NOMES de conta/cartão e categoria (list_accounts / list_credit_cards / list_categories primeiro se não souber). Nunca invente UUID/id. Ex.: account: \"N", "body": { "mode": "raw", "raw": "{\n \"description\": \"\",\n \"amount\": 0,\n \"date\": \"\",\n \"account\": \"\",\n \"category\": \"\",\n \"is_income\": false,\n \"done\": false,\n \"observation\": \"\",\n \"tags\": \"\",\n \"times\": 0,\n \"recurring\": false,\n \"periodicity\": \"\",\n \"idempotency_key\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_create_transfer", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/create/transfer", "host": [ "{{baseUrl}}" ], "path": [ "create", "transfer" ] }, "description": "Cria uma transferência entre duas contas bancárias (suporta recorrência). Prefira NOMES de conta (não invente ids). Não envolve cartões de crédito.", "body": { "mode": "raw", "raw": "{\n \"amount\": 0,\n \"date\": \"\",\n \"credit_account\": \"\",\n \"debit_account\": \"\",\n \"description\": \"\",\n \"done\": false,\n \"observation\": \"\",\n \"tags\": \"\",\n \"recurring\": false,\n \"periodicity\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_delete_account", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/delete/account", "host": [ "{{baseUrl}}" ], "path": [ "delete", "account" ] }, "description": "Exclui uma conta. ATENÇÃO: todas as transações da conta são excluídas em background. Contas automáticas não podem ser excluídas (desconecte pelo menu de conexões).", "body": { "mode": "raw", "raw": "{\n \"account\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_delete_budget", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/delete/budget", "host": [ "{{baseUrl}}" ], "path": [ "delete", "budget" ] }, "description": "Remove um orçamento (limite de gastos) de uma categoria.", "body": { "mode": "raw", "raw": "{\n \"budget_id\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_delete_category", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/delete/category", "host": [ "{{baseUrl}}" ], "path": [ "delete", "category" ] }, "description": "Exclui uma categoria; suas transações vão para outra categoria (substitute_category ou padrão). Categorias padrão NÃO podem ser excluídas. Ao excluir uma raiz, as subcategorias somem.", "body": { "mode": "raw", "raw": "{\n \"category\": \"\",\n \"substitute_category\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_delete_credit_card", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/delete/credit/card", "host": [ "{{baseUrl}}" ], "path": [ "delete", "credit", "card" ] }, "description": "Exclui um cartão de crédito. ATENÇÃO: todas as transações e faturas do cartão são excluídas. Cartões automáticos não podem ser excluídos (desconecte pelo menu de conexões).", "body": { "mode": "raw", "raw": "{\n \"credit_card\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_delete_transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/delete/transaction", "host": [ "{{baseUrl}}" ], "path": [ "delete", "transaction" ] }, "description": "Exclui uma transação. Transações automáticas (Open Finance) não podem ser excluídas. Para recorrentes use delete_recurrence. O transaction_id/uuid DEVE ser copiado de list_transactions, search_transac", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": 0,\n \"transaction_uuid\": \"\",\n \"delete_recurrence\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_find_duplicates", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/find/duplicates", "host": [ "{{baseUrl}}" ], "path": [ "find", "duplicates" ] }, "description": "Encontra transações possivelmente duplicadas (mesmo valor e descrição similar em datas próximas). Útil para limpeza de lançamentos em dobro. Padrão: mês atual.", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"days_threshold\": 0,\n \"include_automatic\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_find_installments", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/find/installments", "host": [ "{{baseUrl}}" ], "path": [ "find", "installments" ] }, "description": "Encontra COMPRAS PARCELADAS no período (use isto, não busca por texto). Combina parcelas estruturadas e heurística para Open Finance (apresentadas como \"possível parcelamento\"). Sem datas, últimos 12 ", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"account\": \"\",\n \"min_occurrences\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_find_subscriptions", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/find/subscriptions", "host": [ "{{baseUrl}}" ], "path": [ "find", "subscriptions" ] }, "description": "Detecta ASSINATURAS e serviços recorrentes (Netflix, Spotify, ChatGPT, aluguel...). Use para \"minhas assinaturas\", \"o que pago todo mês\", \"o que posso cancelar\". Funciona em contas/cartões CONECTADOS ", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"account\": \"\",\n \"min_occurrences\": 0,\n \"include_recurrences\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_account_context", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/account/context", "host": [ "{{baseUrl}}" ], "path": [ "get", "account", "context" ] }, "description": "Orientação inicial em uma só chamada: entidade conectada, plano, data de hoje no fuso do usuário, e listas compactas (id ↔ nome) de contas, cartões e categorias. Chame no início para evitar várias cha", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_balances", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/balances", "host": [ "{{baseUrl}}" ], "path": [ "get", "balances" ] }, "description": "Saldo consolidado: saldo atual de cada conta, fatura atual em aberto de cada cartão e o patrimônio (contas − faturas atuais em aberto). Base caixa; não trata parcelas/faturas futuras como dívida. Use ", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_bank_connections", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/bank/connections", "host": [ "{{baseUrl}}" ], "path": [ "get", "bank", "connections" ] }, "description": "Lista as conexões bancárias (Open Finance / Conectado) ATIVAS e o status de cada uma (estável/indisponível). Somente leitura — não força sincronização. Use para \"meu banco não atualiza\".", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_budget_summary", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/budget/summary", "host": [ "{{baseUrl}}" ], "path": [ "get", "budget", "summary" ] }, "description": "Resumo dos limites de gastos do mês com alertas de budgets excedidos ou próximos do limite (\"estou no controle?\"). Padrão: mês atual.", "body": { "mode": "raw", "raw": "{\n \"month\": 0,\n \"year\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_cashflow_forecast", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/cashflow/forecast", "host": [ "{{baseUrl}}" ], "path": [ "get", "cashflow", "forecast" ] }, "description": "Projeção de fluxo de caixa: parte do saldo atual e aplica os lançamentos não pagos de contas manuais na janela, retornando o saldo projetado ao fim e o menor ponto (risco de negativo). Base caixa; não", "body": { "mode": "raw", "raw": "{\n \"days\": 0,\n \"start_date\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_categories_evolution", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/categories/evolution", "host": [ "{{baseUrl}}" ], "path": [ "get", "categories", "evolution" ] }, "description": "Evolução de gastos/receitas por categoria ao longo do tempo (diário/semanal/mensal). Ideal para tendências. Padrão: últimos 3 meses.", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"periodicity\": \"\",\n \"category_ids\": \"\",\n \"only_parent_category\": false,\n \"lens\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_categories_report", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/categories/report", "host": [ "{{baseUrl}}" ], "path": [ "get", "categories", "report" ] }, "description": "Relatório de gastos e receitas agrupados por categoria (inclui compras de cartão; base POR LANÇAMENTO). Percentuais e subcategorias. Padrão: mês atual.", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"lens\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_credit_card_invoice", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/credit/card/invoice", "host": [ "{{baseUrl}}" ], "path": [ "get", "credit", "card", "invoice" ] }, "description": "Detalhes de uma fatura específica de cartão: transações, pagamentos e gastos por categoria. Prefira passar credit_card com o NOME do cartão.", "body": { "mode": "raw", "raw": "{\n \"credit_card\": \"\",\n \"credit_card_id\": 0,\n \"invoice_id\": 0,\n \"month\": 0,\n \"year\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_credit_card_invoices", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/credit/card/invoices", "host": [ "{{baseUrl}}" ], "path": [ "get", "credit", "card", "invoices" ] }, "description": "Lista faturas de um cartão. Informe credit_card_id.", "body": { "mode": "raw", "raw": "{\n \"credit_card_id\": 0,\n \"start_date\": \"\",\n \"end_date\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_financial_summary", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/financial/summary", "host": [ "{{baseUrl}}" ], "path": [ "get", "financial", "summary" ] }, "description": "Resumo financeiro do período (receitas, despesas, comparação, maiores gastos). Totais em base caixa; maiores gastos em base por lançamento (incluem cartão) — não somam com os totais.", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"year\": 0,\n \"month\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_income_vs_expenses", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/income/vs/expenses", "host": [ "{{baseUrl}}" ], "path": [ "get", "income", "vs", "expenses" ] }, "description": "Relatório de entradas vs saídas (receitas vs despesas) por período, em modo cashflow. Use account_id para filtrar uma conta. Padrão: mês atual. Base caixa por conta — exclui compras individuais de car", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"periodicity\": \"\",\n \"account_id\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_invoices_matrix", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/invoices/matrix", "host": [ "{{baseUrl}}" ], "path": [ "get", "invoices", "matrix" ] }, "description": "Matriz de faturas (mês × cartão) com totais por mês, por cartão e total geral, usando os mesmos valores de get_credit_card_invoices. Use quando o usuário pedir faturas de VÁRIOS cartões e/ou meses, em", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"cards\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_latest_imports", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/latest/imports", "host": [ "{{baseUrl}}" ], "path": [ "get", "latest", "imports" ] }, "description": "Transações mais recentemente importadas via Open Finance (contas/cartões conectados). Use para \"lançamentos novos/recém-importados\". Paginação via page/per_page (padrão 50, máx 100).", "body": { "mode": "raw", "raw": "{\n \"limit\": 0,\n \"page\": 0,\n \"per_page\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_monthly_overview", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/monthly/overview", "host": [ "{{baseUrl}}" ], "path": [ "get", "monthly", "overview" ] }, "description": "Visão geral do mês em uma só chamada: receitas, despesas, saldo, maiores categorias de despesa, status dos limites e contas a pagar dos próximos 7 dias. Padrão: mês atual. totals são base caixa; top_e", "body": { "mode": "raw", "raw": "{\n \"month\": 0,\n \"year\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_open_finance_status", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/open/finance/status", "host": [ "{{baseUrl}}" ], "path": [ "get", "open", "finance", "status" ] }, "description": "Status AO VIVO do agregador Open Finance (Belvo), opcionalmente por banco. Use para saber se \"o banco não atualiza\" é uma instabilidade upstream. Cacheado ~5 min.", "body": { "mode": "raw", "raw": "{\n \"institution\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_tags_report", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/tags/report", "host": [ "{{baseUrl}}" ], "path": [ "get", "tags", "report" ] }, "description": "Relatório de transações agrupadas por tag (despesas e receitas, com percentuais). Para projetos/históricos longos informe start_date e end_date amplos — o padrão é só o mês atual.", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"tag_name\": \"\",\n \"tag_name_prefix\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/transaction", "host": [ "{{baseUrl}}" ], "path": [ "get", "transaction" ] }, "description": "Detalhes completos de uma transação pelo id ou uuid.", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": 0,\n \"transaction_uuid\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_get_upcoming_bills", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/get/upcoming/bills", "host": [ "{{baseUrl}}" ], "path": [ "get", "upcoming", "bills" ] }, "description": "Contas a pagar dos próximos dias: lançamentos não pagos com vencimento na janela e faturas de cartão que vencem no período (\"o que vence essa semana?\"). Padrão: 7 dias.", "body": { "mode": "raw", "raw": "{\n \"days\": 0,\n \"start_date\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_inform_invoice_payment", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/inform/invoice/payment", "host": [ "{{baseUrl}}" ], "path": [ "inform", "invoice", "payment" ] }, "description": "Informa pagamento de fatura em cartão automático (Open Finance).", "body": { "mode": "raw", "raw": "{\n \"credit_card\": \"\",\n \"invoice_date_or_id\": \"\",\n \"date\": \"\",\n \"observation\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_list_accounts", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/list/accounts", "host": [ "{{baseUrl}}" ], "path": [ "list", "accounts" ] }, "description": "Lista as contas do usuário com ids.", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_list_budgets", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/list/budgets", "host": [ "{{baseUrl}}" ], "path": [ "list", "budgets" ] }, "description": "Lista limites de gastos por categoria. Passe year e/ou month para escopo.", "body": { "mode": "raw", "raw": "{\n \"year\": 0,\n \"month\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_list_categories", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/list/categories", "host": [ "{{baseUrl}}" ], "path": [ "list", "categories" ] }, "description": "Lista as categorias usadas para classificar transações.", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_list_credit_cards", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/list/credit/cards", "host": [ "{{baseUrl}}" ], "path": [ "list", "credit", "cards" ] }, "description": "Lista os cartões de crédito do usuário com ids e limites.", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_list_institutions", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/list/institutions", "host": [ "{{baseUrl}}" ], "path": [ "list", "institutions" ] }, "description": "Catálogo de instituições financeiras (bancos/operadoras) com o id (slug) usado em institution_id ao criar/editar contas e cartões. Use query para filtrar por nome.", "body": { "mode": "raw", "raw": "{\n \"query\": \"\",\n \"limit\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_list_recurrences", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/list/recurrences", "host": [ "{{baseUrl}}" ], "path": [ "list", "recurrences" ] }, "description": "Lista as contas fixas CADASTRADAS (lançamentos recorrentes/infinitos): aluguel, assinaturas, salário, etc., com periodicidade, valor e a próxima ocorrência. Só traz recorrências cadastradas (contas/ca", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_list_transactions", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/list/transactions", "host": [ "{{baseUrl}}" ], "path": [ "list", "transactions" ] }, "description": "Lista transações do usuário no período selecionado, com paginação (page/per_page; máximo 80 por página). Detalhes Open Finance (dados crus do banco) não são incluídos nesta listagem para economizar co", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"account_id\": 0,\n \"credit_card_id\": 0,\n \"category_id\": 0,\n \"order_by\": \"\",\n \"list_mode\": \"\",\n \"page\": 0,\n \"per_page\": 0,\n \"installments_only\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_list_transferences", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/list/transferences", "host": [ "{{baseUrl}}" ], "path": [ "list", "transferences" ] }, "description": "Lista transferências entre contas com paginação (page/per_page). Datas em YYYY-MM-DD.", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"account_id\": 0,\n \"page\": 0,\n \"per_page\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_load_skill", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/load/skill", "host": [ "{{baseUrl}}" ], "path": [ "load", "skill" ] }, "description": "Carrega um guia detalhado de uso (skill) sobre um tema do Organizze. Chame ANTES de responder quando a conversa tocar um destes temas:", "body": { "mode": "raw", "raw": "{\n \"skill_name\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_mass_create_transactions", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/mass/create/transactions", "host": [ "{{baseUrl}}" ], "path": [ "mass", "create", "transactions" ] }, "description": "Cria VÁRIAS transações em lote (máx. 100) a partir de uma lista de objetos. Use em vez de create_transaction repetido. Cada linha no array deve ser única (descrição+valor+data+conta) — dedupe no paylo", "body": { "mode": "raw", "raw": "{\n \"transactions\": \"\",\n \"idempotency_key\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_mass_delete_transactions", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/mass/delete/transactions", "host": [ "{{baseUrl}}" ], "path": [ "mass", "delete", "transactions" ] }, "description": "Exclui VÁRIAS transações por lista de ids/uuids (máx. 500). Os ids DEVEM vir de uma busca recente (list/search/find_duplicates/get_transaction) — nunca invente. Automáticas são ignoradas; recorrentes ", "body": { "mode": "raw", "raw": "{\n \"transactions\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_mass_manage_categories", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/mass/manage/categories", "host": [ "{{baseUrl}}" ], "path": [ "mass", "manage", "categories" ] }, "description": "Aplica VÁRIAS mudanças na árvore de categorias em uma chamada atômica (máx. 100 ops). Operações: create, rename, move (parent '0' = raiz), archive, unarchive (NÃO há delete — use archive). Resolve por", "body": { "mode": "raw", "raw": "{\n \"operations\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_mass_update_transactions", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/mass/update/transactions", "host": [ "{{baseUrl}}" ], "path": [ "mass", "update", "transactions" ] }, "description": "Atualiza VÁRIAS transações por FILTRO de busca (máx. 200) — prefira isto a montar listas de IDs quando a mesma alteração vale para todas as linhas. Antes, valide com list_transactions/search_transacti", "body": { "mode": "raw", "raw": "{\n \"query\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"category_id\": 0,\n \"account_id\": 0,\n \"credit_card_id\": 0,\n \"activity_type\": \"\",\n \"tag_filter\": \"\",\n \"paid_filter\": false,\n \"new_category\": \"\",\n \"new_description\": \"\",\n \"description_find\": \"\",\n \"description_replace\": \"\",\n \"new_observation\": \"\",\n \"new_tags\": \"\",\n \"tag_action\": \"\",\n \"new_paid\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_register_invoice_payment", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/register/invoice/payment", "host": [ "{{baseUrl}}" ], "path": [ "register", "invoice", "payment" ] }, "description": "Registra o pagamento de uma fatura de cartão MANUAL como lançamento, vinculado à fatura. Para cartões automáticos use inform_invoice_payment. Prefira NOMES de cartão/conta. Liste faturas com get_credi", "body": { "mode": "raw", "raw": "{\n \"credit_card\": \"\",\n \"source_account\": \"\",\n \"amount\": 0,\n \"date\": \"\",\n \"invoice_date_or_id\": \"\",\n \"observation\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_resolve_entity", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/resolve/entity", "host": [ "{{baseUrl}}" ], "path": [ "resolve", "entity" ] }, "description": "Resolve um nome aproximado para o id/uuid real de conta, cartão ou categoria. Use ANTES de uma escrita para evitar ids inventados. Quando ambíguo, retorna as correspondências.", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"kind\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_search_transactions", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/search/transactions", "host": [ "{{baseUrl}}" ], "path": [ "search", "transactions" ] }, "description": "Busca transações por texto na descrição, observação ou tags (ex.: \"iFood\", \"Uber\", \"salário\"). Paginação via page/per_page; sem datas, o padrão são os últimos 6 meses.", "body": { "mode": "raw", "raw": "{\n \"query\": \"\",\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"min_amount\": 0,\n \"max_amount\": 0,\n \"activity_type\": \"\",\n \"page\": 0,\n \"per_page\": 0,\n \"tags_only\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_set_transaction_paid", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/set/transaction/paid", "host": [ "{{baseUrl}}" ], "path": [ "set", "transaction", "paid" ] }, "description": "Marca uma transação como paga/recebida (paid=true) ou não paga (paid=false) em conta MANUAL (\"já paguei o aluguel\"). Idempotente. Transações automáticas são sempre pagas.", "body": { "mode": "raw", "raw": "{\n \"paid\": false,\n \"transaction_id\": 0,\n \"transaction_uuid\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_suggest_categories", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/suggest/categories", "host": [ "{{baseUrl}}" ], "path": [ "suggest", "categories" ] }, "description": "Sugere categorias para uma ou mais descrições de transação, usando as edições anteriores do próprio usuário, o histórico já categorizado e padrões globais. Use ANTES de create_transaction ao classific", "body": { "mode": "raw", "raw": "{\n \"items\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_transactions_list_results", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/transactions/list/results", "host": [ "{{baseUrl}}" ], "path": [ "transactions", "list", "results" ] }, "description": "Totais financeiros de um período (receitas, despesas, resultado, saldo, previstos) sem paginar transação por transação. Ideal para \"quanto gastei esse mês?\", \"qual meu saldo?\". Padrão: mês atual. Base", "body": { "mode": "raw", "raw": "{\n \"start_date\": \"\",\n \"end_date\": \"\",\n \"account_id\": 0,\n \"category_id\": 0,\n \"list_mode\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_uninform_invoice_payment", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/uninform/invoice/payment", "host": [ "{{baseUrl}}" ], "path": [ "uninform", "invoice", "payment" ] }, "description": "Desfaz um \"Informar Pagamento\" em cartão AUTOMÁTICO (marcador aguardando Open Finance). Não remove pagamentos reais já confirmados. invoice_date_or_id é obrigatório.", "body": { "mode": "raw", "raw": "{\n \"credit_card\": \"\",\n \"invoice_date_or_id\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_update_account", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/update/account", "host": [ "{{baseUrl}}" ], "path": [ "update", "account" ] }, "description": "Atualiza uma conta (nome, descrição, instituição, arquivar). Contas automáticas só permitem nome e archived. Prefira NOME (não invente id).", "body": { "mode": "raw", "raw": "{\n \"account\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"institution_id\": \"\",\n \"archived\": false,\n \"hide_balance\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_update_budget", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/update/budget", "host": [ "{{baseUrl}}" ], "path": [ "update", "budget" ] }, "description": "Atualiza o valor de um orçamento existente. amount = 0 remove o orçamento.", "body": { "mode": "raw", "raw": "{\n \"budget_id\": 0,\n \"amount\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_update_category", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/update/category", "host": [ "{{baseUrl}}" ], "path": [ "update", "category" ] }, "description": "Atualiza uma categoria (nome, cor, pai, arquivar). Categorias padrão não podem ser excluídas, mas podem ser renomeadas/arquivadas. Prefira NOME (não invente id).", "body": { "mode": "raw", "raw": "{\n \"category\": \"\",\n \"name\": \"\",\n \"color\": \"\",\n \"parent\": \"\",\n \"archived\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_update_credit_card", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/update/credit/card", "host": [ "{{baseUrl}}" ], "path": [ "update", "credit", "card" ] }, "description": "Atualiza um cartão de crédito (nome, bandeira, dias de fatura, limite, arquivar). Cartões automáticos só permitem nome e archived. Prefira NOME (não invente id).", "body": { "mode": "raw", "raw": "{\n \"credit_card\": \"\",\n \"name\": \"\",\n \"flag\": \"\",\n \"billing_due_day\": 0,\n \"billing_cycle_day\": 0,\n \"limit\": 0,\n \"payment_account_id\": 0,\n \"archived\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_update_transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/update/transaction", "host": [ "{{baseUrl}}" ], "path": [ "update", "transaction" ] }, "description": "Atualiza uma transação existente (informe só os campos a alterar). Em transações automáticas só descrição, categoria, observação e tags podem mudar. Prefira NOMES de conta/categoria (não invente ids).", "body": { "mode": "raw", "raw": "{\n \"transaction_id\": 0,\n \"transaction_uuid\": \"\",\n \"description\": \"\",\n \"amount\": 0,\n \"date\": \"\",\n \"category\": \"\",\n \"account\": \"\",\n \"paid\": false,\n \"observation\": \"\",\n \"tags\": \"\",\n \"update_recurrence\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_update_transactions_categories", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/update/transactions/categories", "host": [ "{{baseUrl}}" ], "path": [ "update", "transactions", "categories" ] }, "description": "Define a categoria de VÁRIAS transações em uma chamada, com destino por linha (máx. 200). Ideal após suggest_categories quando cada linha tem categoria diferente. Prefira category (NOME) e IDs só de l", "body": { "mode": "raw", "raw": "{\n \"updates\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "organizze_update_transactions_descriptions", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/update/transactions/descriptions", "host": [ "{{baseUrl}}" ], "path": [ "update", "transactions", "descriptions" ] }, "description": "Substitui a descrição de VÁRIAS transações em uma chamada (máx. 200). Cada item: transaction_id (ou id) OU transaction_uuid (ou uuid) + description (ou new_description). IDs só de list_transactions/se", "body": { "mode": "raw", "raw": "{\n \"updates\": \"\"\n}", "options": { "raw": { "language": "json" } } } } } ] }