甄零开放平台
  1. 2.主数据
甄零开放平台
  • 开发者指南
    • 开发者指南(必读)
    • 集成示例(必读)
    • 错误码
    • 数据字典
    • 更新日志
  • 1.认证及授权
    • 1.1 获取 Token
      POST
  • 2.主数据
    • 2.1 相对方批量查询
      POST
    • 2.2 相对方创建及更新
      POST
    • 4.1 组织信息创建及更新
      POST
    • 4.2 岗位创建及更新
      POST
    • 4.3 员工创建及更新
      POST
    • 4.4 值集创建及更新-已下线
      POST
    • 4.4 值集创建及更新
      POST
    • 4.5 独立值集值查询
      POST
    • 5.3 物料创建及更新
      POST
  • 3.合同管理
    • 查询合同关联数据[3.27-3.41]
      • 3.27 查询合同相对方
      • 3.28 查询合同关联资源
      • 3.29 查询合同关联关系
      • 3.30 查询合同租赁条款
      • 3.31 查询合同扩展信息
      • 3.32 查询合同自定义合同行
      • 3.33 查询合同行
      • 3.34 查询合同付款计划
      • 3.35 查询合同收款计划
      • 3.36 查询合同审批记录
      • 3.37 查询合同归档信息
      • 3.38 查询合同归附件
      • 3.39 查询合同授权信息
      • 3.40 查询合同正文
      • 3.41 查询合同签约信息
    • 变更[3.45-3.48]
      • 3.19 查询合同是否存在在途的变更
      • 3.45 合同老变更删除
      • 3.46 合同新变更删除
      • 3.47 旧变更提交校验接口
      • 3.48 是否可发起新变更校验接口
    • 3.4 合同文件上传
      POST
    • 3.5 获取文件预览链接
      POST
    • 3.6 模板变量查询
      POST
    • 3.7 合同正文及附件下载
      POST
    • 3.11 通过fileKey下载文件
      GET
    • 3.15 通用附件上传接口
      POST
    • 3.21 批量合同删除
      POST
    • 3.24 合同列表查询
      POST
    • 3.26 来源创建上传文件清空
      POST
    • 3.40 创建合同
      POST
    • 3.49 合同修改及变更
      POST
    • 合同取消归档
      POST
    • 合同履约信息更新
      POST
  • 6.合同履行
    • 6.4 付款计划支付回调-新合同履行
    • 6.5 付款计划创建-新合同履行
    • 6.6 收款计划查询
    • 6.7 开票信息查询
  • 7.工作流
    • 7.1 个人待办列表查询接口
    • 7.2 个人已办列表查询接口
    • 7.4 审批拒绝指定工作流
    • 7.5 审批同意指定工作流
    • 7.7 租户已办列表查询接口
    • 7.8 外部系统审批后回调
  1. 2.主数据

2.2 相对方创建及更新

test-测试环境
https://oc-test.onecontract-cloud.com
test-测试环境
https://oc-test.onecontract-cloud.com
POST
/api/hitf/v2/rest/async/invoke/trading
相对方创建、更新、删除接口，支持到字段级别的精确更新。
推荐场景：同步上游系统相对方主数据至合同系统，从而保持两边系统主数据的一致性

请求参数

Header 参数

Body 参数application/json

示例
{
    "data": [
        {
            "tradingPartyMain": {
                "sourceKey": "91310115MA1K4PGE3T",
                "mainPartyNumber": "91310115MA1K4PGE3T",
                "mainPartyName": "上海甄零科技有限公司",
                "accountType": "COMPANY",
                "mainPartyShortName": "上海甄零",
                "ourPartyFlag": 1,
                "overseasFlag": 0,
                "mainActiveFlag": 1,
                "mainApprovalStatus": "APPROVED",
                "mainActiveDescription": "审核通过",
                "registerDate": "2021-02-02",
                "validFromDate": "2021-02-02",
                "validEndDate": "",
                "certificateType": "11",
                "certificateNumber": "91310115MA1K4PGE3T",
                "faxNumber": "",
                "address": "中国（上海）自由贸易试验区春芳路400号1幢3层",
                "registeredCapital": "1710.8066万元",
                "legalPerson": "谢伟虎",
                "legalCertificateType": "",
                "legalCertificateNumber": "",
                "billCompanyName": "上海甄零科技有限公司",
                "billIdentificationNumber": "91310115MA1K4PGE3T",
                "billAddress": "",
                "billTelNumber": "",
                "billBankName": "招商银行张江支行",
                "billBankAccountNumber": "20250101001",
                "autoSign": 0,
                "checkFlag": 0
            },
            "tradingParty": {
                "partyNumber": "91310115MA1K4PGE3T",
                "partyName": "上海甄零科技有限公司",
                "sourceKey": "91310115MA1K4PGE3T",
                "customerSupplier": "W",
                "activeFlag":1,
                "approvalStatus": "APPROVED",
                "insideOutside": "L",
                "partyImportanceCode": "",
                "startDate": "2024-01-01",
                "endDate": "",
                "sourceUpSystemFlag": 0,
                "upSystemId": "",
                "companyProperty": "",
                "mdmBpCode": "",
                "validCustomer": 0,
                "validSupplier": 0,
                "partyLabel": ""
            },
            "tradingBank": {
                "operationType": "incremental",
                "data": [
                    {
                        "operation": "ADD",
                        "sourceKey": "20240101001",
                        "accountName": "上海甄零科技有限公司",
                        "accountNumber": "20240101001",
                        "bankName": "招商银行",
                        "branchName": "招商银行张江支行",
                        "branchCode": "",
                        "branchCountry": "",
                        "branchProvince": "",
                        "branchCity": "",
                        "branchAddress": "",
                        "interBankNo": "",
                        "acquiescent": 0,
                        "active": 1
                    }
                ]
            },
            "tradingContacts": {
                "operationType": "incremental",
                "data": [
                    {
                        "operation": "ADD",
                        "contactName": "张三",
                        "contactType": "TEXTOWNER,CHOPOWNER",
                        "nationality": "中国",
                        "sex": "M",
                        "jobTitle": "业务经理",
                        "officePhone": "",
                        "email": "support@onecontract-cloud.com",
                        "mobilePhone": "13500000000",
                        "faxNumber": "",
                        "certificateType": "19",
                        "certificateNumber": "430524202001012444",
                        "acquiescent": 1,
                        "active": 1,
                        "sourceKey": "430524202001012444"
                    }
                ]
            }
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://oc-test.onecontract-cloud.com/api/hitf/v2/rest/async/invoke/trading' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": [
        {
            "tradingPartyMain": {
                "sourceKey": "91310115MA1K4PGE3T",
                "mainPartyNumber": "91310115MA1K4PGE3T",
                "mainPartyName": "上海甄零科技有限公司",
                "accountType": "COMPANY",
                "mainPartyShortName": "上海甄零",
                "ourPartyFlag": 1,
                "overseasFlag": 0,
                "mainActiveFlag": 1,
                "mainApprovalStatus": "APPROVED",
                "mainActiveDescription": "审核通过",
                "registerDate": "2021-02-02",
                "validFromDate": "2021-02-02",
                "validEndDate": "",
                "certificateType": "11",
                "certificateNumber": "91310115MA1K4PGE3T",
                "faxNumber": "",
                "address": "中国（上海）自由贸易试验区春芳路400号1幢3层",
                "registeredCapital": "1710.8066万元",
                "legalPerson": "谢伟虎",
                "legalCertificateType": "",
                "legalCertificateNumber": "",
                "billCompanyName": "上海甄零科技有限公司",
                "billIdentificationNumber": "91310115MA1K4PGE3T",
                "billAddress": "",
                "billTelNumber": "",
                "billBankName": "招商银行张江支行",
                "billBankAccountNumber": "20250101001",
                "autoSign": 0,
                "checkFlag": 0
            },
            "tradingParty": {
                "partyNumber": "91310115MA1K4PGE3T",
                "partyName": "上海甄零科技有限公司",
                "sourceKey": "91310115MA1K4PGE3T",
                "customerSupplier": "W",
                "activeFlag":1,
                "approvalStatus": "APPROVED",
                "insideOutside": "L",
                "partyImportanceCode": "",
                "startDate": "2024-01-01",
                "endDate": "",
                "sourceUpSystemFlag": 0,
                "upSystemId": "",
                "companyProperty": "",
                "mdmBpCode": "",
                "validCustomer": 0,
                "validSupplier": 0,
                "partyLabel": ""
            },
            "tradingBank": {
                "operationType": "incremental",
                "data": [
                    {
                        "operation": "ADD",
                        "sourceKey": "20240101001",
                        "accountName": "上海甄零科技有限公司",
                        "accountNumber": "20240101001",
                        "bankName": "招商银行",
                        "branchName": "招商银行张江支行",
                        "branchCode": "",
                        "branchCountry": "",
                        "branchProvince": "",
                        "branchCity": "",
                        "branchAddress": "",
                        "interBankNo": "",
                        "acquiescent": 0,
                        "active": 1
                    }
                ]
            },
            "tradingContacts": {
                "operationType": "incremental",
                "data": [
                    {
                        "operation": "ADD",
                        "contactName": "张三",
                        "contactType": "TEXTOWNER,CHOPOWNER",
                        "nationality": "中国",
                        "sex": "M",
                        "jobTitle": "业务经理",
                        "officePhone": "",
                        "email": "support@onecontract-cloud.com",
                        "mobilePhone": "13500000000",
                        "faxNumber": "",
                        "certificateType": "19",
                        "certificateNumber": "430524202001012444",
                        "acquiescent": 1,
                        "active": 1,
                        "sourceKey": "430524202001012444"
                    }
                ]
            }
        }
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": "string",
    "data": {
        "batchId": "string"
    },
    "message": "string"
}
上一页
2.1 相对方批量查询
下一页
4.1 组织信息创建及更新
Built with