导入往来单位信息
说明
当已经在每刻系统中维护好了往来单位及分类信息时,可以使用该接口新增/更新往来单位信息。
- 往来单位的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,更新则保持系统内状态。 |
参数样例
{
"partnerList":[
{
"parentName":"分类1号",
"name":"测试供应商",
"nameEn":"englisName",
"partnerType":"供应商",
"partnerProperty":"公司",
"businessCode":"MK001",
"readOnly":false,
"reMark":"备注",
"enabled":true
},{
"parentBizCode":"CODE001",
"name":"测试供应商2",
"nameEn":"englisName2",
"partnerType":"供应商",
"partnerProperty":"公司",
"businessCode":"MK002",
"readOnly":false,
"reMark":"备注"
}
]
}
响应参数
响应参数说明
参数名称 |
类型 |
是否必填 |
参数说明 |
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是英文,验重不区分大小写) |
修改记录
2023-02-08 新增导入往来单位接口