您的位置 : 文档中心 -> API信息

用户在免登和接口调用的时候都需要使用1688上对应的操作员帐号,一般情况下企业系统中都没有1688上对应的子帐号ID,可以通过这个接口为某个操作员快速创建一个子帐号,同时记录到接入商系统内部,便于下次使用。 注意:如果对应子帐号已经建立过了,则直接返回已经建立的子帐号ID,调用此接口前,需要主帐号登陆过旺旺(至少一次),并且已经领用了子帐号,领用页面:http://mai.taobao.com/subaccount/index.htm

API用户授权类型

需要授权

系统级输入参数

名称 类型 是否必须 描述
_aop_timestamp String 请求时间戳
_aop_signature String 请求签名
access_token String 用户授权令牌

应用级输入参数

名称 类型 是否必须 描述 示例值 默认值
employeeId java.lang.String 需要创建的子帐号在接入商系统内部唯一编号或者ID 001
name java.lang.String 需要创建的子帐号的姓名 张三
mobileNo java.lang.String 需要创建的子帐号的手机号,如果为空的话将来无法收到来自1688的采购业务提醒 13500000000
email java.lang.String 需要创建的子帐号的邮箱,如果为空则无法收到来自1688采购业务的邮件提醒 aaa@aliyun.com
sex java.lang.String 需要创建的子帐号的性别,枚举值:1或者2;1表示男,2表示女 1 1
department java.lang.String 需要创建的子帐号所属部门,多级部门用"-"分割,最多三级;如果为空,系统默认会在主帐号下面创建一个“我的团队”这个部门,所有没有传部门的子帐号都会归属到这个默认部门下面去。 采购部-采购一部-采购一组
role java.lang.String 需要创建的子帐号在1688的岗位,例如:1688采购员、采购经理、财务,如果为空的话这个子帐号就没有相关采购寻源的权限或者采购的权限 1688采购员

返回结果

名称 类型 是否必须 描述 示例值
subUserId Long 创建成功的子帐号ID或者是已经与接入商系统内部employeeId绑定的子帐号ID 12345

错误码

错误码 错误描述 解决方案
ISV.CONFLICT_MEMBER 主帐号存在同名帐号,这个是由于alibaba帐号体系合并导致还有很少一部分会员存在用户名冲突问题,新注册的不存在这个问题,如果主帐号冲突的话就不能使用子帐号相关功能,所以当发现这个问题后。 请修改自己的帐号名或者联系采购运营服务同学。
ISV.INVALID_PARAM 接口传入参数不合法 请按接口参数说明检查传入的param参数,确保param对象中的employeeId,buyerMemberId,name,departmend是合法有效的
ISV.DATA_PRIVILEGE_ILLEGAL 您无权调用此api接口,此接口只对与采购平台合作采购商才能提供这个接口服务 请先与采购平台进行合作,可联系采购运营服务同学进行咨询
ISP.SYSTEM_ERROR ISP系统繁忙 请确认主帐号已经登陆过旺旺(至少一次),并且已经领用了子帐号;请稍等片刻,在进行尝试;通知采购运营服务同学告知问题。

API工具