导入往来单位信息
说明
当已经在每刻系统中维护好了往来单位及分类信息时，可以使用该接口新增/更新往来单位信息。
- 往来单位的businessCode在系统中不存在，会新增；已存在则更新。
- 往来单位中英文名称在系统都不存在，会新增；存在其中一个则更新另一个名称，若中英文分别存在两个不同往来位中，则不允许。
- 本接口采用部分失败模式，一条数据失败不影响其他正确数据
- 往来单位分类信息，需要进入系统内手工维护，目前无法通过接口实时同步。
接口限制
入参的往来单位编码最多150个。
接口地址
/api/openapi/tradingPartner/batch/save
请求类型
POST
请求参数
参数说明
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| parentName | String(50) | 否 | 所属分类名称,不超过50个字符，为空表示根分类。多级时以','分割，例如："华东,四区"；注意：分类名称名称中不能含有","，否则会报错‘往来单位分类不存在’。 |
| parentBizCode | String | 否 | 所属分类业务编码，与parentName作用相同。 若和parentName同时存在，则以parentBizCode参数为准（若parentBizCode值不存在则会报错） |
| name | String(500) | 否 | 往来单位中文名，中英文名不能同时为空 |
| nameEn | String(500) | 否 | 往来单位英文名，中英文名不能同时为空 |
| partnerType | String(10) | 是 | 往来关系，可选值为："供应商"、"客户"、"供应商，客户"（既是供应商又是客户的情况下以中文逗号分隔(供应商在前)） |
| partnerProperty | String(15) | 是 | 往来性质，可选值为："公司"、"个体工商户" |
| businessCode | String(50) | 是 | 往来单位编码,不超过50个字符 |
| taxNumber | String(200) | 否 | 税务登记号,不超过200个字符 |
| readOnly | boolean | 否 | 是否只读，默认false。如果为true，那么在每刻系统中往来单位的所有信息（如权限范围、收款账户等）均无法修改。（接口更新操作不受限制） |
| reMark | String(100) | 否 | 往来单位备注 |
| enabled | boolean | 否 | 是否启用（true:启用；false:禁用）。若该参数为空，新增则默认为true，更新则保持系统内状态。 |
| contactName | String(300) | 否 | 联系人姓名 不填时视为维持原数据 填写空字符串时视为清除原数据 |
| contactPhone | String(300) | 否 | 联系电话 不填时视为维持原数据 填写空字符串时视为清除原数据 |
| contactEmail | String(300) | 否 | 联系邮箱 不填时视为维持原数据 填写空字符串时视为清除原数据 |
| contactAddress | String(500) | 否 | 联系地址 不填时视为维持原数据 填写空字符串时视为清除原数据 |
| customObject | CustomObject | 否 | 自定义字段， 不填时视为维持原数据 填写空对象时视为清除原数据 |
| updateCustomObject | boolean | 否 | 是否对CustomObject进行比对。 false:不比对，即覆盖；true:比对,仅更新匹配的参数, 没匹配的忽略。 默认false |
参数样例
{
"partnerList": [
{
"parentName": "分类1号",
"name": "测试供应商",
"nameEn": "englisName",
"partnerType": "供应商",
"partnerProperty": "公司",
"businessCode": "MK001",
"readOnly": false,
"reMark": "备注",
"enabled": true,
"contactName": "",
"contactPhone": null,
"contactEmail": "",
"contactAddress": null,
"updateCustomObject": true,
"customObject": {
"CF31": 333
}
},
{
"parentBizCode": "CODE001",
"name": "测试供应商2",
"nameEn": "englisName2",
"partnerType": "供应商",
"partnerProperty": "公司",
"businessCode": "MK002",
"readOnly": false,
"reMark": "备注",
"contactName": "",
"contactPhone": "",
"contactEmail": "",
"contactAddress": "",
"updateCustomObject": true,
"customObject": {
"CF31": 444
}
}
]
}
响应参数
响应参数说明
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| businessCode | String(80) | 是 | 往来单位编码 |
| status | String(20) | 是 | SUCCESS 成功，ALL_FAIL 全部失败 |
| message | String(200) | 是 | 错误提示 |
参数样例
{
"code":"ACK",
"message":"操作成功！",
"data":[
{
"businessCode":"Mk001",
"status":"SUCCESS",
"message":""
},
{
"businessCode":"MK002",
"status":"ALL_FAIL",
"message":"往来单位已创建"
}
],
"errorCode":null,
"success":true
}
常见报错及解决方案
| 报错信息 | 异常说明/解决方案 |
|---|---|
| 往来单位已创建 | 系统内开启了“所有往来单位名称都不允许重复”校验规则，入参数据存在和系统内name一致但businessCode不一致数据。（若name是英文，验重不区分大小写）(已停用的往来单位name也会参与校验) |
修改记录
2023-02-08 新增导入往来单位接口
2026-03-06 新增联系人姓名、联系电话、联系邮箱、联系地址、自定义字段