2.2 相对方创建及更新
test-测试环境
https://oc-test.onecontract-cloud.com
test-测试环境
https://oc-test.onecontract-cloud.com
POST
/api/hitf/v2/rest/async/invoke/trading
推荐场景：同步上游系统相对方主数据至合同系统，从而保持两边系统主数据的一致性
错误码如下
| 错误编码 | 错误描述 | 备注 |
|---|---|---|
| 410001 | 请求体不是合法的 JSON 数组，无法解析批量记录，处理建议：按接口文档提交 JSON 数组格式的请求体后重试 | 无模块前缀（整包解析失败，无具体模块） |
| 410002 | 模块[{0}]：模块数据无法反序列化为接口约定的结构，处理建议：核对模块字段类型与结构后重试 | |
| 410005 | 模块[{0}]：数据同时缺少 id 与 sourceKey，无法定位目标记录（数据标识：{1}），处理建议：补齐 id 或 sourceKey 后重试 | 各模块通用 |
| 410006 | 模块[{0}]：缺少所属主体或相对方上下文（数据标识：{1}），处理建议：先修复主体或业务信息模块的错误后重试 | |
| 410101 | 模块[{0}]：境内主体必填字段缺失（数据标识：{1}），处理建议：补齐主体名称、证件类型、证件号、账户类型和主体编码后重试 | |
| 410102 | 模块[{0}]：境外主体必填字段 {2} 缺失（数据标识：{1}），处理建议：补齐主体名称、账户类型和主体编码后重试 | |
| 410103 | 模块[{0}]：主体证件规则不满足，证件类型 {2} 与证件号不匹配（数据标识：{1}），处理建议：核对对应证件类型的证件号后重试 | |
| 410104 | 模块[{0}]：主体唯一性冲突，{2}已存在（数据标识：{1}），处理建议：使用已有主体标识或先处理重复数据 | {2} 为「证件号」或「主体名称」：境外按名称判重、境内按证件号判重 |
| 410105 | 模块[{0}]：主体编码重复（数据标识：{1}），处理建议：使用已有主体标识或修改主体编码后重试 | |
| 410107 | 模块[{0}]：主体更新目标已消失（数据标识：{1}），处理建议：刷新主体数据后重试 | |
| 410202 | 模块[{0}]：请求 id 与已有记录冲突（数据标识：{1}；已有记录 id：{2}；请求 id：{3}），处理建议：使用已有记录 id/sourceKey 或先合并重复数据 | |
| 410203 | 模块[{0}]：请求 sourceKey 与已有记录冲突（数据标识：{1}；已有记录 sourceKey：{2}；请求 sourceKey：{3}），处理建议：使用已有记录 id/sourceKey 或先合并重复数据 | |
| 410204 | 模块[{0}]：该业务信息已归属于其他主体（数据标识：{1}；已有记录所属主体：{2}；请求所属主体：{3}），处理建议：核对主体或先处理重复数据 | |
| 410205 | 模块[{0}]：新增业务信息时命中数据库唯一键冲突（数据标识：{1}），处理建议：查询已有业务信息后使用其标识重试 | |
| 410206 | 模块[{0}]：业务信息更新目标不存在（数据标识：{1}），处理建议：刷新数据并核对业务信息标识后重试 | |
| 410301 | 模块[{0}]：授权单位编码缺失（数据标识：{1}），处理建议：补齐 unitCode 后重试 | |
| 410302 | 模块[{0}]：授权单位在组织平台不存在（数据标识：{1}），处理建议：核对组织平台中的 unitCode 后重试 | |
| 410401 | 模块[{0}]：银行必填字段 {2} 缺失（数据标识：{1}），处理建议：补齐银行名称、账户名和账号后重试 | |
| 410501 | 模块[{0}]：联系人必填字段 {2} 缺失（数据标识：{1}），处理建议：补齐联系人名称和类型后重试 | |
| 410502 | 模块[{0}]：默认联系人重复（数据标识：{1}），处理建议：仅保留一个默认联系人 | |
| 410601 | 模块[{0}]：适用规则编码缺失（数据标识：{1}），处理建议：补齐 applyRuleCode 后重试 | |
| 410701 | 模块[{0}]：资质必填字段 {2} 缺失（数据标识：{1}），处理建议：补齐资质类型、名称和文件 Key 后重试 | |
| 419001 | 模块[{0}]：同一主体正在处理，等待锁超时（数据标识：{1}），处理建议：等待前一请求完成后重试，避免并发重复提交 | |
| 419002 | 模块[{0}]：数据版本冲突（数据标识：{1}），处理建议：刷新数据后重试 | |
| 419003 | 模块[{0}]：数据库唯一键冲突（数据标识：{1}），处理建议：核对已有记录，避免重复提交 | |
| 419999 | 模块[{0}]：未分类系统异常（数据标识：{1}），处理建议：联系管理员并提供请求时间及数据标识 |
请求参数
Header 参数
Body 参数application/json