全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
查询卖家已卖出的交易数据(根据创建时间)
接口地址: http://api.vv-tool.com/tool/erps/sold
接口介绍: 获取近 30 天的卖家已卖出的交易数据(根据创建时间) 点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
fields | String | true | tid,type,status,payment,orders,rx_audit_status | 需要返回的字段列表,多个字段用半角逗号分隔,可选值为返回示例中能看到的所有字段。rx_audit_status=0,处方药未审核 |
shop_id | String | true | 123456789 | 店铺 ID |
start_created | Date | false | 2000-01-01 00:00:00 | 查询三个月内交易创建时间开始。格式:yyyy-MM-dd HH:mm:ss |
end_created | Date | false | 2000-01-01 23:59:59 | 查询交易创建时间结束。格式:yyyy-MM-dd HH:mm:ss |
status | String | false | ALL_WAIT_PAY | 交易状态(查看可选值),默认查询所有交易状态的数据,除了默认值外每次只能查询一种状态。 |
buyer_nick | String | false | zhangsan | 买家昵称 |
type | String | false | game_equipment | 交易类型列表,同时查询多种交易类型可用逗号分隔。默认同时查询 guarantee_trade,auto_delivery,ec,cod,step 这 5 种的交易类型的数据;查询所有交易类型的数据,需要设置下面全部可选值。可选值:fixed(一口价)auction(拍卖)guarantee_trade(一口价、拍卖)step(分阶段付款,万人团,阶梯团订单)independent_simple_trade(旺店入门版交易)independent_shop_trade(旺店标准版交易)auto_delivery(自动发货)ec(直冲)cod(货到付款)game_equipment(游戏装备)shopex_trade(ShopEX 交易)netcn_trade(万网交易)external_trade(统一外部交易)instant_trade (即时到账)b2c_cod(大商家货到付款)hotel_trade(酒店类型交易)super_market_trade(商超交易)super_market_cod_trade(商超货到付款交易)taohua(淘花网交易类型)waimai(外卖交易类型)o2o_offlinetrade(O2O 交易)nopaid(即时到帐/趣味猜交易类型)step (万人团) eticket(电子凭证) tmall_i18n(天猫国际);nopaid (无付款交易)insurance_plus(保险)finance(基金)注:guarantee_trade 是一个组合查询条件,并不是一种交易类型,获取批量或单个订单中不会返回此种类型的订单。pre_auth_type(预授权 0 元购) lazada(获取 lazada 订单类型) |
ext_type | String | false | service | 可选值有 ershou(二手市场的订单),service(商城服务子订单)mark(双十一大促活动异常订单)作为扩展类型筛选只能做单个 ext_type 查询,不能全部查询所有的 ext_type 类型 |
rate_status | String | false | RATE_UNBUYER | 评价状态,默认查询所有评价状态的数据,除了默认值外每次只能查询一种状态。可选值:RATE_UNBUYER(买家未评)RATE_UNSELLER(卖家未评)RATE_BUYER_UNSELLER(买家已评,卖家未评)RATE_UNBUYER_SELLER(买家未评,卖家已评)RATE_BUYER_SELLER(买家已评,卖家已评) |
tag | String | false | time_card | 卖家对交易的自定义分组标签,目前可选值为:time_card(点卡软件代充),fee_card(话费软件代充) |
page_no | Number | false | 1 | 页码。默认值:1,可填整数,通过传入 page_no 来控制获取的页数,总页数 =total_results÷ page_size |
page_size | Number | false | 40 | 每页条数。 默认值:40;最大值:45,可填整数(超过 45 很可能会超时后果自负)。通过 page_no 和 page_size 组合多次调用实现翻页获取全量数据。 |
use_has_next | Boolean | false | true | 是否启用 has_next 的分页方式,如果指定 true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量交易,接口调用成功率在原有的基础上有所提升。 |
buyer_open_id | String | false | AAHm5d-EAAeGwJedwSHpg8bT | 买家的 openId |
include_oaid | String | false | true | appkey 未对接 oaid 加密,则忽略该字段。对接 oaid 加密情况下,(收货人 + 手机号 + 座机 + 收货地址 +create)5 个字段组合成 oaid,原始订单上座机为空也满足条件。传 true,代表必须返回 oaid,生成不了就报 isv.oaid-field-miss 错误;默认或者传 false,满足生成条件则返回 oaid,否则为空 |
vvtype | int | false | 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2,标准版 3,需要标准版的传 3,减版 4,需要减版的传 4 | |
atype | int | false | 2 | 不传或则传无效数据默认是 1,可以传 2 |
请求示例
fields:tid,type,status,orders,rx_audit_status,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,consign_time
shop_id:123
请求代码示例
cURL请求代码示例
curl --location --request POST "http://api.vv-tool.com/tool/erps/sold" \
--header "Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx" \
--header "Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=3aa32c870516459600e9332ce76bd82bc315a65c98cfd07da8942b9ad7038626a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22PE2PJvEW1mJEcVED3t_0sXFnzHdu_b46%22%3B%7D" \
--form "fields="tid,type,status,orders,rx_audit_status,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,consign_time"" \
--form "shop_id="123""
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.vv-tool.com/tool/erps/sold",
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,orders,rx_audit_status,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,consign_time","shop_id" => "123"),
CURLOPT_HTTPHEADER => array(
"Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx",
"Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=3aa32c870516459600e9332ce76bd82bc315a65c98cfd07da8942b9ad7038626a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22PE2PJvEW1mJEcVED3t_0sXFnzHdu_b46%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,orders,rx_audit_status,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,consign_time")
.addFormDataPart("shop_id","123")
.build();
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/erps/sold")
.method("POST", body)
.addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx")
.addHeader("Cookie", "__yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=3aa32c870516459600e9332ce76bd82bc315a65c98cfd07da8942b9ad7038626a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22PE2PJvEW1mJEcVED3t_0sXFnzHdu_b46%22%3B%7D")
.build();
Response response = client.newCall(request).execute();
响应参数
名称 | 类型 | 描述 | 示例值 |
---|---|---|---|
code | int | 错误码 0 为成功 | 0 |
msg | string | 返回码描述 | 成功 |
msec | int | 接口执行时间 | 1134 |
time | int | 接口返回时间 | 1612416107 |
total_results | Number | 搜索到的交易信息总数,use_has_next 不传可以获取到 | 100 |
has_next | Boolean | 是否存在下一页 | true |
trades | Trade [] | 搜索到的交易信息列表,返回的 Trade 和 Order 中包含的具体信息为入参 fields 请求的字段信息 | |
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 |
receiver_country | String | 收货人国籍 | 中国 |
receiver_town | String | 收货人街道地址 | 三墎镇 |
order_tax_fee | String | 天猫国际官网直供主订单关税税费 | 0 |
shop_pick | String | 门店自提,总店发货,分店取货的门店自提订单标识 | 1 |
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 |
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 |
seller_flag | Number | 卖家备注旗帜(与淘宝网上订单的卖家备注旗帜对应,只有卖家才能查看该字段)红、黄、绿、蓝、紫 分别对应 1、2、3、4、5 | 1 |
buyer_nick | String | 买家昵称 | 我在测试 |
has_yfx | Boolean | 订单中是否包含运费险订单,如果包含运费险订单返回 true,不包含运费险订单,返回 false | true |
yfx_fee | String | 订单的运费险,单位为元 | 0.50 |
has_buyer_message | Boolean | 判断订单是否有买家留言,有买家留言返回 true,否则返回 false | true |
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 |
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 参数,该参数作为城市 |
西湖区 |
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(没有创建支付宝交易)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 |
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 |
post_gate_declare | Boolean | 邮关订单 | true |
cross_bonded_declare | Boolean | 跨境订单 | false |
order_tax_promotion_fee | String | 天猫国际计税优惠金额 | 0 |
service_type | String | serviceType | timedd,jiaju |
threepl_timing | Boolean | threeplTiming | true |
is_o2o_passport | Boolean | 是否是智慧门店订单,只有 true,或者 null 两种情况 | true |
tmall_delivery | Boolean | tmallDelivery | true |
cn_service | String | 天猫直送服务 | 84_50 |
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 |
asdp_biz_type | String | asdp 业务身份 | logistics_upgrade |
oaid | String | (收货人 + 手机号 + 收货地址 +create)4 字段返回值都都不能为空,否则生成不了 oaid | 2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc |
no_shipping | Boolean | 无物流信息返回 true,平台属性,业务不要依赖 | false |
asdp_ads | String | 送货上门标 | 201 |
aid | String | 地址 aid 字段 | 123123 |
drug_register | String | 是否疫情登记的订单。0= 未登记,1= 已登记 | 1 |
withholding_money | int | 该接口扣费金额(点券) | 1 |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 565,
"time": 1623829190,
"data": {
"withholding_money": 1,
"has_next": true,
"0": {
"buyer_nick": "~Cbiig1GQEGEDdsdwPYilw==~XGREGERGREFQA3J~1~",
"orders": {
"order": [
{
"adjust_fee":"0.00",
"buyer_rate":false,
"cid":5300052424,
"consign_time":"2021-06-16 09:36:39",
"discount_fee":"1110.00",
"divide_order_fee":"110.48",
"invoice_no":"DPK3001802377524",
"is_daixiao":false,
"logistics_company":"火星快递",
"num":1,
"num_iid":568204279099,
"oid":"18753973237752415",
"outer_iid":"AL112237752430",
"outer_sku_id":"ZH-MF14+2+TC",
"part_mjz_discount":"108.52",
"payment":"739.00",
"pic_path":"https:O1CN01Rb6kie1Hmtv0LfFsB_!!928800801.jpg",
"price":"1999.00",
"refund_status":"NO_REFUND",
"seller_rate":false,
"seller_type":"B",
"shipping_type":"express",
"sku_id":"47466237752471",
"sku_properties_name":"颜色分类:火星祈求",
"status":"WAIT_BUYER_CONFIRM_GOODS",
"title":"火星祈求",
"total_fee":"739.00"
},
{
"adjust_fee":"0.00",
"buyer_rate":false,
"cid":50023728,
"consign_time":"2021-06-16 13:31:49",
"discount_fee":"89.00",
"divide_order_fee":"0.00",
"invoice_no":"55705623775243456",
"is_daixiao":false,
"logistics_company":"火星快递",
"num":1,
"num_iid":642212373702,
"oid":"187539723775241115",
"outer_iid":"AL20213141",
"payment":"0.00",
"pic_path":"https:11CN01F1f2377524IaWc_!!0-item_pic.jpg",
"price":"89.00",
"refund_status":"NO_REFUND",
"seller_rate":false,
"seller_type":"B",
"shipping_type":"express",
"status":"WAIT_BUYER_C12377524S",
"title":"火星祈求",
"total_fee":"0.00"
}
]
}
}
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |
614 | 用户不存在 | 通过简单的判断可以减少此类错误:排除特殊字符的昵称,如包含空格,冒号之类的昵称或排除字符长度小于 5 个,大于 20 个的 |
614 | 参数:seller_nick 无效,格式不对、非法值、越界等 | 请填写正确的 nick |
614 | API 调用远程服务超时 | 1. 每次返回 50 条以下,时间跨度小于半个小时 2. 避开交易高峰期上午 9:30-11:00,下午 14:00-17:00,晚上 20:00-22:30 3.使用增量 API(tool/erps/increment)可以减少甚至避免超时问题 |
614 | 请求被拒绝。 | 可能原因为限流,请不要频繁调用,尽量避开高峰期。 |
614 | 数据库限流。 | 请求量较大,请避开高峰期。 |
614 | 服务访问频繁 | 请稍后重试 |
614 | 不合法的参数 | 创建时间和结束时间不能为空 |
614 | 非法的参数 | 卖家 ID 非法 |
614 | 限流 | 请调整请求频率 |
614 | 非法的参数 | 请检查传入参数 |