【联盟淘礼金】礼金查询能力升级

尊敬的淘宝客开发者，

618大促之际，淘宝联盟针对目前各开发者反馈的淘礼金问题对礼金相关接口进行迭代升级。

具体迭代内容如下：

一、淘礼金ID透传至订单明细

为方便淘客进行对账和追踪效果，目前淘礼金ID已支持透传至订单明细中，即日起，订单中均可通过扩展字段中的“淘礼金ID”字段查询该笔订单使用的淘礼金ID。

1、如何查询订单中的礼金ID：

【API】

正向订单查询接口：淘宝客-推广者-所有订单查询taobao.tbk.order.details.get

逆向订单查询接口：淘宝客-推广者-全量维权退款订单查询taobao.tbk.order.refund.get

响应字段：“rights_id”

注：当前仅支持推广者订单查询接口

【PUB】

查询路径：淘宝联盟网页版 — 订单明细报表 — 下载报表

下载明细中可通过淘礼金ID对应创建礼金的批次ID

注意??：由于预售订单优先级高于礼金，如淘礼金核销在预售的尾款订单上，则归因为预售订单，不会归因为淘礼金订单，故该类型订单在订单明细中不会展示。

2、如何与自己的淘礼金ID进行关联

【API创建】

淘客可以与API：taobao.tbk.dg.vegas.tlj.create( 淘宝客-推广者-淘礼金创建 )的字段“rights_id”进行关联，进行数据追踪

【其他端创建】

查询新增接口：taobao.tbk.dg.vegas.tlj.list.report( 淘宝客-推广者-淘礼金效果数据批量 )

入参推广位ID和时间信息即可在响应字段“rights_id”查看所有端创建的礼金ID

二、淘礼金API支持查询多端创建数据

1. 新增接口：taobao.tbk.dg.vegas.tlj.list.report( 淘宝客-推广者-淘礼金效果数据批量）

2. 返回信息：包含所有端创建礼金的淘礼金ID、发放情况等数据

3. 权限申请：该接口归属“淘宝客【推广者】淘礼金营销”权限包，如已有该权限包权限日常可正常使用淘礼金创建API的开发者无需重复申请；如无该权限，可前往淘宝联盟·开放平台后台申请

4. 接口功能：现有API taobao.tbk.dg.vegas.tlj.report( 淘宝客-推广者-淘礼金效果数据 ) 仅能查询API端创建的淘礼金数据情况。为方便淘客的数据查询，新增API查询覆盖该账号下APP、PUB、API多端创建的淘礼金数据

更多信息您可以进钉钉群，群号：145450004082

或提交工单工单入口：“联盟开放平台-答疑中心-提交工单”，问题分类选择“基建类API”（https://aff-open.taobao.com/#!/answer?id=1）