2.14.3【预录入门店】(B2b门店助手)


测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tx/handle

生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle

接口代码(transCode):4010

功能说明:

 

1、通过本API可提前预录入门店信息

2、对于已提前预录入门店信息的用户,在登录小程序进行门店认证授权流程时,会默认拉起展示预录入的门店信息,用户一键确认即可完成认证授权,减少用户操作成本,提示认证授权成功率

3、注意:通过本api预录入的门店信息,在小程序管理后台不可见。

 

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

请求流水号

 

retailInfoList

List

 

是

门店信息列表

每次最多导入100个,多则报错

retailInfoList的明细字段:

字段

字段类型

字段长度

必填

字段名称

说明

mobilePhone

String

50

是

手机号

限制11位手机号

 

retailName

String

60

是

门店名称

 

长度为1-30个字符,一个中文字等于2个字符

 

retailType

String

60

否

一级门店类型

 

类型:杂货店、便利店、超市、餐饮店、母婴店、烟酒店、其他

 

subRetailType

String

60

否

 

二级门店类型

 

一级门店类型=“其他”时必填

 

addressProvince

String

60

是

 

门店所在省

 

 

addressCity

String

60

是

 

门店所在市

 

 

addressRegion

String

60

是

 

门店所在区县

 

 

addressStreet

String

60

是

 

门店所在街道详细地址

 

 

registrationNumber

String

60

否

 

营业执照注册号

 

 

bizName

String

60

否

 

企业名称

 

 

corporationName

String

60

否

 

法人姓名

 

 

latitude

String

60

否

 

纬度

 

 

longitude

String

60

否

 

经度

 

业务响应参数

字段

字段类型

字段长度

必填

字段名称

说明

numSuccess

String

60

是

录入成功数量
 
numFailure

String

60

是

录入失败数量

 

failureInfo

JsonString

60

否

具体失败信息
 

failureInfo的明细字段:

字段

字段类型

字段长度

必填

字段名称

说明

mobilePhone

String

50

是

手机号

 

registrationNumber

String

60

否

营业执照注册号

 
failureCode

String

60

是

错误码  
 

failureCode-错误码字典

响应码

说明

2
无效手机号
3
无效门店类型 
4
地址解析失败
5
手机号已被录入门店信息
6
 

无效的门店名称(长度限制为1-30个字符,一个中文字等于2个字符)


2025年11月26日 10:17 收藏文档