@databolsa/sdk 1.0.10 → 1.0.11

package/dist/schema.d.ts

@@ -1087,6 +1087,258 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/portfolio/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Histórico mensal consolidado
+         * @description Série mensal do patrimônio consolidado do dono da chave: valor de mercado, aporte acumulado, proventos recebidos e resultado realizado, mês a mês. Exclui carteiras marcadas como simulação.
+         */
+        get: operations["getPortfolioHistory"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/portfolios": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Suas carteiras
+         * @description Lista as carteiras do dono da chave (id, nome, nº de ativos, flag de simulação). Use o `id` nas demais operações de carteira.
+         */
+        get: operations["listPortfolios"];
+        put?: never;
+        /**
+         * Criar carteira
+         * @description CRIA uma carteira REAL na conta do dono da chave. O número de carteiras é limitado pelo plano (resposta 402 quando o teto é atingido). Nome único por conta (409 em duplicidade).
+         */
+        post: operations["createPortfolio"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/portfolios/import-template": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Template CSV de import manual
+         * @description Baixa o template CSV de preenchimento manual (colunas: ticker, operacao, data, quantidade, preco) aceito pelo import de planilha.
+         */
+        get: operations["getPortfolioImportTemplate"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/portfolios/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Detalhe de uma carteira
+         * @description Carteira computada: posições com preço médio, quantidade, valor de mercado, P&L, proventos e alocação, além dos totais. A posição é derivada do ledger de transações.
+         */
+        get: operations["getPortfolioDetail"];
+        put?: never;
+        post?: never;
+        /**
+         * Apagar carteira
+         * @description APAGA a carteira REAL do dono da chave, com TODOS os ativos e transações (cascata, irreversível). Confirme com o usuário antes de chamar.
+         */
+        delete: operations["deletePortfolio"];
+        options?: never;
+        head?: never;
+        /**
+         * Editar carteira
+         * @description ALTERA a carteira REAL do dono da chave: renomeia (`name`), muda a visibilidade (`visibility`) e/ou marca como simulação (`exclude_from_consolidated`, fora do consolidado). Informe ao menos um campo.
+         */
+        patch: operations["updatePortfolio"];
+        trace?: never;
+    };
+    "/v1/portfolios/{id}/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Histórico mensal de uma carteira
+         * @description Série mensal (patrimônio, aporte, proventos, realizado) de UMA carteira específica.
+         */
+        get: operations["getPortfolioHistoryById"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/portfolios/{id}/assets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Adicionar ativo à carteira
+         * @description ADICIONA um ativo à carteira REAL do dono da chave (idempotente — repetir não duplica). Ativo sem transações funciona como watchlist; lance transações para rastrear posição. Para Tesouro Direto use o nome oficial do título (ex.: TESOURO SELIC 2029).
+         */
+        post: operations["addPortfolioAsset"];
+        /**
+         * Remover ativo da carteira
+         * @description REMOVE um ativo da carteira REAL do dono da chave, APAGANDO o ledger de transações dele nesta carteira (cascata, irreversível). Confirme com o usuário antes de chamar.
+         */
+        delete: operations["removePortfolioAsset"];
+        options?: never;
+        head?: never;
+        /**
+         * Taxa contratada de renda fixa
+         * @description DEFINE a taxa contratada de uma posição de renda fixa (para o cálculo de rendimento): `rf_indexer` (cdi = % do CDI, prefixado = % a.a., ipca = IPCA + % a.a.) e `rf_rate`. Use `rf_indexer: none` para limpar.
+         */
+        patch: operations["updatePortfolioAsset"];
+        trace?: never;
+    };
+    "/v1/portfolios/{id}/transactions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Ledger de um ativo
+         * @description Lista as transações (compras, vendas, splits, ajustes) de um ativo da carteira, em ordem cronológica.
+         */
+        get: operations["listPortfolioTransactions"];
+        put?: never;
+        /**
+         * Lançar transação
+         * @description LANÇA uma transação na carteira REAL do dono da chave. Se o ativo ainda não está na carteira, ele é adicionado automaticamente — "compra de 100 PETR4" é uma única chamada. buy/sell exigem `quantity`; `price` é opcional (custo desconhecido); split usa `ratio` (2 = 2:1). Confirme valores com o usuário.
+         */
+        post: operations["addPortfolioTransaction"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/portfolios/{id}/transactions/{txId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Remover transação
+         * @description REMOVE uma transação do ledger da carteira REAL do dono da chave (irreversível). Confirme com o usuário antes de chamar.
+         */
+        delete: operations["deletePortfolioTransaction"];
+        options?: never;
+        head?: never;
+        /**
+         * Editar transação
+         * @description ALTERA uma transação existente da carteira REAL do dono da chave (patch parcial: informe só os campos a mudar). Confirme com o usuário antes de chamar.
+         */
+        patch: operations["updatePortfolioTransaction"];
+        trace?: never;
+    };
+    "/v1/portfolios/{id}/imports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Histórico de imports
+         * @description Lista os imports já feitos nesta carteira (arquivo, fonte, data e resumo persistido).
+         */
+        get: operations["listPortfolioImports"];
+        put?: never;
+        /**
+         * Importar planilha (B3 ou template manual)
+         * @description IMPORTA uma planilha para a carteira REAL do dono da chave: Negociação ou Movimentação da B3 (.xlsx) ou o template manual (.csv/.xlsx) — o formato é detectado automaticamente. Envie o arquivo em `content_base64` (máx. 8 MB). Idempotente: reenviar o mesmo arquivo não duplica lançamentos. A resposta resume o que entrou (importadas, duplicadas, ignoradas) e traz avisos.
+         */
+        post: operations["importPortfolioFile"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/portfolios/{id}/imports/{importId}/rows": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Linhas de um import
+         * @description Drill-down de um import: cada linha do arquivo com status (imported, ignored, duplicate, error) e motivo.
+         */
+        get: operations["listPortfolioImportRows"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/portfolios/{id}/reconcile": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Reconciliar posição à B3
+         * @description AJUSTA a posição calculada de um ativo à quantidade declarada pela B3 (`target_qty` na data `as_of`), inserindo um ajuste idempotente — útil quando um evento (ex.: subscrição) não veio no extrato. Confirme a quantidade com o usuário antes de chamar.
+         */
+        post: operations["reconcilePortfolioAsset"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/suitability": {
         parameters: {
             query?: never;
@@ -1878,6 +2130,90 @@ export interface components {
             unrealizedPct: number;
             assets: number;
         };
+        PortfolioListItem: {
+            id: string;
+            name: string;
+            /** @description Nº de ativos na carteira. */
+            count?: number;
+            /** Format: date-time */
+            created_at?: string;
+            /** @description true = carteira de simulação. */
+            exclude_from_consolidated?: boolean;
+        };
+        /** @description Carteira computada: posições derivadas do ledger + métricas agregadas. */
+        PortfolioDetail: {
+            id?: string;
+            name?: string;
+            patrimonio?: number;
+            invested?: number;
+            unrealizedPL?: number;
+            unrealizedPct?: number;
+            realizedPL?: number;
+            /** @description Posições com qty, preço médio, valor de mercado, P&L, proventos e peso. */
+            holdings?: Record<string, never>[];
+        };
+        PortfolioTransaction: {
+            id: string;
+            /** @description buy | sell | split | adjust */
+            kind: string;
+            /** @description AAAA-MM-DD */
+            trade_date: string;
+            quantity: number;
+            /** @description Preço unitário (null = custo desconhecido). */
+            price?: number | null;
+            fees?: number;
+            /** @description Fator do split (só kind=split). */
+            ratio?: number | null;
+            currency?: string;
+            note?: string | null;
+        };
+        PortfolioHistoryResponse: {
+            /** @description Um ponto por mês: patrimônio, aporte acumulado, proventos e realizado. */
+            points?: Record<string, never>[];
+        };
+        /** @description Resumo de um import de planilha (o detalhe linha a linha fica em listPortfolioImportRows). */
+        PortfolioImportSummary: {
+            import_id: string;
+            /** @description negociacao | movimentacao | manual (detectado pelo cabeçalho). */
+            source: string;
+            /** @description Linhas entendidas no arquivo. */
+            parsed?: number;
+            /** @description Lançamentos novos gravados. */
+            imported: number;
+            /** @description Lançamentos já existentes (reimport) pulados. */
+            duplicates_skipped?: number;
+            rows_ignored?: number;
+            /** @description Trades pulados por já estarem cobertos por outra fonte. */
+            cross_source_skipped?: number;
+            symbols?: number;
+            period?: {
+                from?: string | null;
+                to?: string | null;
+            };
+            /** @description Até 10 avisos. */
+            warnings?: string[];
+            /** @description Nº de avisos omitidos além dos 10 primeiros. */
+            warnings_truncated?: number;
+        };
+        PortfolioImportListItem: {
+            id: string;
+            filename?: string | null;
+            source: string;
+            /** Format: date-time */
+            createdAt?: string;
+            summary?: Record<string, never>;
+            warnings?: string[];
+        };
+        PortfolioImportRow: {
+            row_index: number;
+            /** @description imported | ignored | duplicate | error */
+            status: string;
+            kind?: string | null;
+            label?: string | null;
+            reason?: string | null;
+            external_id?: string | null;
+            raw?: unknown;
+        };
         /** @description Carteira consolidada do usuário (mesmo resumo que o agente de IA usa). */
         PortfolioContext: {
             hasPortfolio: boolean;
@@ -4269,6 +4605,770 @@ export interface operations {
             };
         };
     };
+    getPortfolioHistory: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Pontos mensais. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioHistoryResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    listPortfolios: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Carteiras da conta. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        portfolios?: components["schemas"]["PortfolioListItem"][];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    createPortfolio: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Nome da carteira (até 60 caracteres, único na conta). */
+                    name: string;
+                    /**
+                     * @description Visibilidade (default private).
+                     * @enum {string}
+                     */
+                    visibility?: "private" | "unlisted" | "public";
+                };
+            };
+        };
+        responses: {
+            /** @description Carteira criada. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioListItem"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getPortfolioImportTemplate: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Arquivo CSV. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/csv": string;
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getPortfolioDetail: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira (de listPortfolios). */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Carteira computada. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioDetail"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    deletePortfolio: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Carteira apagada. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        deleted?: boolean;
+                        id?: string;
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    updatePortfolio: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Novo nome (até 60 caracteres, único na conta). */
+                    name?: string;
+                    /**
+                     * @description Nova visibilidade.
+                     * @enum {string}
+                     */
+                    visibility?: "private" | "unlisted" | "public";
+                    /** @description true = carteira de simulação (fora do consolidado). */
+                    exclude_from_consolidated?: boolean;
+                };
+            };
+        };
+        responses: {
+            /** @description Campos alterados. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    getPortfolioHistoryById: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Pontos mensais. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioHistoryResponse"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    addPortfolioAsset: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Tipo do ativo.
+                     * @enum {string}
+                     */
+                    asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa";
+                    /** @description Ticker (ex.: PETR4) ou nome oficial do título do Tesouro. */
+                    symbol: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Ativo na carteira. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    removePortfolioAsset: {
+        parameters: {
+            query: {
+                /** @description Tipo do ativo. */
+                asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa";
+                /** @description Ticker ou nome do título. */
+                symbol: string;
+            };
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ativo removido. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    updatePortfolioAsset: {
+        parameters: {
+            query: {
+                /** @description Tipo do ativo (renda_fixa/tesouro). */
+                asset_type: string;
+                /** @description Código do papel. */
+                symbol: string;
+            };
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Indexador (none limpa a taxa).
+                     * @enum {string}
+                     */
+                    rf_indexer: "cdi" | "prefixado" | "ipca" | "none";
+                    /** @description Taxa (ex.: 110 = 110% do CDI; 6.2 = IPCA+6,2%). */
+                    rf_rate?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description Meta da posição. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    listPortfolioTransactions: {
+        parameters: {
+            query: {
+                /** @description Tipo do ativo. */
+                asset_type: string;
+                /** @description Ticker ou nome do título. */
+                symbol: string;
+            };
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Transações do ativo. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        transactions?: components["schemas"]["PortfolioTransaction"][];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    addPortfolioTransaction: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Tipo do ativo.
+                     * @enum {string}
+                     */
+                    asset_type: "stock" | "fii" | "bdr" | "index" | "tesouro" | "crypto" | "option" | "renda_fixa";
+                    /** @description Ticker (ex.: PETR4) ou nome oficial do título do Tesouro. */
+                    symbol: string;
+                    /**
+                     * @description Tipo da transação.
+                     * @enum {string}
+                     */
+                    kind: "buy" | "sell" | "split";
+                    /** @description Data do negócio (AAAA-MM-DD). */
+                    trade_date: string;
+                    /** @description Quantidade (> 0; obrigatória em buy/sell). */
+                    quantity?: number;
+                    /** @description Preço unitário em BRL (omita se desconhecido). */
+                    price?: number;
+                    /** @description Custos/corretagem em BRL (default 0). */
+                    fees?: number;
+                    /** @description Fator do split (2 = 2:1; 0.5 = grupamento 1:2). */
+                    ratio?: number;
+                    /** @description Observação livre (até 280 caracteres). */
+                    note?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Transação lançada. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        transaction?: components["schemas"]["PortfolioTransaction"];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    deletePortfolioTransaction: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+                /** @description Id da transação. */
+                txId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Transação removida. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        deleted?: boolean;
+                        id?: string;
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    updatePortfolioTransaction: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+                /** @description Id da transação (de listPortfolioTransactions). */
+                txId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Tipo da transação.
+                     * @enum {string}
+                     */
+                    kind?: "buy" | "sell" | "split";
+                    /** @description Data do negócio (AAAA-MM-DD). */
+                    trade_date?: string;
+                    /** @description Quantidade. */
+                    quantity?: number;
+                    /** @description Preço unitário em BRL. */
+                    price?: number;
+                    /** @description Custos em BRL. */
+                    fees?: number;
+                    /** @description Fator do split. */
+                    ratio?: number;
+                    /** @description Observação. */
+                    note?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Transação atualizada. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioTransaction"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    listPortfolioImports: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Imports da carteira. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        imports?: components["schemas"]["PortfolioImportListItem"][];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    importPortfolioFile: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Conteúdo do arquivo em base64. */
+                    content_base64: string;
+                    /** @description Nome do arquivo (ajuda a trilha de auditoria). */
+                    filename?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Resumo do import. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioImportSummary"];
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    listPortfolioImportRows: {
+        parameters: {
+            query?: {
+                /** @description Filtra por status. */
+                status?: "imported" | "ignored" | "duplicate" | "error";
+                /** @description Linhas por página (1–500, default 100). */
+                limit?: number;
+                /** @description Offset de paginação. */
+                offset?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+                /** @description Id do import (de listPortfolioImports). */
+                importId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Linhas do import. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        total?: number;
+                        rows?: components["schemas"]["PortfolioImportRow"][];
+                    };
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
+    reconcilePortfolioAsset: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Id da carteira. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Tipo do ativo. */
+                    asset_type: string;
+                    /** @description Ticker. */
+                    symbol: string;
+                    /** @description Quantidade declarada pela B3 (>= 0). */
+                    target_qty: number;
+                    /** @description Data de referência (AAAA-MM-DD). */
+                    as_of: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Resultado do ajuste (delta aplicado). */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": Record<string, never>;
+                };
+            };
+            /** @description Erro (RFC 9457 application/problem+json) */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": Record<string, never>;
+                };
+            };
+        };
+    };
     getSuitability: {
         parameters: {
             query?: never;