跳到主要内容

公共债券交易单

请求​

ENDPOINT
/trade_treasury/public/fund_class/{fund_class_key}/operation
METHOD
POST

路径参数​

参数类型描述
fund_class_keystring基金的唯一标识符。
Request Body
{
    "external_id": "a3f1c2e4-7b8d-4e6f-9a0b-1c2d3e4f5a6b",
    "operation_date": "2025-12-04",
    "payment_date": "2025-12-04",
    "operation_part": "assignee",
    "operation_type": "outright_operation",
    "counterparty": {
        "iselic_number": "20824264",
        "selic_account_number": "123456789",
        "document_number": "20.824.264/0001-77"
    },
    "treasury_type": "ntn_b",
    "unit_price": 1234.567891,
    "units": 10,
    "maturity_date": "2035-05-15"
}

请求体属性​

字段类型必填性描述
external_idstring可选用于幂等性的外部标识符（UUID）。若未提供则自动生成。最多36个字符。
operation_datestring (date)必填操作日期，格式 YYYY-MM-DD。必须为工作日且等于基金的 accounting_date。
payment_datestring (date)必填结算日期，格式 YYYY-MM-DD。必须 >= operation_date。非定期操作（outright_operation、buyback_operation）必须等于 operation_date。
operation_partstring必填基金角色：assignee（买方）或 assignor（卖方）。
operation_typestring必填操作类型：outright_operation、buyback_operation。buyback_operation 要求 operation_part == "assignee"。
counterpartyobject必填交易对手数据。见下方对象说明。
treasury_typestring必填债券类型：lft、ltn、ntn_b 或 ntn_f。
unit_pricenumber必填债券单价。接受任意精度；服务器将按类型向下截断：buyback_operation → 8位小数；其他 → 6位小数。
unitsinteger必填债券数量（正整数）。
maturity_datestring (date)必填债券到期日（YYYY-MM-DD）。必须严格晚于 operation_date。
yearly_negotiated_ratenumber条件性年化协商利率（%）。buyback_operation 必填。
return_datestring (date)条件性返还日期（YYYY-MM-DD）。buyback_operation 必填。必须 > operation_date。

counterparty 对象​

字段类型必填性描述
iselic_numberstring必填交易对手的iSELIC编号（8位数字）。
selic_account_numberstring必填交易对手的SELIC账户号码（9位数字）。
document_numberstring必填带标点的交易对手CNPJ（格式 XX.XXX.XXX/XXXX-XX）。

响应​

STATUS
201
Response Body
{
    "operation_key": "85cfd700-54a4-40f4-bc61-2ece992864ea",
    "external_id": "a3f1c2e4-7b8d-4e6f-9a0b-1c2d3e4f5a6b",
    "fund_class": {
        "fund_class_key": "5122bf31-660a-4f61-a447-38e5e17162dd",
        "manager_key": "bea7581a-f901-4995-a486-46e18ae61aab",
        "name": "EXAMPLE FUND DTVM",
        "document_number": "81.692.758/0001-30",
        "accounting_date": "2025-12-04"
    },
    "status": "pending_manager_approval",
    "operation_part": "assignee",
    "operation_type": {
        "enumerator": "outright_operation",
        "code": 1052
    },
    "treasury": {
        "enumerator": "ntn_b",
        "code": 760199
    },
    "operation_date": "2025-12-04",
    "payment_date": "2025-12-04",
    "maturity_date": "2035-05-15",
    "total_operation_value": 12345.67,
    "units": 10,
    "unit_price": 1234.567891,
    "counterparty": {
        "iselic_number": "20824264",
        "document_number": "20.824.264/0001-77",
        "selic_account_number": "123456789"
    },
    "isin_code": "BRSTNCNTB633",
    "issue_date": "2025-11-04",
    "operation_data": {}
}

响应属性​

字段类型描述
operation_keystringQI Tech生成的操作唯一标识符（UUID）。
external_idstring请求中提供或自动生成的外部标识符。
fund_classobject与操作关联的基金数据。
statusstring操作的初始状态。
operation_partstringassignee（买方）或 assignor（卖方）。
operation_typeobject{ enumerator, code } — 操作类型及对应SELIC代码。
treasuryobject{ enumerator, code } — 债券类型及对应SELIC代码。
operation_datestring操作日期（YYYY-MM-DD）。
payment_datestring结算日期（YYYY-MM-DD）。
maturity_datestring债券到期日（YYYY-MM-DD）。
total_operation_valuedecimal操作总价值（数量 × 单价）。
unitsinteger债券数量。
unit_pricenumber债券单价。
counterpartyobject交易对手数据（iselic_number、document_number、selic_account_number）。
isin_codestring债券ISIN代码。
issue_datestring债券发行日期（YYYY-MM-DD）。
operation_dataobject操作的附加内部元数据。