跳到主要内容

创建赎回申请

注意

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

Request​

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request
MÉTODO
POST
STATUS
201
Request Body
{
  "issuance_serie_key": "UUID",
  "external_id": "UUID",
  "amount": 0.00,
  "source_account_key": "UUID",
  "redeem_all": false
}
注意

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

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

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

否则请勿发送此字段。

Body params​

字段类型描述必填
issuance_serie_keystring发行系列的唯一标识键是
external_idstring赎回申请的唯一外部标识是
amountfloat赎回总金额（若 redeem_all 为 true 则忽略）否
source_account_keystring基金类别的来源银行账户标识键否
redeem_allboolean表示是否为全额赎回否

Response​

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

审批赎回申请

Request​

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY
MÉTODO
PUT
STATUS
202
Request Body
{
  "status": "pending_external_approval"
}

Body params​

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

Response​

Response Body
{
  "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,
    "fund_class_name": "Fund Class Name",
    "fund_class_short_name": "Fund Class Short Name",
    "fund_class_document_number": "00.000.000/0000-00"
  },
  "fund_class": {
    "fund_class_key": "UUID",
    "name": "Fund Class Name",
    "document_number": "00.000.000/0000-00"
  }
}

取消赎回申请

Request​

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY/cancel
MÉTODO
PUT
STATUS
202
注意

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

  • pending_manager_approval
  • pending_distributor_approval

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

Response​

Response Body
{
  "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,
    "fund_class_name": "Fund Class Name",
    "fund_class_document_number": "00.000.000/0000-00"
  },
  "fund_class": {
    "fund_class_key": "UUID",
    "name": "Fund Class Name",
    "document_number": "00.000.000/0000-00"
  }
}