仓储物流类应用升级方案

更新时间：2024/07/31 访问次数：36694

一、背景说明
二、方案概述
三、涉及接口和字段说明
四、通用场景升级说明

一、背景说明

近期国家陆续出台了个人信息保护和数据安全相关的法律法规，对保障消费者个人信息权益、规范数据处理活动提出了更明确的责任要求。平台将启动订单处理链路的消费者敏感信息保护方案，对涉及消费者个人敏感信息采取加密、去标识化等安全技术措施。

新的方案将会把订单中涉及消费者的敏感信息进行脱敏处理，订单中消费者敏感信息是指消费者订单中的收件人信息。具体脱敏信息字段包含：收件人姓名、收件人手机号、收件人电话(固定号码)、收件人详细地址（不包含省市区）。为了确保商家订单履约正常运行，平台将新增收件人ID字段【简称OAID】。OAID是本次升级新增的核心字段。升级后可以通过OAID进行订单合单，电子面单生成打印，服务短信发送、必要场景的信息解密功能等。

升级使用脱敏的订单数据+OAID方案后，可确保订单履约的全链路作业顺畅不受影响，同时能确保消费者的敏感信息受到保护

二、方案概述

1.开发者（软件服务商、自研商家）从淘宝开放平台API或订单推送服务中获取的订单消费者敏感信息（收件人姓名、收件人手机、收件人电话、地址等）均为脱敏数据，本地不允许存储明文消费者敏感数据。

2.开发者（软件服务商、自研商家）的相关系统页面只能展示平台脱敏后的信息，如需展示明文需通过平台解密方案获得，并且要做好明文数据查看权限的隔离。

3.涉及三方仓的发货履约场景，订单处理类应用（ERP、OMS等）与仓储物流类应用（WMS等）之间的数据通信，必须通过淘宝开放平台定义的奇门相关接口来实现。

4.OAID可用于菜鸟电子面单产品的生成和打印。

5.开发者（软件服务商、自研商家）向消费者发送服务短信，可使用OAID通过淘宝开放平台提供的密文发送服务短信接口来实现。

三、涉及接口和字段说明

1. 电子面单相关API

菜鸟电子面单相关如下接口已升级，在兼容目前现状的基础上，新增了可选的OAID和tid入参。当前未接入新方案的订单，需传入空的OAID，和明文的收件人信息。接入新方案的订单，需传入不为空的 OAID和交易单号tid，新方案中OAID和tid必填。

API名称：cainiao.waybill.ii.get（电子面单云打印接口）

入参改动：新增参数oaid。

名称	参数类型	示例值	描述
└ trade_order_info_dtos	TradeOrderInfoDto[]	?	请求面单信息，数量限制为10
└ recipient	UserInfoDto	?	收件人信息
└ oaid	String	2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc	收件人ID
└ tid	String	1527014522198024829	淘宝交易订单号，针对淘宝订单敏感加密场景使用，非必填，如果填写则必须是淘宝真实的交易订单ID

API名称：cainiao.waybill.ii.update（电子面单云打印更新接口）

入参改动：新增参数oaid。

名称	参数类型	示例值	描述
└ recipient	RecipientInfoDto	?	收件人信息
└ oaid	String	2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc	收件人ID

API名称：cainiao.reachable.batchjudge（是否派送可达判定批量查询接口）

入参改动：新增参数oaid。

名称	参数类型	示例值	描述
address_and_service_list	ReachableAddressAndServiceDto[]	?	收发地址和服务列表
└ oaid	String	2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc	收件人ID

API名称：cainiao.pickup.business.callguoguo（菜鸟商家寄件下单并呼叫裹裹运力）

入参改动：新增参数encrypted_customer_info。

名称	参数类型	示例值	描述
guo_guo_package_info	GuoGuoPackageInfo[]	?	包裹信息，最多传30个
└ encrypted_customer_info	EncryptedCustomerInfo	?	淘宝加密字段（如果无法取到明文的收件人信息，可以本字段代替，否则勿使用本字段。若本字段下属2个字段都不为空，则取解密后的地址为收件人地址。否则此字段无效，依然取上面的full_address_detail等信息为收件人信息。若下属2个字段都不为空但有误，会下单失败）
└ oaid	String	abcdefghij	收件人ID (Open Addressee ID)，长度128位字符之内
└ taobao_order_id	String	123456	淘宝订单ID

API名称：cainiao.pickup.business.preorderview.get（菜鸟商家寄件下单前获取预览信息）

入参改动：新增参数encrypted_customer_info。

名称	参数类型	示例值	描述
package_info_list	GuoGuoPackageInfo[]	?	批量下单时包裹信息列表，最多传30个
└ encrypted_customer_info	EncryptedCustomerInfo	?	淘宝加密字段（如果无法取到明文的收件人信息，可以本字段代替，否则勿使用本字段。若本字段下属2个字段都不为空，则取解密后的地址为收件人地址。否则此字段无效，依然取上面的full_address_detail等信息为收件人信息。若下属2个字段都不为空但有误，会下单失败）
└ oaid	String	abcdefghij	收件人ID (Open Addressee ID)，长度128位字符之内
└ taobao_order_id	String	123456	淘宝订单ID

2. 奇门相关API

订单相关的奇门API，已新增OAID的出入参，订单接口中Create、batchcreate接口用于衔接订单处理类应用（ERP、OMS等)与仓储物流类应用（WMS等)之间的发货订单数据传输。

如果仓储物流类应用（WMS等)接到的密文数据因为业务需要，需要对某笔订单进行解密时，需要调用receiverinfo.query接口反向调用订单处理类应用（ERP、OMS等)的解密接口完成明文获取。receiverinfo.query接口需要订单处理类应用（ERP、OMS等)对接来实现解密功能。

每个接口的具体入参内容，请点击如下接口链接查看。

奇门API	API名称
taobao.qimen.deliveryorder.create	发货单创建
taobao.qimen.deliveryorder.batchcreate	发货单创建批量接口
taobao.qimen.order.query	根据收件人信息查询交易单号接口
taobao.qimen.receiverinfo.query	OAID 收件人信息解密接口

四、通用场景升级说明

由于每个应用的功能范围存在差异，此章节仅提供整体性介绍和常见或关键改造点的改造建议，不同的功能改造点涉及到使用不同的接口，还需要服务商开发者根据自身产品情况做具体的实施和落地。

整体数据推送链路

1. 奇门数据传输脱敏

主要实现订单处理类应用（ERP、OMS等)-》奇门-》仓储物流类应用（WMS等)三方数据的互通传递，需要保证数据在脱敏+OAID的形式下完成

订单处理类应用（ERP、OMS等)需要支持仓储物流类应用（WMS等)对特殊订单通过奇门解密接口：taobao.qimen.receiverinfo.query的反向解密需求。

2. 电子面单

电子面单的获取接口兼容脱敏数据的处理，当前未接入新方案的订单，需传入空的OAID，和明文的收件人信息。接入新方案的订单，需传入不为空的OAID和交易单号tid。新方案中OAID和tid必填。

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

淘宝开放平台

商家经营工具-开发指引

仓储物流类应用升级方案

一、背景说明

二、方案概述

三、涉及接口和字段说明

1. 电子面单相关API

2. 奇门相关API

四、通用场景升级说明

1. 奇门数据传输脱敏

2. 电子面单

FAQ