注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 基础技术

虚拟号升级700号段方案指引

更新时间:2025/12/17 访问次数:279

一、背景

根据工信部关于号码保护服务管理的最新要求,平台将对原11+4虚拟号格式进行升级,升级为700虚拟号格式,此次升级的700号段与原11+4号段号码格式不同,且拨打700号段虚拟号前必须先报备外呼主叫号码,开发者须在规定时间内完成方案升级

升级时间:2025年12月17日-1月17日

二、号段变更说明

对比维度

原11+4虚拟号

700号段虚拟号

说明

号码格式

有连接符,有分机号,11位主号+4位分机号(示例:13699999999-1234)

没有连接符,没有分机号,位长15位(示例:700101234567890)

“虚拟主号+分机号”变更为15位连续数字

虚拟号有效期

订单完成后7天内有效

订单完成后7天内有效

无变化

电联拨打

输入11位虚拟号主号后,根据提示音输入4位分机号,以#结束

700虚拟号拨打前必须上报主叫号码组,号码组之外的号码拨打不通

核心变化

短信发送

不支持直接发送短信

不支持直接发送短信

基于oaid的短信发送接口

面单打印

官方电子面单:保持现状

非官方电子面单:保持现状

官方电子面单:平台内部改造即可,无需开发者改造

非官方电子面单:需协同物流公司改造

灰度期间需兼容两种面单格式

三、接口变更说明

1、接口出参变更

1)taobao.top.oaid.decrypt(OAID解密)

接口地址:https://open.taobao.com/api.htm?spm=a219a.7386797.0.0.18d3669avqilZI&source=search&docId=54714&docType=2

接口出参改造:mobile(收件人手机号绑定的虚拟号)字段格式发生改变。

原出参:

"mobile": "13200000001-9999"

现出参:

"mobile": "700507877719557"

2、新增接口

1)新增订单G组号码更新接口

接口描述:更新主叫号码组,一个订单通过此接口最多报备80个主叫号码,单次不超过20个,超出自行删除,按照实际情况按需报备,避免造成资源浪费。

接口名称:taobao.top.secret.group.update(报备/更新主叫(G组)号码组)

请求类型:POST

接口链接:https://open.taobao.com/api.htm?docId=73786&docType=2

接口入参:

入参

类型

是否必传

描述

样例

oaid

String

oaid


operate_type

String

操作类型

ADD_GXB_GROUP:添加G组号码

DELETE_GXB_GROUP:删除G组号码

mobile_list

List<String>

手机号列表

13100000000,13100000001,13100000002

接口返回值:

字段名称

字段类型

参数描述

示例值

success

Boolean

是否请求成功

false

errorCode

String

响应码

gxb-group-update-failed

errorMsg

String

错误码

G组号池更新失败

2)新增订单G组号码查询接口

接口描述:查询订单关联的700号码绑定的G组号码列表。

接口名称:taobao.top.secret.group.query(查询G组号码列表)

请求类型:GET

接口地址:https://open.taobao.com/api.htm?docId=73785&docType=2

接口入参:

入参

类型

是否必传

描述

样例

oaid

String

oaid


接口返回值:

字段名称

字段类型

参数描述

示例值

call_mobile

List

脱敏后的手机号列表

131****0000,131****0001,131****0002

success

Boolean

是否请求成功

false

errorCode

String

响应码

gxb-group-query-error

errorMsg

String

错误码

G组号池查询失败

四、补充

1.淘宝700虚拟号改造咨询钉钉群 群号:147045021493。

2.工业和信息化部关于开展号码保护服务业务试点的通知:https://www.gov.cn/zhengce/zhengceku/202507/content_7030611.htm

3.灰度计划:将在2026年1月至3月进行灰度,灰度期间会同时存在11+4位虚拟号和700号段虚拟号。

FAQ

关于此文档暂时还没有FAQ
返回
顶部