taobao.trade.fullinfo.get.vo (天猫国际直邮店获取履单)

获取单笔交易的详细信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String 必须 tid,type,status,payment,orders,promotion_details 需要返回的字段列表,多个字段用半角逗号分隔,可选值为返回示例中能看到的所有字段。
tid Number 必须 123456789 交易编号

响应参数

名称 类型 示例值 描述
trade Trade 交易主订单信息
  • └ tid
  • Number
  • 2231958349
  • 交易编号 (父订单的交易编号)
  • └ payment
  • String
  • 200.07
  • 实付金额。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ discount_fee
  • String
  • 200.07
  • 建议使用trade.promotion_details查询系统优惠系统优惠金额(如打折,VIP,满就送等),精确到2位小数,单位:元。如:200.07,表示:200元7分
  • └ adjust_fee
  • String
  • 200.07
  • 卖家手工调整金额,精确到2位小数,单位:元。如:200.07,表示:200元7分。来源于订单价格修改,如果有多笔子订单的时候,这个为0,单笔的话则跟[order].adjust_fee一样
  • └ post_fee
  • String
  • 200.07
  • 邮费。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ total_fee
  • String
  • 200.07
  • 商品金额(商品价格乘以数量的总金额)。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ pay_time
  • Date
  • 2000-01-01 00:00:00
  • 付款时间。格式:yyyy-MM-dd HH:mm:ss。订单的付款时间即为物流订单的创建时间。
  • └ buyer_message
  • String
  • 要送的礼物的,不要忘记的哦
  • 买家留言
  • └ shipping_type
  • String
  • free
  • 创建交易时的物流方式(交易完成前,物流方式有可能改变,但系统里的这个字段一直不变)。可选值:free(卖家包邮),post(平邮),express(快递),ems(EMS),virtual(虚拟发货),25(次日必达),26(预约配送)。
  • └ point_fee
  • Number
  • 0
  • 买家使用积分,下单时生成,且一直不变。格式:100;单位:个.
  • └ promotion
  • String
  • hello world
  • 交易促销详细信息
  • orders
  • Order []
  • 订单列表
  • └ title
  • String
  • 山寨版测试机器
  • 商品标题
  • └ price
  • String
  • 200.07
  • 商品价格。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ num_iid
  • Number
  • 2342344
  • 商品数字ID
  • └ outer_iid
  • String
  • 152e442aefe88dd41cb0879232c0dcb0
  • 商家外部编码(可与商家外部系统对接)。外部商家自己定义的商品Item的id,可以通过taobao.items.custom.get获取商品的Item的信息
  • └ outer_sku_id
  • String
  • 81893848
  • 外部网店自己定义的Sku编号
  • └ oid
  • Number
  • 2231958349
  • 子订单编号
  • └ discount_fee
  • String
  • 200.07
  • 子订单级订单优惠金额。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ adjust_fee
  • String
  • 1.01
  • 手工调整金额.格式为:1.01;单位:元;精确到小数点后两位.
  • └ num
  • Number
  • 1
  • 购买数量。取值范围:大于零的整数
  • └ store_code
  • String
  • 南京QDHEWL-0004
  • 发货的仓库编码
  • └ sub_order_tax_fee
  • String
  • 0
  • 天猫国际官网直供子订单关税税费
  • └ refund_status
  • String
  • SUCCESS(退款成功)
  • 退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
  • combine_item_info
  • CombineSubItemDO []
  • 组合品信息
  • └ item_id
  • Number
  • 123123
  • 商品数字编号
  • └ sku_id
  • Number
  • 22331764490705
  • 商品的最小库存单位Sku的id
  • └ quantity
  • Number
  • 1
  • 数量
  • └ item_name
  • String
  • 商品名称
  • 商品名称
  • └ outer_iid
  • String
  • 152e442aefe88dd41cb0879232c0dcb0
  • 商家外部编码(可与商家外部系统对接)。
  • └ sku_title
  • String
  • 16g
  • SKU标题
  • └ origin_fee
  • Number
  • 123
  • 成分品原价
  • └ combine_sub_item_fee
  • Number
  • 123
  • 成分品套餐原价
  • └ ismain
  • Boolean
  • true
  • 套餐购是否商品主子成分品
  • └ estcon_time
  • Boolean
  • 7 / 2023-02-15
  • 套餐购成分品预计承诺时效(如果为时间格式为yyyy-MM-dd 则为绝对时间,为数字则为相对时间,比如7天内发货)
  • └ outer_sku_id
  • String
  • 123
  • outer_sku_id
  • └ has_combine_item
  • Boolean
  • true
  • 是否包含组合商品
  • promotion_details
  • PromotionDetail []
  • 优惠详情
  • └ id
  • Number
  • 22331764490705
  • 交易的主订单或子订单号
  • └ promotion_name
  • String
  • 满就减钱
  • 优惠信息的名称
  • └ discount_fee
  • String
  • 10.00
  • 优惠金额(免运费、限时打折时为空),单位:元
  • └ gift_item_name
  • String
  • 晨光签字笔
  • 满就送商品时,所送商品的名称
  • └ gift_item_id
  • String
  • 13233791195
  • 赠品的宝贝id
  • └ gift_item_num
  • String
  • 1
  • 满就送礼物的礼物数量
  • └ promotion_desc
  • String
  • 双11促销,满就送
  • 优惠活动的描述
  • └ promotion_id
  • String
  • mjs
  • 优惠id,(由营销工具id、优惠活动id和优惠详情id组成,结构为:营销工具id-优惠活动id_优惠详情id,如mjs-123024_211143)
  • └ order_tax_fee
  • String
  • 0
  • 天猫国际官网直供主订单关税税费
  • └ cross_bonded_declare
  • Boolean
  • true
  • 跨境订单
  • └ trade_attr
  • String
  • {\"payCurrency\":\"HKD\"}
  • 主订单扩展属性;payCurrency:HKD(港币)、TWD(台币)
  • └ omnichannel_param
  • String
  • orderState:X_SHOP_HANDLED,orderType:STORE_DELIVER,acceptExpirationTime:2016-09-05 23:41:59,targetCode:34510274,allocationCode:339001,subOrderCode:194497830335000,targetType:STORE;
  • 全渠道订单相关字段
  • └ step_trade_status
  • String
  • FRONT_NOPAID_FINAL_NOPAID
  • 分阶段付款的订单状态(例如万人团订单等),目前有三返回状态FRONT_NOPAID_FINAL_NOPAID(定金未付尾款未付),FRONT_PAID_FINAL_NOPAID(定金已付尾款未付),FRONT_PAID_FINAL_PAID(定金和尾款都付)
  • └ step_paid_fee
  • String
  • 525.70
  • 分阶段付款的已付金额(万人团订单已付金额)
  • └ send_time
  • String
  • 2000-01-01
  • 订单将在此时间前发出,主要用于预售订单
  • └ type
  • String
  • fixed(一口价)
  • 交易类型列表,同时查询多种交易类型可用逗号分隔。默认同时查询guarantee_trade, auto_delivery, ec, cod的4种交易类型的数据 可选值 fixed(一口价) auction(拍卖) guarantee_trade(一口价、拍卖) auto_delivery(自动发货) independent_simple_trade(旺店入门版交易) independent_shop_trade(旺店标准版交易) ec(直冲) cod(货到付款) fenxiao(分销) game_equipment(游戏装备) shopex_trade(ShopEX交易) netcn_trade(万网交易) external_trade(统一外部交易)o2o_offlinetrade(O2O交易)step (万人团)nopaid(无付款订单)pre_auth_type(预授权0元购机交易)
  • └ status
  • String
  • TRADE_NO_CREATE_PAY
  • 交易状态。可选值: * TRADE_NO_CREATE_PAY(没有创建支付宝交易) * WAIT_BUYER_PAY(等待买家付款) * SELLER_CONSIGNED_PART(卖家部分发货) * WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) * WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) * TRADE_BUYER_SIGNED(买家已签收,货到付款专用) * TRADE_FINISHED(交易成功) * TRADE_CLOSED(付款以后用户退款成功,交易自动关闭) * TRADE_CLOSED_BY_TAOBAO(付款以前,卖家或买家主动关闭交易) * PAY_PENDING(国际信用卡支付付款确认中) * WAIT_PRE_AUTH_CONFIRM(0元购合约中) * PAID_FORBID_CONSIGN(拼团中订单或者发货强管控的订单,已付款但禁止发货)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradeFullinfoGetVoRequest req = new TradeFullinfoGetVoRequest();
req.setFields("tid,type,status,payment,orders,promotion_details");
req.setTid(123456789L);
TradeFullinfoGetVoResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<trade_fullinfo_get_vo_response>
    <trade>
        <tid>2231958349</tid>
        <payment>200.07</payment>
        <discount_fee>200.07</discount_fee>
        <adjust_fee>200.07</adjust_fee>
        <post_fee>200.07</post_fee>
        <total_fee>200.07</total_fee>
        <pay_time>2000-01-01 00:00:00</pay_time>
        <buyer_message>要送的礼物的,不要忘记的哦</buyer_message>
        <shipping_type>free</shipping_type>
        <point_fee>0</point_fee>
        <promotion>hello world</promotion>
        <orders>
            <order>
                <title>山寨版测试机器</title>
                <price>200.07</price>
                <num_iid>2342344</num_iid>
                <outer_iid>152e442aefe88dd41cb0879232c0dcb0</outer_iid>
                <outer_sku_id>81893848</outer_sku_id>
                <oid>2231958349</oid>
                <discount_fee>200.07</discount_fee>
                <adjust_fee>1.01</adjust_fee>
                <num>1</num>
                <store_code>南京QDHEWL-0004</store_code>
                <sub_order_tax_fee>0</sub_order_tax_fee>
                <refund_status>SUCCESS(退款成功)</refund_status>
                <combine_item_info>
                    <combine_sub_item_d_o>
                        <item_id>123123</item_id>
                        <sku_id>22331764490705</sku_id>
                        <quantity>1</quantity>
                        <item_name>商品名称</item_name>
                        <outer_iid>152e442aefe88dd41cb0879232c0dcb0</outer_iid>
                        <sku_title>16g</sku_title>
                        <origin_fee>123</origin_fee>
                        <combine_sub_item_fee>123</combine_sub_item_fee>
                        <ismain>true</ismain>
                        <estcon_time>7 / 2023-02-15</estcon_time>
                        <outer_sku_id>123</outer_sku_id>
                    </combine_sub_item_d_o>
                </combine_item_info>
                <has_combine_item>true</has_combine_item>
            </order>
        </orders>
        <promotion_details>
            <promotion_detail>
                <id>22331764490705</id>
                <promotion_name>满就减钱</promotion_name>
                <discount_fee>10.00</discount_fee>
                <gift_item_name>晨光签字笔</gift_item_name>
                <gift_item_id>13233791195</gift_item_id>
                <gift_item_num>1</gift_item_num>
                <promotion_desc>双11促销,满就送</promotion_desc>
                <promotion_id>mjs</promotion_id>
            </promotion_detail>
        </promotion_details>
        <order_tax_fee>0</order_tax_fee>
        <cross_bonded_declare>true</cross_bonded_declare>
        <trade_attr>{\&quot;payCurrency\&quot;:\&quot;HKD\&quot;}</trade_attr>
        <omnichannel_param>orderState:X_SHOP_HANDLED,orderType:STORE_DELIVER,acceptExpirationTime:2016-09-05 23:41:59,targetCode:34510274,allocationCode:339001,subOrderCode:194497830335000,targetType:STORE;</omnichannel_param>
        <step_trade_status>FRONT_NOPAID_FINAL_NOPAID</step_trade_status>
        <step_paid_fee>525.70</step_paid_fee>
        <send_time>2000-01-01</send_time>
        <type>fixed(一口价)</type>
        <status>TRADE_NO_CREATE_PAY</status>
    </trade>
</trade_fullinfo_get_vo_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>

错误码解释

错误码 错误描述 解决方案
isv.invalid-permission 必须是此交易的买家或卖家才能获取交易详细信息 保证传入的订单ID和卖家SessionKey信息是一致的
isv.trade-not-exist 交易不存在 订单已进入历史库,不再提供实时查询,出现此错误请清除本地数据库该订单,不要重试
isv.invalid-parameter:tid 订单ID不存在,或者使用了子订单ID来查询 请填写正确的订单ID,或使用主订单ID来查询
isv.trade-service-access-frequency 交易慢查询访问太频繁 缩短查询订单的时间范围,减少超时查询的次数,或者等待一段时间后再来查询
isp.trade-service-degrade 单位时间内慢查询过多,服务被降级 请稍后重试。
isp.commission-service-unavailable 佣金服务不可用 重试
isp.trade-service-unavailable 交易服务不可用 适当重试
isp.trade-service-failed 服务不可用 重试
isp.call-limited 交易服务限流 请稍后重试
isp.remote-connection-error 交易服务连接依赖的远程服务错误 请稍后重试
isp.remote-service-timeout 交易服务处理超时 请稍后重试
isv.invalid-parameter 请求参数有误 请传入正确的参数
isv.astrolabe-trade-closured 门店发货拦截订单 重试
isp.contextPrepareError 交易服务不可用 重试
isv.trade-hold 订单已经被星盘拦截 对接星盘发货系统
isp.processError ??? ???
isp.filterError ??? ???
isp.syncLockError ??? ???
isp.processCatchError ??? ???

API工具

如何获得此API

FAQ

返回
顶部