文档中心 > API类目 > 淘宝客API

taobao.tbk.sc.cp.order.details.get (淘宝客-工具-团长-所有订单查询)

工具团长订单查询;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
jump_type Number 可选 1 跳转类型,当向前或者向后翻页必须提供,-1: 向前翻页,1:向后翻页
page_size Number 可选 20
  • 默认值:20
  • 页大小,默认20
    query_type Number 可选 1
  • 默认值:1
  • 查询时间类型,1:按照订单淘客创建时间查询,2:按照订单淘客付款时间查询,3:按照订单淘客结算时间查询,4:按照订单更新时间;
    page_no Number 可选 1
  • 默认值:1
  • 第几页,默认1
    start_time String 必须 2020-04-01 00:00:01 订单查询开始时间
    position_index String 可选 1123213_123213 位点,除第一页之外,都需要传递;前端原样返回
    end_time String 必须 2020-04-01 01:00:01 订单查询结束时间,订单开始时间至订单结束时间,中间时间段日常要求不超过3个小时,但如618、双11、年货节等大促期间预估时间段不可超过20分钟,超过会提示错误,调用时请务必注意时间段的选择,以保证亲能正常调用!
    tk_status Number 可选 12 淘客订单状态,12-付款,13-关闭,14-确认收货,3-结算成功;不传,表示所有状态

    响应参数

    名称 类型 示例值 描述
    data Data Data 返回数据
    • results
    • Result []
    • CpPublisherOrderDTO
    • CpPublisherOrderDTO
    • └ tk_paid_time
    • String
    • 2020-03-25 23:49:31
    • 订单付款的时间,该时间同步淘宝,可能会略晚于买家在淘宝的订单创建时间
    • └ event_id
    • Number
    • 7500393
    • 活动ID
    • └ tk_deposit_time
    • String
    • --
    • 预售时期,用户对预售商品支付定金的付款时间,可能略晚于在淘宝付定金时间
    • └ tk_service_rate
    • String
    • 6
    • 服务费率
    • └ click_time
    • String
    • 2020-03-25 23:22:50
    • 通过推广链接达到商品、店铺详情页的点击时间
    • └ tb_paid_time
    • String
    • 2020-03-25 23:49:21
    • 订单在淘宝拍下付款的时间
    • └ item_id
    • String
    • 534660795472
    • 商品id
    • └ alipay_total_price
    • String
    • 7
    • 买家拍下付款的金额(不包含运费金额)
    • └ tk_status
    • Number
    • 3
    • 已付款:指订单已付款,但还未确认收货 已收货:指订单已确认收货,但商家佣金未支付 已结算:指订单已确认收货,且商家佣金已支付成功 已失效:指订单关闭/订单佣金小于0.01元,订单关闭主要有:1)买家超时未付款; 2)买家付款前,买家/卖家取消了订单;3)订单付款后发起售中退款成功;3:订单结算,12:订单付款, 13:订单失效,14:订单成功
    • └ pre_service_fee
    • String
    • 0.42
    • 预估付款服务费
    • └ tk_create_time
    • String
    • 2020-03-25 23:49:27
    • 订单创建的时间,该时间同步淘宝,可能会略晚于买家在淘宝的订单创建时间
    • └ item_title
    • String
    • 吉得利香辣65g新奥尔良腌料中辣烧烤调料烤翅烤肉料低价肯德基
    • 商品标题
    • └ trade_parent_id
    • String
    • 909934018941578718
    • 买家在淘宝后台显示的订单编号
    • └ item_num
    • Number
    • 1
    • 商品数量
    • └ pay_price
    • String
    • 7
    • 买家确认收货的付款金额(不包含运费金额)
    • └ deposit_price
    • String
    • 0
    • 预售时期,用户对预售商品支付的定金金额
    • └ seller_nick
    • String
    • 天猫超市
    • 店铺名称
    • └ seller_shop_title
    • String
    • 天猫超市
    • 店铺名称
    • └ tb_deposit_time
    • String
    • --
    • 预售时期,用户对预售商品支付定金的付款时间
    • └ service_fee
    • String
    • 0.42
    • 预估结算服务费
    • └ item_price
    • String
    • 7.2
    • 商品单价
    • └ cp_channel_name
    • String
    • 渠道001
    • 招商渠道名称,团长合作流量渠道自定义名称
    • └ cp_channel_id
    • Number
    • 10001
    • 招商渠道ID,团长流量合作渠道标识
    • └ modified_time
    • String
    • 2020-03-25 23:49:27
    • 订单更新时间
    • └ contact_emp_id
    • Number
    • 123
    • 员工id
    • └ contact_emp_name
    • String
    • 这是员工姓名
    • 员工姓名
    • └ page_no
    • Number
    • 1
    • 页码
    • └ page_size
    • Number
    • 10
    • 页大小
    • └ has_next
    • Boolean
    • false
    • 是否还有下一页
    • └ position_index
    • String
    • 1585147709_15brZz9GJR399|1585151367_15dvsG2sw7I99
    • 位点字段,由调用方原样传递
    • └ has_pre
    • Boolean
    • false
    • 是否还有上一页

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TbkScCpOrderDetailsGetRequest req = new TbkScCpOrderDetailsGetRequest();
    req.setJumpType(1L);
    req.setPageSize(20L);
    req.setQueryType(1L);
    req.setPageNo(1L);
    req.setStartTime("2020-04-01 00:00:01");
    req.setPositionIndex("1123213_123213");
    req.setEndTime("2020-04-01 01:00:01");
    req.setTkStatus(12L);
    TbkScCpOrderDetailsGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tbk_sc_cp_order_details_get_response>
        <data>
            <results>
                <result>
                    <tk_paid_time>2020-03-25 23:49:31</tk_paid_time>
                    <event_id>7500393</event_id>
                    <tk_deposit_time>--</tk_deposit_time>
                    <tk_service_rate>6</tk_service_rate>
                    <click_time>2020-03-25 23:22:50</click_time>
                    <tb_paid_time>2020-03-25 23:49:21</tb_paid_time>
                    <item_id>534660795472</item_id>
                    <alipay_total_price>7</alipay_total_price>
                    <tk_status>3</tk_status>
                    <pre_service_fee>0.42</pre_service_fee>
                    <tk_create_time>2020-03-25 23:49:27</tk_create_time>
                    <item_title>吉得利香辣65g新奥尔良腌料中辣烧烤调料烤翅烤肉料低价肯德基</item_title>
                    <trade_parent_id>909934018941578718</trade_parent_id>
                    <item_num>1</item_num>
                    <pay_price>7</pay_price>
                    <deposit_price>0</deposit_price>
                    <seller_nick>天猫超市</seller_nick>
                    <seller_shop_title>天猫超市</seller_shop_title>
                    <tb_deposit_time>--</tb_deposit_time>
                    <service_fee>0.42</service_fee>
                    <item_price>7.2</item_price>
                    <cp_channel_name>渠道001</cp_channel_name>
                    <cp_channel_id>10001</cp_channel_id>
                    <modified_time>2020-03-25 23:49:27</modified_time>
                    <contact_emp_id>123</contact_emp_id>
                    <contact_emp_name>这是员工姓名</contact_emp_name>
                </result>
            </results>
            <page_no>1</page_no>
            <page_size>10</page_size>
            <has_next>false</has_next>
            <position_index>1585147709_15brZz9GJR399|1585151367_15dvsG2sw7I99</position_index>
            <has_pre>false</has_pre>
        </data>
    </tbk_sc_cp_order_details_get_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部