错误码如下

错误编码	错误描述	备注
500101	缺少用户标识或用户标识类型	补充用户标识及标识类型后重新推送。
500102	字段内容超过最大长度	根据返回的定位字段缩短内容后重新推送。
500103	缺少必填字段	补齐对应模块的必填字段；金额为空等已映射的必填校验也可能返回此码。
500201	指定用户不存在	检查当前租户下的用户是否已创建或同步；完成维护后重新推送。
500202	签订部门不存在	核对当前租户的签订部门编码和编码类型，修正后重新推送。
500203	业务归属部门不存在	核对业务归属部门编码和编码类型；定位数据可包含出错编码及编码类型。
500204	经办人不存在	核对经办人工号或用户标识及对应编码类型，修正后重新推送。
500205	合同分类不存在	核对合同分类编码或标识；先建立有效分类后重新推送。
500206	合同分类已停用	启用合同分类，或改用已启用的合同分类。
500207	员工不存在	先同步该员工，或改用已存在的员工；定位数据可包含员工工号。
500208	关联类型不存在	核对关联合同类型编码，修正后重新推送。
500209	关联类型已停用	启用对应关联类型，或改用有效的关联类型。
500210	相对方信息不存在	核对相对方标识与主数据；定位数据可包含相对方编码及编码类型。
500211	签订主体不存在或未启用	核对签订主体编码及启用状态，修正后重新推送。
500212	签订主体不能为空	补充签订主体信息后重新推送。
500213	相对方主数据查询失败	包括相对方数据或联系人查询失败；可稍后重试，持续失败时携带 traceId 联系管理员。
500214	相对方必填信息缺失（角色或名称）	补齐相对方角色、名称等必填信息后重新推送。
500215	相对方重复	去掉重复的相对方后重新推送。
500216	同一角色下的相对方顺序重复	修正同一角色下的相对方顺序后重新推送。
500217	我方主签约方必须且只能有一个	检查我方主签约方配置，确保有且只有一个。
500218	电子签章相对方缺少联系人信息	为电子签章相对方补充联系人及联系方式后重新推送。
500219	关联类型与关联合同重复	去掉重复的合同关联关系后重新推送。
500301	合同正文或模板缺失	补充合同正文或有效模板后重新推送。
500302	合同性质与模板不匹配	修正合同性质，或调整模板允许的合同性质。
500303	合同分类与模板不匹配	修正合同分类，或调整模板允许的合同分类。
500304	待签相对方缺少签署节点	为每个需要签署的相对方补齐签署节点；确实无需签署的相对方，应明确传入 signatoryFlag=false。
500305	公司签章位置不合法	公司签章需具有非骑缝章签署位置，不能仅配置骑缝章位置。
500306	个人签署位置缺失	为个人签署节点补充签署位置后重新推送。
500307	签署节点包含不需要签署的相对方	删除多余签署节点，或修正节点对应的相对方标识。
500308	计划收款合计超过合同金额	调整计划收款合计，使其不超过合同金额。
500311	合同已创建，但签约申请因签署相对方与签署节点不一致而失败	先核对原合同是否已有签约申请；确无申请时，在原合同补录全部待签相对方。勿重新推送来源单创建合同。
500312	合同已创建，但签约服务返回了未归类的错误	先核对原合同是否已有签约申请；携带来源单号及合同标识联系管理员。勿重复创建合同。
500313	合同已创建，但所选电签平台没有可用的电签账号	维护对应平台的有效电签账号后，在 OC 系统提交已创建合同。勿重新推送创建第二份合同。
500314	合同已创建，但自动提交未通过业务校验	按具体原因修改已创建合同并在 OC 系统提交；如需重新创建，应先作废原合同。
500315	来源创建未通过业务校验	未映射到专用错误码的业务校验兜底；以具体原因及 businessKey 为准。重推前先核对是否已有合同。
500320	需签署的文件数量超过上限{0}	{0}为数量上限；减少需签署文件数量后重新推送。定位数据可包含 maxFileCount。
500321	单份文件大小超过上限{0}MB	{0}为单文件大小上限；压缩文件后重新推送。定位数据可包含 maxSingleFileSizeMb。
500322	单份合同文件总容量超过上限{0}MB	{0}为文件总容量上限；减少或压缩文件后重新推送。定位数据可包含 maxTotalFileSizeMb。
500323	物料已失效	改用有效物料后重新推送；定位数据可包含物料编码。
500324	未找到对应的扩展对象数据	核对扩展字段及扩展对象配置后重新推送。
500325	模板记录不存在	核对报文中的模板标识，或先建立该模板后重新推送。
500326	单据预检数据未就绪（正文/模板/附件）	可稍后重试；持续失败时携带 traceId 联系管理员。
500327	报文字段类型非法	核对定位字段的取值类型、格式及转换要求后重新推送。
500328	未匹配到正文，无法记录自定义域变量	核对报文中的正文与自定义域变量配置后重新推送。
500330	计划收款比例合计超过100%	调整计划收款比例合计至100%以内。
500331	付款计划金额合计超过所关联合同行金额	调整付款计划金额或对应合同行金额后重新推送。
500332	付款计划金额合计超过合同总金额	调整付款计划金额，使其不超过合同总金额。
500333	计划类型不能为空	补充计划类型后重新推送。
500334	计划金额不能为空	补充计划金额后重新推送；包括周期性计划金额缺失。
500335	计划开始或截止日期非法	检查日期是否缺失，以及开始日期、截止日期的先后关系。
500336	周期性拆分参数非法（周期或金额）	核对合同周期、金额及周期性拆分要求后重新推送。
500337	行维度下收款计划缺少合同行	为收款计划补充对应合同行后重新推送。
500338	合同金额或收款计划金额异常	核对合同金额与收款计划金额，修正后重新推送。
500401	来源单正在处理中	当前来源单尚未处理完成，应稍后查询进度，勿直接重复创建。
500402	该来源单已经创建合同	使用已创建合同；如需变更，应走对应更新或重建入口。
500403	相同来源键的报文内容已变化	已定义的冲突码；当前来源创建代码及脚本快照未确认实际触发点，不能据此认定已实现报文指纹冲突校验。
500501	Redis队列投递失败	PROCESS脚本文案为“异步创建任务投递失败”；先查询处理进度，再决定是否重试，持续失败时携带 traceId 联系管理员。
500502	异步处理超时	PROCESS脚本文案为“创建逻辑执行超时”；脚本轮询超过900000毫秒（15分钟）会返回此码。超时不等于合同一定未创建，应先查进度。
500504	模板变量提取失败	已定义下游错误映射；可稍后重试，持续失败时携带 traceId 联系管理员。本次未验证实际触发。
500505	数据写入失败，请联系管理员	包括附件、付款计划、收款计划、相对方、关联关系、合同行等内部模型化或创建失败；可识别的内层业务原因优先返回对应业务码。勿盲目重复推送。
500506	后置处理类未配置	联系管理员配置后置处理类后重新处理。
500507	没有该合同的权限	使用有权限的账号，或联系管理员授权。
500508	下游服务响应无法解析	包括下游响应翻译、Feign或JSON解析失败；先查询处理结果，持续失败时携带 traceId 联系管理员。
500509	下游服务调用失败	实际文案可附带下游返回的具体失败原因；先查询处理结果，持续失败时携带 traceId 联系管理员。
500601	未找到处理记录	核对来源系统及来源单号；刚推送时可稍后重查。实际文案可包含具体来源系统和来源单号。
500602	处理试次状态冲突	已定义；当前来源创建链路及脚本快照未确认实际触发点。标准处理建议为携带 attemptId 查询指定处理试次。
500603	进度查询服务执行失败	脚本及Controller可返回“进度查询失败，请稍后重试或联系管理员”；脚本在持久化结果无法按attemptId对应接口记录时，也返回此码，文案为“中间表返回结果与接口记录无法对应”。需结合具体文案区分。
509998	历史记录未保存结构化错误	用于未保留详细编码的历史失败记录；原始错误文案可保留，不能仅凭此码判断具体业务原因。
509999	未归类的系统异常	未命中专用码时的系统兜底；可安全展示时保留原始失败信息，携带 traceId 联系管理员。

请求参数

Header 参数

Body 参数application/json

示例

{
    "data": [
        {
            "autoCreateFlag": true,
            "autoSubmit": true,
            "operateMethod": "",
            "sourceCode": "DEMO_20250101008",
            "sourceSystem": "oms",
            "contractName": "采购合同",
            "type": "oms",
            "categoryUuid": "",
            "categoryCode": "0101",
            "categoryCodeType": "CODE",
            "templateUniqueKey": "",
            "templateUniqueKeyType": "",
            "propertyCode": "ORDINARY",
            "amount": "1000.12",
            "validDateStartType": "DATE",
            "startDate": "2025-01-01",
            "validDateEndType": "DATE",
            "endDate": "2050-01-01",
            "validFlag": "",
            "sourceName": "",
            "principalId": "",
            "principalCode": "0001",
            "principalCodeType": "CODE",
            "departmentId": "",
            "departmentCode": "1001",
            "departmentCodeType": "CODE",
            "belongingDepartmentId": "",
            "belongingDepartmentCode": "1001",
            "belongingDepartmentCodeType": "CODE",
            "reCreateNewContract": false,
            "userId": "",
            "userCode": "zhenling_openapi_admin",
            "userCodeType": "LOGIN_NAME",
            "childList": [
                {
                    "childType": "partyInformation",
                    "data": [
                        {
                            "roleCode": "J",
                            "roleOrder": "1",
                            "partyNumber": "91310115MA1K4PGE3T",
                            "ourFlag": "true",
                            "ourParty": "true",
                            "sourceKey": ""
                        },
                        {
                            "roleCode": "Y",
                            "roleOrder": "2",
                            "partyNumber": "91330108MAD23G379L",
                            "ourFlag": "false",
                            "ourParty": "false",
                            "sourceKey": ""
                        }
                    ]
                },
                {
                    "childType": "contractLine",
                    "data": [
                        {
                            "price": 100.123456,
                            "quantity": 1,
                            "materialsCode": ""
                        }
                    ]
                },
                {
                    "childType": "custContractLine",
                    "data": [
                        {
                            "customLineCode": "materials",
                            "item": "物品",
                            "attributeVarchar1": "物品描述"
                        }
                    ]
                },
                {
                    "childType": "associatedInfo",
                    "data": [
                        {
                            "relContractSerialNumber": "202504080001",
                            "relContractNumber": "CON_0120250408001",
                            "typeCode": "SC"
                        }
                    ]
                },
                {
                    "childType": "signInformation",
                    "data": [
                        {
                            "sealOrder": "OSF",
                            "sealMaterial": "PHYSICALSEAL",
                            "signCount": 2,
                            "deadline": ""
                        }
                    ]
                },
                {
                    "childType": "signNode",
                    "data": [
                        {
                            "partyNumber": "91310115MA1K4PGE3T",
                            "partyNumberType": "CODE",
                            "signatoryEmpCode": "0001",
                            "signatoryEmpCodeType": "CODE"
                        },
                        {
                            "partyNumber": "91330108MAD23G379L",
                            "partyNumberType": "CODE",
                            "signatoryName": "李四"
                        }
                    ]
                },
                {
                    "childType": "collectionPlanJ",
                    "data": [
                        {
                            "planType": "ACYCLIC",
                            "totalAmount": 100,
                            "planStartDate": "2025-01-01",
                            "planEndDate": "2025-12-31"
                        }
                    ]
                },
                {
                    "childType": "custVariable",
                    "data": [
                        {
                            "fieldName": "印花税",
                            "fieldValue": "loan",
                            "isEditable": "0"
                        },
                        {
                            "fieldName": "datetime",
                            "fieldValue": "2025-11-16 09:51:54",
                            "isEditable": "0"
                        }
                    ]
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://oc-test.onecontract-cloud.com/api/hitf/v2/rest/async/invoke/SOURCE_HEADER' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: application/json' \
--data '{
    "data": [
        {
            "autoCreateFlag": true,
            "autoSubmit": true,
            "operateMethod": "",
            "sourceCode": "DEMO_20250101008",
            "sourceSystem": "oms",
            "contractName": "采购合同",
            "type": "oms",
            "categoryUuid": "",
            "categoryCode": "0101",
            "categoryCodeType": "CODE",
            "templateUniqueKey": "",
            "templateUniqueKeyType": "",
            "propertyCode": "ORDINARY",
            "amount": "1000.12",
            "validDateStartType": "DATE",
            "startDate": "2025-01-01",
            "validDateEndType": "DATE",
            "endDate": "2050-01-01",
            "validFlag": "",
            "sourceName": "",
            "principalId": "",
            "principalCode": "0001",
            "principalCodeType": "CODE",
            "departmentId": "",
            "departmentCode": "1001",
            "departmentCodeType": "CODE",
            "belongingDepartmentId": "",
            "belongingDepartmentCode": "1001",
            "belongingDepartmentCodeType": "CODE",
            "reCreateNewContract": false,
            "userId": "",
            "userCode": "zhenling_openapi_admin",
            "userCodeType": "LOGIN_NAME",
            "childList": [
                {
                    "childType": "partyInformation",
                    "data": [
                        {
                            "roleCode": "J",
                            "roleOrder": "1",
                            "partyNumber": "91310115MA1K4PGE3T",
                            "ourFlag": "true",
                            "ourParty": "true",
                            "sourceKey": ""
                        },
                        {
                            "roleCode": "Y",
                            "roleOrder": "2",
                            "partyNumber": "91330108MAD23G379L",
                            "ourFlag": "false",
                            "ourParty": "false",
                            "sourceKey": ""
                        }
                    ]
                },
                {
                    "childType": "contractLine",
                    "data": [
                        {
                            "price": 100.123456,
                            "quantity": 1,
                            "materialsCode": ""
                        }
                    ]
                },
                {
                    "childType": "custContractLine",
                    "data": [
                        {
                            "customLineCode": "materials",
                            "item": "物品",
                            "attributeVarchar1": "物品描述"
                        }
                    ]
                },
                {
                    "childType": "associatedInfo",
                    "data": [
                        {
                            "relContractSerialNumber": "202504080001",
                            "relContractNumber": "CON_0120250408001",
                            "typeCode": "SC"
                        }
                    ]
                },
                {
                    "childType": "signInformation",
                    "data": [
                        {
                            "sealOrder": "OSF",
                            "sealMaterial": "PHYSICALSEAL",
                            "signCount": 2,
                            "deadline": ""
                        }
                    ]
                },
                {
                    "childType": "signNode",
                    "data": [
                        {
                            "partyNumber": "91310115MA1K4PGE3T",
                            "partyNumberType": "CODE",
                            "signatoryEmpCode": "0001",
                            "signatoryEmpCodeType": "CODE"
                        },
                        {
                            "partyNumber": "91330108MAD23G379L",
                            "partyNumberType": "CODE",
                            "signatoryName": "李四"
                        }
                    ]
                },
                {
                    "childType": "collectionPlanJ",
                    "data": [
                        {
                            "planType": "ACYCLIC",
                            "totalAmount": 100,
                            "planStartDate": "2025-01-01",
                            "planEndDate": "2025-12-31"
                        }
                    ]
                },
                {
                    "childType": "custVariable",
                    "data": [
                        {
                            "fieldName": "印花税",
                            "fieldValue": "loan",
                            "isEditable": "0"
                        },
                        {
                            "fieldName": "datetime",
                            "fieldValue": "2025-11-16 09:51:54",
                            "isEditable": "0"
                        }
                    ]
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": "100250",
    "data": {
        "results": [
            {
                "endDate": "2050-01-01",
                "validFlag": "",
                "sourceSystem": "oms",
                "departmentId": "",
                "departmentCode": "1001",
                "principalId": "",
                "childList": [
                    {
                        "childType": "partyInformation",
                        "data": [
                            {
                                "sourceKey": "",
                                "ourParty": "true",
                                "roleCode": "J",
                                "ourFlag": "true",
                                "roleOrder": "1",
                                "partyNumber": "91310115MA1K4PGE3T"
                            },
                            {
                                "sourceKey": "",
                                "ourParty": "false",
                                "roleCode": "Y",
                                "ourFlag": "false",
                                "roleOrder": "2",
                                "partyNumber": "91330108MAD23G379L"
                            }
                        ]
                    },
                    {
                        "childType": "contractLine",
                        "data": [
                            {
                                "quantity": "1",
                                "price": "100.123456",
                                "materialsCode": ""
                            }
                        ]
                    },
                    {
                        "childType": "custContractLine",
                        "data": [
                            {
                                "item": "物品",
                                "customLineCode": "materials",
                                "attributeVarchar1": "物品描述"
                            }
                        ]
                    },
                    {
                        "childType": "associatedInfo",
                        "data": [
                            {
                                "relContractSerialNumber": "202504080001",
                                "relContractNumber": "CON_0120250408001",
                                "typeCode": "SC"
                            }
                        ]
                    },
                    {
                        "childType": "signInformation",
                        "data": [
                            {
                                "signCount": "2",
                                "sealOrder": "OSF",
                                "sealMaterial": "PHYSICALSEAL",
                                "deadline": ""
                            }
                        ]
                    },
                    {
                        "childType": "signNode",
                        "data": [
                            {
                                "signatoryEmpCodeType": "CODE",
                                "partyNumberType": "CODE",
                                "signatoryEmpCode": "0001",
                                "partyNumber": "91310115MA1K4PGE3T"
                            },
                            {
                                "partyNumberType": "CODE",
                                "signatoryName": "李四",
                                "partyNumber": "91330108MAD23G379L"
                            }
                        ]
                    },
                    {
                        "childType": "collectionPlanJ",
                        "data": [
                            {
                                "totalAmount": "100",
                                "planType": "ACYCLIC",
                                "planStartDate": "2025-01-01",
                                "planEndDate": "2025-12-31"
                            }
                        ]
                    }
                ],
                "type": "oms",
                "userCodeType": "LOGIN_NAME",
                "userCode": "zhenling_openapi_admin",
                "autoSubmit": true,
                "sourceCode": "DEMO_20250101007",
                "propertyCode": "ORDINARY",
                "validDateStartType": "DATE",
                "principalCode": "0001",
                "subCode": "500003",
                "belongingDepartmentCode": "1001",
                "departmentCodeType": "CODE",
                "validDateEndType": "DATE",
                "belongingDepartmentId": "",
                "templateUniqueKeyType": "",
                "amount": "1000.12",
                "operateMethod": "",
                "categoryCode": "0101",
                "autoCreateFlag": true,
                "principalCodeType": "CODE",
                "reCreateNewContract": false,
                "userId": "",
                "categoryCodeType": "CODE",
                "categoryUuid": "",
                "templateUniqueKey": "",
                "belongingDepartmentCodeType": "CODE",
                "sourceName": "",
                "subMessage": "[DEMO_20250101007]来源单数据已经创建了非草稿状态的合同, 需要先作废已存在合同再来源创建",
                "startDate": "2025-01-01"
            }
        ]
    },
    "message": "简单校验失败"
}

3.1 创建合同

错误码如下#

请求参数

请求示例代码

返回响应

错误码如下