转让合同

该流程在投资基金与转让方之间生成一份转让合同，并发送签署。生成合同需要准备好基金的 fund_class_key（由 QI DTVM 团队提供），以及同样由该团队提供的 assignment_contract_template_key；后者定义合同的参数，例如共同责任、转让所需文件、条款以及合同的产品。

产品标识的是例如某类资产的转让配置、回购配置等。产品来自模板：无需在申请中发送。将发送两份文件进行签署：一份是合同本身，包含所有相关方，例如转让方、管理人、担保人等；另一份是管理人声明，仅需管理人签署，证明已遵守 CVM、Anbima 和巴西央行针对该转让方业务规定的所有规范和要求，涵盖从风险分析到反洗钱（PLD）等方面，具体可在各自的门户中查阅。

合同流程是可变的：可以配置在文件生成后立即发送签署，也可以配置为等待手动发送。此外，如果合同由顾问提出，在发送签署之前需要管理人审批。最后，如果转让方注册尚未开通，或正处于更新过程中，需要等待最近一次审查完成后才能发送签署。如果审查被拒绝，合同也会被取消。

可选地，在模板允许的情况下，可以为转让方与基金之间的业务指定担保人。担保人必须事先与转让方一同注册，在合同中只需通过证件号指定。放款账户在转让方注册中定义；当模板要求为该合同指定特定账户时，通过 disbursement_account_key 指定。

合同的整个签署流程由我们的认证机构 CertifiQI 完成。签署跟踪和产品启用均自动进行——参见产品启用。

适用范围

角色	主机	所需权限
管理人	`manager-api`	写入
顾问	`consultant-api`	Create assignment contracts

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

Request

ENDPOINT

/assignment_contract/assignment_contract

MÉTODO

POST

Request Body
{
    "fund_class_key": "813ce253-bae5-4448-8d15-04c48d9991b7",
    "assignor_document_number": "55.666.777/0001-81",
    "assignment_contract_template_key": "2555f90a-4c6a-4d65-8bda-5d16f827840c",
    "credit_limit": 1000000,
    "external_id": "Contrato 550",
    "observation": "Contrato referente ao vínculo com coobrigação do cedente",
    "guarantors": [
        {
            "name": "Avalista da operação",
            "document_number": "969.698.790-03"
        }
    ]
}

Body Params

字段	类型	描述	字符数
`fund_class_key` *	string	基金的唯一标识 key。在创建基金时生成，由 QI DTVM 团队提供。	uuid key
`assignment_contract_template_key` *	string	合同模板的唯一标识 key。同样由 QI DTVM 团队提供。	uuid key
`assignor_document_number` **	string	转让方的证件号。	CPF 或 CNPJ，最多 18
`assignor_registry_key` **	string	转让方注册的 key，可替代 `assignor_document_number`。	uuid key
`credit_limit`	number	合同的信用额度。	1 到 1.000.000.000
`disbursement_account_key`	string	合同的放款账户。当模板的放款账户策略为 `locked_on_assignment_contract` 时必填，其他情况会被拒绝。必须是转让方处于 `active` 状态的账户。	uuid key
`external_id`	string	合同的外部标识。通常为合同编号。	最多 50
`case_number`	string	案件编号。在同一基金内唯一；省略时自动生成。	最多 17
`observation`	string	备注。可自由填写任何说明。	最多 1000
`delay`	object	逾期罚金（`fine`）和逾期利息（`interest`）。仅当模板允许自定义这些值时接受。	--
`guarantors`	array	业务的担保人。	见担保人定义。

*必填字段

**在 assignor_document_number 和 assignor_registry_key 中只能发送一个。

提示

担保人必须同时在转让方注册和此步骤中指定，这一点非常重要。如果只在注册中指定而未在合同中指定，担保人将不会签署文件。如果只在合同中指定而未在注册中指定，将返回错误。

Response

STATUS

201

响应体为完整的合同，格式与合同查询相同。节选：

Response Body
{
    "assignment_contract_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "status": "pending_document",
    "external_id": "Contrato 550",
    "case_number": "17375775230001234",
    "disbursement_account_key": null,
    "products": [
        {
            "product_key": "57efbd9f-0917-4c79-9a43-bc8f1039fc78",
            "assignment_configuration_key": null,
            "fund_class_configuration_key": "0b6f3a8e-2f7d-4c11-9a52-6a1d1c0e9f10",
            "product_type": "assignment_term",
            "asset_type": "ccb",
            "has_coobligation": true,
            "status": "pending_contract_signature"
        }
    ]
}

信息

务必保存 assignment_contract_key：它在查询和 webhook 中标识该合同，且由该合同生成的转让配置（包括通过分支机构流程产生的配置）都与之关联。如需获取所生成的产品和配置，请使用合同查询。

产品启用

没有启用接口：合同签署后，产品会自动启用。

所有文件均已签署 → 合同变为 signed，并发送带有 assignment_contract_new_status: contract_signed 的 assignment_contract.assignment_contract_status_change webhook。
在配置转让流程期间，每个产品从 pending_contract_signature 变为 pending_create_assignment_configuration。这可能需要几分钟。
流程配置完成后，产品变为 active，并发送 assignment_contract.product_status_change webhook，其中包含 assignment_configuration_key——用于在基金与转让方之间转让资产的 key。

payload 参见合同 Webhook。如不想依赖 webhook，可查询合同并读取 products[].status 和 products[].assignment_configuration_key。

担保人定义

字段	类型	描述	字符数
`name`	string	担保人姓名。	最多 255
`document_number`	string	CPF 或 CNPJ，带格式。	14 到 18

提示

如前所述，担保人必须事先与特定转让方一同注册。

枚举值

Assignment Contract Status

枚举值	描述
created	合同已创建（初始的过渡状态）
pending_document	等待生成文件
pending_manager_approval	等待管理人审批
pending_assignor_registry_release	等待所关联的转让方注册开通（处于注册或更新阶段）
pending_signature_submission	等待手动发送签署
sending_to_signature	正在发送签署
pending_signature	可供各方签署
waiting_escrow_data	等待 escrow 账户数据（仅限带 escrow 账户的模板）
pending_escrow_activation	等待 escrow 账户启用（仅限带 escrow 账户的模板）
signed	已签署
suspended	已暂停；产品在重新启用前处于 `inactive`
denied	在管理人审查中被拒绝
canceled	已取消

Product Status

枚举值	描述
pending_contract_signature	等待合同签署
pending_create_assignment_configuration	合同已签署；转让流程配置中
active	已启用；`assignment_configuration_key` 可用
inactive	未启用（合同已取消或已暂停）

Attached Document Status

枚举值	描述
pending_generate	等待生成文件
approved	文件已生成
pending_upload	等待上传文件
uploaded	文件已上传
pending_validation	文件已上传，校验中
pending_signed_upload	等待上传已签署的文件
signed	文件已签署
reproved	文件已失效（合同已取消或被拒绝）

错误

状态码	代码	触发条件
404	`ACT000001`	未找到 `fund_class_key`，或其不属于已认证的管理人。
404	`ACT000016`	未找到该基金的 `assignment_contract_template_key`。
400	`ACT000126`	模板未启用。请使用已启用的模板。
404	`ACT000065`	`assignor_document_number` 对应的转让方未针对提出方代理方注册。
404	`ACT000134`	未找到 `assignor_registry_key`，或该代理方不是该注册的所有者。
400	`ACT000142`	该转让方只有基础审查注册，不能签订合同。
400	`ACT000096`	该转让方没有已注册的账户。请在转让方账户中注册一个账户。
400	`ACT000155`	模板要求 `disbursement_account_key`，但未发送。
400	`ACT000156`	发送了 `disbursement_account_key`，但模板不接受按合同指定账户。
400	`ACT000154`	`disbursement_account_key` 不是转让方处于 `active` 状态的账户。
400	`ACT000081`	`guarantors` 中的某一项未注册为该转让方的担保人。
400	`ACT000102`	发送了 `delay`，但模板不允许自定义罚金和利息。
409	`ACT000095`	`case_number` 已在该基金中使用。请使用其他值或省略该字段。

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

Request​

Body Params​

Response​

产品启用​

担保人定义​

枚举值​

Assignment Contract Status​

Product Status​

Attached Document Status​

错误​