跳到主要内容

担保执行

简介​

本资源旨在执行以投资者份额设立的担保，将份额锁定转换为向债权人的付款。

与其他锁定事件不同，担保执行会在基金类别中生成一笔赎回申请，所得金额以担保中登记的债权人名义支付，而非支付给投资者。投资者的持仓将按实际赎回的份额数量相应减少。

前提条件​

在申请执行之前，请确认：

条件说明
锁定已批准份额锁定必须处于 approved 状态。
担保类型的锁定仅包含 collateral 对象的锁定可以执行。司法查封类锁定不可执行。
债权人已确定collateral.recipient 必须包含 name 和 document_number。
债权人银行账户collateral.recipient.bank_account 必须包含 account_number、account_branch、account_digit 和 financial_institution_ispb。

债权人及其银行账户在创建锁定时登记，参见申请份额锁定。若担保登记信息不完整，所申请的执行不会被记录。

注意

collateral.recipient.bank_account 中提供的银行账户为债权人账户，是执行付款的目标账户。请勿与 collateral.bank_account_key 混淆，后者标识投资者的账户，不参与担保执行。

适用范围
角色主机所需权限
管理人manager-api写入

各主机的 Base URL：环境（主机）。

Request​

ENDPOINT
/quota_lock/investor/INVESTOR_KEY/quota_lock/QUOTA_LOCK_KEY/investor_position_lock/INVESTOR_POSITION_LOCK_KEY/event
MÉTODO
POST
STATUS
201
担保执行
{
    "type": "collateral_execution",
    "net_value": 1000.00
}

Collateral Execution Event​

字段类型说明字符数必填
typestring事件类型枚举值。担保执行为：collateral_execution最多 255是
net_valuefloat需执行并支付给债权人的净额-是

net_value 中提供的金额不得超过申请时的已锁定金额。

Response​

执行已记录
{
    "investor_position_lock_event_key": "UUID"
}
字段类型说明字符数
investor_position_lock_event_keystring所创建执行事件的标识36

申请之后​

  1. 执行事件以 pending_processing 状态记录。此时被锁定的金额仍然全额锁定。
  2. 系统按所提供的金额，在基金类别中自动开立一笔 net_value_redemption 类型的赎回申请。
  3. 赎回申请在基金类别的常规周期中完成计价。付款将支付至债权人账户，金额为扣除所得税（IR）和金融操作税（IOF）后的净额。
  4. 计价完成后，实际赎回的份额数量从锁定中扣减，事件转为 done。

若赎回申请在计价前被取消，执行事件转为 canceled，被锁定的金额全额保留，不做部分扣减。

Event Status​

枚举值说明
pending_processing执行已记录，等待赎回申请完成计价
done执行已完成，份额已从锁定中扣减
canceled执行已取消，被锁定的金额予以保留

状态跟踪​

执行状态通过份额锁定查询接口查询，位于 investor_position_locks[].events[] 对象中。

锁定查询中的事件
{
    "investor_position_locks": [
        {
            "investor_position_lock_key": "UUID",
            "current_locked_quotas": 100.00000000000000,
            "events": [
                {
                    "quota_lock_event_key": "UUID",
                    "type": "collateral_execution",
                    "status": "pending_processing"
                }
            ]
        }
    ]
}
信息

在查询响应中，事件标识通过 quota_lock_event_key 字段返回，与创建时返回的 investor_position_lock_event_key 相对应。

执行完成后，同一事件将显示 status: "done"，并通过 new_locked_quotas 字段给出锁定中剩余的份额数量。

担保执行事件没有专用的 webhook。份额锁定可用的 webhook 参见份额锁定 Webhooks。

错误​

状态代码发生情形
400QLK000044提供的 net_value 为空、为零或为负数
400QLK000042提供的 net_value 超过已锁定金额
400QLK000036所选代理并非该锁定的申请方
404QLK000022未找到份额锁定
404QLK000037未找到被锁定的持仓

认证、权限和主机相关错误：参见 API 错误。