电子面单对接说明

一、方案背景

小红书电子面单是小红书电商平台与物流商面向商家提供的一项快速打印快递面单服务。为保障消费者信息安全，现已支持数据的加密传输。目前已覆盖市面上主流的快递公司：圆通快递、韵达快递、申通快递、极兔快递、邮政快递包裹、EMS、德邦快递、中通快递、顺丰速运、京东快递，更多物流公司正在对接中。
商家使用ISV电子面单打印功能需要先在小红书商家后台申请电子面单，完成基础设置流程，见小红书电子面单操作指南。

二、对接流程

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

三、电子面单交互流程

四、接口文档

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

附录1：快递公司编码

快递公司编码	快递公司品牌编码	快递公司名称	加盟类型
zto		中通速递	加盟
yuantong		圆通快递	加盟
yunda		韵达速递	加盟
jtexpress		极兔速递	加盟
shentong		申通速递	加盟
youzhengguonei		邮政快递	直营
ems		EMS	直营
debangwuliu		德邦快递	直营
shunfeng	SF	顺丰速运	直营
shunfeng	FOP	顺丰快运	直营

附录2：物流增值服务

快递公司名称	快递公司编码	增值服务code	增值服务名称	是否需要订购	传值规则	示例值
中通速递	zto	SVC-INSURE	保价	是	"{"SVC-INSURE":{"value":"金额"}}"	"{"SVC-INSURE":{"value":"100"}}"
SVC-SIGN-CONFIRM	秘钥签收	是	"{"SVC-SIGN-CONFIRM":{}}"	"{"SVC-SIGN-CONFIRM":{}}"
SVC-VIP	VIP尊享	是	"{"SVC-VIP":{}}"	"{"SVC-VIP":{}}"
SVC-TIMING-HIGH	特快	是	"{"SVC-TIMING-HIGH":{}}"	"{"SVC-TIMING-HIGH":{}}"
SVC-TIMING-STANDARD	中通标快	是	"{"SVC-TIMING-STANDARD":{}}"	"{"SVC-TIMING-STANDARD":{}}"
STAR-CITY	同城	是	"{"STAR-CITY":{}}"	"{"STAR-CITY":{}}"
STAR-COLD	冷链	是	"{"STAR-COLD":{}}"	"{"STAR-COLD":{}}"
SVC-STAR	星联	是	"{"SVC-STAR":{}}"	"{"SVC-STAR":{}}"
韵达速递	yunda	SVC-INSURE	保价	是	"{"SVC-INSURE":{"value":"金额"}}"	"{"SVC-INSURE":{"value":"100"}}"
申通速递	shentong	SVC-INSURE	保价	否	"{"SVC-INSURE":{"value":"金额"}}"	"{"SVC-INSURE":{"value":"100"}}"
SVC-FRESH	生鲜件	否	"{"SVC-FRESH":{}}"	"{"SVC-FRESH":{}}"
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	INSURE	保价-IN02	否	"{"INSURE":{"value":"金额"}}"	"{"INSURE":{"value":"100"}}"

附录3：物流产品类型

快递公司名称	快递公司编码	快递公司品牌编码	产品类型名称	产品类型编码
顺丰速运	shunfeng	SF	顺丰特快	1
顺丰标快	2
顺丰即日	6
便利封/袋（特快）	31
顺丰干配	111
顺丰空配	112
重货包裹	154
标准零担	155
特快包裹	199
冷运标快	201
顺丰微小件	202
精温专递	229
标准零担D类	230
陆运包裹	231
纯重特配	238
电商标快	247
顺丰空配（新）	266
特快包裹（新）	293
顺丰快运	shunfeng	FOP	顺丰特快	1
顺丰标快	2
顺丰干配	111
整车直达	153
重货包裹	154
标准零担	155
大票直送	215
标准零担D类	230
纯重特配	238
顺丰卡航	255
顺丰卡航（D类）	256

附录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	其他