淘宝客-服务商-所有订单查询 - 乐天联盟-开放平台

服务商使用。可通过该接口查询推广者账号下对应的推广订单明细。

请求参数

Body 参数application/json

openId

string

用户身份Id

必需

startTime

string

订单查询开始时间

必需

endTime

string

订单查询结束时间

必需

queryType

integer | null

查询时间类型

可选

1：按照订单淘客创建时间查询，2:按照订单淘客付款时间查询，3:按照订单淘客结算时间查询，4:按照订单更新时间；

orderScene

integer | null

场景订单场景类型

可选

1:常规订单，2:渠道订单，3:会员运营订单，默认为1

status

integer | null

淘客订单状态

可选

12-付款，13-关闭，14-确认收货，3-结算成功;不传，表示所有状态

jumpType

integer | null

跳转类型

可选

当向前或者向后翻页必须提供,-1: 向前翻页,1：向后翻页

pageNo

integer | null

页码

可选

默认1，1~100

pageSize

integer | null

页大小

可选

默认20，1~100

memberType

integer | null

推广者角色类型

可选

2:二方，3:三方，不传，表示所有角色

memberGroupId

integer | null

member组Id

可选

positionIndex

string | null

位点字段，由调用方原样传递

可选

示例

{
  "openId": "584e2889-4c3d-4608-884e-d01c309b19fd",
  "startTime": "2022-12-14 09:56:40",
  "endTime": "2022-12-14 10:10:40",
  "orderScene": 2
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

positionIndex

string

位点字段，由调用方原样传递

必需

hasPre

boolean

是否还有上一页

必需

hasNext

boolean

是否还有下一页

必需

pageNo

integer

页码

必需

pageSize

integer

页大小

必需

publisherOrders

array [object {53}]

订单详情

必需

tradeId

string

必需

买家通过购物车购买的每个商品对应的订单编号，此订单编号并未在淘宝买家后台透出

tradeParentId

string

必需

买家在淘宝后台显示的订单编号

refundTag

integer

必需

维权标签，0 含义为非维权 1 含义为维权订单

status

integer

必需

已付款：指订单已付款，但还未确认收货已收货：指订单已确认收货，但商家佣金未支付已结算：指订单已确认收货，且商家佣金已支付成功已失效：指订单关闭/订单佣金小于0.01元，订单关闭主要有：1）买家超时未付款； 2）买家付款前，买家/卖家取消了订单；3）订单付款后发起售中退款成功；3：订单结算，12：订单付款， 13：订单失效，14：订单成功

orderType

string

必需

订单所属平台类型，包括天猫、淘宝、聚划算等

terminalType

string

成交平台

必需

flowSource

string

产品类型

必需

marketingType

string

必需

营销类型：该字段中视订单情况有单个或多个值。例如：淘礼金（自助充值），特价版客户端染色，特价版客户端锁粉，特价版客户端推广。

orderRole

integer

必需

二方：佣金收益的第一归属者；三方：从其他淘宝客佣金中进行分成的推广者

payPrice

integer

必需

买家确认收货的付款金额（不包含运费金额）

alipayTotalPrice

integer

必需

买家拍下付款的金额（不包含运费金额）

createTime

string

订单创建的时间

必需

paidTime

string

订单付款的时间

必需

earningTime

string

必需

订单确认收货后且商家完成佣金支付的时间

depositPrice

integer

必需

预售时期，用户对预售商品支付的定金金额

depositTime

string

必需

预售时期，用户对预售商品支付定金的付款时间

totalRate

number

必需

提成=收入比率*分成比率。指实际获得收益的比率

incomeRate

number

必需

订单结算的佣金比率+平台的补贴比率

subsidyType

string

必需

平台出资方，如天猫、淘宝、或聚划算等

subsidyRate

integer

必需

平台给与的补贴比率，如天猫、淘宝、聚划算等

subsidyFee

integer

必需

补贴金额=结算金额*补贴比率

totalCommissionRate

number

佣金比率

必需

totalCommissionFee

integer | number

必需

佣金金额=结算金额＊佣金比率

alimamaRate

integer

必需

推广者赚取佣金后支付给阿里妈妈的技术服务费用的比率

alimamaShareFee

integer

必需

技术服务费=结算金额收入比率技术服务费率。推广者赚取佣金后支付给阿里妈妈的技术服务费用

commissionPreFeeForMediaPlatform

integer

必需

预估内容专项服务费：内容场景专项技术服务费，内容推广者在内容场景进行推广需要支付给阿里妈妈专项的技术服务费用。专项服务费＝付款金额＊专项服务费率。

commissionFeeForMediaPlatform

integer

必需

结算内容专项服务费：内容场景专项技术服务费，内容推广者在内容场景进行推广需要支付给阿里妈妈专项的技术服务费用。专项服务费＝结算金额＊专项服务费率。

commissionRateForMediaPlatform

integer

必需

内容专项服务费率：内容场景专项技术服务费率，内容推广者在内容场景进行推广需要按结算金额支付一定比例给阿里妈妈作为内容场景专项技术服务费，用于提供与内容平台实现产品技术对接等服务。

alscId

string

口碑子订单号

必需

alscParentId

string

口碑父订单号

必需

isLx

boolean

必需

订单是否为激励池订单 1，表征是 0，表征否

lxRid

string

激励池对应的rid

必需

specialId

integer

会员运营Id

必需

relationId

integer

渠道关系Id

必需

pubId

integer

推广者的会员Id

必需

pubShareRate

integer

必需

从结算佣金中分得的收益比率

pubShareFee

integer | number

必需

结算预估收入=结算金额*提成。以买家确认收货的付款金额为基数，预估您可能获得的收入。因买家退款、您违规推广等原因，可能与您最终收入不一致。最终收入以月结后您实际收到的为准

pubSharePreFee

integer

必需

付款预估收入=付款金额*提成。指买家付款金额为基数，预估您可能获得的收入。因买家退款等原因，可能与结算预估收入不一致

siteId

integer

必需

媒体管理下的Id,同时也是pid=mm_1_2_3中的“2”这段数字

siteName

string

必需

媒体管理下的对应Id的自定义名称

adzoneId

integer

必需

推广位管理下的推广位名称对应的Id，同时也是pid=mm_1_2_3中的“3”这段数字

adzoneName

string

必需

推广位管理下的自定义推广位名称

itemId

string

商品Id

必需

itemTitle

string

商品标题

必需

itemUrl

string

商品链接

必需

itemImage

string

商品主图

必需

itemNum

integer

商品数量

必需

itemPrice

integer

商品价格

必需

itemCategoryName

string

必需

商品所属的根类目，即一级类目的名称

sellerNick

string

卖家昵称

必需

sellerShopTitle

string

卖家店铺名称

必需

clickTime

string

必需

通过推广链接达到商品、店铺详情页的点击时间

modifiedTime

string

订单更新时间

必需

示例

{
  "positionIndex": "1670983033_3Gz1kIrWQ7g2|1670983033_3Gz1kIs12gi2",
  "hasPre": false,
  "hasNext": false,
  "pageNo": 1,
  "pageSize": 20,
  "publisherOrders": [
    {
      "tradeId": "3094102334586708146",
      "tradeParentId": "3094102334584708146",
      "refundTag": 0,
      "status": 13,
      "orderType": "天猫",
      "terminalType": "无线",
      "flowSource": "--",
      "marketingType": "",
      "orderRole": 2,
      "payPrice": 0,
      "alipayTotalPrice": 0,
      "createTime": "2022-12-14 09:57:13",
      "paidTime": "2022-12-14 09:57:40",
      "earningTime": "",
      "depositPrice": 0,
      "depositTime": "--",
      "totalRate": 1.35,
      "incomeRate": 1.35,
      "subsidyType": "--",
      "subsidyRate": 0,
      "subsidyFee": 0,
      "totalCommissionRate": 1.35,
      "totalCommissionFee": 0,
      "alimamaRate": 0,
      "alimamaShareFee": 0,
      "commissionPreFeeForMediaPlatform": 0,
      "commissionFeeForMediaPlatform": 0,
      "commissionRateForMediaPlatform": 0,
      "alscId": "",
      "alscParentId": "",
      "isLx": false,
      "lxRid": "",
      "specialId": 0,
      "relationId": 0,
      "pubId": 116407728,
      "pubShareRate": 100,
      "pubShareFee": 0,
      "pubSharePreFee": 0,
      "siteId": 2319150062,
      "siteName": "妖妖灵",
      "adzoneId": 111981100354,
      "adzoneName": "测试22233",
      "itemId": "qYtrU8tD6rtWt0-7A34KQcwbGKnMXdfQ",
      "itemTitle": "【买家秀征集】5元晒图3张+视频+20字文字以上截图给客服领取红包",
      "itemUrl": "//uland.taobao.com/item/edetail?id=qYtrU8tD6rtWt0-7A34KQcwbGKnMXdfQ",
      "itemImage": "//img.alicdn.com/tfscom/i4/2923332693/O1CN01ia3vSI1VlRNwqcngd_!!0-item_pic.jpg",
      "itemNum": 1,
      "itemPrice": 99,
      "itemCategoryName": "其他",
      "sellerNick": "夫尼保罗旗舰店",
      "sellerShopTitle": "夫尼保罗旗舰店",
      "clickTime": "2022-12-14 09:55:32",
      "modifiedTime": "2022-12-24 10:07:15"
    },
    {
      "tradeId": "3094102334585708146",
      "tradeParentId": "3094102334584708146",
      "refundTag": 0,
      "status": 3,
      "orderType": "天猫",
      "terminalType": "无线",
      "flowSource": "--",
      "marketingType": "",
      "orderRole": 2,
      "payPrice": 69,
      "alipayTotalPrice": 69,
      "createTime": "2022-12-14 09:57:13",
      "paidTime": "2022-12-14 09:57:40",
      "earningTime": "2022-12-24 10:09:01",
      "depositPrice": 0,
      "depositTime": "--",
      "totalRate": 1.5,
      "incomeRate": 1.5,
      "subsidyType": "--",
      "subsidyRate": 0,
      "subsidyFee": 0,
      "totalCommissionRate": 1.5,
      "totalCommissionFee": 1.04,
      "alimamaRate": 0,
      "alimamaShareFee": 0,
      "commissionPreFeeForMediaPlatform": 0,
      "commissionFeeForMediaPlatform": 0,
      "commissionRateForMediaPlatform": 0,
      "alscId": "",
      "alscParentId": "",
      "isLx": false,
      "lxRid": "",
      "specialId": 0,
      "relationId": 0,
      "pubId": 116407728,
      "pubShareRate": 100,
      "pubShareFee": 1.04,
      "pubSharePreFee": 0,
      "siteId": 2319150062,
      "siteName": "妖妖灵",
      "adzoneId": 111981100354,
      "adzoneName": "测试22233",
      "itemId": "5gtXURtQjOCMtV-G90pAnSqqAdeOrQCnj",
      "itemTitle": "【奇妙物语】秋衣纯棉男士打底衫薄款棉毛衫秋裤新款保暖内衣套装",
      "itemUrl": "//uland.taobao.com/item/edetail?id=5gtXURtQjOCMtV-G90pAnSqqAdeOrQCnj",
      "itemImage": "//img.alicdn.com/tfscom/i2/2923332693/O1CN01JWXCid1VlRJybxcxw_!!2923332693.jpg",
      "itemNum": 1,
      "itemPrice": 79,
      "itemCategoryName": "女士内衣/男士内衣/家居服",
      "sellerNick": "夫尼保罗旗舰店",
      "sellerShopTitle": "夫尼保罗旗舰店",
      "clickTime": "2022-12-14 09:55:32",
      "modifiedTime": "2022-12-24 10:09:02"
    }
  ]
}