# QI Tech — Investment-as-a-Service › Ativo / Cotas de Fundo Documentação da QI Tech em texto corrido, para colar em um LLM. Fonte: https://docs.qitech.com.br 7 página(s). Índice: - Consulta de Aplicações Financeiras por Classe de Fundo (/documentation/iaas/cotas_de_fundo/consulta_paginada_aplicacoes_financeiras) - Consulta de Resgates por Classe de Fundo (/documentation/iaas/cotas_de_fundo/consulta_paginada_resgates) - Consulta de Séries de Emissão (/documentation/iaas/cotas_de_fundo/consulta_paginada_series_de_emissao) - Consulta de Posições em Cotas de Fundo (/documentation/iaas/cotas_de_fundo/consulta_posicoes_cotas_de_fundo) - Introdução (/documentation/iaas/cotas_de_fundo/inicio) - Criar Aplicação Financeira (/documentation/iaas/cotas_de_fundo/operacao_aplicacoes_financeiras) - Criar Pedido de Resgate (/documentation/iaas/cotas_de_fundo/operacao_resgates) --- # Consulta de Aplicações Financeiras por Classe de Fundo URL: /documentation/iaas/cotas_de_fundo/consulta_paginada_aplicacoes_financeiras Retorna, paginadas, as aplicações financeiras que a sua classe de fundo fez em cotas de outros fundos. :::info Disponível em | Perfil | Host | Permissão exigida | | ----------- | ---------------- | ---------------------------------------------------------------------------- | | Gestora | `manager-api` | Leitura | | Consultoria | `consultant-api` | Ler Aplicações, Resgates e Séries | URL base de cada host: [Ambientes (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_applications MÉTODO GET ### Query Params | Parâmetro | Tipo | Descrição | | ---------------------------------- | ----- | -------------------------------------------------------------------------------------------------- | | `page` | int | Número da página, a partir de `0`. Padrão: `0`. | | `limit` | int | Registros por página. Padrão: `10`. Máximo: `50`. | | `quotation_date` | data | Data de cotização exata (`YYYY-MM-DD`). | | `quotation_date_from` | data | Data de cotização inicial (`YYYY-MM-DD`). | | `quotation_date_to` | data | Data de cotização final (`YYYY-MM-DD`). Não pode ser anterior a `quotation_date_from`. | | `financial_application_status` | lista | Status a incluir, separados por vírgula (ex.: `pending_manager_approval,pending_payment`). | | `not_financial_application_status` | lista | Status a excluir, separados por vírgula. | | `document_number` | string | CNPJ da classe do fundo investido, com pontuação. Correspondência exata. | | `internal_codes` | lista | Códigos internos das séries investidas, separados por vírgula. | | `asset_type` | string | Tipo do ativo (ex.: `fidc_fund_quota`, `multi_market_fund_quota`). | | `sub_class_name` | lista | Nomes de subclasse da série investida, separados por vírgula (sem diferenciar acento e maiúscula). | | `search` | string | Busca parcial no nome curto do fundo investido, no nome da série, no código interno ou no CNPJ. | Os status possíveis estão em [Criar Aplicação Financeira](/documentation/iaas/cotas_de_fundo/operacao_aplicacoes_financeiras#response). ## Response STATUS 200 Caso 01: Retorno com uma aplicação ```json { "data": [ { "amount": 0.00, "financial_application_key": "UUID", "asset_key": "UUID", "quotation_date": "YYYY-MM-DD", "status": "confirmed", "issuance_serie": { "issuance_serie_key": "UUID", "name": "Invested Issuance Serie Name", "subclass_name": "Invested Sub Class Name", "serie": 1, "quota_calculation_method": "quota_value", "internal_code": "Internal Code", "fund_class_name": "Invested Fund Class Name", "fund_class_short_name": "Invested Fund Class short name", "fund_class_document_number": "00.000.000/0000-00", "minimum_share_capital": 0.0, "investment_category": "multi_market", "payment_type": "transfer", "account_data": { "account_digit": "0", "account_branch": "0001", "account_number": "12345", "financial_institution_code": "329", "financial_institution_ispb": "00000000" }, "last_updated_date": "YYYY-MM-DD", "administrator": { "administrator_key": "UUID", "name": "Administrator Name", "document_number": "00.000.000/0000-00" }, "operation_periods": { "redemption_request": { "payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" }, "quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" } }, "amortization_request": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } }, "financial_application": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } } }, "isin_code": "BR000000000" }, "fund_class": { "fund_class_key": "UUID", "name": "Fund Class Name", "short_name": "Fund Class Short Name", "document_number": "00.000.000/0000-00", "accounting_date": "YYYY-MM-DD", "distributor": { "name": "Distributor Name", "distributor_key": "UUID", "document_number": "00.000.000/0000-00" }, "manager": { "manager_key": "UUID", "manager_name": "Manager Name", "document_number": "00.000.000/0000-00" } } } ], "limit": 10, "page": 0, "is_last_page": true } ``` ### Page | Campo | Tipo | Descrição | |---------------|--------|------------------------------------------------------------------------------| | `data` | array | Lista de objetos de **[Financial Application](#financial_application)** | | `limit` | int | Limite de objetos recuperados por página | | `page` | int | Número da página recuperada | | `is_last_page`| boolean| Informação que indica se a página recuperada é a última | ### Financial Application {#financial_application} | Campo | Tipo | Descrição | | ------------------------------------ | ------ | ----------------------------------------------- | | amount | float | Valor aplicado | | financial_application_key | string | Chave única da aplicação financeira | | asset_key | string | Chave do ativo relacionado | | quotation_date | string | Data de cotização (YYYY-MM-DD) | | payment_date | string | Data de pagamento (YYYY-MM-DD) | | payment_method | string | `wire_transfer` ou `pix` | | payment_type | string | `transfer` ou `automatic_debit` | | status | string | Status da aplicação | | external_financial_application_key | string | Identificador externo da aplicação financeira | | iof_amount | float | IOF da aplicação; presente quando calculado | | number_of_quotas | float | Quantidade de cotas; presente após a cotização | | issuance_serie | JSON | Objeto de **[Issuance Serie](#issuance-serie)** | | fund_class | JSON | Objeto de **[Fund Class](#fund-class)** | ### Issuance Serie | Campo | Tipo | Descrição | | ----------------------------- | ------ | ----------------------------------------------------- | | issuance_serie_key | string | Chave única da série de emissão | | name | string | Nome da série de emissão | | subclass_name | string | Nome da subclasse (ex: SUBORDINADA) | | serie | int | Número da série | | quota_calculation_method | string | Método de cálculo da cota (ex: quota_value) | | internal_code | string | Código interno da série | | fund_class_name | string | Nome da classe do fundo associado à série | | fund_class_short_name | string | Nome curto da classe do fundo | | fund_class_document_number | string | CNPJ da classe do fundo | | minimum_share_capital | float | Valor mínimo para aplicação | | investment_category | string | Categoria do investimento (ex: multi_market) | | payment_type | string | Tipo de pagamento (ex: transfer) | | account_data | JSON | Objeto de **[Account Data](#account-data)** | | last_updated_date | string | Última data de atualização (YYYY-MM-DD) | | administrator | JSON | Objeto de **[Administrator](#administrator)** | | operation_periods | JSON | Objeto de **[Operation Periods](#operation-periods)** | | isin_code | string | Código ISIN da série | ### Administrator | Campo | Tipo | Descrição | | ------------------ | ------ | ---------------------------- | | administrator_key | string | Chave única do administrador | | name | string | Nome do administrador | | document_number | string | CNPJ do administrador | ### Operation Periods | Campo | Tipo | Descrição | | ---------------------- | ---- | -------------------------------------------------------------------------------------- | | redemption_request | JSON | Objeto de períodos de **[Cotização e Pagamento](#quotation-and-payment)** para resgates| | amortization_request | JSON | Objeto de períodos de **[Cotização e Pagamento](#quotation-and-payment)** amortizações | | financial_application | JSON | Objeto de períodos de **[Cotização e Pagamento](#quotation-and-payment)** aplicações | ### Quotation and Payment | Campo | Tipo | Descrição | | -------------- | ------ | ------------------------------------------------ | | days | int | Quantidade de dias | | type | string | Tipo de contagem (ex: fixed, until) | | calendar_base | string | Base de calendário (ex: workdays, calendar_365) | ### Account Data | Campo | Tipo | Descrição | | ---------------------------- | ------ | ----------------------------------------------------------------- | | account_digit | string | Dígito da conta bancária | | account_branch | string | Número da agência bancária | | account_number | string | Número da conta bancária | | financial_institution_code | string | Código da instituição financeira | | financial_institution_ispb | string | ISPB da instituição financeira (Sistema de Pagamentos Brasileiro) | ### Fund Class | Campo | Tipo | Descrição | | ---------------- | ------ | ----------------------------------------- | | fund_class_key | string | Chave única da classe de fundo | | name | string | Nome completo da classe de fundo | | short_name | string | Nome curto da classe de fundo | | document_number | string | CNPJ da classe de fundo | | accounting_date | string | Data contábil mais recente | | distributor | JSON | Objeto de **[Distributor](#distributor)** | | manager | JSON | Objeto de **[Manager](#manager)** | ### Distributor | Campo | Tipo | Descrição | | ---------------- | ------ | --------------------------- | | name | string | Nome do distribuidor | | distributor_key | string | Chave única do distribuidor | | document_number | string | CNPJ do distribuidor | ### Manager | Campo | Tipo | Descrição | | ---------------- | ------ | --------------------------------- | | manager_key | string | Chave única do gestor | | manager_name | string | Nome do gestor da classe de fundo | | document_number | string | CNPJ do gestor | ## Erros | Status | Código | Quando acontece | | ------ | ----------- | ------------------------------------------------------------ | | 400 | `TFQ000218` | `quotation_date_from` posterior a `quotation_date_to`. | | 403 | `TFQ000054` | A classe de fundo não pertence à sua gestora. | | 404 | `TFQ000005` | Classe de fundo não encontrada. | Erros de autenticação, permissão e host: veja [Erros da API](/documentation/iaas/introducao/erros). --- # Consulta de Resgates por Classe de Fundo URL: /documentation/iaas/cotas_de_fundo/consulta_paginada_resgates Retorna, paginadas, os pedidos de resgate que a sua classe de fundo fez em cotas de outros fundos. :::info Disponível em | Perfil | Host | Permissão exigida | | ----------- | ---------------- | ---------------------------------------------------------------------------- | | Gestora | `manager-api` | Leitura | | Consultoria | `consultant-api` | Ler Aplicações, Resgates e Séries | URL base de cada host: [Ambientes (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_requests MÉTODO GET ### Query Params | Parâmetro | Tipo | Descrição | | ------------------------------- | ------ | -------------------------------------------------------------------------------------------------- | | `page` | int | Número da página, a partir de `0`. Padrão: `0`. | | `limit` | int | Registros por página. Padrão: `10`. Máximo: `50`. | | `quotation_date` | data | Data de cotização exata (`YYYY-MM-DD`). | | `quotation_date_from` | data | Data de cotização inicial (`YYYY-MM-DD`). | | `quotation_date_to` | data | Data de cotização final (`YYYY-MM-DD`). | | `redemption_request_status` | lista | Status a incluir, separados por vírgula. | | `not_redemption_request_status` | lista | Status a excluir, separados por vírgula. | | `document_number` | string | CNPJ da classe do fundo investido, com pontuação. Correspondência exata. | | `internal_codes` | lista | Códigos internos das séries investidas, separados por vírgula. | | `asset_type` | string | Tipo do ativo (ex.: `fidc_fund_quota`, `multi_market_fund_quota`). | | `sub_class_name` | lista | Nomes de subclasse da série investida, separados por vírgula (sem diferenciar acento e maiúscula). | | `search` | string | Busca parcial no nome curto do fundo investido, no nome da série, no código interno ou no CNPJ. | Os status possíveis estão em [Criar Pedido de Resgate](/documentation/iaas/cotas_de_fundo/operacao_resgates#response). ## Response STATUS 200 Caso 01: Retorno com um resgate ```json { "data": [ { "redemption_request_key": "UUID", "status": "confirmed", "quotation_date": "YYYY-MM-DD", "payment_date": "YYYY-MM-DD", "amount": 0.00, "issuance_serie": { "issuance_serie_key": "UUID", "name": "Issuance Serie Name", "subclass_name": "SUBORDINADA", "serie": 1, "quota_calculation_method": "quota_value", "internal_code": "Internal Code", "fund_class_name": "Fund Class Name", "fund_class_short_name": "Fund Class Short Name", "fund_class_document_number": "00.000.000/0000-00", "minimum_share_capital": 0.0, "investment_category": "fixed_income", "payment_type": "automatic_debit", "financial_institution_code": "341", "account_data": { "account_digit": "0", "account_branch": "0001", "account_number": "12345", "financial_institution_code": "329", "financial_institution_ispb": "00000000" }, "last_updated_date": "YYYY-MM-DD", "administrator": { "administrator_key": "UUID", "name": "Administrator Name", "document_number": "00.000.000/0000-00" }, "operation_periods": { "redemption_request": { "payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" }, "quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" } }, "amortization_request": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } }, "financial_application": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } } } }, "fund_class": { "fund_class_key": "UUID", "name": "Fund Class Name", "short_name": "Fund Class Short Name", "document_number": "00.000.000/0000-00", "accounting_date": "YYYY-MM-DD", "distributor": { "name": "Distributor Name", "distributor_key": "UUID", "document_number": "00.000.000/0000-00" }, "manager": { "manager_key": "UUID", "manager_name": "Manager Name", "document_number": "00.000.000/0000-00" } } } ], "limit": 10, "page": 0, "is_last_page": true } ``` ### Page | Campo | Tipo | Descrição | | -------------- | ------- | ----------------------------------------------------------------- | | `data` | array | Lista de objetos de **[Redemption Request](#redemption-request)** | | `limit` | int | Limite de objetos recuperados por página | | `page` | int | Número da página recuperada | | `is_last_page` | boolean | Informação que indica se a página recuperada é a última | ### Redemption Request | Campo | Tipo | Descrição | | ---------------------------------- | ------ | ----------------------------------------------- | | redemption_request_key | string | Chave única do pedido de resgate | | external_redemption_request_key | string | Chave externa de controle (opcional) | | status | string | Status do pedido de resgate (ex: confirmed) | | quotation_date | string | Data da cotização do resgate | | payment_date | string | Data do pagamento do resgate | | amount | float | Valor resgatado | | redeem_all | boolean | `true` quando o pedido é de resgate total; omitido nos demais | | cash_expectation | JSON | Expectativa de caixa do resgate; presente quando criada | | issuance_serie | JSON | Objeto de **[Issuance Serie](#issuance-serie)** | | fund_class | JSON | Objeto de **[Fund Class](#fund-class)** | ### Issuance Serie | Campo | Tipo | Descrição | | ----------------------------- | ------ | ----------------------------------------------------- | | issuance_serie_key | string | Chave única da série de emissão | | name | string | Nome da série de emissão | | subclass_name | string | Nome da subclasse (ex: SUBORDINADA) | | serie | int | Número da série | | quota_calculation_method | string | Método de cálculo da cota (ex: quota_value) | | internal_code | string | Código interno da série | | fund_class_name | string | Nome da classe do fundo associado à série | | fund_class_short_name | string | Nome curto da classe do fundo | | fund_class_document_number | string | CNPJ da classe do fundo | | minimum_share_capital | float | Valor mínimo para aplicação | | investment_category | string | Categoria do investimento (ex: multi_market) | | payment_type | string | Tipo de pagamento (ex: transfer) | | account_data | JSON | Objeto de **[Account Data](#account-data)** | | last_updated_date | string | Última data de atualização (YYYY-MM-DD) | | administrator | JSON | Objeto de **[Administrator](#administrator)** | | operation_periods | JSON | Objeto de **[Operation Periods](#operation-periods)** | | isin_code | string | Código ISIN da série | ### Administrator | Campo | Tipo | Descrição | | ------------------ | ------ | ---------------------------- | | administrator_key | string | Chave única do administrador | | name | string | Nome do administrador | | document_number | string | CNPJ do administrador | ### Operation Periods | Campo | Tipo | Descrição | | ---------------------- | ---- | -------------------------------------------------------------------------------------- | | redemption_request | JSON | Objeto de períodos de **[Cotização e Pagamento](#quotation-and-payment)** para resgates| | amortization_request | JSON | Objeto de períodos de **[Cotização e Pagamento](#quotation-and-payment)** amortizações | | financial_application | JSON | Objeto de períodos de **[Cotização e Pagamento](#quotation-and-payment)** aplicações | ### Quotation and Payment | Campo | Tipo | Descrição | | -------------- | ------ | ------------------------------------------------ | | days | int | Quantidade de dias | | type | string | Tipo de contagem (ex: fixed, until) | | calendar_base | string | Base de calendário (ex: workdays, calendar_365) | ### Account Data | Campo | Tipo | Descrição | | ---------------------------- | ------ | ----------------------------------------------------------------- | | account_digit | string | Dígito da conta bancária | | account_branch | string | Número da agência bancária | | account_number | string | Número da conta bancária | | financial_institution_code | string | Código da instituição financeira | | financial_institution_ispb | string | ISPB da instituição financeira (Sistema de Pagamentos Brasileiro) | ### Fund Class | Campo | Tipo | Descrição | | ---------------- | ------ | ----------------------------------------- | | fund_class_key | string | Chave única da classe de fundo | | name | string | Nome completo da classe de fundo | | short_name | string | Nome curto da classe de fundo | | document_number | string | CNPJ da classe de fundo | | accounting_date | string | Data contábil mais recente | | distributor | JSON | Objeto de **[Distributor](#distributor)** | | manager | JSON | Objeto de **[Manager](#manager)** | ### Distributor | Campo | Tipo | Descrição | | ---------------- | ------ | --------------------------- | | name | string | Nome do distribuidor | | distributor_key | string | Chave única do distribuidor | | document_number | string | CNPJ do distribuidor | ### Manager | Campo | Tipo | Descrição | | ---------------- | ------ | --------------------------------- | | manager_key | string | Chave única do gestor | | manager_name | string | Nome do gestor da classe de fundo | | document_number | string | CNPJ do gestor | ## Erros | Status | Código | Quando acontece | | ------ | ----------- | ------------------------------------------------------------ | | 400 | `TFQ000218` | `quotation_date_from` posterior a `quotation_date_to`. | | 403 | `TFQ000054` | A classe de fundo não pertence à sua gestora. | | 404 | `TFQ000005` | Classe de fundo não encontrada. | Erros de autenticação, permissão e host: veja [Erros da API](/documentation/iaas/introducao/erros). --- # Consulta de Séries de Emissão URL: /documentation/iaas/cotas_de_fundo/consulta_paginada_series_de_emissao Retorna, paginadas, as séries de emissão de fundos cadastradas para aplicação em cotas. Use o `issuance_serie_key` devolvido para [criar uma aplicação](/documentation/iaas/cotas_de_fundo/operacao_aplicacoes_financeiras) ou [um pedido de resgate](/documentation/iaas/cotas_de_fundo/operacao_resgates). :::info Disponível em | Perfil | Host | Permissão exigida | | ----------- | ---------------- | ---------------------------------------------------------------------------- | | Gestora | `manager-api` | Leitura | | Consultoria | `consultant-api` | Ler Aplicações, Resgates e Séries | Na consultoria, a lista traz só as séries das classes de fundo vinculadas à consultoria; sem vínculo, `data` vem vazio. URL base de cada host: [Ambientes (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /trade_fund_quota/issuance_series MÉTODO GET ### Query Params | Parâmetro | Tipo | Descrição | | ---------------------------- | ------ | ------------------------------------------------------------------------------------------------------ | | `page` | int | Número da página, a partir de `0`. Padrão: `0`. | | `limit` | int | Registros por página. Padrão: `10`. Máximo: `100`. | | `fund_class_document_number` | string | CNPJ do fundo da série, com pontuação (ex.: `11.222.333/0001-81`). Correspondência parcial. | | `fund_class_name` | string | Nome do fundo da série. Correspondência parcial. | | `internal_code` | string | Código interno da série. Correspondência parcial. | | `internal_codes` | lista | Códigos internos, separados por vírgula. Correspondência exata. | | `status` | lista | Status a incluir: `created`, `active`, `inactive`, `pre_operational`. Sem este filtro, séries `inactive` não são retornadas. | | `not_status` | lista | Status a excluir, separados por vírgula. | | `sub_class_name` | lista | Nomes de subclasse, separados por vírgula (sem diferenciar acento e maiúscula). | | `search` | string | Busca parcial no nome curto do fundo, no nome da série, no código interno ou no CNPJ. | ## Response STATUS 200 Caso 01: Retorno com uma série ```json { "data": [ { "issuance_serie_key": "UUID", "name": "Invested Issuance Serie Name", "subclass_name": "Invested Sub Class Name", "serie": 1, "quota_calculation_method": "quota_value", "condominium_type": "open_ended", "internal_code": "Internal Code", "fund_class_name": "Invested Fund Class Name", "fund_class_short_name": "Invested Fund Class short name", "fund_class_document_number": "00.000.000/0000-00", "minimum_share_capital": 0.0, "investment_category": "multi_market", "asset_type": "multi_market_fund_quota", "payment_type": "transfer", "status": "active", "financial_institution_code": "329", "account_data": { "account_digit": "0", "account_branch": "0001", "account_number": "12345", "financial_institution_code": "329", "financial_institution_ispb": "00000000" }, "last_updated_date": "YYYY-MM-DD", "administrator": { "administrator_key": "UUID", "name": "Administrator Name", "document_number": "00.000.000/0000-00", "status": "active" }, "operation_periods": { "redemption_request": { "payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" }, "quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" } }, "amortization_request": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } }, "financial_application": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } } }, "isin_code": "BR000000000" } ], "limit": 10, "page": 0, "is_last_page": true } ``` ### Page | Campo | Tipo | Descrição | |---------------|--------|------------------------------------------------------------------------------| | `data` | array | Lista de objetos de **[Issuance Serie](#issuance_serie)** | | `limit` | int | Limite de objetos recuperados por página | | `page` | int | Número da página recuperada | | `is_last_page`| boolean| Informação que indica se a página recuperada é a última | ### Issuance Serie {#issuance_serie} | Campo | Tipo | Descrição | | ----------------------------- | ------ | ----------------------------------------------------- | | issuance_serie_key | string | Chave única da série de emissão | | name | string | Nome da série de emissão | | subclass_name | string | Nome da subclasse (ex: SUBORDINADA) | | serie | int | Número da série | | quota_calculation_method | string | Método de cálculo da cota (ex: quota_value) | | internal_code | string | Código interno da série | | fund_class_name | string | Nome da classe do fundo associado à série | | fund_class_short_name | string | Nome curto da classe do fundo | | fund_class_document_number | string | CNPJ da classe do fundo | | minimum_share_capital | float | Valor mínimo para aplicação | | investment_category | string | Categoria do investimento (ex: multi_market) | | payment_type | string | Tipo de pagamento (ex: transfer) | | account_data | JSON | Objeto de **[Account Data](#account-data)** | | last_updated_date | string | Última data de atualização (YYYY-MM-DD) | | administrator | JSON | Objeto de **[Administrator](#administrator)** | | operation_periods | JSON | Objeto de **[Operation Periods](#operation-periods)** | | isin_code | string | Código ISIN da série | | condominium_type | string | `open_ended` (aberto) ou `close_ended` (fechado). Só séries `open_ended` aceitam resgate. | | asset_type | string | Tipo do ativo (ex.: `multi_market_fund_quota`) | | status | string | `created`, `active`, `inactive` ou `pre_operational` | | financial_institution_code | string | Código da instituição financeira usada no débito automático | ### Administrator | Campo | Tipo | Descrição | | ------------------ | ------ | ---------------------------- | | administrator_key | string | Chave única do administrador | | name | string | Nome do administrador | | document_number | string | CNPJ do administrador | | status | string | `active` ou `blocked` | ### Operation Periods | Campo | Tipo | Descrição | | ---------------------- | ---- | -------------------------------------------------------------------------------------- | | redemption_request | JSON | Objeto de períodos de **[Cotização e Pagamento](#quotation-and-payment)** para resgates| | amortization_request | JSON | Objeto de períodos de **[Cotização e Pagamento](#quotation-and-payment)** amortizações | | financial_application | JSON | Objeto de períodos de **[Cotização e Pagamento](#quotation-and-payment)** aplicações | ### Quotation and Payment | Campo | Tipo | Descrição | | -------------- | ------ | ------------------------------------------------ | | days | int | Quantidade de dias | | type | string | Tipo de contagem (ex: fixed, until) | | calendar_base | string | Base de calendário (ex: workdays, calendar_365) | ### Account Data | Campo | Tipo | Descrição | | ---------------------------- | ------ | ----------------------------------------------------------------- | | account_digit | string | Dígito da conta bancária | | account_branch | string | Número da agência bancária | | account_number | string | Número da conta bancária | | financial_institution_code | string | Código da instituição financeira | | financial_institution_ispb | string | ISPB da instituição financeira (Sistema de Pagamentos Brasileiro) | ## Erros | Status | Código | Quando acontece | | ------ | ----------- | ------------------------------------------------------ | | 404 | `TFQ000002` | A gestora da integração não está cadastrada na plataforma. | Erros de autenticação, permissão e host: veja [Erros da API](/documentation/iaas/introducao/erros). --- # Consulta de Posições em Cotas de Fundo URL: /documentation/iaas/cotas_de_fundo/consulta_posicoes_cotas_de_fundo Retorna, para cada fundo investido, **quanto o seu fundo tem aplicado**: o valor atualizado da posição em reais, a quantidade de cotas e a data da última marcação. Diferente da consulta de aplicações financeiras, que lista operação por operação, aqui a resposta já vem consolidada por série de emissão do fundo investido. É a consulta indicada para saber o saldo aplicado em um **fundo de zeragem** — veja [Consultando a posição em um fundo de zeragem](#fundo-de-zeragem). :::info Disponível em | Perfil | Host | Permissão exigida | | ------- | ------------- | ----------------- | | Gestora | `manager-api` | Leitura | URL base de cada host: [Ambientes (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /wallet/fund_class/FUND_CLASS_KEY/fund_quota_positions MÉTODO GET Onde `FUND_CLASS_KEY` é a chave da **sua** classe de fundo, aquela que detém as cotas. ### Query Params | Parâmetro | Tipo | Descrição | Obrigatório | | --------------------- | ------ | ------------------------------------------------------------------------------------------- | ----------- | | `page` | int | Número da página. Começa em `0`. Padrão: `0`. | Não | | `limit` | int | Quantidade de registros por página. Máximo: `50`. Padrão: `10`. | Não | | `document_number` | string | CNPJ da classe do fundo investido, com pontuação. Correspondência exata. | Não | | `internal_code` | string | Código interno da série investida. Correspondência parcial. | Não | | `internal_codes` | lista | Lista de códigos internos. Correspondência exata. | Não | | `fund_class_name` | string | Nome da classe do fundo investido. Correspondência parcial. | Não | | `subclass_name` | lista | Senioridade da subclasse investida: `senior`, `mezzanine`, `subordinate`. | Não | | `investment_category` | lista | Categoria do fundo investido: `fidc`, `fiagro`, `multi_market`, `fixed_income`, `private_equity`, `equity`, `real_state`. | Não | | `asset_types` | lista | Tipo do ativo: `fidc_fund_quota`, `fiagro_fund_quota`, `multi_market_fund_quota`, `fixed_income_fund_quota`, `private_equity_fund_quota`. | Não | ```python title="Exemplo de chamada" GET /wallet/fund_class/{fund_class_key}/fund_quota_positions?document_number=11.222.333/0001-81 ``` :::info Atenção Somente posições em ativos **ativos** entram no resultado. Cotas totalmente resgatadas ou baixadas não aparecem. ::: ## Response STATUS 200 ```json title='Response Body' { "data": [ { "quota_fund_class": { "name": "Série Única", "quota_fund_class_key": "UUID", "document_number": "00.000.000/0000-00", "fund_class_name": "Invested Fund Class Name", "fund_class_short_name": "Invested Fund Class Short Name", "investment_category": "fixed_income", "tax_classification": "long_term", "internal_code": "Internal Code", "subclass_name": "senior", "entity_category": "fund", "fund_term_target": "undetermined", "fund_regime": "open_ended", "operation_periods": { "redemption_request": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } } }, "isin_code": "BR000000000" }, "total_current_value": 1234567.89, "total_current_units": 1180000.0, "last_mtm_date": "YYYY-MM-DD", "lag": { "reference": "daily", "amount": 1 } } ], "limit": 10, "page": 0, "is_last_page": true } ``` ### Response Fields | Campo | Tipo | Descrição | | -------------- | ------- | ---------------------------------------------------------------- | | `data` | array | Lista de objetos de **[Posição](#posicao)** | | `limit` | int | Limite de objetos recuperados por página | | `page` | int | Número da página recuperada | | `is_last_page` | boolean | Indica se a página recuperada é a última | ### Posição {#posicao} | Campo | Tipo | Descrição | | --------------------- | ------ | ------------------------------------------------------------------------------------------------ | | `quota_fund_class` | JSON | Objeto de **[Fundo investido](#fundo-investido)** | | `total_current_value` | float | **Valor atualizado da posição, em reais.** Soma do valor corrente dos ativos da série | | `total_current_units` | float | Quantidade atual de cotas detidas na série | | `last_mtm_date` | string | Data da marcação **mais antiga** entre as posições agregadas, no formato `YYYY-MM-DD` | | `lag` | JSON | Configuração de defasagem de precificação da série. Omitido quando a série não tem defasagem | :::caution **Atenção** Diferente da API de Visibilidade de Caixa, onde os saldos vêm em centavos, aqui `total_current_value` é um número decimal em reais. Ex.: `1234.56` = R$ 1.234,56. O `last_mtm_date` é o **mínimo** entre as datas de marcação das posições agregadas, e não a mais recente. Use-o para saber até quando o valor está garantidamente atualizado. ::: ### Fundo investido {#fundo-investido} | Campo | Tipo | Descrição | | ------------------------ | ------ | ------------------------------------------------------------------------ | | `name` | string | Nome da série de emissão investida | | `quota_fund_class_key` | string | Chave única da série de emissão investida | | `document_number` | string | CNPJ da classe do fundo investido | | `fund_class_name` | string | Nome da classe do fundo investido | | `fund_class_short_name` | string | Nome curto da classe do fundo investido | | `investment_category` | string | Categoria de investimento do fundo investido | | `tax_classification` | string | Classificação tributária do fundo investido | | `internal_code` | string | Código interno da série investida | | `subclass_name` | string | Senioridade da subclasse investida | | `entity_category` | string | Categoria da entidade investida | | `fund_term_target` | string | Prazo alvo do fundo investido | | `fund_regime` | string | Regime do fundo investido | | `operation_periods` | JSON | Prazos de cotização e liquidação das operações da série | | `isin_code` | string | Código ISIN da série. Omitido quando a série não tem ISIN cadastrado | ## Consultando a posição em um fundo de zeragem {#fundo-de-zeragem} Fundos de zeragem são fundos de liquidez usados para aplicar o caixa ocioso da sua classe, com aplicação e resgate por débito automático. A operação é feita pelos endpoints de [Criar Aplicação Financeira](/documentation/iaas/cotas_de_fundo/operacao_aplicacoes_financeiras) e [Criar Pedido de Resgate](/documentation/iaas/cotas_de_fundo/operacao_resgates), enviando o `source_account_key`. Para consultar quanto a sua classe tem aplicado em um fundo de zeragem específico, filtre pelo CNPJ dele (substitua `11.222.333/0001-81` pelo CNPJ do fundo de zeragem): ```python title="Posição em um fundo de zeragem" GET /wallet/fund_class/{fund_class_key}/fund_quota_positions?document_number=11.222.333/0001-81 ``` O `total_current_value` da resposta é o saldo aplicado, em reais, na data indicada por `last_mtm_date`. :::info Atenção Uma mesma classe de fundo investida pode ter mais de uma série de emissão. Nesse caso a resposta traz **uma linha por série**, todas com o mesmo `document_number`, e o saldo total no fundo é a soma dos `total_current_value` retornados. ::: Para conhecer o saldo em **conta bancária** — que é o caixa ainda não aplicado — use os endpoints de [Visibilidade de Caixa](/documentation/iaas/visibildade_de_caixa/get_accounts). ## Erros | Status | Código | Quando acontece | | ------ | ----------- | ----------------------------------------------------- | | 403 | `WLT000098` | A classe de fundo não pertence à gestora da integração. | | 404 | `WLT000001` | Classe de fundo não encontrada. | | 404 | `WLT000066` | Gestora não encontrada. | Erros de autenticação, permissão e host: veja [Erros da API](/documentation/iaas/introducao/erros). --- # Introdução URL: /documentation/iaas/cotas_de_fundo/inicio O sistema de Cotas de Fundo é uma solução que permite a compra, venda e consulta relacionado a cotas de outros fundos. Este módulo oferece funcionalidades essenciais para: - Gerenciar aportes e resgates em outros fundos - Criar operações Esta documentação fornece uma visão detalhada sobre como utilizar o sistema de cotas de fundo, incluindo seus principais recursos e fluxos. Aqui você encontrará informações sobre: - Compra, venda e consulta relacionadas a cotas de outros fundos - Endpoints e payloads Para começar a utilizar o sistema, navegue pelos tópicos disponíveis nesta documentação para entender melhor cada aspecto do módulo de cotas de fundo. --- # Criar Aplicação Financeira URL: /documentation/iaas/cotas_de_fundo/operacao_aplicacoes_financeiras Cria uma aplicação da sua classe de fundo em cotas de outro fundo (série de emissão investida) e permite aprovar ou cancelar a aplicação enquanto ela não foi processada. :::info Disponível em | Perfil | Host | Permissão exigida | | ----------- | ---------------- | -------------------------------------------------------------------- | | Gestora | `manager-api` | Escrita | | Consultoria | `consultant-api` | Criar Aplicações e Resgates | URL base de cada host: [Ambientes (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application MÉTODO POST STATUS 201 `FUND_CLASS_KEY` é a chave da **sua** classe de fundo, a que vai aplicar. ```json title='Request Body' { "issuance_serie_key": "", "amount": 100000.00, "quotation_date": "2026-10-08", "payment_method": "wire_transfer" } ``` ### Body params | Campo | Tipo | Descrição | Obrigatório | | -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | | `issuance_serie_key` | string | Chave da série de emissão investida (36 caracteres). Veja [Consulta paginada de séries de emissão](/documentation/iaas/cotas_de_fundo/consulta_paginada_series_de_emissao). | Sim | | `amount` | number | Valor da aplicação, maior que zero e maior ou igual ao `minimum_share_capital` da série. | Sim | | `quotation_date` | string | Data de cotização (`YYYY-MM-DD`). Obrigatória quando a série tem `quota_calculation_method` = `quota_value`; não pode ser anterior à data contábil da sua classe. Em séries `internal`, é ignorada; a data de cotização é definida pela plataforma e volta na resposta. | Condicional | | `source_account_key` | string | `account_key` da conta da sua classe que será debitada. Obrigatória quando a série tem `payment_type` = `automatic_debit`; não envie nos demais casos. | Condicional | | `payment_method` | string | `wire_transfer` (padrão) ou `pix`. | Não | :::info Débito automático Quando a série tem `payment_type` = `automatic_debit` (normalmente fundos de zeragem), envie `source_account_key`: a conta precisa estar aberta e ser da mesma instituição financeira da série (`financial_institution_code`). Recupere a chave em [Recuperando informações da conta](/documentation/iaas/visibildade_de_caixa/get_accounts). ::: Em séries `quota_value`, a aplicação nasce em `pending_manager_approval` e precisa ser aprovada (seção abaixo). Em séries `internal`, ela é aprovada na criação e segue para `pending_payment`. ## Response O mesmo objeto é devolvido pela criação, aprovação e cancelamento. Response Body ```json { "amount": 100000.0, "financial_application_key": "", "asset_key": null, "status": "pending_manager_approval", "quotation_date": "2026-10-08", "payment_date": "2026-10-08", "external_financial_application_key": null, "payment_method": "wire_transfer", "payment_type": "transfer", "issuance_serie": { "issuance_serie_key": "", "name": "Invested Issuance Serie Name", "subclass_name": "Invested Sub Class Name", "serie": 1, "quota_calculation_method": "quota_value", "condominium_type": "open_ended", "internal_code": "Internal Code", "fund_class_name": "Invested Fund Class Name", "fund_class_short_name": "Invested Fund Class Short Name", "fund_class_document_number": "00.000.000/0000-00", "minimum_share_capital": 0.0, "investment_category": "multi_market", "asset_type": "multi_market_fund_quota", "payment_type": "transfer", "status": "active", "financial_institution_code": "329", "account_data": { "account_digit": "0", "account_branch": "0001", "account_number": "12345", "financial_institution_code": "329", "financial_institution_ispb": "00000000" }, "last_updated_date": "2026-10-07", "administrator": { "administrator_key": "", "name": "Administrator Name", "document_number": "00.000.000/0000-00", "status": "active" }, "operation_periods": { "financial_application": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } }, "redemption_request": { "payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" }, "quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" } } }, "isin_code": "BR000000000" }, "fund_class": { "fund_class_key": "", "name": "Fund Class Name", "short_name": "Fund Class Short Name", "document_number": "00.000.000/0000-00", "accounting_date": "2026-10-07", "investor_key": "", "distributor": { "name": "Distributor Name", "distributor_key": "", "document_number": "00.000.000/0000-00" }, "manager": { "manager_key": "", "manager_name": "Manager Name", "document_number": "00.000.000/0000-00" } } } ``` `asset_key` é preenchido na cotização; `iof_amount` e `number_of_quotas` aparecem quando já calculados. A descrição de cada campo está em [Consulta paginada de aplicações](/documentation/iaas/cotas_de_fundo/consulta_paginada_aplicacoes_financeiras#financial_application). Status possíveis: `created`, `pending_manager_approval`, `pending_distributor_approval`, `pending_external_approval`, `pending_payment`, `pending_payment_confirmation`, `pending_notify_distributor`, `pending_quotation`, `mismatched_external_data`, `canceled`, `confirmed`. ## Aprovar aplicação financeira Aprova uma aplicação em `pending_manager_approval`. A resposta traz `pending_payment` ou, quando a série depende de aprovação do distribuidor, `pending_distributor_approval`. ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application/FINANCIAL_APPLICATION_KEY MÉTODO PUT STATUS 202 ```json title='Request Body' { "status": "pending_payment" } ``` | Campo | Tipo | Descrição | Obrigatório | | -------- | ------ | ------------------------------------------------------------------------------------------------ | ----------- | | `status` | string | Envie `pending_payment`. Outro valor, ou aplicação fora de `pending_manager_approval`, devolve `TFQ000052`. | Sim | A resposta é o objeto de aplicação financeira (veja [Response](#response)). ## Cancelar aplicação financeira ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application/FINANCIAL_APPLICATION_KEY/cancel MÉTODO PUT STATUS 202 Sem corpo. A aplicação pode ser cancelada nos status `pending_manager_approval`, `pending_payment`, `pending_payment_confirmation` e `mismatched_external_data`. Em `pending_distributor_approval` e `pending_external_approval`, só o administrador cancela (`TFQ000053`); nos demais status, a API devolve `TFQ000073`. A resposta é o objeto de aplicação financeira, com `status` = `canceled`. ## Erros | Status | Código | Quando acontece | | ------ | ----------- | ---------------------------------------------------------------------------------------- | | 400 | `TFQ000023` | `amount` menor que o mínimo de aplicação da série (`minimum_share_capital`). | | 400 | `TFQ000033` | A série investida é da própria classe de fundo. | | 400 | `TFQ000039` | `quotation_date` não enviada numa série `quota_value`. | | 400 | `TFQ000050` | `quotation_date` anterior à data contábil da sua classe. | | 400 | `TFQ000055` | Falta um dado exigido pela série (por exemplo, `source_account_key` em débito automático). | | 400 | `TFQ000056` | `source_account_key` enviado para uma série que não usa débito automático. | | 400 | `TFQ000058` | A conta de `source_account_key` não é da instituição financeira da série. | | 400 | `TFQ000061` | A conta de `source_account_key` não está aberta. | | 400 | `TFQ000108` | Aplicação enviada depois do horário-limite da série. | | 400 | `TFQ000148` | A série de emissão está inativa. | | 400 | `TFQ000187` | A data de pagamento calculada para a `quotation_date` já passou. | | 400 | `TFQ000207` | A grade de movimentação da série já fechou. | | 422 | `TFQ000198` | A série está bloqueada para aplicações porque o administrador está bloqueado. | | 422 | `TFQ000220` | O fundo investido foi liquidado e não aceita novas aplicações nessa série. | | 400 | `TFQ000052` | Aprovação com `status` diferente de `pending_payment` ou aplicação fora de `pending_manager_approval`. | | 400 | `TFQ000053` | Cancelamento de aplicação que aguarda o distribuidor ou o administrador. | | 400 | `TFQ000073` | Cancelamento não permitido no status atual. | | 403 | `TFQ000054` | A classe de fundo não pertence à sua gestora, ou aprovação de aplicação em `pending_external_approval` (só o administrador aprova). | | 404 | `TFQ000005` | Classe de fundo não encontrada. | | 404 | `TFQ000011` | Série de emissão não encontrada. | | 404 | `TFQ000013` | Aplicação financeira não encontrada (cancelamento). | | 404 | `TFQ000059` | Aplicação financeira não encontrada (aprovação). | Erros de autenticação, permissão e host: veja [Erros da API](/documentation/iaas/introducao/erros). --- # Criar Pedido de Resgate URL: /documentation/iaas/cotas_de_fundo/operacao_resgates Cria um pedido de resgate das cotas que a sua classe de fundo tem em outro fundo (série de emissão investida) e permite aprovar ou cancelar o pedido. :::info Disponível em | Perfil | Host | Permissão exigida | | ----------- | ---------------- | -------------------------------------------------------------------- | | Gestora | `manager-api` | Escrita | | Consultoria | `consultant-api` | Criar Aplicações e Resgates | URL base de cada host: [Ambientes (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request MÉTODO POST STATUS 201 `FUND_CLASS_KEY` é a chave da **sua** classe de fundo, a que detém as cotas. ```json title='Request Body' { "issuance_serie_key": "", "external_id": "3f1c2a9e-8b7d-4c6e-9a5f-1d2e3c4b5a60", "amount": 50000.00, "quotation_date": "2026-10-08" } ``` ### Body params | Campo | Tipo | Descrição | Obrigatório | | -------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | | `issuance_serie_key` | string | Chave da série de emissão investida (36 caracteres). A série precisa ser de condomínio aberto (`open_ended`). | Sim | | `external_id` | string | Seu identificador do pedido, com exatamente 36 caracteres (um UUID). Único: um segundo pedido com o mesmo valor é recusado com `TFQ000048`. | Sim | | `amount` | number | Valor do resgate, maior que zero. Em séries `internal`, é tratado como valor líquido. Obrigatório quando `redeem_all` não é `true`. | Condicional | | `redeem_all` | boolean | `true` para resgatar a posição inteira; nesse caso `amount` é dispensado. | Não | | `quotation_date` | string | Data de cotização (`YYYY-MM-DD`). Obrigatória quando a série tem `quota_calculation_method` = `quota_value`; não pode ser anterior à data contábil da sua classe. Em séries `internal`, é ignorada. | Condicional | | `payment_date` | string | Data de pagamento (`YYYY-MM-DD`), igual ou posterior a `quotation_date`. Se omitida, vale `quotation_date`. Só é usada em séries `quota_value`. | Não | | `source_account_key` | string | `account_key` da conta da sua classe na instituição financeira da série. Obrigatória quando o `payment_type` da série é `automatic_debit`; não envie quando é `transfer`. | Condicional | :::info Débito automático Quando o `payment_type` da série é `automatic_debit` (normalmente fundos de zeragem), envie `source_account_key`: a conta precisa estar aberta e ser da mesma instituição financeira da série. Recupere a chave em [Recuperando informações da conta](/documentation/iaas/visibildade_de_caixa/get_accounts). ::: :::tip Reenvio Em caso de erro, reenvie a requisição: se o pedido já existir, a API devolve `TFQ000048` (409) e não cria outro. Nesse caso, confira-o na [Consulta paginada de resgates](/documentation/iaas/cotas_de_fundo/consulta_paginada_resgates) em vez de recriar. Veja [Reenvio e duplicidade](/documentation/iaas/introducao/erros#reenvio-e-duplicidade). ::: Em séries `quota_value`, o pedido nasce em `pending_manager_approval` e precisa ser aprovado (seção abaixo). Em séries `internal`, ele é aprovado na criação. ## Response O mesmo objeto é devolvido pela criação, aprovação e cancelamento. Response Body ```json { "redemption_request_key": "", "external_redemption_request_key": null, "status": "pending_manager_approval", "quotation_date": "2026-10-08", "payment_date": "2026-10-08", "amount": 50000.0, "issuance_serie": { "issuance_serie_key": "", "name": "Issuance Serie Name", "subclass_name": "SUBORDINADA", "serie": 1, "quota_calculation_method": "quota_value", "condominium_type": "open_ended", "internal_code": "Internal Code", "fund_class_name": "Fund Class Name", "fund_class_short_name": "Fund Class Short Name", "fund_class_document_number": "00.000.000/0000-00", "minimum_share_capital": 0.0, "investment_category": "fixed_income", "asset_type": "fixed_income_fund_quota", "payment_type": "automatic_debit", "status": "active", "financial_institution_code": "329", "account_data": { "account_digit": "0", "account_branch": "0001", "account_number": "12345", "financial_institution_code": "329", "financial_institution_ispb": "00000000" }, "last_updated_date": "2026-10-07", "administrator": { "administrator_key": "", "name": "Administrator Name", "document_number": "00.000.000/0000-00", "status": "active" }, "operation_periods": { "redemption_request": { "payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" }, "quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" } }, "financial_application": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } } } }, "fund_class": { "fund_class_key": "", "name": "Fund Class Name", "short_name": "Fund Class Short Name", "document_number": "00.000.000/0000-00", "accounting_date": "2026-10-07", "investor_key": "", "distributor": { "name": "Distributor Name", "distributor_key": "", "document_number": "00.000.000/0000-00" }, "manager": { "manager_key": "", "manager_name": "Manager Name", "document_number": "00.000.000/0000-00" } } } ``` `redeem_all` aparece (com `true`) quando o pedido é de resgate total; `cash_expectation` aparece quando a expectativa de caixa já foi criada. O `external_id` enviado não é devolvido. A descrição de cada campo está em [Consulta paginada de resgates](/documentation/iaas/cotas_de_fundo/consulta_paginada_resgates#redemption-request). Status possíveis: `created`, `pending_manager_approval`, `pending_distributor_approval`, `pending_external_approval`, `pending_quotation`, `quoted`, `mismatched_external_data`, `canceled`, `confirmed`, `quotation_reversed`. ## Aprovar pedido de resgate Aprova um pedido em `pending_manager_approval`. Sem corpo. ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY/approval MÉTODO PUT STATUS 202 A rota `PUT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY`, com o corpo `{"status": "pending_external_approval"}`, faz a mesma aprovação e continua disponível nos mesmos perfis. A resposta é o objeto de pedido de resgate (veja [Response](#response)). ## Cancelar pedido de resgate ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY/cancel MÉTODO PUT STATUS 202 Sem corpo. Você pode cancelar o pedido enquanto ele está em `pending_manager_approval`. Depois da aprovação, o cancelamento é feito pelo administrador, e a API devolve `TFQ000053`. A resposta é o objeto de pedido de resgate, com `status` = `canceled`. ## Erros | Status | Código | Quando acontece | | ------ | ----------- | --------------------------------------------------------------------------------------- | | 409 | `TFQ000048` | Já existe um pedido de resgate com esse `external_id`. | | 400 | `TFQ000039` | `quotation_date` não enviada numa série `quota_value`. | | 400 | `TFQ000041` | A sua classe não tem cotas ativas dessa série para resgatar. | | 400 | `TFQ000046` | `payment_date` anterior a `quotation_date`. | | 400 | `TFQ000049` | A série ainda não tem cota calculada (séries `internal`). | | 400 | `TFQ000050` | `quotation_date` anterior à data contábil da sua classe. | | 400 | `TFQ000055` | `source_account_key` não enviado numa série com débito automático. | | 400 | `TFQ000056` | `source_account_key` enviado numa série com `payment_type` = `transfer`. | | 400 | `TFQ000058` | A conta de `source_account_key` não é da instituição financeira da série. | | 400 | `TFQ000061` | A conta de `source_account_key` não está aberta. | | 400 | `TFQ000067` | `amount` não enviado e `redeem_all` diferente de `true`. | | 400 | `TFQ000177` | A série não aceita resgate (condomínio fechado). | | 400 | `TFQ000207` | A grade de movimentação da série já fechou (aprovação). | | 400 | `TFQ000052` | Aprovação de pedido fora de `pending_manager_approval`. | | 400 | `TFQ000053` | Cancelamento de pedido fora de `pending_manager_approval`. | | 403 | `TFQ000054` | A classe de fundo não pertence à sua gestora. | | 404 | `TFQ000005` | Classe de fundo não encontrada. | | 404 | `TFQ000011` | Série de emissão não encontrada. | | 404 | `TFQ000045` | Pedido de resgate não encontrado (cancelamento). | | 404 | `TFQ000060` | Pedido de resgate não encontrado (aprovação). | Erros de autenticação, permissão e host: veja [Erros da API](/documentation/iaas/introducao/erros).