注意：以下文档只适用于TOP接口，请谨慎使用！
注意：以下文档只适用于TOP接口，请谨慎使用！
近期淘宝新增了一种订单类型，存在付款人和收货人两个角色，在订单付款时尚未明确收件人信息，需要由收货人填写收货地址。基于上述场景淘宝开放平台同步升级了此类业务场景下的交易模型，在部分交易相关数据查询接口上增加了【收货人openId】和【收货人的淘宝昵称】（模糊化），生态侧系统需要完成相应的适配，可参考下文中的改造方案。
请服务商确认产品中以下接口的使用
这里的API接口包括正向和逆向
类型 |
接口 |
正向交易 |
taobao.trade.fullinfo.get taobao.trades.sold.get taobao.trades.sold.increment.get taobao.trades.sold.incrementv.get taobao.trade.simple.get taobao.trade.get taobao.trades.simple.sold.get taobao.trades.simple.sold.increment.get taobao.trades.sold.history.get taobao.open.trades.sold.get taobao.open.trade.get taobao.trades.sold.get.vo taobao.trade.fullinfo.get.vo taobao.trade.fullinfo.get.customization |
逆向退款 |
taobao.refund.get tmall.dispute.receive.get taobao.refunds.receive.get taobao.special.refund.get tmall.exchange.get tmall.exchange.receive.get taobao.special.refunds.receive.get |
API接口侧主订单和退款单模型会增加如下的字段信息：
字段 |
描述 |
类型 |
real_receiver_open_id |
收件人淘宝加密openId |
string |
real_receiver_display_nick |
收件人淘宝加密昵称 |
string |
数据推送交易、退款、天猫换货的同步字段配置会增加real_receiver_open_id和real_receiver_display_nick（默认选中，不用单独配置）；相应的数据通过大字段的形式写入到jdp_response中。对应的表分别为：
sys_info库表 |
类型 |
jdp_tb_trade |
订单 |
jdp_tb_refund |
退款 |
jdp_exchange_refund |
天猫换货 |
消息字段没有变更，不会增加数据，但对于单据信息上有收件人real_receiver_open_id的一些垂直场景的订单，创建和支付等消息不会下发。
1. 当real_receiver_open_id为空时，说明是普通场景的淘宝单据，按照普通的交易模式处理即可。
2. 当real_receiver_open_id不为空时，说明当前单据为本次业务模型相关的订单数据，需要在包括但不限于订单功能页、旺旺亮灯等页面做信息表达。
3. 字段解释：订单和退款单上的 buyer_open_uid 和buyer_nick表示付款人的信息；real_receiver_display_nick和real_receiver_open_id表示的是收货人的信息。
4. 旺旺亮灯：当前旺旺昵称唤起聊天展示时，需要新增对收货人信息：real_receiver_open_id和real_receiver_display_nick的识别展示。
产品类型 |
优化建议 |
参考效果 |
客服面板产品 |
1. 官方新增飘条提示：告知商家（客服人员）当前订单和进线咨询的消费者之间的关系（三方无需处理） 2. 客服面板中【三方需要重点提示】的部分： a. 提示 1：无法识别到订单的场景如下，请使用公告提示，文案可参考：由于存在付款人和收货人不一致的特殊订单类型，在收货人确认收货地址前，暂时无法获取相关订单，如有问题请前往千牛后台-订单管理处理 i. 【付款人进线+不能识别订单】，由于收货人确认收货地址前，三方无法感知订单存在，此时订单列表无订单 ii.【收货人进线+不能识别订单】，由于三方未将收货人关联的订单进行合并，此时订单列表无订单 b. 提示 2：需要提醒客服人员严禁将付款人和收货人信息告知对方，依据进线消费者角色的差异，提示文案有所不同 i. 【付款人进线+能识别订单】，提示文案：当前订单为特殊订单，聊天对象为付款人，但非收货人。为保障用户信息及隐私，在聊天过程中请勿对其擅自透露订单的收货地址、物流轨迹等信息 ii. 【收货人进线+能识别订单】，提示文案：当前订单为特殊订单，聊天对象为收货人，但非付款人。为保障用户信息及隐私，在聊天过程中请勿对其擅自透露订单的支付账号、优惠权益等支付信息 c. 提示 3：由于该类订单的运费部分由平台补贴，三方暂时无法感知运费数据，请提示商家前往千牛查看，文案建议：可前往千牛后台-订单管理，查看特殊订单的运费信息 3. 操作区屏蔽：收货人确认收货地址后，面向付款人和收货人的能力存在差异，比如仅支持付款人开票、仅支持收货人退货退款，其他操作请 ISV 谨慎评估是否需要屏蔽；官方面板中，核对订单、小额打款、小额收款、协商发货、帮他退款均保持禁用，供三方参考 |
面板改造示意： |
ERP产品 订单工具 |
1. 公告提示：由于收货人确认收货地址前，三方无法感知订单存在，因此 ERP 需要在工具面板中提供公告区域，声明如果出现这类资讯需求前往千牛后台查看，参考的公告内容：由于存在付款人和收货人不一致的订单类型，在收货人确认收货地址前，暂时无法获取相关订单，如有问题请前往千牛后台-订单管理处理 2. 付款人和收货人信息展示： a. 在订单列表上，可以展示订单对应的付款人和收款人，使用模糊化的淘宝 nick，具体字段已在上文给出 b. 在订单详情中，可参考图示展示付款人和收货人信息，并增加提示，告知商家严禁将付款人和收货人信息告知对方 i. 特殊订单提示：订单的付款人和收货人不同，发货及售后问题请联系收货人；发票问题请联系付款人 ii 买家信息提示：为保障用户信息及隐私，请勿对收货人（收货人nick）擅自透露订单的支付账号、优惠权益等支付信息 iii. 物流信息提示：为保障用户信息及隐私，请勿对付款人（付款人nick）擅自透露订单的收货地址、物流轨迹等信息 |
ERP 或 订单工具示意： |
由于运费数据部分 ISV 无法获取，部分基于订单总价的产品策略需要评估是否提醒商家或屏蔽。
A：由于订单的特殊性，收货人确认收货地址前，不会推送订单（API查询会返回“交易截单”信息），目前 hold 单时长最多不超过 24 小时，超时会自动关闭（关闭后的订单和对应的退款单也不会下发，单据不会向生态同步）；同时由于在生态 ERP 和工具看不到该订单，建议让商家能够感知到该订单并且在千牛后台进行查看。
A：以上场景两笔订单的OAID一致。
A：该类型订单不要和普通订单做拆合单，以免出现无法预知的问题，这个拆合单只能必须整单发,不允许与同类型合并,也不允许拆分发货。
A：收货人确认收货地址前，订单处于hold单状态，交易创建、支付消息不会下发。
A：不论是在ERP侧或者官方后台均不支持此类订单修改地址，但后期会考虑开放。
A：没有地址信息的时候不会下发，超时关单也不会下发。
A：当前该类型订单的运费由官方补贴，接口中暂不推送运费数据，请提示商家前往千牛查看，文案建议：可前往千牛后台-订单管理，查看特殊订单的运费信息。
A：收货人确认收货地址前，三方无法获取订单信息，以引导到官方处理为主，同时该阶段中，仅付款人可以进线咨询订单售后问题；收货人确认收货地址后，付款人和收货人均可进线咨询，两者能够处理的售后问题存在差异。
