服务商使用。可通过该接口查询推广者账号下对应的推广订单明细。
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
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 |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | 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()); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 | < 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 > < 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 > |
1 2 3 4 5 6 | < 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 | 该账号无法调用,请前往服务商平台更新公司自用的账号名单 | 该账号无法调用,请前往服务商平台更新公司自用的账号名单 |