2.2 相对方创建及更新

相对方创建、更新、删除接口，支持到字段级别的精确更新。
推荐场景：同步上游系统相对方主数据至合同系统，从而保持两边系统主数据的一致性

请求参数

Header 参数

Authorization

string

可选

默认值:

Body 参数application/json

data

array [object {4}]

请求数据

必需

tradingPartyMain

object

相对方主体信息

可选

主要包含工商信息、法人、开票信息，指公司维度的数据

tradingParty

object

相对方

可选

当一家公司有多个角色，如同时为客户、供应商时，可以创建多个相对方到相对方主体下。

tradingBank

object

相对方银行列表

可选

tradingContacts

object

相对方联系人列表

可选

示例

{
    "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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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"
                    }
                ]
            }
        }
    ]
}'

application/json

Body

code

string

必需

data

object

必需

batchId

string

异步任务ID

必需

message

string

必需

示例

{
    "code": "string",
    "data": {
        "batchId": "string"
    },
    "message": "string"
}

请求参数

示例代码

返回响应