创建合同

在基金与供应商之间创建费用合同。合同的初始状态为 pending_submission。之后，请上传文件并提交审核。

创建合同

适用范围

角色	主机	所需权限
管理人	manager-api	写入
顾问	consultant-api	创建费用合同

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

ENDPOINT

/expense_contract/fund_class/{fund_class_key}/contract

方法

POST

路径参数

参数	类型	说明
fund_class_key	string	基金类别的 key（UUID）。

Corpo da requisição

{
    "name": "Contrato de auditoria 2027",
    "vendor_key": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9",
    "signature_method": "certifiqi",
    "expense_types": [
        {
            "expense_type": "audit_tax"
        }
    ],
    "recurrences": [
        {
            "expense_type": "audit_tax",
            "description": "Auditoria anual - parcela mensal",
            "amount": 2500.00,
            "start_date": "2027-01-01",
            "end_date": "2027-12-31"
        }
    ],
    "expiration_date": "2027-12-31"
}

请求体字段

字段	类型	是否必填	说明
name	string	是	合同名称，1 至 255 个字符。
vendor_key	string	是	供应商的 key，36 个字符。
signature_method	string	是	certifiqi 或 qi_sign：通过 QI Tech 电子签署。external：上传的文件已签署。参见合同签署。
expense_types	array	是	合同的费用类型，不可重复。每项仅包含 expense_type。参见可接受的类型。
expense_types[].expense_type	string	是	费用类型。
recurrences	array	否	自动的月度费用，可在定期费用中查询。如果发送，expense_types 中的每种类型必须恰好对应一项。
recurrences[].expense_type	string	是	定期费用的费用类型。
recurrences[].description	string	是	所生成费用的描述，1 至 200 个字符。
recurrences[].amount	number	是	月度金额，大于零。
recurrences[].start_date	string	是	开始日期，YYYY-MM-DD。
recurrences[].end_date	string	是	结束日期，YYYY-MM-DD，或 null 表示定期费用无结束日期。不能早于 start_date。
expiration_date	string	否	合同到期日，YYYY-MM-DD，或 null。如果未提供，自动读取会填入在文件中找到的日期。

不在此表中的字段会被拒绝，返回 QIT000001。

响应

STATUS

201

Corpo da resposta

{
    "contract_key": "3f2b8c1e-7d4a-4e9b-9a61-0c5d2e8f4b17",
    "name": "Contrato de auditoria 2027",
    "status": "pending_submission",
    "fund_class_key": "9a7c3d52-1b8e-4f0a-8c2d-6e4b1f9a0d33",
    "fund_class": {
        "fund_class_key": "9a7c3d52-1b8e-4f0a-8c2d-6e4b1f9a0d33",
        "name": "FIDC EXEMPLO",
        "document_number": "33.444.555/0001-81",
        "manager_key": "a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c"
    },
    "vendor": {
        "vendor_key": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9",
        "name": "AUDITORES EXEMPLO S.A.",
        "document_number": "44.555.666/0001-81",
        "status": "registered",
        "agent_key": "a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c"
    },
    "consultant_key": null,
    "signature_method": "certifiqi",
    "expiration_date": "2027-12-31",
    "ai_analysis": null,
    "reproval_reason": null,
    "reproval_details": null,
    "amended_contract_key": null,
    "root_contract_key": null,
    "created_at": "2026-11-09T14:03:22.512345",
    "expense_types": [
        {
            "expense_type": "audit_tax",
            "sub_class_key": null
        }
    ],
    "parametrizations": [
        {
            "parametrization_key": "0b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
            "expense_type": "audit_tax",
            "sub_class_key": null,
            "status": "pending",
            "target": "recurring_expense",
            "external_configuration_key": null,
            "configuration_data": {
                "expense_type": "audit_tax",
                "description": "Auditoria anual - parcela mensal",
                "amount": 2500.0,
                "start_date": "2027-01-01",
                "end_date": "2027-12-31"
            }
        }
    ],
    "attachments": [],
    "terminations": []
}

合同字段

字段	类型	说明
contract_key	string	合同的 key（UUID）。
name	string	合同名称。
status	string	状态。参见合同状态。
fund_class_key	string	基金类别的 key。
fund_class	object	fund_class_key、name、document_number、manager_key。
vendor	object	vendor_key、name、document_number、status 以及 agent_key（供应商的所有者）。status 为 created、pending_analysis、registered（供应商已获批）、inactive 或 expired。
consultant_key	string	录入该合同的顾问，或 null。
signature_method	string	certifiqi、qi_sign 或 external。由 QI Tech 在基金设立时创建的合同为 null。
expiration_date	string	到期日，YYYY-MM-DD，或 null。
ai_analysis	object	最近一次对文件的自动读取：ai_analysis_key、status（sent、valid、inconclusive 或 failed）以及 analysis_result（从文件中读取的数据，或 null）。提交审核前为 null。
reproval_reason	string	驳回原因，或 null。参见驳回原因。
reproval_details	string	驳回详情，最多 1000 个字符，或 null。
amended_contract_key	string	如果该合同是补充协议，则为其替代的合同；否则为 null。
root_contract_key	string	补充协议链中的原始合同，或 null。
created_at	string	创建时间，不带时区的 ISO 8601。
expense_types	array	expense_type 和 sub_class_key（通过 API 创建的合同中始终为 null）。
parametrizations	array	合同的定期费用：parametrization_key、expense_type、sub_class_key、status、target、external_configuration_key 以及 configuration_data（发送的定期费用）。status 和 target 的取值见下文。
attachments	array	附件：attachment_key、status、created_at。参见附件。
terminations	array	解除申请：termination_key、status、termination_details、reproval_details、created_at。参见解除。

parametrizations[].status：

• pending：合同尚未生效。
• active：合同生效中。
• inactive：合同已被取消、驳回、替代或已到期。
• canceled：定期费用在编辑中被移除。

parametrizations[].target 为 recurring_expense。基金设立时创建的合同还会有 quota_fee、performance_fee 和 expense_control。

错误

状态	code	发生情形
400	QIT000001	请求体无效：缺少必填字段、expense_types 中有重复类型、值不在列表中或包含未定义的字段。
400	ECT000040	expiration_date 不是有效日期，例如 2027-02-30。
400	ECT000012	该费用类型在基金设立时签约：administration_tax、management_tax、performance_fee 或 credit_rights_registration_fee。
400	ECT000010	该费用类型不存在或不使用合同。参见可接受的类型。
400	ECT000061	某条定期费用的 end_date 早于 start_date。
400	ECT000045	recurrences 未为每种申报的类型恰好提供一条定期费用。
404	ECT000005	基金类别不存在，或您无权访问该基金类别。
404	ECT000008	供应商不存在，或既不属于该管理人，也不属于在该基金拥有“创建费用合同”权限的顾问。
409	ECT000015	供应商为 inactive。
409	ECT000059	供应商登记已到期（expired）。
409	ECT000014	该费用类型已出现在本基金与该供应商之间另一份进行中、active 或 expired 的合同中。消息中提到 sub class None，这是因为通过 API 创建的合同没有子类别。
409	ECT000029	本基金与该供应商之间的某份合同已被合规部门永久驳回。两者之间不能再创建新合同。

Exemplo

{
  "title": "Expense type already contracted",
  "description": "The expense type audit_tax for the sub class None is already in another open, active or expired contract of this fund class and vendor.",
  "translation": "O tipo de despesa audit_tax da sub-classe None ja esta em outro contrato em andamento, ativo ou expirado deste fundo e fornecedor.",
  "code": "ECT000014"
}

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

下一步

合同文件：获取上传 URL 并上传 PDF。