文档中心 > API类目 > 海外-淘宝客API

taobao.ovs.tbk.settle.order.details.get (海外淘宝客-推广者-结算订单查询)

海外淘宝客-推广者-结算订单查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
biz_type String 必须 ALIMAMA 订单业务类型,枚举值。"PANAMA": 巴拿马订单;"ALIMAMA": 阿里妈妈订单。必传
sandbox Number 可选 0 是否沙盒环境,0否 1是
trade_ids String 必须 123,234 多笔订单英文逗号分割

响应参数

名称 类型 示例值 描述
order_list SettleOrder [] 订单列表
  • └ refund_fee
  • String
  • 10
  • 买家维权金额
  • └ unid
  • String
  • 123
  • 渠道自定义id
  • └ parent_trade_id
  • String
  • 123456
  • 淘宝父订单id
  • └ earning_time
  • Number
  • 1671460373000
  • 淘宝结算时间
  • └ order_status
  • String
  • 15
  • 结算订单状态:3:订单结算,15:海外结算,16:订单维权
  • └ refund_status
  • String
  • 2
  • 维权订单状态:维权创建(淘客结算回执) 4,维权成功(淘客结算回执) 2,维权失败(淘客结算回执) 3,发生多次维权,待处理 11,从淘客处补扣(钱已结给淘客) 等待扣款 12,从淘客处补扣(钱已结给淘客) 扣款成功 13,从卖家处补扣(钱已结给卖家) 等待扣款 14,从卖家处补扣(钱已结给卖家) 扣款成功 15
  • └ adzone_id
  • String
  • 123
  • 广告位id
  • └ update_time
  • Number
  • 1671460373000
  • 淘宝订单更新时间
  • └ refund_commission
  • String
  • 0.2
  • 应退还佣金
  • └ refund_finish_time
  • Number
  • 1671460373000
  • 维权完成时间
  • └ trade_id
  • String
  • 123456
  • 淘宝子订单id
  • └ ovs_update_time
  • Number
  • 1671460373000
  • 海外订单更新时间
  • └ refund_create_time
  • Number
  • 1671460373000
  • 维权创建时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OvsTbkSettleOrderDetailsGetRequest req = new OvsTbkSettleOrderDetailsGetRequest();
req.setBizType("ALIMAMA");
req.setSandbox(0L);
req.setTradeIds("123,234");
OvsTbkSettleOrderDetailsGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ovs_tbk_settle_order_details_get_response>
    <order_list>
        <settle_order>
            <refund_fee>10</refund_fee>
            <unid>123</unid>
            <parent_trade_id>123456</parent_trade_id>
            <earning_time>1671460373000</earning_time>
            <order_status>15</order_status>
            <refund_status>2</refund_status>
            <adzone_id>123</adzone_id>
            <update_time>1671460373000</update_time>
            <refund_commission>0.2</refund_commission>
            <refund_finish_time>1671460373000</refund_finish_time>
            <trade_id>123456</trade_id>
            <ovs_update_time>1671460373000</ovs_update_time>
            <refund_create_time>1671460373000</refund_create_time>
        </settle_order>
    </order_list>
</ovs_tbk_settle_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

返回
顶部