全部
淘宝客
在线测试

获取单笔交易的详细信息


接口地址: http://api.vv-tool.com/tool/erps/acxgetxq


接口介绍: 获取单笔交易的详细信息 点击查看详情


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 扣账户余额


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数 类型 必选 描述
shop_id String 店铺 ID
tid Number 交易编号
include_oaid string appkey 未对接 oaid 加密,则忽略该字段。对接 oaid 加密情况下,(收货人 + 手机号 + 座机 + 收货地址 +create)5 个字段组合成 oaid,原始订单上座机为空也满足条件。传 true,代表必须返回 oaid,生成不了就报 isv.oaid-field-miss 错误;默认或者传 false,满足生成条件则返回 oaid,否则为空
fields string 需要返回的字段列表,多个字段用半角逗号分隔,可选值为返回示例中能看到的所有字段。可填参数:seller_nick, buyer_nick, title, type, created, tid, seller_rate,buyer_flag, buyer_rate, status, payment, adjust_fee, post_fee, total_fee, pay_time, end_time, modified, consign_time, buyer_obtain_point_fee, point_fee, real_point_fee, received_payment, commission_fee, buyer_memo, seller_memo, alipay_no,alipay_id,buyer_message, pic_path, num_iid, num, price, buyer_alipay_no, receiver_name, receiver_state, receiver_city, receiver_district, receiver_address, receiver_zip, receiver_mobile, receiver_phone,seller_flag, seller_alipay_no, seller_mobile, seller_phone, seller_name, seller_email, available_confirm_fee, has_post_fee, timeout_action_time, snapshot_url, cod_fee, cod_status, shipping_type, trade_memo, is_3D,buyer_email,buyer_area, trade_from,is_lgtype,is_force_wlb,is_brand_sale,buyer_cod_fee,discount_fee,seller_cod_fee,express_agency_fee,invoice_name,service_orders,credit_cardfee,orders,trade_ext
phone_id string 手机号 id
vvtype int 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2,标准版 3,需要标准版的传 3

请求示例

fields:tid,type,status,payment,orders,promotion_details,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,receiver_country,receiver_town
tid:123456789
shop_id:123

请求代码示例

cURL请求代码示例

curl --location --request POST "http://api.vv-tool.com/tool/erps/acxgetxq" \
--header "Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx" \
--header "Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D" \
--form "fields="tid,type,status,payment,orders,promotion_details,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,receiver_country,receiver_town"" \
--form "tid="1692089714634374451"" \
--form "shop_id="123""
PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://api.vv-tool.com/tool/erps/acxgetxq",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => array("fields" => "tid,type,status,payment,orders,promotion_details,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,receiver_country,receiver_town","tid" => "1692089714634374451","shop_id" => "123"),
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx",
    "Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;


JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("fields","tid,type,status,payment,orders,promotion_details,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,receiver_country,receiver_town")
  .addFormDataPart("tid","1692089714634374451")
  .addFormDataPart("shop_id","123")
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/acxgetxq")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Cookie", "__yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

名称 类型 示例值 描述
trade Trade 交易主订单信息
seller_nick String 卖家昵称 我在测试
pic_path String 商品图片绝对途径 http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg
payment String 实付金额。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分 200.07
seller_rate Boolean 卖家是否已评价。可选值:true(已评价),false(未评价) true
post_fee String 邮费。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分 200.07
receiver_name String 收货人的姓名 东方不败
receiver_state String 收货人的所在省份 浙江省
receiver_address String 收货人的详细地址 淘宝城 911 号
receiver_zip String 收货人的邮编 223700
receiver_mobile String 收货人的手机号码 13512501826
receiver_phone String 收货人的电话号码 13819175372
consign_time Date 卖家发货时间。格式:yyyy-MM-dd HH:mm:ss 2000-01-01 00:00:00
received_payment String 卖家实际收到的支付宝打款金额(由于子订单可以部分确认收货,这个金额会随着子订单的确认收货而不断增加,交易成功后等于买家实付款减去退款金额)。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分 200.07
promotion_details PromotionDetail[] 优惠详情
id Number 交易的主订单或子订单号 22331764490705
promotion_name String 优惠信息的名称 满就减钱
discount_fee Price 优惠金额(免运费、限时打折时为空),单位:元 10.00
gift_item_name String 满就送商品时,所送商品的名称 晨光签字笔
gift_item_id String 赠品的宝贝 id 13233791195
gift_item_num String 满就送礼物的礼物数量 1
promotion_desc String 优惠活动的描述 双 11 促销,满就送
promotion_id String 优惠 id,(由营销工具 id、优惠活动 id 和优惠详情 id 组成,结构为:营销工具 id-优惠活动 id_优惠详情 id,如 mjs-123024_211143) mjs
est_con_time String 商家的预计发货时间 付款后 30 天内
receiver_country String 收货人国籍 中国
receiver_town String 收货人街道地址 三墎镇
order_tax_fee String 天猫国际官网直供主订单关税税费 0
paid_coupon_fee String 满返红包的金额;如果没有满返红包,则值为 0.00 10.00
shop_pick String 门店自提,总店发货,分店取货的门店自提订单标识 1
tid_str String 同 tid demo
biz_code String 为 tmall.daogoubao.cloudstore 时表示云店链路 tmall.daogoubao.cloudstore
cloud_store String 值为 1,且 bizCode 不为 tmall.daogoubao.cloudstore 时,为旗舰店订单 1
new_presell Boolean 预售单为 true,否则 false (云店订单专用) true
you_xiang Boolean 优享购为 true,否则 false(云店订单专用) true
pay_channel String 默认为 0,0 表示用户主动支付 1 表示系统代扣 2 表示保险赔付 0
tid Number 交易编号 (父订单的交易编号) 2231958349
num Number 商品购买数量。取值范围:大于零的整数,对于一个 trade 对应多个 order 的时候(一笔主订单,对应多笔子订单),num=0,num 是一个跟商品关联的属性,一笔订单对应多比子订单的时候,主订单上的 num 无意义。 1
num_iid Number 商品数字编号 3424234
status String 交易状态。可选值: * 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(拼团中订单或者发货强管控的订单,已付款但禁止发货) TRADE_NO_CREATE_PAY
title String 交易标题,以店铺名作为此标题的值。注:taobao.trades.get 接口返回的 Trade 中的 title 是商品名称 麦包包
type String 交易类型列表,同时查询多种交易类型可用逗号分隔。默认同时查询 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 元购机交易) fixed(一口价)
price String 商品价格。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分 200.07
discount_fee String 可以使用 trade.promotion_details 查询系统优惠系统优惠金额(如打折,VIP,满就送等),精确到 2 位小数,单位:元。如:200.07,表示:200 元 7 分 200.07
has_post_fee Boolean 是否包含邮费。与 available_confirm_fee 同时使用。可选值:true(包含),false(不包含) true
total_fee String 商品金额(商品价格乘以数量的总金额)。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分 200.07
created Date 交易创建时间。格式:yyyy-MM-dd HH:mm:ss 2000-01-01 00:00:00
pay_time Date 付款时间。格式:yyyy-MM-dd HH:mm:ss。订单的付款时间即为物流订单的创建时间。 2000-01-01 00:00:00
modified Date 交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss 2000-01-01 00:00:00
end_time Date 交易结束时间。交易成功时间(更新交易状态为成功的同时更新)/确认收货时间或者交易关闭时间 。格式:yyyy-MM-dd HH:mm:ss 2000-01-01 00:00:00
buyer_message String 买家留言 要送的礼物的,不要忘记的哦
buyer_memo String 买家备注(与淘宝网上订单的买家备注对应,只有买家才能查看该字段) 上衣要大一号
buyer_flag Number 买家备注旗帜(与淘宝网上订单的买家备注旗帜对应,只有买家才能查看该字段)红、黄、绿、蓝、紫 分别对应 1、2、3、4、5 1
seller_memo String 卖家备注(与淘宝网上订单的卖家备注对应,只有卖家才能查看该字段) 好的
seller_flag Number 卖家备注旗帜(与淘宝网上订单的卖家备注旗帜对应,只有卖家才能查看该字段)红、黄、绿、蓝、紫 分别对应 1、2、3、4、5 1
buyer_nick String 买家昵称 我在测试
trade_attr JSON top 动态字段 {}
has_yfx Boolean 订单中是否包含运费险订单,如果包含运费险订单返回 true,不包含运费险订单,返回 false true
yfx_fee String 订单的运费险,单位为元 0.50
credit_card_fee String 使用信用卡支付金额数 30.5
step_trade_status String 分阶段付款的订单状态(例如万人团订单等),目前有三返回状态 FRONT_NOPAID_FINAL_NOPAID(定金未付尾款未付),FRONT_PAID_FINAL_NOPAID(定金已付尾款未付),FRONT_PAID_FINAL_PAID(定金和尾款都付) FRONT_NOPAID_FINAL_NOPAID
step_paid_fee String 分阶段付款的已付金额(万人团订单已付金额) 525.70
mark_desc String 订单出现异常问题的时候,给予用户的描述,没有异常的时候,此值为空 该订单需要延长收货时间
shipping_type String 创建交易时的物流方式(交易完成前,物流方式有可能改变,但系统里的这个字段一直不变)。可选值:free(卖家包邮),post(平邮),express(快递),ems(EMS),virtual(虚拟发货),25(次日必达),26(预约配送)。 free
buyer_cod_fee String 买家货到付款服务费。精确到 2 位小数;单位:元。如:12.07,表示:12 元 7 分 12.07
adjust_fee String 卖家手工调整金额,精确到 2 位小数,单位:元。如:200.07,表示:200 元 7 分。来源于订单价格修改,如果有多笔子订单的时候,这个为 0,单笔的话则跟[order].adjust_fee 一样 200.07
trade_from String 交易内部来源。WAP(手机);HITAO(嗨淘);TOP(TOP 平台);TAOBAO(普通淘宝);JHS(聚划算)一笔订单可能同时有以上多个标记,则以逗号分隔 WAP,JHS
service_orders ServiceOrder[] 服务子订单列表
oid Number 虚拟服务子订单订单号 110770592823138
item_oid Number 服务所属的交易订单号。如果服务为一年包换,则 item_oid 这笔订单享受改服务的保护 110770592803138
service_id Number 服务数字 id 2342344
service_detail_url String 服务详情的 URL 地址 http://wt.taobao.com/plan.htm?plan_id=planId
num Number 购买数量,取值范围为大于 0 的整数 1
price String 服务价格,精确到小数点后两位:单位:元 39.09
payment String 子订单实付金额。精确到 2 位小数,单位:元。如:200.07,表示:200 元 7 分。 29.98
title String 商品名称 滚筒洗衣机
total_fee String 服务子订单总费用 39.09
buyer_nick String 卖家昵称 小倩 2005
refund_id String 最近退款的 id 2231958349
seller_nick String 卖家昵称 麦包包
pic_path String 服务图片地址 http://img08.taobao.com/bao/upload/i8/T1jVXXXePb_a0908.jpg
tmser_spu_code String 支持家装类物流的类型 家装干支装服务
oid_str String 虚拟服务子订单订单号(String 类型) 110770592823138
apple_care_email String appleCareEmail
apple_care_mpn String appleCareMPN
ext_service_biz_id String 服务订单与实物订单关联关系 23423_324234,2324_342342
service_order_type String 服务供应链-服务订单类型,1:主子挂载;2:双主挂载;3:单独售卖 1
service_outer_id String 服务供应链-服务商外部编码标 suni_outid_23432
buyer_rate Boolean 买家是否已评价。可选值:true(已评价),false(未评价)。如买家只评价未打分,此字段仍返回 false true
receiver_city String 收货人的所在城市 杭州市
注:因为国家对于城市和地区的划分的有:省直辖市和省直辖县级行政区(区级别的)划分的,淘宝这边根据这个差异保存在不同字段里面比如:广东广州:广州属于一个直辖市是放在的 receiver_city 的字段里面;而河南济源:济源属于省直辖县级行政区划分,是区级别的,放在了 receiver_district 里面
建议:程序依赖于城市字段做物流等判断的操作,最好加一个判断逻辑:如果返回值里面只有 receiver_district 参数,该参数作为城市
receiver_district String 收货人的所在地区 西湖区
注:因为国家对于城市和地区的划分的有:省直辖市和省直辖县级行政区(区级别的)划分的,淘宝这边根据这个差异保存在不同字段里面比如:广东广州:广州属于一个直辖市是放在的 receiver_city 的字段里面;而河南济源:济源属于省直辖县级行政区划分,是区级别的,放在了 receiver_district 里面
建议:程序依赖于城市字段做物流等判断的操作,最好加一个判断逻辑:如果返回值里面只有 receiver_district 参数,该参数作为城市
service_tags LogisticsTag[] 物流标签
order_id String 主订单或子订单的订单号 123456
logistic_service_tag_list LogisticServiceTag[] 服务标签
service_tag String 物流服务下的标签属性,多个标签之间有";"分隔 comFee=1211;comTim=1;companyCode=SF;
service_type String 消费者选快递请直接判断 service_tag 是否包含 companyCode。而不要判断 service_type FAST
o2o String 导购宝 =crm crm
o2o_guide_id String 导购员 id 123456
o2o_shop_id String 导购员门店 id 123456
o2o_guide_name String 导购员名称 西湖门店导购员 1
o2o_shop_name String 导购门店名称 西湖门店
o2o_delivery String 导购宝提货方式,inshop:店内提货,online:线上发货 inshop
orders Order[] 订单列表
item_meal_name String 套餐的值。如:M8 原装电池:便携支架:M8 专用座充:莫凡保护袋 M8 原装电池:便携支架:M8 专用座充:莫凡保护袋
pic_path String 商品图片的绝对路径 http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg
seller_nick String 卖家昵称 麦包包
buyer_nick String 买家昵称 碎银子
refund_status String 退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功) SUCCESS(退款成功)
outer_iid String 商家外部编码(可与商家外部系统对接)。外部商家自己定义的商品 Item 的 id,可以通过 taobao.items.custom.get 获取商品的 Item 的信息 152e442aefe88dd41cb0879232c0dcb0
snapshot_url String 订单快照 URL T1mURbXopZXXXe3rLI.1257513712679_snap
snapshot String 订单快照详细信息 自定义值
timeout_action_time Date 订单超时到期时间。格式:yyyy-MM-dd HH:mm:ss 2000-01-01 00:00:00
buyer_rate Boolean 买家是否已评价。可选值:true(已评价),false(未评价) true
seller_rate Boolean 卖家是否已评价。可选值:true(已评价),false(未评价) true
seller_type String 卖家类型,可选值为:B(商城商家),C(普通卖家) B(商城商家)
cid Number 交易商品对应的类目 ID 123456
sub_order_tax_fee String 天猫国际官网直供子订单关税税费 0
sub_order_tax_rate String 天猫国际官网直供子订单关税税率 0
estimate_con_time String 子订单预计发货时间 demo
o2o_guide_id String 导购员 ID 12345
o2o_guide_name String 导购员名称 abc
o2o_shop_id String 门店 Id 12345
o2o_shop_name String 门店名称 abc
biz_code String 为 tmall.daogoubao.cloudstore 时表示云店链路 tmall.daogoubao.cloudstore
cloud_store String 为 1,且 bizCode 不为 tmall.daogoubao.cloudstore 时,为旗舰店订单 1
hj_settle_no_commission String 云店是否扣拥 1
order_taking String 云店接单标记 接单标记
cloud_store_token String 云店改价用 token 11111
cloud_store_bind_pos String 云店 pos 单号 12345
os_activity_id String 前 N 有礼活动 id 2734957495
os_fg_item_id String 前 N 有礼赠品 id 58901376862
os_gift_count String 前 N 有礼赠品数量 1
os_sort_num String 前 N 有礼中奖名次,获得奖品的订单才会有该字段 10
oid Number 子订单编号 2231958349
status String 订单状态(请关注此状态,如果为 TRADE_CLOSED_BY_TAOBAO 状态,则不要对此订单进行发货,切记啊!)。可选值: TRADE_NO_CREATE_PAY
TRADE_NO_CREATE_PAY(没有创建支付宝交易)
WAIT_BUYER_PAY(等待买家付款)
WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款)
WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货)
TRADE_BUYER_SIGNED(买家已签收,货到付款专用)
TRADE_FINISHED(交易成功)
TRADE_CLOSED(付款以后用户退款成功,交易自动关闭)
TRADE_CLOSED_BY_TAOBAO(付款以前,卖家或买家主动关闭交易)
PAY_PENDING(国际信用卡支付付款确认中)
title String 商品标题 山寨版测试机器
item_oid Number 服务所属的交易订单号。如果服务为一年包换,则 item_oid 这笔订单享受改服务的保护 110770592803138
type String 交易类型 直冲
iid String 商品的字符串编号(注意:iid 近期即将废弃,请用 num_iid 参数) 152e442aefe88dd41cb0879232c0dcb0
price String 商品价格。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分 200.07
num_iid Number 商品数字 ID 2342344
service_id Number 服务数字 id 2342344
item_meal_id Number 套餐 ID 2564854632
sku_id String 商品的最小库存单位 Sku 的 id.可以通过 taobao.item.sku.get 获取详细的 Sku 信息 5937146
num Number 购买数量。取值范围:大于零的整数 1
outer_sku_id String 外部网店自己定义的 Sku 编号 81893848
order_from String 子订单来源,如 jhs(聚划算)、taobao(淘宝)、wap(无线) jhs
total_fee String 应付金额(商品价格 * 商品数量 + 手工调整金额 - 子订单级订单优惠金额)。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分 200.07
service_detail_url String 服务详情的 URL 地址 http://wt.taobao.com/plan.htm?plan_id=planId
payment String 子订单实付金额。精确到 2 位小数,单位:元。如:200.07,表示:200 元 7 分。对于多子订单的交易,计算公式如下:payment = price * num + adjust_fee - discount_fee ;单子订单交易,payment 与主订单的 payment 一致,对于退款成功的子订单,由于主订单的优惠分摊金额,会造成该字段可能不为 0.00 元。建议使用退款前的实付金额减去退款单中的实际退款金额计算。 200.07
discount_fee String 子订单级订单优惠金额。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分 200.07
adjust_fee String 手工调整金额。格式为:1.01;单位:元;精确到小数点后两位。 1.01
modified Date 订单修改时间,目前只有 taobao.trade.ordersku.update 会返回此字段。 2000-01-01 00:00:00
sku_properties_name String SKU 的值。如:机身颜色:黑色;手机套餐:官方标配 颜色:桔色;尺码:M
refund_id String 最近退款 ID 2231958349
is_oversold Boolean 是否超卖 true
is_service_order Boolean 是否是服务订单,是返回 true,否返回 false。 true
end_time Date 子订单的交易结束时间说明:子订单有单独的结束时间,与主订单的结束时间可能有所不同,在有退款发起的时候或者是主订单分阶段付款的时候,子订单的结束时间会早于主订单的结束时间,所以开放这个字段便于订单结束状态的判断 2012-04-07 00:00:00
consign_time String 子订单发货时间,当卖家对订单进行了多次发货,子订单的发货时间和主订单的发货时间可能不一样了,那么就需要以子订单的时间为准。(没有进行多次发货的订单,主订单的发货时间和子订单的发货时间都一样) 2013-01-13 15:23:00
order_attr JSON 子订单扩展属性: is_free_down_payment:是否免首付:true:是,false:否,可选字段 car_back_payment:返还免首付金额,单位:分, car_ref_activity_id:服务商传入活动 ID,依赖外部服务商传入; {"isFreeDownPayment":"true","backPayment":"3000.00","refActivityId":"312321312"}
shipping_type String 子订单的运送方式(卖家对订单进行多次发货之后,一个主订单下的子订单的运送方式可能不同,用 order.shipping_type 来区分子订单的运送方式) post
bind_oid Number 捆绑的子订单号,表示该子订单要和捆绑的子订单一起发货,用于卖家子订单捆绑发货 23194074143138
logistics_company String 子订单发货的快递公司名称 顺风快递
invoice_no String 子订单所在包裹的运单号 05432465
is_daixiao Boolean 表示订单交易是否含有对应的代销采购单。如果该订单中存在一个对应的代销采购单,那么该值为 true;反之,该值为 false。 true
divide_order_fee String 分摊之后的实付金额 21.00
part_mjz_discount String 优惠分摊 21.00
ticket_outer_id String 对应门票有效期的外部 id 123456abcd
ticket_expdate_key String 门票有效期的 key 100FFFFFF02374020000002001020304000A
store_code String 发货的仓库编码 南京 QDHEWL-0004
is_www Boolean 子订单是否是 www 订单 true
tmser_spu_code String 支持家装类物流的类型 家装干支装服务
bind_oids String bind_oid 字段的升级,支持返回绑定的多个子订单,多个子订单以半角逗号分隔 193741211090019,193741211080019
zhengji_status String 征集预售订单征集状态:1(征集中),2(征集成功),3(征集失败) 1
md_qualification String 免单资格属性 true_免单原因
md_fee String 免单金额 999
customization String 定制信息 {"itemId":"2100753308662","pic":[{"id":1,"url":"//img.alicdn.com/imgextra/i1/664681545/TB2tYURjpXXXXadXpXXXXXXXXXX_!!664681545.jpg"}],"skuId":"0","text":[{"content":"oreo","id":1}]}
inv_type String 库存类型:6 为在途 6
xxx String xxx xxx
is_sh_ship Boolean 是否发货 true
shipper String 仓储信息 cn
f_type String 订单履行类型,如喵鲜生极速达(jsd) jsd
f_status String 订单履行状态,如喵鲜生极速达:分单完成 分单完成
f_term String 单履行内容,如喵鲜生极速达:storeId,phone storeId
o2o_et_order_id String
combo_id String 天猫搭配宝 1923423423
assembly_rela String 主商品订单 id 100293929394324
assembly_price String 价格 30000
assembly_item String assemblyItem 1234,234234
sub_order_tax_promotion_fee String 天猫国际子订单计税优惠金额 0
cl_down_payment String clDownPayment 1000
cl_down_payment_ratio String clDownPaymentRatio 1000
cl_month_payment String clMonthPayment 1000
cl_tail_payment String clTailPayment 1000
cl_installment_num String clInstallmentNum 1000
cal_penalty String calPenalty 1000
cl_service_fee String clServiceFee 1000
cl_car_taker String clCarTaker 1000
cl_car_taker_phone String clCarTakerPhone 1000
cl_car_taker_i_d_num String clCarTakerIDNum 1000
cl_car_taker_id_num String clCarTakerIDNum 1000
down_payment String downPayment 1000
down_payment_ratio String downPaymentRatio 1000
month_payment String monthPayment 1000
tail_payment String tailPayment 1000
installment_num String installmentNum 12
penalty String penalty 1000
service_fee String serviceFee 1000
car_taker String carTaker 张三
car_taker_phone String carTakerPhone 12345678901
car_taker_id_num String carTakerIDNum 123
car_store_code String carStoreCode 123
car_store_name String carStoreName 汽车门店
out_unique_id String outUniqueId 123
ws_bank_apply_no String wsBankApplyNo 123
car_taker_id String carTakerID 123
oid_str String oidStr 123
fqg_num Number 花呗分期期数 12
is_fqg_s_fee Boolean 是否商家承担手续费 true
tax_free Boolean 天猫国际订单是否包税 true
tax_coupon_discount String 天猫国际订单包税金额 0
recharge_fee String 个人充值红包金额 1000
platform_subsidy_fee String platformSubsidyFee 100.00
nr_reduce_inv_fail String nrReduceInvFail 1
nr_outer_iid String 新零售商家端商品唯一编号 2983778187
bind_oids_all_status String bind_oids 字段的升级,在交易成功和交易关闭状态下也能获取到,支持返回绑定的多个子订单,多个子订单以半角逗号分隔 193741211090019,193741211080019
sort_info JSON sortInfo
retail_store_id String 天猫无人店线下店 ID
out_item_id String 天猫未来店外部 ERP 商品 ID
rt_omni_outer_sc_id String 新零售全渠道订单:商家自有货品编码
rt_omni_sc_id String 新零售全渠道订单:后端货品 ID
modify_address String 有值表示买家修改了地址;1 表示付款后改地址;2 表示付款前改地址 1
ti_modify_address_time String 买家修改地址时间 2019-02-18 11:32:53
credit_buy String 有值表示信用购订单;1 表示信用购一期;2 表示信用购二期;3 表示信用购三期 3
s_tariff_fee String
timing_promise String 时效服务身份,如 tmallPromise 代表天猫时效承诺 tmallPromise
promise_service String 时效服务字段,服务字段,会有多个服务值,以英文半角逗号","切割 tmallpromise.arrival.timing,tmallpromise.xx.timing
es_date String 预计送达时间 格式 yyyy-MM-dd
es_range String 预计配送时间段 格式 hh:mm-hh:mm
os_date String 预约配送,用户预约时间 格式 yyyy-MM-dd
os_range String 预约配送,用户预约时间段 格式 hh:mm-hh:mm
cutoff_minutes String 物流截单时间,分钟 660
es_time String 物流时效,相对时间,单位是天 1
delivery_time String 最晚发货时间 2019-04-12 16:00:00
collect_time String 最晚揽收时间 2019-04-12 16:00:00
dispatch_time String 最晚派送时间 2019-04-12 16:00:00
sign_time String 最晚签收时间 2019-04-12 16:00:00
promise_end_time String 信用购履约结束时间 格式 yyyy-MM-dd HH:mm
omni_jxs_outerid String 经销商货品商家编码 123
propoint String 使用淘金币的数量,以分为单位,和订单标 propoint 中间那一段一样 10
is_kaola Boolean 是否是考拉商品订单 true
brand_light_shop_source String 同城购订单 source source1
brand_light_shop_store_id String 同城购门店 id 123456
special_refund_type String 特殊的退款类型,比如直播返现、价保
extend_info String 透出的额外信息
is_devalue_fee Boolean 子订单优惠贬值 true
service_order_type String 服务供应链-服务订单类型,1:主子挂载;2:双主挂载;3:单独售卖 1
service_outer_id String 服务供应链-服务商外部编码 sunin_outid_324324324
expand_card_expand_price_used_suborder String 购物金核销子订单权益金分摊金额(单位为分) 1000
expand_card_basic_price_used_suborder String 购物金核销子订单本金分摊金额(单位为分) 1000
seller_display_nick String 卖家展示昵称 xx 旗舰店
buyer_display_nick String 买家展示昵称 xx 买家
lijian String 预售订单立减金额 10.01
trade_ext TradeExt 交易扩展表信息
before_enable_flag Number enable 前扩展标识位 1
before_close_flag Number 关闭订单前扩展标识位 1
before_pay_flag Number 付款前扩展标识位 1
before_ship_flag Number 发货前扩展标识位 1
before_confirm_flag Number 确认收货前扩展标识位 1
before_rate_flag Number 评价前扩展标识位 1
before_refund_flag Number 退款前扩展标识位 1
before_modify_flag Number 修改前扩展标识位 1
third_party_status Number 第三方状态,第三方自由定义 1
extra_data String 第三方个性化数据 abc
ext_attributes String attributes 标记 abc
eticket_service_addr String 天猫电子凭证家装 地址信息
rx_audit_status String 处方药未审核状态 0
es_range String 时间段 18:00-20:00
es_date String 时间 yyyyMMdd
os_date String 时间 yyyyMMdd
os_range String 时间段 18:00-20:00
coupon_fee Number 订单中使用红包付款的金额 100.00
o2o_et_order_id String 分阶段交易的特权定金订单 ID 193753681999224
post_gate_declare Boolean 邮关订单 true
cross_bonded_declare Boolean 跨境订单 false
omnichannel_param String 全渠道商品通相关字段 { "orderType":"STORE_DELIVER", //门店发货 "allocationCode":70001, //平台分单号 "orders":[ //分单明细 { "orderCode":2139971, "storeDeliverTargetType":"STORE", "storeDeliverTargetCode":"1313", "status":"X_ALLOCATION_NOTIFY" }, { "orderCode":2139972, "storeDeliverTargetType":"WAREHOUSE", "storeDeliverTargetCode":"E1313", "status":"X_ALLOCATION_NOTIFY" } ] }
assembly String 组合商品 1
top_hold Number TOP 拦截标识,0 不拦截,1 拦截 0
omni_attr String 星盘标识字段 {}
omni_param String 星盘业务字段 {}
forbid_consign Number 聚划算一起买字段 1
identity String 采购订单标识 EPP
team_buy_hold Number 天猫拼团拦截标示 1
share_group_hold Number shareGroupHold 1
ofp_hold Number 天猫国际拦截 1
o2o_step_trade_detail String 组装 O2O 多阶段尾款订单的明细数据 总阶段数,当前阶数,阶段金额(单位:分),支付状态,例如 3_1_100_paid ; 3_2_2000_nopaid 3_1_100_paid
o2o_step_order_id String 特权定金订单的尾款订单 ID 2505550397798727
o2o_voucher_price String 分阶段订单的特权定金抵扣金额,单位:分 1000
order_tax_promotion_fee String 天猫国际计税优惠金额 0
delay_create_delivery Number 聚划算火拼标记 1
toptype Number top 定义订单类型 1
service_type String serviceType timedd,jiaju
o2o_service_mobile String o2oServiceMobile 17802118895
o2o_service_name String o2oServiceName 衍一
o2o_service_state String o2oServiceState 浙江省
o2o_service_city String o2oServiceCity 杭州市
o2o_service_district String o2oServiceDistrict 余杭区
o2o_service_town String o2oServiceTown 五常街道
o2o_service_address String o2oServiceAddress 杭州市余杭区文一西路 969 号
o2o_step_trade_detail_new String o2oStepTradeDetailNew bizType:分阶段付款交易,orderPayChannel:支付宝在线支付,subOrderPayTime:step 0: payTime Sun Jul 30 17:08:50 CST 2017 step 1: payTime Sat Aug 05 04:07:14 CST 2017 ,totalStep:2,currStep:2,fee:60300,payStatus:paid
o2o_xiaopiao String o2oXiaopiao 123
o2o_contract String o2oContract 3213
retail_store_code String 新零售门店编码 BaiAnJu
retail_out_order_id String 新零售线下订单 id 2231958349
recharge_fee String rechargeFee 100
platform_subsidy_fee String platformSubsidyFee 100.00
nr_offline String nrOffline 1
wtt_param String 网厅订单垂直表信息 JSON 格式
logistics_infos LogisticsInfo[] logisticsInfos
trade_id Number 交易号 1100070860172581613
sub_trade_id Number 子交易号 1100070860173581613
item_id String 货品仓储 ID 2323232
item_code String 货品仓储 code 323232
need_consign_num Number 应发数量 5
store_code String 如是菜鸟仓,则将菜鸟仓的区域仓 code 进行填充,如是商家仓发货则填充商家仓 code 2223
type String 子订单类型:标示该子交易单来源交易,还是 BMS 增加的,枚举值(00= 交易,10=BMS 绑定) 00
num_iid Number 商品数字编号 12222
consign_type String 发货类型 CN= 菜鸟发货,SC 的商家仓发货 cn
sku_id String 商品的最小库存单位 Sku 的 id 213
item_ratio Number 商品比例 1
combine_item_code String 组合商品编码 code 1021-0
combine_item_id String 组合商品 id 558578215712
nr_store_order_id String nrStoreOrderId 下发鲜生活订单号
nr_shop_id String 门店 ID
nr_shop_name String 门店名称
nr_shop_guide_id String 导购员 ID
nr_shop_guide_name String 导购员名称
sort_info JSON sortInfo
sorted Number 1 已排序 2 不排序 1
nr_no_handle String 一小时达不处理订单 1
buyer_open_uid String 买家 OpenUid AAHk5d-EAAeGwJedwSFu0XXX
is_gift Boolean isGift 暂不公开
donee_nick String doneeNick 暂不公开
donee_open_uid String doneeUid 暂不公开
suning_shop_code String suningShopCode
suning_shop_valid Number suningShopValid
retail_store_id String retailStoreId
is_istore Boolean isIstore
ua String ua
cutoff_minutes String 截单时间 660
es_time String 时效:天 4
delivery_time String 发货时间 2018-06-09 12:13:14
collect_time String 揽收时间 2018-06-09 12:13:14
dispatch_time String 派送时间 2018-06-09 12:13:14
sign_time String 签收时间 2018-06-09 12:13:14
delivery_cps String 派送 CP STO
linkedmall_ext_info String linkedmall 透传参数 {}
rt_omni_send_type String 新零售全渠道订单:订单类型,自提订单:pickUp,电商发货:tmall,门店发货(配送、骑手):storeSend pickUp
rt_omni_store_id String 新零售全渠道订单:发货门店 ID
rt_omni_outer_store_id String 新零售全渠道订单:商家自有发货门店编码
tcps_start String 同城预约配送开始时间 2018-10-10 11:00:00
tcps_code String 同城业务类型,com.tmall.dsd:定时送,storeDsd-fn-3-1:淘速达 3 公里蜂鸟配送 com.tmall.dsd
tcps_end String 同城预约配送结束时间 2018-10-10 13:00:00
m_tariff_fee String
timing_promise String 时效服务身份,如 tmallPromise 代表天猫时效承诺 tmallPromise
promise_service String 时效服务字段,服务字段,会有多个服务值,以英文半角逗号","切割 aa,bb,cc
oi_range String 苏宁预约安装,用户安装时间段 10:15-11:15
oi_date String 苏宁预约安装,用户安装时间 2014-05-26
hold_install String 苏宁预约安装,暂不安装 暂不安装
outer_partner_member_id String 外部会员 id 123456
root_cat String 叶子分类 1234567
gifting String 1-gifting 订单 1
gifting_takeout String 1-coffee gifting 订单 1
app_name String 订单来源 tmall
easy_home_city_type String 居然之家同城站订单类型 deposit:预约到店,direct:直接购买,tail:尾款核销 deposit
nr_deposit_order_id String 同城站关联订单号 关联订单号
nr_store_code String 摊位 id 123456
propoint String 使用淘金币的数量,以分为单位,和订单标 propoint 中间那一段一样,没有返回 null 10
zqs_order_tag String 1-周期送订单 1
txp_freezer_id String 天鲜配冰柜 id 1234
txp_receive_method String 天鲜配自提方式 post
brand_light_shop_store_id String 同城购门店 ID 123456
brand_light_shop_source String 同城购订单 source source1
extend_info String 透出的额外信息 {"itemTag":"100"}
lm String 收货地址有变更,返回"1" 1
ncz_ext_attr String 新康众定制数据
is_wmly String 标识完美履约订单 1
omni_package String 全渠道包裹信息 [{"city_token":"155774003320052624","pickup_code":"059006","latest_prepare_time":"2020-05-26 13:00:00","select_time":"2020-05-26 13:00-17:00","sub_order_ids":"1020810305042492171,1020810305043492171"}]
expandcard_info ExpandCardInfo 购物金信息输出 1
basic_price String 买卡订单本金 0.01
expand_price String 买卡订单权益金 0.01
basic_price_used String 用卡订单使用的本金 0.01
expand_price_used String 用卡订单使用的权益金 0.01
invoice_detail_after_refund String 苹果发票详情 "{"result":{"subOrderId":[{"type":"积分类服务费","details":[{"name":"天猫购物券","amount":100},{"name":"积分红包","amount":200},{"name":"优惠码","amount":300}]}]},"success":true,"errorCode":""}"
invoice_detail_pay String 苹果发票详情 "{"result":{"subOrderId":[{"type":"积分类服务费","details":[{"name":"天猫购物券","amount":100},{"name":"积分红包","amount":200},{"name":"优惠码","amount":300}]}]},"success":true,"errorCode":""}"
invoice_detail_mid_refund String 苹果发票详情 "{"result":{"subOrderId":[{"type":"积分类服务费","details":[{"name":"天猫购物券","amount":100},{"name":"积分红包","amount":200},{"name":"优惠码","amount":300}]}]},"success":true,"errorCode":""}"
expand_card_basic_price String 买卡订单本金 0.01
expand_card_expand_price String 买卡订单权益金 0.01
expand_card_basic_price_used String 用卡订单所用的本金 0.01
expand_card_expand_price_used String 用卡订单所用的权益金 0.01
is_openmall Boolean 是否是 Openmall 订单 false
asdp_biz_type String asdp 业务身份 logistics_upgrade
oaid String (收货人 + 手机号 + 收货地址 +create)4 字段返回值都都不能为空,否则生成不了 oaid 2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc
v_logistics_create Boolean 是否是码上收订单 false
q_r_pay Boolean 是否是非物流订单 false
order_follow_id String 关联下单订单
asdp_ads String 送货上门标 201
ob_tag String 消费者催发货标识,lg 表示消费者做过催发货 lg
aid String 地址 aid 字段 123123
general_new_presell Boolean 通用的是否预售 true
drug_register String 是否疫情登记的订单。0= 未登记,1= 已登记 1
is_sh_ship Boolean 是否屏蔽发货 true
o2o_snatch_status String 抢单状态 0,未处理待分发;1,抢单中;2,已抢单;3,已发货;-1,超时;-2,处理异常;-3,匹配失败;-4,取消抢单;-5,退款取消;-9,逻辑删除 1
market String 垂直市场 eticket
et_type String 电子凭证扫码购-扫码支付订单 type bs_common
et_shop_id Number 扫码购关联门店 66749068
obs String 1 门店预约自提订单标
phone_id2 String 1595959 VT 平台手机号 id
withholding_money int 该接口扣费金额(点券) 1

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
		    "withholding_money": 1,
        "new_presell": false,
        "orders": {
            "order": [
                {
                    "adjust_fee": "0.00",
                    "buyer_rate": false,
                    "cid": 50010895,
                    "discount_fee": "0.00",
                    "divide_order_fee": "98.00",
                    "estimate_con_time": "付款后3天内",
                    "is_daixiao": false,
                    "is_oversold": false,
                    "num": 1,
                    "num_iid": 623917802188,
                    "oid": "1692089714634374451",
                    "oid_str": "1692089714634374451",
                    "order_from": "WAP,WAP",
                    "payment": "108.00",
                    "pic_path": "https://img.alicdn.com/bao/uploaded/i3/2208657956577/O1CN01MtD9Oh1ySJXNYVQ4N_!!2208657956577.png",
                    "price": "98.00",
                    "refund_status": "NO_REFUND",
                    "seller_rate": false,
                    "seller_type": "C",
                    "snapshot_url": "t:1692089714634374451_1",
                    "status": "WAIT_SELLER_SEND_GOODS",
                    "title": "婴幼儿童宝贝随身便携小包迷你清洁宝宝消毒湿巾生活多场景使用包",
                    "total_fee": "98.00"
                }
            ]
        },
        "payment": "108.00",
        "receiver_address": "三墩镇xxxxxxxxxxxxxxxxxxx",
        "receiver_country": "",
        "receiver_mobile": "$un9BDyLXrNjZ8ki4CNcpNw==$atY/AnsLxQTX53Ds2TGBtw==$1$$",
        "receiver_name": "~2HGxiil8FDf34JYKjQXVNw==~3Xu+~1~~",
        "receiver_state": "浙江省",
        "receiver_town": "三墩镇",
        "receiver_zip": "000000",
        "status": "WAIT_SELLER_SEND_GOODS",
        "tid": "1692089714634374451",
        "tid_str": "1692089714634374451",
        "type": "fixed",
        "you_xiang": false
    }
}


响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或者联系对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权
614 必须是此交易的买家或卖家才能获取交易详细信息 保证传入的订单 ID 和卖家 SessionKey 信息是一致的
614 交易不存在 订单已进入历史库,不再提供实时查询,出现此错误请清除本地数据库该订单,不要重试
614 订单 ID 不存在,或者使用了子订单 ID 来查询 请填写正确的订单 ID,或使用主订单 ID 来查询
614 交易慢查询访问太频繁 缩短查询订单的时间范围,减少超时查询的次数,或者等待一段时间后再来查询
614 单位时间内慢查询过多,服务被降级 请稍后重试。
614 佣金服务不可用 重试
614 交易服务不可用 适当重试
614 服务不可用 重试
614 交易服务限流 请稍后重试
614 交易服务连接依赖的远程服务错误 请稍后重试
614 交易服务处理超时 请稍后重试
614 请求参数有误 请传入正确的参数
614 门店发货拦截订单 重试
614 交易服务不可用 重试
614 订单已经被星盘拦截 对接星盘发货系统