基础技术
一、背景说明
近期国家陆续出台了个人信息保护和数据安全相关的法律法规，对保障消费者个人信息权益、规范数据处理活动提出了更明确的责任要求。平台将启动订单处理链路的消费者敏感信息保护方案，对涉及消费者个人敏感信息采取加密、去标识化等安全技术措施。
新的方案将会把订单中涉及消费者的敏感信息进行脱敏处理，订单中消费者敏感信息是指消费者订单中的收件人信息。具体脱敏信息字段包含：收件人姓名、收件人手机号、收件人电话(固定号码)、收件人详细地址（不包含省市区）。为了确保商家订单履约正常运行，平台将新增收件人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名称 |
发货单创建 |
|
发货单创建批量接口 |
|
根据收件人信息查询交易单号接口 |
|
OAID 收件人信息解密接口 |
四、通用场景升级说明
由于每个应用的功能范围存在差异，此章节仅提供整体性介绍和常见或关键改造点的改造建议，不同的功能改造点涉及到使用不同的接口，还需要服务商开发者根据自身产品情况做具体的实施和落地。
整体数据推送链路
1. 奇门数据传输脱敏
主要实现订单处理类应用（ERP、OMS等)-》奇门-》仓储物流类应用（WMS等)三方数据的互通传递，需要保证数据在脱敏+OAID的形式下完成
订单处理类应用（ERP、OMS等)需要支持仓储物流类应用（WMS等)对特殊订单通过奇门解密接口：taobao.qimen.receiverinfo.query的反向解密需求。
2. 电子面单
电子面单的获取接口兼容脱敏数据的处理，当前未接入新方案的订单，需传入空的OAID，和明文的收件人信息。接入新方案的订单，需传入不为空的OAID和交易单号tid。新方案中OAID和tid必填。
