订单隐私改造方案

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

新的方案将会把订单中涉及消费者的敏感信息进行脱敏处理，订单中消费者敏感信息是指消费者订单中的收件人信息。具体脱敏信息字段包含：收件人姓名、收件人手机号、收件人电话(固定号码)、收件人详细地址（不包含省市区）。为了确保商家订单履约正常运行，平台将新增收件人ID字段【简称OAID】。OAID是本次升级新增的核心字段。

收件人脱敏后的信息类似如下：

"receiver_address": "陆**街道**路***号****室",  
"receiver_mobile": "*******6392", 
"receiver_name": "王**",
"receiver_phone": "",

为了使大家顺利改造接口、兼容现有的电子面单取号等，在过渡期内，即在2021年8月20日之前，蜂巢的订单消息推送和订单相关接口都还将订单中的收件人信息使用明文返回给大家，但是请视为已经是脱敏后的信息，使用最新的接口参数进行系统升级改造，以免影响系统的使用。

一、订单消息推送改造

消息topic	说明	变更
tb_push_wait_seller_send_trade	买家已付款，即等待卖家发货	推送的订单里增加oaid字段
tb_tradememo_modified_with_trade	交易备注修改消息，附带订单信息，可设置推送规则。未设置规则，默认推送。	推送的订单里增加oaid字段
tb_push_paid_trade_with_buyermessage	根据买家留言推送待发货订单，可设置推送规则，未设置规则，默认不推送	推送的订单里增加oaid字段

推送消息文档：http://doc.fw199.com/docs/h7b/ws-message

二、相关接口改造

1. 蜂巢接口<订单详情> 变更

返回结果增加字段：oaid, 相关收件人信息脱敏

接口文档：http://doc.fw199.com/docs/h7b/trade-detail

2. 蜂巢接口<批量获取订单详情> 变更

返回结果增加字段：oaid，相关收件人信息脱敏

接口文档：http://doc.fw199.com/docs/h7b/tb-trade-batch-detail

3. 蜂巢接口<获取订单列表> 变更

返回结果增加字段：oaid ，相关收件人信息脱敏

接口文档：http://doc.fw199.com/docs/h7b/tradelist

4. 蜂巢接口<获取增量订单列表> 变更

返回结果增加字段：oaid，相关收件人信息脱敏

接口文档：http://doc.fw199.com/docs/h7b/tb-order-increment-list

5. 蜂巢接口<电子面单取号>变更

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

      "recipient": {
                            "address": {  
                                "city": "广州市", 
                                "detail": "",    
                                "district": "白云区", 
                                "province": "广东省" 
                              },  
                             "mobile":  "" ,
                             "name":  "" ,
                             "phone":  "" ,
                             "oaid": "1h12MgRsECYSQayzH33CwBP1s3CmkVyx1m4SItNJ6ZhgUibyzr9RA", 
                             "tid": "2003779371056565830"  

             }