接口描述

请求地址：/sync/md/customData/sys_vendors/sys_vendors_merge_bank

接口编号：FSSC-API-000159

接口诞生版本：3.9.3

所属系统：基础数据平台

所属微服务：zfs-base

接口说明：同步客户、供应商、供应商/客户的基本信息和银行账户信息

接口类型：同步类

单次调用最大条数：1000【主表不超1000条，明细不超1000条】

注意事项：

1、一次只支持同步一个集团的数据

2、此接口支持同步的客商数据的客商类型为：客户、供应商、供应商/客户

3、客商基本信息根据“客商编码/vendorCode”判断唯一，客商编码不存在，则视为新增；若客商编码已存在，则视为更新；

4、客商银行账户信息根据“客商编码/vendorCode”+"银行账号/vendorId+bankAccount“判断唯一，若客商编码+银行账号不存在，则视为新增；若客商编码+银行账号已存在，则视为更新；

5、接口根据对应“客商管理”主数据模板生成，若集团自行修改配置，需自行调整接口说明。

6、该接口发布后，接口平台不支持用数据导入的方式导入数据

请求参数

参数名	中文名称	类型	是否必填	字段长度	示例	参数说明
▼data	请求数据	array	Y
rowNum	行号	String	N	63		外系统传过来的行号，用于接口返回时告知外系统哪一行数据同步失败了长度校验（不超63）
vendorCode	客商编码	string	Y	20	GYS01	1、必填校验 2、若填写，格式校验，需满足编码格式（允许输入数字、字母、特殊符号；且首位不能为特殊符号） 3、长度校验（不超20） 4、校验批次内不能重复，重复则报错：{字段名称}与第{重复的行号、、}行重复。与多个数据重复，用，号隔开 5、判断系统内客商编码是否存在。不存在，则视为新增；若客商编码已存在，则视为更新
name	客商名称	string	Y	60	蔡蔡供应商	校验长度（不超过60）
nameEn	客商名称（英文）	string	N	60	cai	校验长度（不超过60）
vendorType	客商类型	string	Y		002	1、校验必填 2、校验是否为枚举值范围：枚举值：002/供应商、003/客户、005/供应商/客户。不在范围内，则按通用提示。数据源：系统编码（客商类型）
address	地址	string	N	80	长沙市岳麓区	校验长度（不超过80）
telNum	电话	string	N	25	18548795625	校验长度（不超过25）
billBankName	开票开户行名称	string	N	60	长沙银行	判断客商类型是否为客户或供应商/客户：如果不为客户或供应商/客户，则此字段未填，不校验；如果为客户或供应商/客户，此字段未填，需进行必填校验；此字段填写了，需校验长度（不超过60）
billBankAccount	开票银行账号	string	N	60	324234234234	判断客商类型是否为客户或供应商/客户：如果不为客户或供应商/客户，则此字段未填，不校验；如果为客户或供应商/客户，此字段未填，需进行必填校验；此字段填写了，先需校验格式满足银行账号格式（仅允许输入数字），后校验长度（不超过60）
internalUnitFlag	是否内部单位	string	N		0	校验是否为枚举值： 0/是 1/否
foreignLeId	归属核算主体	string	N		C01	先判断“是否为内部单位”：如果是，先校验此字段必填，再校验（核算主体编码）在基础数据-财务数据-财务组织中是否存在和有效如果不是，此字段未填，不校验；此字段填写了，需校验（核算主体编码）在基础数据-财务数据-财务组织中是否存在和有效
globalVendor	是否全局客商	string	N		1	校验是否为枚举值： 0/是 1/否
vendorsCompany	分配核算主体	string	N		C01	填写核算主体编码，多个用逗号分隔；选择上限50；是否全局客商为否时，该字段必填；校验在基础数据-财务数据-财务组织中是否存在和有效
taxNumber	税号	string	Y	20	2132323	1、必填校验； 2、校验长度（不超20）
legalPerson	法人	string	N	20	湖南公司	校验长度（不超20）
registeredCapital	注册资本	string	N	64	10000	校验长度（不超64）
registeredDate	注册时间	string	N		2023/7/1 0:00	校验格式：yyyy-mm-dd hh:mm:ss
taxpayerType	纳税人类型	string	Y		0	校验是否为枚举值： 0/一般纳税人 1/小规模纳税人 2/政府机关 3/简易征收纳税人
validityFlag	状态	string	N		0	校验是否为枚举值： 0/有效 1/无效为空默认：有效
enabledFlag	是否删除	string	N		0	1/删除 0/新增/更新；为空默认：新增/更新注意：是否删除不可逆，不支持从1变回0; enabledFlag传1时，若对应数据在系统中不存在或已经被删除，则该数据被跳过，执行结果默认为成功; enabledFlag传1时，若对应数据唯一标识为多选字段，则该多选字段传值内容必须和系统中已有数据内容一致（如a,b,c和b,c,a可视为一致），才可删除该数据，否则视为该数据在系统中不存在，执行跳过。
extendS1	扩展字段1	string	N	60		校验长度（不超60）
extendS2	扩展字段2	string	N	60		校验长度（不超60）
extendS3	扩展字段3	string	N	60		校验长度（不超60）
extendS4	扩展字段4	string	N	60		校验长度（不超60）
extendS5	扩展字段5	string	N	60		校验长度（不超60）
extendS6	扩展字段6	string	N	60		校验长度（不超60）
extendS7	扩展字段7	string	N	60		校验长度（不超60）
extendS8	扩展字段8	string	N	60		校验长度（不超60）
extendS9	扩展字段9	string	N	60		校验长度（不超60）
extendS10	扩展字段10	string	N	60		校验长度（不超60）
▼sys_vendors_bank	请求数据（银行明细）	Object	N			数据对象先同步主表数据，主表数据同步成功则再同步明细数据；主表数据同步失败，则不会同步主表数据下的明细数据
rowId	行号	string	N			外系统传值，用于接口返回时告知外系统哪一行明细数据同步失败了
bankAccountName	账户名称	string	Y	60	供应商银行账户名称	校验长度（不超60）
bankAccount	银行账号	string	Y	60	675766545475	需满足银行账号格式（仅允许输入数字）
bankSource	开户行来源	string	Y		1	校验是否为枚举值:1/公共数据、2/自定义快速编码：开户行来源
subBankId	开户行	string	Y		23423432	开户行来源为“公共数据”时，该字段必填校验在公共数据-银联号管理中是否存在和有效
vendorSitesTypeName	对公/对私	string	Y		1	校验是否为枚举值: 1/对公 2/对私
defaultFlag	默认标识	string	Y		DF0001	校验是否为枚举值: DF0001/是 DF0002/否注意：同一客户或供应商或供应商/客户只能有唯一的默认银行号
swiftCode	银行国际代码	string	N			1、开户行来源为“自定义”时，校验该字段必填， 2、校验长度不超过20
swiftName	银行名称	string	N			1、开户行来源为“自定义”时，校验该字段必填， 2、校验长度（不超63）
headOfficeCode	总行代码	string	N			校验长度（不超63）
validityFlag	状态	string	N		0	校验是否为枚举值: 0/有效 1/无效为空默认：有效
enabledFlag	是否删除	string	N		0	校验是否为枚举值: 1/删除 0/新增/更新；为空默认：新增/更新
extendS1	扩展字段1	string	N	60		校验长度（不超60）
extendS2	扩展字段2	string	N	60		校验长度（不超60）
extendS3	扩展字段3	string	N	60		校验长度（不超60）
extendS4	扩展字段4	string	N	60		校验长度（不超60）
extendS5	扩展字段5	string	N	60		校验长度（不超60）
extendS6	扩展字段6	string	N	60		校验长度（不超60）
extendS7	扩展字段7	string	N	60		校验长度（不超60）
extendS8	扩展字段8	string	N	60		校验长度（不超60）
extendS9	扩展字段9	string	N	60		校验长度（不超60）
extendS10	扩展字段10	string	N	60		校验长度（不超60）

返回参数

参数名	中文明细	~~参数类型~~	中文名称	示例
code	编码	number	返回代码	2
msg	信息	string	返回消息	部分成功，部分失败
successNum	成功条数	string	成功条数	1
failNum	失败条数	string	失败条数	0
▼data	数据	array	失败对象	{"data":[{"rowId":"1","rowNum":"1","errMsg":"第1行年月超出范围限制;"}]}
rowId	行ID	string	接口平台数据同步标识
rowNum	行号	string	行号
errMsg	错误信息	string	每行错误信息	明细行报错根据 rowId区分

请求参数示例

{
    "data": [
        {
            "vendorType": "002",
            "vendorCode": "HHKS1", 
            "nameEn": "", 
            "name": "皇皇供应商1", 
            "globalVendor": "", 
            "vendorsCompany": "", 
            "taxNumber": "1234321234", 
            "legalPerson": "", 
            "registeredCapital": "", 
            "registeredDate": "", 
            "taxpayerType": "0", 
            "address": "", 
            "telNum": "", 
            "billBankName": "", 
            "billBankAccount": "", 
            "internalUnitFlag": "", 
            "foreignLeId": "", 
            "validityFlag": "0", 
            "enabledFlag": "", 
            "extendS1": "", 
            "extendS2": "", 
            "extendS3": "", 
            "extendS4": "", 
            "extendS5": "", 
            "extendS6": "", 
            "extendS7": "", 
            "extendS8": "", 
            "extendS9": "", 
            "extendS10": "", 
            "m1": "111", 
            "sys_vendors_bank": [
                {
                    "bankAccountName": "皇皇供应商1", 
                    "bankAccount": "666999000111", 
                    "bankSource": "1", 
                    "subBankId": "781585090125", 
                    "swiftCode": "", 
                    "swiftName": "", 
                    "vendorSitesTypeName": "1", 
                    "defaultFlag": "DF0001", 
                    "validityFlag": "", 
                    "enabledFlag": "0", 
                    "extendS1": "", 
                    "extendS2": "", 
                    "extendS3": "", 
                    "extendS4": "", 
                    "extendS5": "", 
                    "extendS6": "", 
                    "extendS7": "", 
                    "extendS8": "", 
                    "extendS9": "", 
                    "extendS10": "", 
                    "headOfficeCode": "", 
                    "m1": "222", 
                    "rowId": "1"
                }, {
                    "bankAccountName": "皇皇供应商1", 
                    "bankAccount": "666999000112", 
                    "bankSource": "1", 
                    "subBankId": "781585090125", 
                    "swiftCode": "", 
                    "swiftName": "", 
                    "vendorSitesTypeName": "1", 
                    "defaultFlag": "DF0001", 
                    "validityFlag": "", 
                    "enabledFlag": "0", 
                    "extendS1": "", 
                    "extendS2": "", 
                    "extendS3": "", 
                    "extendS4": "", 
                    "extendS5": "", 
                    "extendS6": "", 
                    "extendS7": "", 
                    "extendS8": "", 
                    "extendS9": "", 
                    "extendS10": "", 
                    "headOfficeCode": "", 
                    "m1": "333", 
                    "rowId": "A1"
                }
            ], 
            "rowNum": "1"
        }
    ]
}

返回参数示例

{
  "msg": "全部失败",
  "failNum": "1",
  "code": "1",
  "data": [
    {
      "rowId": null,
      "rowNum": "1",
      "errMsg": "主表正常处理完成！明细区存在异常:第A1行一个客商只能有一个默认银行账号;"
    }
  ],
  "successNum": "0"
}

客商信息同步接口（合并）（3.9.3）

客商信息同步接口（合并）（3.9.3）

关于作者

目录