全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

查询卖家已卖出的增量交易数据(根据修改时间)


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


接口介绍: 查询卖家已卖出的增量交易数据(根据修改时间) 点击查看详情


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


请求方式: POST


返回格式: JSON


接口收费: 扣账户余额


频率限制: 10 次/秒


请求头参数

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

请求参数

名称 类型 必须 示例值 描述
fields String true tid,type,status,payment,orders,rx_audit_status 需要返回的字段列表,多个字段用半角逗号分隔,可选值为返回示例中能看到的所有字段。
shop_id String true 123456789 店铺 ID
start_create Date true 2000-01-01 00:00:00 查询修改开始时间(修改时间跨度不能大于一天)。格式:yyyy-MM-dd HH:mm:ss
end_create Date true 2000-01-02 00:00:00 查询修改结束时间,必须大于修改开始时间(修改时间跨度不能大于一天),格式:yyyy-MM-dd HH:mm:ss。建议使用 30 分钟以内的时间跨度,能大大提高响应速度和成功率。
status String false TRADE_NO_CREATE_PAY 交易状态(查看可选值),默认查询所有交易状态的数据,除了默认值外每次只能查询一种状态。
type String false fixed 交易类型列表(查看可选值),一次查询多种类型可用半角逗号分隔,默认同时查询 guarantee_trade,auto_delivery,ec,cod,step 这 5 种类型的数据。
ext_type String false service 可选值有 ershou(二手市场的订单),service(商城服务子订单)mark(双十一大促活动异常订单)作为扩展类型筛选只能做单个 ext_type 查询,不能全部查询所有的 ext_type 类型
tag String false time_card 卖家对交易的自定义分组标签,目前可选值为:time_card(点卡软件代充),fee_card(话费软件代充)
page_no Number false 1 页码。取值范围:大于零的整数;默认值:1。注:必须采用倒序的分页方式(从最后一页往回取)才能避免漏单问题。
page_size Number false 40 每页条数。取值范围:1100,默认值:40。建议使用 4050,可以提高成功率,减少超时数量。
use_has_next Boolean false true 是否启用 has_next 的分页方式,如果指定 true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量交易,效率在原有的基础上有 80% 的提升。
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

请求示例

fields:tid,type,status,payment,orders,rx_audit_status
shop_id:123456789
start_modified:2000-01-01 00:00:00
end_modified:2000-01-02 00:00:00

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/increment' \
--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"' \
--form 'start_create="2021-04-01 14:00:00"' \
--form 'end_create="2021-04-01 16:50:00"' \
--form 'shop_id="123"' \
--form 'status="WAIT_SELLER_SEND_GOODS"'
PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/increment',
  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','start_create' => '2021-04-01 14:00:00','end_create' => '2021-04-01 16:50:00','shop_id' => '123','status' => 'WAIT_SELLER_SEND_GOODS'),
  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")
  .addFormDataPart("start_create","2021-04-01 14:00:00")
  .addFormDataPart("end_create","2021-04-01 16:50:00")
  .addFormDataPart("shop_id","123")
  .addFormDataPart("status","WAIT_SELLER_SEND_GOODS")
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/increment")
  .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();

响应参数

名称 类型 示例值 描述
total_results Number 100 搜索到的交易信息总数
trades Trade [] 搜索到的交易信息列表,返回的 Trade 和 Order 中包含的具体信息为入参 fields 请求的字段信息
seller_nick String 我在测试 卖家昵称
pic_path String jpg 商品图片绝对途径
payment String 200.07 实付金额。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
seller_rate Boolean true 卖家是否已评价。可选值:true(已评价),false(未评价)
post_fee String 200.07 邮费。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
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 2000-01-01 00:00:00 卖家发货时间。格式:yyyy-MM-dd HH:mm:ss
received_payment String 200.07 卖家实际收到的支付宝打款金额(由于子订单可以部分确认收货,这个金额会随着子订单的确认收货而不断增加,交易成功后等于买家实付款减去退款金额)。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
receiver_country String 中国 收货人国籍
receiver_town String 三墎镇 收货人街道地址
order_tax_fee String 0 天猫国际官网直供主订单关税税费
shop_pick String 1 门店自提,总店发货,分店取货的门店自提订单标识
tid Number 2231958349 交易编号 (父订单的交易编号)
num Number 1 商品购买数量。取值范围:大于零的整数,对于一个 trade 对应多个 order 的时候(一笔主订单,对应多笔子订单),num=0,num 是一个跟商品关联的属性,一笔订单对应多比子订单的时候,主订单上的 num 无意义。
num_iid Number 3424234 商品数字编号
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(买
title String 麦包包 交易标题,以店铺名作为此标题的值。注:taobao.trades.get 接口返回的 Trade 中的 title 是商品名称
type String fixed(一口价) 交易类型列表,同时查询多种交易类型可用逗号分隔。默认同时查询 guarantee_trade, auto_delivery, ec, cod 的 4 种交易类型的数据 可选值
price String 200.07 商品价格。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
discount_fee String 200.07 可以使用 trade.promotion_details 查询系统优惠系统优惠金额(如打折,VIP,满就送等),精确到 2 位小数,单位:元。如:200.07,表示:
total_fee String 200.07 商品金额(商品价格乘以数量的总金额)。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
created Date 2000-01-01 00:00:00 交易创建时间。格式:yyyy-MM-dd HH:mm:ss
pay_time Date 2000-01-01 00:00:00 付款时间。格式:yyyy-MM-dd HH:mm:ss。订单的付款时间即为物流订单的创建时间。
modified Date 2000-01-01 00:00:00 交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss
end_time Date 2000-01-01 00:00:00 交易结束时间。交易成功时间(更新交易状态为成功的同时更新)/确认收货时间或者交易关闭时间 。格式:yyyy-MM-dd HH:mm:ss
seller_flag Number 1 卖家备注旗帜(与淘宝网上订单的卖家备注旗帜对应,只有卖家才能查看该字段)红、黄、绿、蓝、紫 分别对应 1、2、3、4、5
buyer_nick String 我在测试 买家昵称
has_buyer_message Boolean true 判断订单是否有买家留言,有买家留言返回 true,否则返回 false
credit_card_fee String 30.5 使用信用卡支付金额数
step_trade_status String FRONT_NOPAID_FINAL_NOPAID 分阶段付款的订单状态(例如万人团订单等),目前有三返回状态 FRONT_NOPAID_FINAL_NOPAID(定金未付尾款未
step_paid_fee String 525.70 分阶段付款的已付金额(万人团订单已付金额)
mark_desc String 该订单需要延长收货时间 订单出现异常问题的时候,给予用户的描述,没有异常的时候,此值为空
shipping_type String free 创建交易时的物流方式(交易完成前,物流方式有可能改变,但系统里的这个字段一直不变)。可选值:free(卖家包邮),post(平邮),express
adjust_fee String 200.07 卖家手工调整金额,精确到 2 位小数,单位:元。如:200.07,表示:200 元 7 分。来源于订单价格修改,如果有多笔子订单的时候,这个为 0,单笔
service_orders ServiceOrder[] 服务子订单列表
oid Number 110770592823138 虚拟服务子订单订单号
item_oid Number 110770592803138 服务所属的交易订单号。如果服务为一年包换,则 item_oid 这笔订单享受改服务的保护
service_id Number 2342344 服务数字 id
service_detail_url String http://wt.taobao.com/plan.htm?plan_id=planId 服务详情的 URL 地址
num Number 1 购买数量,取值范围为大于 0 的整数
price String 39.09 服务价格,精确到小数点后两位:单位:元
payment String 29.98 子订单实付金额。精确到 2 位小数,单位:元。如:200.07,表示:200 元 7 分。
title String 滚筒洗衣机 商品名称
total_fee String 39.09 服务子订单总费用
buyer_nick String 小倩 2005 卖家昵称
refund_id String 2231958349 最近退款的 id
seller_nick String 麦包包 卖家昵称
pic_path String jpg 服务图片地址
tmser_spu_code String 家装干支装服务 支持家装类物流的类型
oid_str String 110770592823138 虚拟服务子订单订单号(String 类型)
apple_care_email String appleCareEmail
apple_care_mpn String appleCareMPN
ext_service_biz_id String 23423_324234,2324_342342 服务订单与实物订单关联关系
service_order_type String 1 服务供应链-服务订单类型,1:主子挂载;2:双主挂载;3:单独售卖
service_outer_id String suni_outid_23432 服务供应链-服务商外部编码标
buyer_rate Boolean true 买家是否已评价。可选值:true(已评价),false(未评价)。如买家只评价未打分,此字段仍返回 false
receiver_city String 杭州市 收货人的所在城市
注:因为国家对于城市和地区的划分的有:省直辖市和省直辖县级行政区(区级别的)划分的,淘宝这边根据这个差异保存在不同字段里面比如:广东广州:广州属于一个直辖市 是放在的 receiver_city 的字段里面;而河南济源:济源属于省直辖县级行政区划分,是区级别的,放在了 receiver_district 里面
建议:程序依赖于城市字段做物流等判断的操作,最好加一个判断逻辑:如果返回值里面只有 receiver_district 参数,该参数作为城市
receiver_district String 西湖区 收货人的所在地区
注:因为国家对于城市和地区的划分的有:省直辖市和省直辖县级行政区(区级别的)划分的,淘宝这边根据这个差异保存在不同字段里面比如:广东广州:广州属于一个直辖市 是放在的 receiver_city 的字段里面;而河南济源:济源属于省直辖县级行政区划分,是区级别的,放在了 receiver_district 里面
建议:程序依赖于城市字段做物流等判断的操作,最好加一个判断逻辑:如果返回值里面只有 receiver_district 参数,该参数作为城市
orders Order[] 订单列表
item_meal_name String M8 原装电池:便携支架:M8 专用座充:莫凡保护袋 套餐的值。如:M8 原装电池:便携支架:M8 专用座充:莫凡保护袋
pic_path String jpg 商品图片的绝对路径
seller_nick String 麦包包 卖家昵称
buyer_nick String 碎银子 买家昵称
refund_status String SUCCESS(退款成功) 退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
outer_iid String 152e442aefe88dd41cb0879232c0dcb0 商家外部编码(可与商家外部系统对接)。外部商家自己定义的商品 Item 的 id,可以通过 taobao.items.custom.get 获
snapshot_url String T1mURbXopZXXXe3rLI.1257513712679_snap 订单快照 URL
snapshot String 自定义值 订单快照详细信息
timeout_action_time Date 2000-01-01 00:00:00 订单超时到期时间。格式:yyyy-MM-dd HH:mm:ss
buyer_rate Boolean true 买家是否已评价。可选值:true(已评价),false(未评价)
seller_rate Boolean true 卖家是否已评价。可选值:true(已评价),false(未评价)
seller_type String B(商城商家) 卖家类型,可选值为:B(商城商家),C(普通卖家)
cid Number 123456 交易商品对应的类目 ID
sub_order_tax_fee String 0 天猫国际官网直供子订单关税税费
sub_order_tax_rate String 0 天猫国际官网直供子订单关税税率
estimate_con_time String demo 子订单预计发货时间
o2o_guide_id String 12345 导购员 ID
o2o_guide_name String abc 导购员名称
o2o_shop_id String 12345 门店 Id
o2o_shop_name String abc 门店名称
biz_code String tmall.daogoubao.cloudstore 为 tmall.daogoubao.cloudstore 时表示云店链路
cloud_store String 1 为 1,且 bizCode 不为 tmall.daogoubao.cloudstore 时,为旗舰店订单
hj_settle_no_commission String 1 云店是否扣拥
order_taking String 接单标记 云店接单标记
cloud_store_token String 11111 云店改价用 token
cloud_store_bind_pos String 12345 云店 pos 单号
os_activity_id String 2734957495 前 N 有礼活动 id
os_fg_item_id String 58901376862 前 N 有礼赠品 id
os_gift_count String 1 前 N 有礼赠品数量
os_sort_num String 10 前 N 有礼中奖名次,获得奖品的订单才会有该字段
oid Number 2231958349 子订单编号
status String 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 110770592803138 服务所属的交易订单号。如果服务为一年包换,则 item_oid 这笔订单享受改服务的保护
type String 直冲 交易类型
iid String 152e442aefe88dd41cb0879232c0dcb0 商品的字符串编号(注意:iid 近期即将废弃,请用 num_iid 参数)
price String 200.07 商品价格。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
num_iid Number 2342344 商品数字 ID
service_id Number 2342344 服务数字 id
item_meal_id Number 2564854632 套餐 ID
sku_id String 5937146 商品的最小库存单位 Sku 的 id.可以通过 taobao.item.sku.get 获取详细的 Sku 信息
num Number 1 购买数量。取值范围:大于零的整数
outer_sku_id String 81893848 外部网店自己定义的 Sku 编号
order_from String jhs 子订单来源,如 jhs(聚划算)、taobao(淘宝)、wap(无线)
total_fee String 200.07 应付金额(商品价格 * 商品数量 + 手工调整金额 - 子订单级订单优惠金额)。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
service_detail_url String http://wt.taobao.com/plan.htm?plan_id=planId 服务详情的 URL 地址
payment String 200.07 子订单实付金额。精确到 2 位小数,单位:元。如:200.07,表示:200 元 7 分。对于多子订单的交易,计算公式如下:payment = price * num +
discount_fee String 200.07 子订单级订单优惠金额。精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
adjust_fee String 1.01 手工调整金额。格式为:1.01;单位:元;精确到小数点后两位。
modified Date 2000-01-01 00:00:00 订单修改时间,目前只有 taobao.trade.ordersku.update 会返回此字段。
sku_properties_name String 颜色:桔色;尺码:M SKU 的值。如:机身颜色:黑色;手机套餐:官方标配
refund_id String 2231958349 最近退款 ID
is_oversold Boolean true 是否超卖
is_service_order Boolean true 是否是服务订单,是返回 true,否返回 false。
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,依赖外部服务商传入;
shipping_type String post 子订单的运送方式(卖家对订单进行多次发货之后,一个主订单下的子订单的运送方式可能不同,用 order.shipping_type 来区分子订单的运送方式)
bind_oid Number 23194074143138 捆绑的子订单号,表示该子订单要和捆绑的子订单一起发货,用于卖家子订单捆绑发货
logistics_company String 顺风快递 子订单发货的快递公司名称
invoice_no String 05432465 子订单所在包裹的运单号
is_daixiao Boolean true 表示订单交易是否含有对应的代销采购单。如果该订单中存在一个对应的代销采购单,那么该值为 true;反之,该值为 false。
divide_order_fee String 21.00 分摊之后的实付金额
part_mjz_discount String 21.00 优惠分摊
ticket_outer_id String 123456abcd 对应门票有效期的外部 id
ticket_expdate_key String 100FFFFFF02374020000002001020304000A 门票有效期的 key
store_code String 南京 QDHEWL-0004 发货的仓库编码
is_www Boolean true 子订单是否是 www 订单
tmser_spu_code String 家装干支装服务 支持家装类物流的类型
bind_oids String 193741211090019,193741211080019 bind_oid 字段的升级,支持返回绑定的多个子订单,多个子订单以半角逗号分隔
zhengji_status String 1 征集预售订单征集状态:1(征集中),2(征集成功),3(征集失败)
md_qualification String true_免单原因 免单资格属性
md_fee String 999 免单金额
customization String 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 单履行内容,如喵鲜生极速达:storeId,phone
o2o_et_order_id String
combo_id String 1923423423 天猫搭配宝
assembly_rela String 100293929394324 主商品订单 id
assembly_price String 30000 价格
assembly_item String 1234,234234 assemblyItem
sub_order_tax_promotion_fee String 0 天猫国际子订单计税优惠金额
cl_down_payment String 1000 clDownPayment
cl_down_payment_ratio String 1000 clDownPaymentRatio
cl_month_payment String 1000 clMonthPayment
cl_tail_payment String 1000 clTailPayment
cl_installment_num String 1000 clInstallmentNum
cal_penalty String 1000 calPenalty
cl_service_fee String 1000 clServiceFee
cl_car_taker String 1000 clCarTaker
cl_car_taker_phone String 1000 clCarTakerPhone
cl_car_taker_i_d_num String 1000 clCarTakerIDNum
cl_car_taker_id_num String 1000 clCarTakerIDNum
down_payment String 1000 downPayment
down_payment_ratio String 1000 downPaymentRatio
month_payment String 1000 monthPayment
tail_payment String 1000 tailPayment
installment_num String 12 installmentNum
penalty String 1000 penalty
service_fee String 1000 serviceFee
car_taker String 张三 carTaker
car_taker_phone String 12345678901 carTakerPhone
car_taker_id_num String 123 carTakerIDNum
car_store_code String 123 carStoreCode
car_store_name String 汽车门店 carStoreName
out_unique_id String 123 outUniqueId
ws_bank_apply_no String 123 wsBankApplyNo
car_taker_id String 123 carTakerID
oid_str String 123 oidStr
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 100.00 platformSubsidyFee
nr_reduce_inv_fail String 1 nrReduceInvFail
nr_outer_iid String 2983778187 新零售商家端商品唯一编号
bind_oids_all_status String 193741211090019,193741211080019 bind_oids 字段的升级,在交易成功和交易关闭状态下也能获取到,支持返回绑定的多个子订单,多个子订单以半角逗号分隔
sort_info JSON sort
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 有值表示买家修改了地址;1 表示付款后改地址;2 表示付款前改地址
ti_modify_address_time String 2019-02-18 11:32:53 买家修改地址时间
credit_buy String 3 有值表示信用购订单;1 表示信用购一期;2 表示信用购二期;3 表示信用购三期
s_tariff_fee String
timing_promise String 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 10 使用淘金币的数量,以分为单位,和订单标 propoint 中间那一段一样
is_kaola Boolean true 是否是考拉商品订单
brand_light_shop_source String source1 同城购订单 source
brand_light_shop_store_id String 123456 同城购门店 id
special_refund_type String 特殊的退款类型,比如直播返现、价保
extend_info String 透出的额外信息
is_devalue_fee Boolean true 子订单优惠贬值
service_order_type String 1 服务供应链-服务订单类型,1:主子挂载;2:双主挂载;3:单独售卖
service_outer_id String sunin_outid_324324324 服务供应链-服务商外部编码
rx_audit_status String 0 处方药未审核状态
post_gate_declare Boolean true 邮关订单
cross_bonded_declare Boolean false 跨境订单
order_tax_promotion_fee String 0 天猫国际计税优惠金额
service_type String timedd,jiaju serviceType
is_o2o_passport Boolean true 是否是智慧门店订单,只有 true,或者 null 两种情况
oaid String (收货人 + 手机号 + 收货地址 +create)4 字段返回值都都不能为空,否则生成不了 oaid
has_next Boolean true 是否存在下一页
withholding_money int 100 该接口扣费金额(点券)

返回数据

{
    "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 未授权店铺 根据返回链接进行扫码授权
401 身份凭证无效 在请求头中添加 access_token,重新更新 token
404 请求路径或请求方式错误 请更换请求方式或者检查路径是否正确
614 查询条件(修改时间)跨度不能超过一天 只能查询 3 个月内并且跨度为一天的修改过的数据
614 buyer_nick 无效 请填写正确的 buyer_nick。
614 限流 避开限流