创建金融申购
为您的基金类别创建一笔申购其他基金份额（被投资的发行系列）的金融申购，并可在其处理之前审批或取消该申购。
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 写入 |
| 顾问 | consultant-api | Create Applications and Redemptions |
各主机的 Base URL：环境（主机）。
Request
FUND_CLASS_KEY 是您的基金类别（即进行申购的一方）的 key。
{
"issuance_serie_key": "<issuance_serie_key>",
"amount": 100000.00,
"quotation_date": "2026-10-08",
"payment_method": "wire_transfer"
}
Body params
| 字段 | 类型 | 描述 | 必填 |
|---|---|---|---|
issuance_serie_key | string | 被投资发行系列的 key（36 个字符）。参见发行系列分页查询。 | 是 |
amount | number | 申购金额，必须大于零，且大于或等于该系列的 minimum_share_capital。 | 是 |
quotation_date | string | 份额确认日期（YYYY-MM-DD）。当系列的 quota_calculation_method = quota_value 时必填；不得早于您基金类别的会计日期。在 internal 系列中会被忽略；份额确认日期由平台确定，并在响应中返回。 | 条件必填 |
source_account_key | string | 您基金类别中要扣款账户的 account_key。系列的 payment_type 为 automatic_debit 时必填；其他情况请勿发送。 | 条件必填 |
payment_method | string | wire_transfer（默认）或 pix。 | 否 |
当系列的 payment_type 为 automatic_debit（通常为归零基金）时，请发送 source_account_key：该账户必须处于开立状态，且与该系列属于同一金融机构（financial_institution_code）。可在获取账户信息中获取该 key。
在 quota_value 系列中，申购创建后处于 pending_manager_approval，需要审批（见下文）。在 internal 系列中，申购在创建时即被审批，并进入 pending_payment。
Response
创建、审批和取消均返回同一个对象。
Response Body
{
"amount": 100000.0,
"financial_application_key": "<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": "<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": "<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": "<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": "<investor_key>",
"distributor": {
"name": "Distributor Name",
"distributor_key": "<distributor_key>",
"document_number": "00.000.000/0000-00"
},
"manager": {
"manager_key": "<manager_key>",
"manager_name": "Manager Name",
"document_number": "00.000.000/0000-00"
}
}
}
asset_key 在份额确认时填充；iof_amount 和 number_of_quotas 在计算完成后返回。各字段的说明参见申购分页查询。
可能的状态：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。
审批金融申购
审批处于 pending_manager_approval 的申购。响应返回 pending_payment；若该系列需要分销商审批，则返回 pending_distributor_approval。
{
"status": "pending_payment"
}
| 字段 | 类型 | 描述 | 必填 |
|---|---|---|---|
status | string | 请发送 pending_payment。发送其他值，或申购不处于 pending_manager_approval 时，返回 TFQ000052。 | 是 |
响应为金融申购对象（参见 Response）。
取消金融申购
无请求体。申购可在 pending_manager_approval、pending_payment、pending_payment_confirmation 和 mismatched_external_data 状态下取消。在 pending_distributor_approval 和 pending_external_approval 状态下，只有行政管理人可以取消（TFQ000053）；在其他状态下，API 返回 TFQ000073。
响应为金融申购对象，status = canceled。
错误
| 状态码 | 代码 | 触发条件 |
|---|---|---|
| 400 | TFQ000023 | amount 低于该系列的最低申购额（minimum_share_capital）。 |
| 400 | TFQ000033 | 被投资的系列属于本基金类别自身。 |
| 400 | TFQ000039 | 在 quota_value 系列中未发送 quotation_date。 |
| 400 | TFQ000050 | quotation_date 早于您基金类别的会计日期。 |
| 400 | TFQ000055 | 缺少该系列要求的数据（例如自动扣款时的 source_account_key）。 |
| 400 | TFQ000056 | 为不使用自动扣款的系列发送了 source_account_key。 |
| 400 | TFQ000058 | source_account_key 对应的账户不属于该系列的金融机构。 |
| 400 | TFQ000061 | source_account_key 对应的账户未处于开立状态。 |
| 400 | TFQ000108 | 在该系列的截止时间之后提交申购。 |
| 400 | TFQ000148 | 该发行系列未启用。 |
| 400 | TFQ000187 | 根据 quotation_date 计算出的付款日期已过。 |
| 400 | TFQ000207 | 该系列的交易时间窗口已关闭。 |
| 422 | TFQ000198 | 由于行政管理人被冻结，该系列已暂停申购。 |
| 422 | TFQ000220 | 被投资基金已清盘，该系列不再接受新的申购。 |
| 400 | TFQ000052 | 审批时 status 不是 pending_payment，或申购不处于 pending_manager_approval。 |
| 400 | TFQ000053 | 取消正在等待分销商或行政管理人处理的申购。 |
| 400 | TFQ000073 | 当前状态下不允许取消。 |
| 403 | TFQ000054 | 该基金类别不属于您的管理人，或审批处于 pending_external_approval 的申购（仅管理机构可审批）。 |
| 404 | TFQ000005 | 未找到基金类别。 |
| 404 | TFQ000011 | 未找到发行系列。 |
| 404 | TFQ000013 | 未找到金融申购（取消）。 |
| 404 | TFQ000059 | 未找到金融申购（审批）。 |
认证、权限和主机相关错误：参见 API 错误。