跳到主要内容

创建资产——贴现合同

用于向转让批次中插入贴现合同类资产的端点。此类资产代表一份信贷合同的某一分期，其信用权利将转让给基金。

适用范围
角色主机所需权限
管理人manager-api写入
顾问consultant-apiBatches
转让方assignor-api写入

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

我在流程中的哪一步？

这是转让流程的第 2 步。在此之前，您应已创建批次。插入资产后，请提交所需的文件并结束插入。

注意

信用权利的 external_id 字段用于在批次内标识资产，不要与批次的 external_id 混淆。

Request​

ENDPOINT
/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}/asset
MÉTODO
POST
Request Body
{
    "asset_type": "discounted_contract",
    "total_purchase_value": 1231.21,
    "discounted_credit_right": {
        "external_id": "mdf27za1-ra5f-46c0-a32f-fb909884dbb2",
        "originator_document_number": "22.333.444/0001-81",
        "face_value": 1231.21,
        "maturity_date": "2025-12-10",
        "installment_number": 1,
        "borrower": {
            "name": "Natália Nascimento",
            "document_number": "969.698.790-03",
            "person_type": "natural_person",
            "email": "natalia.nascimento@yopmail.com",
            "address": {
                "street": "Gilberto Sabino",
                "number": "215",
                "neighborhood": "Pinheiros",
                "city": "São Paulo",
                "postal_code": "05425-020",
                "uf": "SP",
                "country": "BRA"
            },
            "phone": {
                "area_code": "11",
                "number": "36360268"
            },
            "natural_person": {
                "mother_name": "Lívia Santos",
                "birthdate": "2001-01-05"
            }
        },
        "contract": {
            "number_of_installments": 5,
            "total_face_value": 1231.21,
            "number": "958431587",
            "issue_date": "2023-10-10"
        }
    }
}

请求体属性​

字段类型是否必填描述
asset_typestring必填资产类型。贴现合同请填写 discounted_contract。
total_purchase_valuenumber必填资产的购买总额——即受让方实际支付的金额。最多 2 位小数。
discounted_credit_rightobject必填信用权利数据。参见 discounted_credit_right 属性。

discounted_credit_right 属性​

字段类型是否必填描述
external_idstring必填该资产在合作伙伴系统中的唯一标识 key。最多 50 个字符。
originator_document_numberstring必填促成该业务的发起人的 CPF 或 CNPJ，带格式（000.000.000-00 或 00.000.000/0000-00）。必须已在 QI Tech 注册；否则返回 TRC000019。
face_valuenumber必填面值。最多 8 位小数。
maturity_datestring必填分期到期日，格式为 YYYY-MM-DD。
installment_numberinteger必填该资产所代表的合同分期期数。缺少该字段时，插入返回 TRC000077。
borrowerobject必填付款人数据。参见"创建资产——CCB"页面中的 borrower 属性。
contractobject必填合同数据。参见 contract 属性。缺少该对象时，插入返回 TRC000075。此类资产请勿发送 invoice 对象（TRC000076）。

contract 属性​

字段类型是否必填描述
number_of_installmentsinteger必填合同的总期数。
total_face_valuenumber必填合同的总面值。最多 2 位小数。
numberstring必填合同编号。最多 50 个字符。
issue_datestring必填签发日期，格式为 YYYY-MM-DD。

Response​

STATUS
201
Response Body
{
    "asset_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "external_id": "mdf27za1-ra5f-46c0-a32f-fb909884dbb2",
    "status": "pending_eligibility"
}

响应属性​

字段类型描述
asset_keystringQI Tech 生成的资产唯一标识（UUID）。
external_idstring与 discounted_credit_right 的 external_id 字段中提供的外部 key 相同。
statusstring资产的初始状态。始终返回 pending_eligibility，表示资产已插入，等待合格性审查。

错误​

状态码代码触发条件
400QIT000001请求体不符合预期格式：缺少必填字段、类型或格式无效。description 会指出具体字段。
404TRC000018该转让配置中不存在使用此 assignment_external_id 的批次。
400TRC000025asset_type 与转让配置的资产类型不同。
400TRC000022批次不再接受资产：插入已结束。如需添加更多资产，请重新开放批次。
400TRC000009originator_document_number 或自然人付款人的 document_number 中的 CPF 或 CNPJ 无效。
404TRC000019没有使用所提供 originator_document_number 注册的发起人。尽管标题为 Originator bond not found，该错误与和配置的关联无关。
400TRC000077缺少 installment_number。
400TRC000075缺少 contract 对象。
400TRC000076在 discounted_contract 资产中发送了 invoice 对象。
409TRC000054该批次中已存在使用此 external_id 的资产。
409TRC100026基金投资组合中，同一转让方已存在使用此 external_id 的信用权利。
400TRC1000xx资产财务校验拒绝了该请求体。例如：TRC100017（409），基金不购买已逾期的资产。

错误体格式如下：

{
  "title": "Already Exist This External Id",
  "description": "Already exist an asset with this External Id and asset_key->41d6ff41-1dac-4df7-9e50-d15210ec57f3",
  "translation": "Ja existe um ativo com esse External Id e asset_key->41d6ff41-1dac-4df7-9e50-d15210ec57f3",
  "code": "TRC000054"
}

如发生错误，请重发请求。重复（TRC000054）表示该资源已存在：请通过资产查询端点查询它，而不是重新创建。详见重发与重复。

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

后续步骤​

插入资产后，流程继续：

  1. 提交文件——为每项通过合格性审查的资产提交所需文件。
  2. 结束插入——表明所有资产均已插入，以便批次进入合格性审查。