跳到主要内容

创建金融申购

注意

此资源仅适用于担任基金经理角色的集成方。

Request​

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application
MÉTODO
POST
STATUS
201
Request Body
{
  "issuance_serie_key": "UUID",
  "source_account_key": "UUID",
  "amount": 0.00,
  "quotation_date": "YYYY-MM-DD",
  "payment_method": "string"
}
注意

当操作涉及 "payment_type" 为 "automatic_debit"（通常为清零基金）的系列时，必须发送 source_account_key。

此操作不会实际产生申购，仅创建预期记录并将资金转至您名下的账户，以便后续完成操作。

您可以通过以下端点获取此键：获取账户信息 其中 source_account_key 即为您希望进行申购的机构的 account_key。

否则请勿发送此字段。

Body params​

字段类型描述必填
issuance_serie_keystring发行系列的唯一标识键是
amountfloat申购金额是
source_account_keystring资金目标银行账户的标识键否
quotation_datestring配额日期，格式为 YYYY-MM-DD否
payment_methodstring付款方式（wire_transfer、pix）否

Response​

Response Body
{
"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"
    }
}
}

审批金融申购

Request​

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application/FINANCIAL_APPLICATION_KEY
MÉTODO
PUT
STATUS
202
Request Body
{
  "status": "pending_payment"
}

Body params​

字段类型描述
statusstring赎回申请的新状态。请参见下方允许的值。

Response​

Response Body
{
"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"}
}
}

取消金融申购

Request​

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application/FINANCIAL_APPLICATION_KEY/cancel
MÉTODO
PUT
STATUS
202
注意

只有当申购申请处于以下状态之一时，才能取消：

  • pending_manager_approval
  • pending_distributor_approval

否则您将收到错误代码：TFQ000073

Response​

Response Body
{
"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"}
}
}