跳到主要内容

插入文件

为处于 pending_document 的补充协议发送补充协议书。收到文件后，补充协议进入 pending_approval。

仅当补充协议流程要求提供文件时（amendment_configuration.requires_document: true）才接受。在不要求文件的流程中，API 返回 AAM000038。

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

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

管理人

manager-api 不提供此端点。管理人的补充协议停留在 pending_document 时如何处理，参见创建补充协议申请。

Request​

ENDPOINT
/asset_amendment/fund_class/FUND_CLASS_KEY/amendment_configuration/AMENDMENT_CONFIGURATION_KEY/asset_amendment/ASSET_AMENDMENT_KEY/document
MÉTODO
POST
Request Body
{
    "document_type": "amendment_term",
    "document_b64": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSPj4Kc3RyZWFtCg=="
}

Body Params​

字段类型描述
document_type *string文件类型。唯一可接受的值：amendment_term
document_b64 *string补充协议书的 PDF 文件，以 Base64 编码

Response​

STATUS
201

响应为更新后的补充协议，格式与创建申请相同。

Response Body
{
    "asset_amendment_key": "a914aac6-93ff-45ee-8574-f4dbaf6c0642",
    "status": "pending_approval",
    "amendment_type": "all_contract",
    "amendment_configuration": {
        "amendment_configuration_key": "5f0d3a52-8c1e-4b8e-9a51-2f6a8f0c1d22",
        "fund_class": {
            "fund_class_key": "<fund_class_key>",
            "document_number": "11.222.333/0001-81",
            "name": "FUNDO EXEMPLO FIDC",
            "manager": {
                "manager_key": "<manager_key>",
                "document_number": "22.333.444/0001-81",
                "manager_name": "GESTORA EXEMPLO LTDA"
            },
            "accounting_date": "2024-04-01"
        },
        "requires_document": true
    },
    "asset_type": "ccb",
    "asset_key": "0b6f6c55-5d1b-4b6e-8f3a-6c1f0f7f2b10",
    "amendment_date": "2024-04-01",
    "asset_external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "source": "api_integration",
    "status_history": [
        {
            "status": "pending_document",
            "event_datetime": "2024-04-01T13:02:45Z"
        },
        {
            "status": "pending_approval",
            "event_datetime": "2024-04-01T13:10:02Z"
        }
    ]
}

错误​

状态码代码触发条件
400AAM000038该补充协议流程不要求文件
400AAM000026document_type 不是 amendment_term
400AAM000025document_b64 不是有效的 Base64
404AAM000009在该基金和该流程中未找到补充协议

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