# 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 6 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) - 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 :::warning Atenção Este recurso está disponível apenas para integrações que exercem o papel de **Gestor**. ::: ### Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_applications MÉTODO GET #### Query Params | Parâmetro | Tipo | Descrição | | ---------------------------------- | ------ | --------------------------------------------- | | `quotation_date` | data | Data de cotização da aplicação | | `financial_application_status` | string | Filtra as aplicações por um status específico | | `not_financial_application_status` | string | Exclui as aplicações com um status específico | | `document_number` | string | CNPJ da classe do fundo investido | ### 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 | 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) | | status | string | Status da aplicação | | external_financial_application_key | string | Identificador externo da aplicação financeira | | 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 | --- # Consulta de Resgates por Classe de Fundo URL: /documentation/iaas/cotas_de_fundo/consulta_paginada_resgates :::warning Atenção Este recurso está disponível apenas para integrações que exercem o papel de Gestor. ::: ### Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_requests MÉTODO GET #### Query Params | Parâmetro | Tipo | Descrição | | ------------------------------- | ------ | ------------------------------------------- | | `quotation_date` | data | Data de cotização do resgate | | `redemption_request_status` | string | Filtra os resgates por um status específico | | `not_redemption_request_status` | string | Exclui os resgates com um status específico | | `document_number` | string | CNPJ da classe do fundo investido | ### 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" } } }, "issuance_serie_data": { "name": "Issuance Serie Name", "serie": 1, "payment_type": "automatic_debit", "remuneration": "residual", "internal_code": "Internal Code", "subclass_name": "SUBORDINADA", "fund_class_name": "Fund Class Name", "issuance_serie_key": "UUID", "tax_classification": "long_term", "investment_category": "fixed_income", "fund_class_short_name": "Fund Class Short Name", "minimum_share_capital": 0.00, "quota_calculation_method": "quota_value", "financial_institution_code": "329", "fund_class_document_number": "00.000.000/0000-00", "administrator_document_number": "00.000.000/0000-00" } }, "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 resgate (ex: confirmed) | | quotation_date | string | Data da cotização do resgate | | payment_date | string | Data do pagamento do resgate | | amount | float | Valor resgatado | | 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 | --- # Consulta de Séries de Emissão URL: /documentation/iaas/cotas_de_fundo/consulta_paginada_series_de_emissao :::warning Atenção Este recurso está disponível apenas para integrações que exercem o papel de **Gestor**. ::: ### Request ENDPOINT /trade_fund_quota/issuance_series MÉTODO GET #### Query Params | Parâmetro | Tipo | Descrição | | ---------------------------- | ------ | ---------------------------------- | | `fund_class_document_number` | string | CNPJ do fundo (00.000.000/0001-00) | ### 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", "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" } ], "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 | 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) | --- # 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 --- :::warning Atenção Este recurso está disponível apenas para integrações que exercem o papel de Gestor. ::: ### Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application MÉTODO POST STATUS 201 ```json title='Request Body' { "issuance_serie_key": "UUID", "source_account_key": "UUID", "amount": 0.00, "quotation_date": "YYYY-MM-DD", "payment_method": "string" } ``` :::note **Atenção**. Sempre que a operação for em uma série que o "payment_type" é "automatic_debit" (normalmente fundos de zeragem) é preciso enviar o source_account_key. Esta operação não resultará em uma aplicação de fato, apenas na criação das expectativas e transferência para a conta de sua titularidade para que seja efetuado a operação na sequência. Você pode recuperar essa chave através do endpoint: [`Recuperando Informações da Conta`](/documentation/iaas/visibildade_de_caixa/get_accounts) Onde o source_account_key é a account_key da instituição onde você deseja realizar a aplicação. Caso contrário não envie este campo. ::: ### Body params | Campo | Tipo | Descrição | Obrigatório | | -------------------- | ------ | ------------------------------------------------ | ----------- | | `issuance_serie_key` | string | Chave única de identificação da série de emissão | Sim | | `amount` | float | Valor da aplicação | Sim | | `source_account_key` | string | Chave da conta bancária de destino dos recursos | Não | | `quotation_date` | string | Data da cotização no formato `YYYY-MM-DD` | Não | | `payment_method` | string | Método de pagamento (`wire_transfer`, `pix`) | Não | ### Response Response Body ```json { "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" } } } ``` # Aprovar Aplicação Financeira --- ### Request 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" } ``` ### Body params | Campo | Tipo | Descrição | | -------- | ------ | -------------------------------------------------------------------- | | `status` | string | Novo status do pedido de resgate. Veja abaixo os valores permitidos. | ### Response Response Body ```json { "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" } } } ``` # Cancelar Aplicação Financeira --- ### Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application/FINANCIAL_APPLICATION_KEY/cancel MÉTODO PUT STATUS 202 :::note **Atenção**. Você poderá cancelar um pedido de aplicação caso ele esteja em algum destes status: - pending_manager_approval - pending_distributor_approval Caso contrário você vai receber um erro com o seguinte código: TFQ000073 ::: ### Response Response Body ```json { "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" } } } ``` --- # Criar Pedido de Resgate URL: /documentation/iaas/cotas_de_fundo/operacao_resgates --- :::warning Atenção Este recurso está disponível apenas para integrações que exercem o papel de Gestor. ::: ### Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request MÉTODO POST STATUS 201 ```json title='Request Body' { "issuance_serie_key": "UUID", "external_id": "UUID", "amount": 0.00, "source_account_key": "UUID", "redeem_all": false } ``` :::note **Atenção**. Sempre que a operação for em uma série que o "payment_type" é "automatic_debit" (normalmente fundos de zeragem) é preciso enviar o source_account_key. Esta operação não resultará em um resgate de fato, apenas na criação das expectativas e transferência para a conta de sua titularidade para que seja efetuado a operação na sequência. Você pode recuperar essa chave através do endpoint: [`Recuperando Informações da Conta`](/documentation/iaas/visibildade_de_caixa/get_accounts) Onde o source_account_key é a account_key da instituição onde você deseja realizar o resgate. Caso contrário não envie este campo. ::: ### Body params | Campo | Tipo | Descrição | Obrigatório | | -------------------- | ------- | ------------------------------------------------------------ | ----------- | | `issuance_serie_key` | string | Chave única da Série de Emissão | Sim | | `external_id` | string | Identificador externo único do pedido de resgate | Sim | | `amount` | float | Valor bruto do resgate (ignorado se `redeem_all` for `true`) | Não | | `source_account_key` | string | Chave da conta bancária de origem do fundo classe | Não | | `redeem_all` | boolean | Indica se o resgate deve ser total | Não | ### Response Response Body ```json { "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" } } }, "issuance_serie_data": { "name": "Issuance Serie Name", "serie": 1, "payment_type": "automatic_debit", "remuneration": "residual", "internal_code": "Internal Code", "subclass_name": "SUBORDINADA", "fund_class_name": "Fund Class Name", "issuance_serie_key": "UUID", "tax_classification": "long_term", "investment_category": "fixed_income", "fund_class_short_name": "Fund Class Short Name", "minimum_share_capital": 0.00, "quota_calculation_method": "quota_value", "financial_institution_code": "329", "fund_class_document_number": "00.000.000/0000-00", "administrator_document_number": "00.000.000/0000-00" } }, "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" } } } ``` # Aprovar um Pedido de Resgate --- ### Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY MÉTODO PUT STATUS 202 ```json title='Request Body' { "status": "pending_external_approval" } ``` ### Body params | Campo | Tipo | Descrição | | -------- | ------ | -------------------------------------------------------------------- | | `status` | string | Novo status do pedido de resgate. Veja abaixo os valores permitidos. | ### Response Response Body ```json { "redemption_request_key": "UUID", "status": "pending_external_approval", "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" } } }, "issuance_serie_data": { "name": "Issuance Serie Name", "serie": 1, "payment_type": "automatic_debit", "remuneration": "residual", "internal_code": "Internal Code", "subclass_name": "SUBORDINADA", "fund_class_name": "Fund Class Name", "issuance_serie_key": "UUID", "tax_classification": "long_term", "investment_category": "fixed_income", "fund_class_short_name": "Fund Class Short Name", "minimum_share_capital": 0.00, "quota_calculation_method": "quota_value", "financial_institution_code": "329", "fund_class_document_number": "00.000.000/0000-00", "administrator_document_number": "00.000.000/0000-00" } }, "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" } } } ``` # Cancelar um Pedido de Resgate --- ### Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY/cancel MÉTODO PUT STATUS 202 :::note **Atenção**. Você poderá cancelar um pedido de resgate caso ele esteja em algum destes status: - pending_manager_approval - pending_distributor_approval Caso contrário você vai receber um erro com o seguinte código: TFQ000078 ::: ### Response Response Body ```json { "redemption_request_key": "UUID", "status": "canceled", "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" } } }, "issuance_serie_data": { "name": "Issuance Serie Name", "serie": 1, "payment_type": "automatic_debit", "remuneration": "residual", "internal_code": "Internal Code", "subclass_name": "SUBORDINADA", "fund_class_name": "Fund Class Name", "issuance_serie_key": "UUID", "tax_classification": "long_term", "investment_category": "fixed_income", "fund_class_short_name": "Fund Class Short Name", "minimum_share_capital": 0.00, "quota_calculation_method": "quota_value", "financial_institution_code": "329", "fund_class_document_number": "00.000.000/0000-00", "administrator_document_number": "00.000.000/0000-00" } }, "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" } } } ```