导入往来单位信息

说明

当已经在每刻系统中维护好了往来单位及分类信息时,可以使用该接口新增/更新往来单位信息。

  1. 往来单位的businessCode在系统中不存在,会新增;已存在则更新。
  2. 往来单位中英文名称在系统都不存在,会新增;存在其中一个则更新另一个名称,若中英文分别存在两个不同往来位中,则不允许。
  3. 本接口采用部分失败模式,一条数据失败不影响其他正确数据
  4. 往来单位分类信息,需要进入系统内手工维护,目前无法通过接口实时同步。

接口限制

入参的往来单位编码最多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  新增导入往来单位接口
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2024-11-20 10:52:00

results matching ""

    No results matching ""

    results matching ""

      No results matching ""