文档中心 > 基础技术

隐私保护消费者唯一标识变更改造方案(TOPAPI)

更新时间:2024/04/28 访问次数:25781

一、背景

随着越来越多的消费者进行淘宝会员名修改,为避免淘宝会员名(淘宝Nick)变更给开发者带来的消费者唯一标识的识别困扰,开放平台统一给开发者提供open_uid作为消费者唯一标识字段,代替原先的淘宝会员名(淘宝nick),无论消费者的淘系会员名是否修改,开发者使用同一个appkey获取的open_uid都不会发生变化。


二、改造范围&内容

本次改造涉及变更点:

交易正逆向TOPAPI接口:出参新增字段buyer_open_uid,服务商需要通过接口获取该字段,并通过使用该字段完成对自身系统中消费者全局唯一标识的适配。

交易正逆向官方消息:添加buyer_open_uid,服务商需要在订阅读取消息时获取该字段,并通过使用该字段完成对自身系统中消费者全局唯一标识的适配。

如有涉及使用到相关API或消息服务,可根据实际情况进行相关适配调整。


三、方案概述

1.本次改造主要是调整交易正逆向订单及消息服务相关接口出入参新增buyer_open_uid,后续通过此字段作为系统里面消费者身份的唯一标识取代buyer_nick。服务商从接口出参获取buyer_open_uid,同时将字段应用到之前buyer_nick覆盖的功能场景。

2.在服务商完成字段的适配和改造调整后,平台将在节点时间统一切流将原接口出参中buyer_nick字段做模糊化处理,在此期间服务商关注自身应用功能并完成检查,确保复核确认buyer_open_uid适配替换场景功能无阻塞,无缺陷。

3.模糊化针对的是接口出参中的buyer_nick,入参buyer_nick保留不受影响。

四、API字段变更说明

交易正逆向TOPAPI改造接口列表


apiName

接口说明

入参变更

出参变更

备注

taobao.refunds.receive.get

查询卖家收到的退款列表

添加:buyer_open_uid

添加:buyer_open_uid

taobao.trade.fullinfo.get

订单信息查询

无变化

添加:buyer_open_uid

taobao.trade.get

获取单笔交易信息

无变化

添加:buyer_open_uid

taobao.trades.sold.get

查询卖家已卖出的交易数据(根据创建时间)

添加:buyer_open_uid

添加:buyer_open_uid

taobao.trades.sold.increment.get

查询卖家已卖出的增量交易数据(根据修改时间)

添加:buyer_open_uid

添加:buyer_open_uid

taobao.trades.sold.incrementv.get

查询卖家已卖出的增量交易数据(根据入库时间)

无变化

添加:buyer_open_uid

taobao.trade.simple.get

CRM获取交易订单的简易信息

无变化

添加:buyer_open_uid


taobao.trades.simple.sold.get

查询卖家已卖出的交易简易数据

添加:buyer_open_uid



taobao.trades.simple.sold.increment.get

查询卖家已卖出的增量交易简易数据(根据修改时间)

添加:buyer_open_uid

添加:buyer_open_uid


tmall.dispute.receive.get

天猫逆向纠纷查询

添加:buyer_open_uid

添加:buyer_open_uid

taobao.refunds.apply.get

查询买家申请的退款列表

无变化

添加:buyer_open_uid

taobao.refund.get

获取单笔退款详情

无变化

添加:buyer_open_uid

taobao.special.refunds.receive.get

特殊退款类型的纠纷单列表查询

添加:buyer_open_uid

添加:buyer_open_uid

taobao.special.refund.get

特殊部分退纠纷单查询

无变化

添加:buyer_open_uid

taobao.refund.messages.get

查询退款留言/凭证列表

无变化

添加:owner_open_uid


owner_open_uid同buyer_open_uid


五、消息服务字段变更说明

交易正逆向相关消息服务改造列表

topic_name

消息说明

参数变更说明

备注

taobao_refund_RefundBuyerModifyAgreement

买家修改退款协议消息

添加:buyer_open_uid


taobao_refund_RefundBuyerReturnGoods

买家退货给卖家消息

添加:buyer_open_uid


taobao_refund_RefundClosed

退款关闭消息

添加:buyer_open_uid


taobao_refund_RefundCreated

退款创建消息

添加:buyer_open_uid


taobao_refund_RefundSellerAgreeAgreement

卖家同意退款协议消息

添加:buyer_open_uid


taobao_refund_RefundSellerRefuseAgreement

卖家拒绝退款协议消息

添加:buyer_open_uid


taobao_refund_RefundSuccess

退款成功消息

添加:buyer_open_uid


taobao_refund_TaobaoInterApplied

申请淘宝介入消息

添加:buyer_open_uid


taobao_refund_TaobaoIntervened

淘宝介入退款消息

添加:buyer_open_uid


taobao_trade_AdvanceDisburse

订单极速放款成功消息

添加:buyer_open_uid


taobao_trade_TradeAlipayCreate

创建支付宝订单消息

添加:buyer_open_uid


taobao_trade_TradeBuyerPay

买家付完款,或万人团买家付完尾款

添加:buyer_open_uid


taobao_trade_TradeBuyerStepPay

分阶段订单付定金

添加:buyer_open_uid


taobao_trade_TradeChanged

订单信息变更消息

添加:buyer_open_uid


taobao_trade_TradeClose

关闭交易消息

添加:buyer_open_uid


taobao_trade_TradeCloseAndModifyDetailOrder

关闭或修改子订单消息

添加:buyer_open_uid


taobao_trade_TradeCreate

创建淘宝交易消息

添加:buyer_open_uid


taobao_trade_TradeDelayConfirmPay

延长收货时间消息

添加:buyer_open_uid


taobao_trade_TradeLogisticsAddressChanged

修改交易收货地址消息

添加:buyer_open_uid


taobao_trade_TradeMemoModified

交易备注修改消息

添加:buyer_open_uid


taobao_trade_TradeModifyFee

修改交易费用消息

添加:buyer_open_uid


taobao_trade_TradePartlyConfirmPay

子订单打款成功消息

添加:buyer_open_uid


taobao_trade_TradePartlyRefund

子订单退款成功消息

添加:buyer_open_uid


taobao_trade_TradePartlySellerShip

交易的部分子订单发货消息

添加:buyer_open_uid


taobao_trade_TradeRated

交易评价变更消息

添加:buyer_open_uid


taobao_trade_TradeSellerShip

卖家发货消息

添加:buyer_open_uid


taobao_trade_TradeSuccess

交易成功消息

添加:buyer_open_uid


taobao_trade_TradeTimeoutRemind

交易超时提醒消息

添加:buyer_open_uid



针对此次去Nick改造,目前平台已经发布了数据清理转化接口

1.通过订单号进行数据转换接口:点击查看

2.通过NICK进行数据转换接口:点击查看

目前平台已经对改造任务所涉及应用进行相应的接口使用授权。

接口错误码解析

sub_code: "isp.order.query.error" 查询失败,可尝试重试;

sub_code: "isv.openuid-convert-error" openuid转换服务异常,可尝试重试;

sub_code: "isv.invalid-order.error" 无效订单 tid入参有问题;

sub_code: "isv.invalid-usernick.error" usernick不存在;

sub_code: "isv.order.notfound" 订单未找到:tid 数据源未找到;

sub_code: "isv.order.buyer.inconsistent", 订单不属于当前买家:tid。

FAQ

关于此文档暂时还没有FAQ
返回
顶部