服务商使用。可通过该接口查询推广者账号下对应的推广订单明细。
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| query_type | Number | 可选 | 1 |
|
查询时间类型，1：按照订单淘客创建时间查询，2:按照订单淘客付款时间查询，3:按照订单淘客结算时间查询，4:按照订单更新时间； |
| position_index | String | 可选 | 2222_334666 | 位点，除第一页之外，都需要传递；前端原样返回。 | |
| page_size | Number | 可选 | 20 |
|
页大小，默认20，1~100 |
| member_type | Number | 可选 | 2 | 推广者角色类型,2:二方，3:三方，不传，表示所有角色 | |
| tk_status | Number | 可选 | 12 | 淘客订单状态，12-付款，13-关闭，14-确认收货，3-结算成功;不传，表示所有状态 | |
| end_time | String | 必须 | 2019-04-23 12:28:22 | 订单查询结束时间，订单开始时间至订单结束时间，中间时间段日常要求不超过3个小时，但如618、双11、年货节等大促期间预估时间段不可超过20分钟，超过会提示错误，调用时请务必注意时间段的选择，以保证亲能正常调用！ | |
| start_time | String | 必须 | 2019-04-05 12:18:22 | 订单查询开始时间 | |
| jump_type | Number | 可选 | 1 |
|
跳转类型，当向前或者向后翻页必须提供,-1: 向前翻页,1：向后翻页 |
| page_no | Number | 可选 | 1 |
|
第几页，默认1，1~100 |
| order_scene | Number | 可选 | 1 |
|
筛选订单类型，1:所有订单，2:渠道订单，3:会员运营订单，默认为1 |
| member_group_id | Number | 可选 | 100 | member组ID |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| data | OrderPage | OrderPage | PublisherOrderDto |
|
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkScOrderDetailsGetRequest req = new TbkScOrderDetailsGetRequest();
req.setQueryType(1L);
req.setPositionIndex("2222_334666");
req.setPageSize(20L);
req.setMemberType(2L);
req.setTkStatus(12L);
req.setEndTime("2019-04-23 12:28:22");
req.setStartTime("2019-04-05 12:18:22");
req.setJumpType(1L);
req.setPageNo(1L);
req.setOrderScene(1L);
req.setMemberGroupId(100L);
TbkScOrderDetailsGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());
<tbk_sc_order_details_get_response>
<data>
<results>
<publisher_order_dto>
<tb_paid_time>2019-04-22 15:15:05</tb_paid_time>
<tk_paid_time>2019-04-22 15:15:05</tk_paid_time>
<pay_price>9.11</pay_price>
<pub_share_fee>0</pub_share_fee>
<trade_id>294159887445064307</trade_id>
<tk_order_role>2</tk_order_role>
<tk_earning_time>2019-04-22 15:15:05</tk_earning_time>
<adzone_id>11</adzone_id>
<pub_share_rate>100</pub_share_rate>
<refund_tag>0</refund_tag>
<subsidy_rate>0</subsidy_rate>
<tk_total_rate>9.99</tk_total_rate>
<item_category_name>淘小铺</item_category_name>
<seller_nick>--</seller_nick>
<pub_id>98836808</pub_id>
<alimama_rate>0</alimama_rate>
<subsidy_type>--</subsidy_type>
<item_img>//img.alicdn.com/bao/uploaded/i1/2200782262419/O1CN01b5qlop1TjwarUo8fo_!!2200782262419.jpg</item_img>
<pub_share_pre_fee>0</pub_share_pre_fee>
<alipay_total_price>11.22</alipay_total_price>
<item_title>tsh_rj_测试请不要拍_阶佣11.1</item_title>
<site_name>合伙人</site_name>
<item_num>2</item_num>
<subsidy_fee>0</subsidy_fee>
<alimama_share_fee>0</alimama_share_fee>
<trade_parent_id>294159887445064307</trade_parent_id>
<order_type>如意淘</order_type>
<tk_create_time>2019-04-22 15:15:05</tk_create_time>
<flow_source>--</flow_source>
<terminal_type>无线</terminal_type>
<click_time>2019-04-22 15:14:55</click_time>
<tk_status>13</tk_status>
<item_price>2.1</item_price>
<item_id>590141576510</item_id>
<adzone_name>爱分享</adzone_name>
<total_commission_rate>9.99</total_commission_rate>
<item_link>https://detail.tmall.com/item.htm?id=557017471577</item_link>
<site_id>45598009</site_id>
<seller_shop_title>--</seller_shop_title>
<income_rate>9.99</income_rate>
<total_commission_fee>0</total_commission_fee>
<special_id>2323</special_id>
<relation_id>2323</relation_id>
<tk_deposit_time>2019-09-09 12:01:01</tk_deposit_time>
<tb_deposit_time>2019-09-09 12:01:01</tb_deposit_time>
<deposit_price>122.22</deposit_price>
<app_key>112121</app_key>
<tp_order_id>3243</tp_order_id>
<service_fee_dto_list>
<service_fee_d_t_o>
<share_relative_rate>0.10</share_relative_rate>
<share_fee>11.11</share_fee>
<share_pre_fee>11.11</share_pre_fee>
<tk_share_role_type>122</tk_share_role_type>
</service_fee_d_t_o>
</service_fee_dto_list>
<marketing_type>淘礼金</marketing_type>
<modified_time>2022-05-12 15:35:59</modified_time>
<extra_mkt_id>1gwcawUiqn49</extra_mkt_id>
<pub_share_pre_fee_for_commission>0</pub_share_pre_fee_for_commission>
<pub_share_fee_for_commission>0</pub_share_fee_for_commission>
<subsidy_info_dto_list>
<subsidy_detail_d_t_o>
<subsidy_type>妈妈补贴</subsidy_type>
<subsidy_rate>0</subsidy_rate>
<subsidy_fee>0</subsidy_fee>
<subsidy_upper_limit>0</subsidy_upper_limit>
<subsidy_share_rate>0</subsidy_share_rate>
</subsidy_detail_d_t_o>
</subsidy_info_dto_list>
<pub_share_rate_for_sdy>0</pub_share_rate_for_sdy>
<tk_total_rate_for_sdy>0</tk_total_rate_for_sdy>
<pub_share_pre_fee_for_sdy>0</pub_share_pre_fee_for_sdy>
<pub_share_fee_for_sdy>0</pub_share_fee_for_sdy>
<alimm_share_info_dto>
<alimm_tech_service_rate>0</alimm_tech_service_rate>
<alimm_tech_service_pre_fee>0</alimm_tech_service_pre_fee>
<alimm_tech_service_fee>0</alimm_tech_service_fee>
<alimm_agent_service_rate>0</alimm_agent_service_rate>
<alimm_agent_service_pre_fee>0</alimm_agent_service_pre_fee>
<alimm_agent_service_fee>0</alimm_agent_service_fee>
</alimm_share_info_dto>
<platform_special_service_rate>0</platform_special_service_rate>
<platform_special_service_fee>0</platform_special_service_fee>
<platform_special_share_info_dto>
<content_tech_service_rate>0</content_tech_service_rate>
<content_tech_service_pre_fee>0</content_tech_service_pre_fee>
<content_tech_service_fee>0</content_tech_service_fee>
<traffic_tech_service_rate>0</traffic_tech_service_rate>
<traffic_tech_service_pre_fee>0</traffic_tech_service_pre_fee>
<traffic_tech_service_fee>0</traffic_tech_service_fee>
</platform_special_share_info_dto>
<uvid>0</uvid>
</publisher_order_dto>
</results>
<has_pre>false</has_pre>
<position_index>1555904214_lGltNdNvSX2|1555917305_lJfPMeFmdt2</position_index>
<has_next>true</has_next>
<page_no>1</page_no>
<page_size>11</page_size>
</data>
</tbk_sc_order_details_get_response>
<error_response>
<code>50</code>
<msg>Remote service error</msg>
<sub_code>isv.invalid-parameter</sub_code>
<sub_msg>非法参数</sub_msg>
</error_response>
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 3001 | 系统繁忙，请稍后重试！ | 系统繁忙，请稍后重试！ |
| 1006 | tkStatus非法 | 请检查tkStatus参数 |
| 1008 | positionIndex非法 | 请检查positionIndex参数 |
| 9100 | 您的账号因调用不符合要求，当前触发限流。为保障广大推广者正常使用系统，会有账号维度的限流机制：通过API、淘宝客PC后台、联盟APP或使用第三方工具获取数据，同账号会统一限流。同一个账号1秒总请求次数约200次，其中调用API约40次，超过或接近临界值，会触发限流 | 建议您逐一排查各个渠道的总调用量，降低调用频次。此外，在淘宝客PC后台_效果报表_推广者推广明细页面，注意事项第3条会有订单查询方式建议，违反建议也会触发限流。请按建议调整请求策略。 |
| 1005 | jumpType非法 | 请检查jumpType参数 |
| 2002 | 请求参数非法，开始时间应该小于当前时间 | 请求参数非法，观察错误频次，分析是否有爬虫风险 |
| 2004 | 请求参数非法，开始时间应大于最近90天 | 请求参数非法，观察错误频次，分析是否有爬虫风险 |
| 2007 | 请求参数非法，时间段日常要求不超过3个小时，但如618、双11、年货节等大促期间预估时间段不可超过20分钟，超过会提示错误，调用时请务必注意时间段的选择，以保证亲能正常调用！ | 请求参数非法，请缩短查询时间段，同时观察错误频次，分析是否有爬虫风险 |
| 2001 | 请求参数非法，开始时间应该小于结束时间 | 请求参数非法，观察调用频次，分析是否有爬虫风险 |
| 2000 | 请求参数非法，时间格式不正确 | 请求参数非法，观察调用频次，分析是否有爬虫风险 |
| isp.pubrpt-service-unavailable | 服务不可用 | 检查上下游依赖 |
| -4001 | 请查看API返回日志确定具体原因 | 请查看API返回日志确定具体原因 |
| -4002 | 该账号无法调用，请前往服务商平台更新公司自用的账号名单 | 该账号无法调用，请前往服务商平台更新公司自用的账号名单 |