**温馨提示：**小红书新版电子面单已上线，11.30开始按照比例灰度商家。新对接的自研商家建议直接接入新版电子面单，在小红书千帆系统电子面单页面的顶部可以点击新版电子面单进入新版。已经接入旧版面单的ISV请查看文档：新版小红书电子面单ISV对接改造。如仍需对接旧版请查看：旧版电子面单对接说明。

一、方案背景

小红书电子面单是小红书电商平台与物流商面向商家提供的一项快速打印快递面单服务。为保障消费者信息安全，现已支持数据的加密传输。目前已覆盖市面上主流的快递公司：圆通快递、韵达快递、申通快递、极兔快递、邮政快递包裹、EMS、德邦快递、中通快递、顺丰速运、京东快递，更多物流公司正在对接中。

商家使用ISV电子面单打印功能需要先在小红书千帆系统申请电子面单，完成基础设置流程，见小红书电子面单操作指南

二、对接流程

序号	流程标准	流程详情说明
1	注册开放平台服务应用	入驻开放平台，申请APP 应用，并给APP应用申请【订单接口】权限包
2	APP应用添加授权店铺	在开放平台添加授权店铺，然后商家进行授权
3	对接-线上面单接口	根据实际情况对接电子面单相关开放接口，支持HTTP API调用、SDK调用
4	对接-打印组件交互协议	下载并安装小红书官方打印组件（windows版、mac版），对接电子面单打印组件协议（新）
5	联调测试	线上联调及测试，电子面单常见问题（新）
6	上线	上线

三、电子面单交互流程

四、接口文档

查看类目	接口	接口描述	操作
物流API	express.queryEbillSubscribes	查询电子面单订购关系和使用情况	查看
物流API	express.queryEbillTemplates	查询电子面单模板列表	查看
物流API	express.createEbillOrders	批量取号	查看
物流API	express.updateEbillOrder	更新面单	查看
物流API	express.cancelEbillOrder	取消面单	查看
物流API	express.queryEbillOrder	查询面单，用于补打面单	查看
物流API	express.queryEbillServices	查询电子面单增值服务	查看

五、无店铺使用电子面单

有些厂商希望无店铺使用电子面单，可以使用小红书电子面单系统，需要isv服务商将小红书服务市场的授权页面链接从【https://ark.xiaohongshu.com/ark/authorization?redirectUri=回调地址&appId=应用ID】改为【https://open.xiaohongshu.com/authorization?redirectUri=回调地址&appId=应用ID】

注意：同一个邮箱不要同时用来注册小红书店铺和小红书电子面单系统，否则可能导致授权覆盖和数据错乱的问题。建议厂商优先使用小红书店铺来订购电子面单系统，小红书店铺的功能更加全面。

附录1：快递公司编码

快递公司编码	快递公司品牌编码	快递公司名称	加盟类型	备注
zto		中通快递	加盟
yuantong		圆通速递	加盟
yunda		韵达速递	加盟
jtexpress		极兔速递	加盟
shentong		申通快递	加盟
youzhengguonei		邮政快递	直营	对应邮政官网国内邮政的【快递包裹】、邮政小包
ems		EMS	直营	对应邮政官网国内邮政的【国内特快专递】
debangwuliu		德邦快递	直营	德邦快递就是德邦物流，小红书暂时不支持德邦快运
shunfeng	SF	顺丰速运	直营
shunfeng	FOP	顺丰快运	直营
jd		京东快递	直营	曾用名：京东物流
youzhengbiaokuai		邮政电商标快	直营
danniao		菜鸟速递	直营	曾用名：丹鸟
kuayue		跨越速运	直营	只有子母单取号模式，最大500个子单，必须指定产品类型，如果要默认传值建议默认传陆运件，让商家联系快递公司配置成自动转换线路
yimidida		壹米滴答	加盟	只有子母单取号模式，最大999个子单

附录2：物流增值服务

保价说明：保价的单位是元，保留2位小数。

增值服务的参数logisticsServices是一个json格式的字符串，注意对双引号进行转移，格式：{“增值服务1的code”:{增值服务1的值},“增值服务2的code”:{增值服务2的值} }，例如同时使用中通保价和特快：“logisticsServices”:”{\“SVC-INSURE\”:{\“value\”:\“100\”},\“SVC-TIMING-HIGH\“:{}}"

快递公司名称	快递公司编码	品牌编码	增值服务code	增值服务名称	是否需要订购	传值规则	示例值	备注
中通快递	zto		SVC-INSURE	保价	是	{"SVC-INSURE":{"value":"金额"}}	{"SVC-INSURE":{"value":"100"}}
	SVC-SIGN-CONFIRM	秘钥签收	是	{"SVC-SIGN-CONFIRM":{}}	{"SVC-SIGN-CONFIRM":{}}
	SVC-VIP	中通标快	是	{"SVC-VIP":{}}	{"SVC-VIP":{}}
	SVC-TIMING-HIGH	中通飞快	是	{"SVC-TIMING-HIGH":{}}	"{"SVC-TIMING-HIGH":{}}"
	SVC-TIMING-STANDARD	中通好快	是	{"SVC-TIMING-STANDARD":{}}"	"{"SVC-TIMING-STANDARD":{}}"
韵达速递	yunda		SVC-INSURE	保价	是	{"SVC-INSURE":{"value":"金额"}}"	{"SVC-INSURE":{"value":"100"}}
	SVC-TKZCWY	智橙网	是	{"SVC-TKZCWY":{}}	{"SVC-TKZCWY":{}}
申通快递	shentong		SVC-INSURE	保价	是	{"SVC-INSURE":{"value":"金额"}}"	{"SVC-INSURE":{"value":"100"}}
	SVC-AXPS	申咚咚	是	{"SVC-AXPS":{}}	{"SVC-AXPS":{}}
圆通速递	yuantong		SVC-INSURE	保价	否	{"SVC-INSURE":{"value":"金额"}}"	{"SVC-INSURE":{"value":"100"}}	仅新版电子面单支持默认开通
EMS	ems		SVC-INSURE	保价	否	{"SVC-INSURE":{"value":"金额"}}"	{"SVC-INSURE":{"value":"100"}}
邮政快递	youzhengguonei		SVC-INSURE	保价	否	{"SVC-INSURE":{"value":"金额"}}	{"SVC-INSURE":{"value":"100"}}
极兔速递	jtexpress		SVC-INSURE	保价	否	{"SVC-INSURE":{"value":"金额"}}	{"SVC-INSURE":{"value":"100"}}
	SVC-TYD	兔优达	是	{"SVC-TYD":{}}	{"SVC-TYD":{}}
德邦物流	debangwuliu		insurance	保价	否	{"insurance":{"insuranceValue":"金额"}}	{"insurance":{"insuranceValue":"100"}}
顺丰速运	shunfeng	SF	INSURE	保价-IN02	否	{"INSURE":{"value":"金额"}}	{"INSURE":{"value":"100"}}
IN41	保鲜服务	否	{"IN41":{}}	{"IN41":{}}
顺丰快运	shunfeng	FOP	IN31	包装服务-IN31	否	{"IN31":{}}	{"IN31":{}}
DOORTODOOR	上楼服务-IN45	否	{"DOORTODOOR":{}}	{"DOORTODOOR":{}}
京东	jd		SVC-INSURE	保价	否	{"SVC-INSURE":{"value":"金额"}}	{"SVC-INSURE":{"value":"100"}}
	SVC-FRESH	生鲜温层	否	{"SVC-FRESH":{"value":"温层值"}}	{"SVC-FRESH":{"value":"usual"}}	注意需要产品类型是生鲜特惠、生鲜特快、医药专送和冷链专送时才生效，生鲜产品不传默认usual-生鲜常温common：生鲜普通 usual：生鲜常温 alive：生鲜鲜活 control：生鲜控温 cold：生鲜冷藏 freezing：生鲜冷冻 deepCool ：生鲜深冷medicalUsual：医药常温（仅产品类型是医药专送md-m-0005时才支持）
邮政电商标快	youzhengbiaokuai		SVC-COD	代收货款	是	{"SVC-COD":{"value":"金额"}}	{"SVC-COD":{"value":"100"}}
菜鸟速递	danniao		VALUE_INSURED	保价	是	{"VALUE_INSURED":{"value":"金额"}}	{"VALUE_INSURED":{"value":"100"}}
跨越速运	kuayue		SVC-THIRD-PARTY-PAY	第三方代付	否	{"SVC-THIRD-PARTY-PAY":{"value":"第三方代付公司编码"}}	{"SVC-THIRD-PARTY-PAY":{"value":"123456"}}
			SVC-COD	代收金额，单位元	否	{"SVC-COD":{"value":"代收金额"}}	{"SVC-COD":{"value":"100"}}
			woodenFrame	木架方式	否	{"woodenFrame":{"value":"木架方式枚举"}}	{"woodenFrame":{"value":"10"}}	枚举值：10-打卡板、20-打木架、30-打木箱，
			SVC-DELIVERY-TYPE	送货方式	否	{ “SVC-DELIVERY-TYPE”: {"value":"送货方式枚举"} }	{ “SVC-DELIVERY-TYPE”: {"value":"SEND"} }	枚举值：SEND-送货上门; SELF-自提
			SVC-DELIVERY-RECEIPT	签回单	否	{ “SVC-DELIVERY-RECEIPT”: {“value”: 签回单枚举} }	{ “SVC-DELIVERY-RECEIPT”: {“value”: 1} }	枚举值如下，10：回单原件（含回单照片），20：无需回单，30：回单照片，40：电子回单（传代码）
			SIGN-TYPE	签收标志	否	{ “SIGN-TYPE”: {“value”: 签收标志} }	{ “SIGN-TYPE”: {“value”: 10} }	是否本人签收 10:本人签收, 20:非本人签收
			SVC-INSURE	保价	否	{ “SVC-INSURE”: { “value”: 保价金额} }	{ “SVC-INSURE”: { “value”: 100.5 } }
壹米滴答	yimidida		SVC-INSURE	保价	否	{ “SVC-INSURE”: { “value”: 保价金额} }	{ “SVC-INSURE”: { “value”: 100.5 } }

附录3：物流产品类型

物流产品类型的接口字段：productCode

快递公司名称	快递公司编码	快递公司品牌编码	产品类型名称	产品类型编码	备注
顺丰速运	shunfeng	SF	顺丰特快	1	顺丰不传产品类型默认就是顺丰特快；平台会将产品编码透传给顺丰，没有列举出来的产品类型也都支持，完整的产品类型参照顺丰官网。
顺丰标快	2
顺丰即日	6
便利封/袋（特快）	31
顺丰干配	111
顺丰空配	112
特快包裹	199
冷运标快	201
顺丰微小件	202
精温专递	229
陆运包裹	231
电商标快	247
同城半日达	263
区域城配	331
顺丰空配（新）	266
填舱标快	283	不支持上门取件
填舱电标	285
特快包裹（新）	293
顺丰快运	shunfeng	FOP	顺丰特快	1	顺丰不传产品类型默认就是顺丰特快；顺丰快运和顺丰速运是一套逻辑，已经没有特殊区别。
顺丰标快	2
顺丰干配	111
整车直达	153
大票直送	215
顺丰卡航	255
顺丰卡航（D类）	256
京东快递	jd		京东标快	ed-m-0001	曾用名：特惠送
京东特快	ed-m-0002	曾用名：特快送
生鲜标快	LL-HD-M	曾用名：生鲜特惠，需要结合增值服务SVC-FRESH设置温层，默认是生鲜常温
生鲜特快	LL-SD-M	需要结合增值服务SVC-FRESH设置温层，默认是生鲜常温
京东特惠	ed-m-0019	曾用名：特惠小件
特快重货	fr-m-0004
特快零担	fr-m-0001
特惠重货	fr-m-0002
电商标快	ed-m-0059	曾用名：电商特惠
函速达	ed-m-0017
冷链专送	ll-m-0015	需要结合增值服务SVC-FRESH设置温层
医药专送	md-m-0005	只有一个温层设置值，医药常温：{"SVC-FRESH":{"value":"medicalUsual"}}
特惠包裹	ed-m-0012
特惠专配	fr-m-0017
大件标准宅配	lq-m-0025
大件-零担配送	lq-m-0011
大件商务仓-仓配	lq-m-0005
德邦快递	debangwuliu		标准快递	PACKAGE	德邦不传值时默认标准快递
大件快递360	RCP
特快专递	TZKJC
特快次日	HKDJC
航空大件隔日达	HKDJG
精准泡货	NZBRH
新精准汽运	NLRF
新精准卡航	NFLF
新精准重货	NJZZH
小件特惠	WXJTH
泡货特惠	ZYSCZD
重货特惠	DSZH
特快当日	TKDR
特快冷链	DEAP
DP联运(K)	DPTL
DP联运(L)	TKLY
精准大票(电商)	YTYDS
圆通速递	yuantong		标准快递	1	不传值时默认标准快递
圆准达	2	需要和网点线下开通
航空件	3	需要和网点线下开通
同城特快	4	需要和网点线下开通
跨越速运	kuayue		当天达	10
次日达	20
隔日达	30
陆运件	40
同城次日	50
同城即日	70
省内次日	160
省内即日	170
空运	210
专运	220

附录4：渠道编码

渠道编码	渠道名称
XIAO_HONG_SHU	小红书
TB	淘宝
TM	天猫
DOU_YIN	抖音
KUAI_SHOU	快手
JD	京东
PP	拍拍
YX	易讯
DD	当当
EBAY	EBAY
AMAZON	亚马逊
QQ	QQ
SN	苏宁
GM	国美
WPH	唯品会
JM	聚美
LF	乐蜂
MGJ	蘑菇街
JS	聚尚
PX	拍鞋
YT	银泰
YHD	1号店
VANCL	凡客
YL	邮乐
YG	优购
1688	1688
YOU_ZAN	有赞
PIN_DUO_DUO	拼多多
ZHE_800	折800
CHU_CHU_JIE	楚楚街
JUAN_PI	卷皮
BEI_BEI	贝贝
WEI_DIAN	微店
QIAN_MI	千米
MEI_LI_SHUO	美丽说
FAN_LI	返利
MENG_DIAN	萌店
YAN_XUAN	网易严选
WEI_MENG	微盟
WEI_SHANG	微商
XIAO_MI	小米
KAO_LA	考拉
MI_YA	蜜芽
YUN_JI	云集
BEI_DIAN	贝店
XIAN_YU	闲鱼
WAN_WU_DE_ZHI	玩物得志
HUAWEI	华为
YANG_MA_TOU	洋码头
WO_MAI	我买
JIU_XIAN_WANG	酒仙网
BEN_LAI_SHENG_HUO	本来生活
DU	得物
YouPin	小米有品
MTShanGou	美团闪购
ELE	饿了么
DOU_CANG	抖仓
WXXD	微信小店
OTHERS	其他

电子面单对接说明（新）

一、方案背景#

二、对接流程#

三、电子面单交互流程#

四、接口文档#

五、无店铺使用电子面单#

附录1：快递公司编码#

附录2：物流增值服务#

附录3：物流产品类型#

附录4：渠道编码#