全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
根据条件检索订单信息(基础接口)
接口地址: http://api.vv-tool.com/tool/erps/jdordersearch
接口介绍: 根据条件检索订单信息 (仅适用于 SOP 类型,且只能查出达到生产条件的订单,FBP 类型请调取 FBP 订单检索 )
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 请求次数收费,联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
owner_id | String | 是 | 店铺 ownerId | |
start_date | String | 是 | 示例:2018-11-14 10:00:00 | 以订单创建时间或者更新时间检索(开始时间和结束时间,不得相差超过 1 个月。) |
end_date | String | 是 | 示例:2018-12-14 10:00:00 | (开始时间和结束时间,不得相差超过 1 个月。) |
order_state | String | 是 | 示例: WAIT_SELLER_STOCK_OUT, WAIT_GOODS_RECEIVE_CONFIRM | 多订单状态可以用英文逗号隔开,请不要使用数字,请用英文逗号拼接英文状态传递给 jos 系统。 1)WAIT_SELLER_STOCK_OUT 等待出库 2)WAIT_GOODS_RECEIVE_CONFIRM 等待确认收货 3)WAIT_SELLER_DELIVERY 等待发货(只适用于海外购商家,含义为“等待境内发货”标签下的订单,非海外购商家无需使用) 4) PAUSE 暂停(loc 订单可通过此状态获取) 5)FINISHED_L 完成 6)TRADE_CANCELED 取消 7)LOCKED 已锁定 8)POP_ORDER_PAUSE pop 业务暂停,如 3c 号卡/履约/黄金 可传此状态 |
optional_fields | String | 是 | temInfoList,orderId,isShipmenttype,scDT,idSopShipmenttype,orderStartTime | 需返回的字段列表。必填,不填或者为空则请求被拒绝。请参考返回结果集中的对象参数描述:orderInfo 结构体中的所有字段;字段之间用,分隔 |
page | String | 是 | 1 | 查询的页数。 |
page_size | String | 是 | 20 | 每页的条数(最大 page_size 50 条)建议:50 |
vvtype | int | 否 | 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2 |
请求示例
{
owner_id:12345
start_date:2022-01-14 10:00:00
end_date:2022-02-14 10:00:00
page:1
order_state:WAIT_SELLER_STOCK_OUT
page_size:20
optional_fields:orderId,payType,orderTotalPrice,orderPayment,orderSellerPrice,freightPrice,sellerDiscount,orderState,orderStateRemark,deliveryType,invoiceInfo,orderRemark,orderStartTime,orderEndTime,consigneeInfo,itemInfoList,couponDetailList,returnOrder,venderRemark,pin,balanceUsed,modified,paymentConfirmTime,logisticsId,waybill,invoiceCode,orderSource,storeOrder,waybill
order_id:236587500875
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
searchorderinfo_result | com.jd.ac.domain.api.offline.OrderListResult | 结果集 | |
apiResult | com.jd.ac.domain.api.ApiResult | 返回结果 | |
-success | Boolean | false | 是否成功 |
-englishErrCode | String | client validate does not pass or exist problem | 英文错误信息(client validate does not pass or exist problem;system exception;there is no available order state parameter;contain empty order state;order state is wrong;order state is not suitable for the business;page is not numeric;pageSize is not numeric;page is littler than 1 or too large;pageSize is littler than 1 or larger than 100;there is only available endDate or only available beginDate;endDate is not date type;beginDate is not date type;endDate is before beginDate;interval between beginDate and endDate is more than one month;es exception;search order detail is error) |
-chineseErrCode | String | 客户端校验没通过或有问题 | 中文错误信息(客户端校验没通过或有问题;系统异常;订单状态参数为空或不存在;含有空的订单状态;订单状态不正确;订单状态不适用于当前商家;页数不是数字格式;每页行数不是数字格式;页数小于 1 或者太大;每页行数大于 100 或者小于 1;只有开始时间或者只有结束时间;结束时间不是日期类型;开始时间不是日期类型;结束时间早于开始时间;结束时间和开始时间的间隔大于 1 个月;ES 查询异常;查询订单明细失败) |
-numberCode | Number | 10500001 | 错误码(10500001;999999;10100019;10100020;10100021;10100022;10100023;10100024;10100025;10100026;10100031;10100028;10100027;10100029;10100030;13200004;10100043) |
-orderTotal | Number | 100 | 订单的总数量 |
orderInfoList | java.util.List | 订单信息列表 | |
--- | com.jd.open.api.sdk.domain.order.OrderSearchInfo | ||
-orderId | String | 45612313 | 订单 id |
-venderId | String | 281201 | 商家 id |
-orderType | String | 22 | 订单类型(22 SOP;75 LOC;21 FBP 订单,112 FCS,FBP 请用 fbp.search 接口查询) 可选字段,需要在输入参数 optional_fields 中写入才能返回 |
-payType | String | 1 | 支付方式(1 货到付款, 2 邮局汇款, 3 自提, 4 在线支付, 5 公司转账, 6 银行卡转账) |
-orderTotalPrice | String | 20.00 | 订单总金额。总金额 = 订单金额(不减优惠,不加运费服务费税费) |
-orderSellerPrice | String | 100 | 订单货款金额(订单总金额-商家优惠金额) |
-orderPayment | String | 50 | 用户应付金额。应付款 = 货款-用户优惠-余额 + 运费 + 税费 + 服务费。 |
-freightPrice | String | 10 | 商品的运费 |
-sellerDiscount | String | 20 | 商家优惠金额。如:20-套装优惠, 28-闪团优惠, 29-团购优惠, 30-单品促销优惠, 35-满返满送(返现),100-店铺优惠 |
-orderState | String | DengDaiChuKu | 1)WAIT_SELLER_STOCK_OUT 等待出库 2)WAIT_GOODS_RECEIVE_CONFIRM 等待确认收货 3)WAIT_SELLER_DELIVERY 等待发货(只适用于海外购商家,含义为“等待境内发货”标签下的订单,非海外购商家无需使用) 4) POP_ORDER_PAUSE POP 暂停 5)FINISHED_L 完成 6)TRADE_CANCELED 取消 7)LOCKED 已锁定 8)WAIT_SEND_CODE 等待发码 9)PAUSE 暂停(等待出库之前的状态) 10)DELIVERY_RETURN 配送退货 11)UN_KNOWN 未知 请联系运营 |
-orderStateRemark | String | 等待出库 | 订单状态说明(中文),同上。 |
-deliveryType | String | 1 | 送货(日期)类型(1-只工作日送货(双休日、假日不用送);2-只双休日、假日送货(工作日不用送);3-工作日、双休日与假日均可送货;其他值-返回“任意时间”) |
invoiceEasyInfo | com.jd.ac.domain.api.offline.InvoiceEasyInfo | 发票组装信息。包含电子发票信息。可替代 invoiceInfo 使用。 | |
-invoiceType | String | 0 | 发票类型,0= 不开发票、1= 普通发票、2= 增值税发票(专票)、3= 电子发票 |
-invoiceTitle | String | 无需发票 | 发票抬头。个人/公司名称 |
-invoiceContentId | String | 21 | 发票内容。如明细。 |
-invoiceConsigneeEmail | String | 无 | 电子发票联系人邮箱 |
-invoiceConsigneePhone | String | 18311111111 | 电子发票联系人手机号 |
-invoiceCode | String | VLN2131312321 | 发票纳税人识别号 |
-invoiceInfo | String | 1 | 发票信息: 1. “不需要开具发票”情况下无需开具发票;2.其它返回值请正常开具发票 。(没有电子发票具体信息) |
-invoiceCode | String | 无 | 普通发票纳税人识别码 |
-orderRemark | String | 尽快发货 | 买家下单时订单备注 |
-orderStartTime | String | 2019-01-01 12:12:12 | 下单时间,订单创建时间 |
-orderEndTime | String | 2019-01-01 12:12:12 | 结单时间 。如返回信息为“0001-01-01 00:00:00”和“1970-01-01 00:00:00”,可认为此订单为未完成状态。 |
consigneeInfo | com.jd.open.api.sdk.domain.order.UserInfo | 收货人基本信息 | |
-fullname | String | 李蕾 | 姓名 |
-telephone | String | 010-2553791 | 固定电话 |
-mobile | String | 18311111111 | 手机 |
-fullAddress | String | 河北廊坊市三河市齐心庄镇 | 地址 |
-province | String | 河北省 | 省 |
-city | String | 廊坊市 | 市 |
-county | String | 三河市 | 县 |
-town | String | 齐心庄镇 | 镇 |
-provinceId | String | 5 | 省 Id |
-cityId | String | 274 | 市 Id |
-countyId | String | 49707 | 县 Id |
-townId | String | 49968 | 镇 Id |
-desen_telephone | String | 010-2553791 | 固定电话 |
-desen_mobile | String | 18311111111 | 手机 |
itemInfoList | java.util.List | 商品详细信息列表 | |
--- | com.jd.open.api.sdk.doamin.order.ItemInfo | ||
-skuId | String | 45123213 | 京东内部 SKU 的 ID |
-outerSkuId | String | 1233242 | SKU 外部 ID(极端情况下不保证返回,建议从商品接口获取) |
-skuName | String | 测试商品 | 商品的名称 +SKU 规格 |
-jdPrice | String | 100 | SKU 的京东价 |
-giftPoint | String | 50 | 赠送积分 |
-wareId | String | 451261 | 京东内部商品 ID(极端情况下不保证返回,建议从商品接口获取) |
-itemTotal | String | 1 | 商品总数量 |
-productNo | String | 45671231 | 货号。 |
-serviceName | String | 无 | 服务项名称 |
-newStoreId | String | 21 | item 维度的仓库 id。 |
-itemExt | String | 无 | item 维度的扩展信息;包括服务项数据、黄金珠宝、医疗器械,门店 id 等订单标识。黄金珠宝标识:zszs=1;serviceId,家具服务,市区站点自提 1101,送货上门 1102,送货上门安装 1103,送货上门安装 (200 城市免送装)1104;建材服务,市区站点自提 1105,送货上门 1106,送货上门安装 1107;运动器材服务,市区站点自提 3702,送货上门 3902,送货上门安装 3903 ; 门店 id 对应的 key:locShopId(只有门店服务的订单,扩展信息里面才有这个节点) |
couponDetailList | java.util.List | 优惠详细信息列表 | |
--- | com.jd.open.sdk.domain.order.CouponDetail | ||
-orderId | String | 4521311 | 订单编号 |
-skuId | String | 无 | 京东 sku 编号。(只有 30-单品促销优惠 此 skuId 才非空) |
-couponType | String | 20 | 优惠类型: 20-套装优惠, 28-闪团优惠, 29-团购优惠, 30-单品促销优惠, 34-手机红包, 35-满返满送(返现), 39-京豆优惠,41-京东券优惠, 52-礼品卡优惠,100-店铺优惠 |
-couponPrice | String | 100 | 优惠金额。isv 请联系服务市场类目运营,商家请联系店铺运营。 |
-venderRemark | String | 会尽快发货(请去备注接口获取) | 请去备注接口获取 |
-balanceUsed | String | 100 | 余额支付金额 。可选字段,需要在输入参数 optional_fields 中写入才能返回 |
-pin | String | testpin | 买家的账号信息 。可选字段,需要在输入参数 optional_fields 中写入才能返回 |
-returnOrder | String | 0 | 售后订单标记。 0:不是换货订单 1 返修发货,直接赔偿,客服补件 2 售后调货 。可选字段,需要在输入参数 optional_fields 中写入才能返回 |
-paymentConfirmTime | String | 2019-01-01 12:12:12 | 付款确认时间 。如果没有付款时间 返回 null。可选字段,需要在输入参数 optional_fields 中写入才能返回 |
-waybill | String | VL21309123 | 运单号(当厂家自送时运单号可为空,不同物流公司的运单号用“ |
-logisticsId | String | 21 | 物流公司 ID 。可选字段,需要在输入参数 optional_fields 中写入才能返回 |
vatInfo | com.jd.open.api.domain.order.VatIncoiceInfo | 增值税发票(专票),普通发票,普通电子发票 可选字段,需要在输入参数 optional_fields 中写入才能返回(发票相关扩展字段) | |
-vatNo | String | VL23213109 | 纳税人识别号 |
-addressRegIstered | String | 无 | 注册地址 |
-phoneRegIstered | String | 18311111111 | 注册电话 |
-depositBank | String | 北京市银行 | 开户银行 |
-bankAccount | String | 无 | 银行账户 |
-userAddress | String | 北京市大兴区 | 收票人地址 |
-userName | String | 张三 | 收票人姓名 |
-userPhone | String | 1831111111 | 收票人电话 |
-invoicePersonalName | String | 李四 | 普通发票,电子普通发票的个人姓名 |
-desen_userPhone | String | 1831111111 | 收票人电话 |
-modified | String | 2019-01-01 12:12:12 | 订单更新时间 |
-directParentOrderId | String | 457612313 | 直接父订单号 。当一个订单被拆多次时,此值为直接上级父单 ID。需要在输入参数 optional_fields 中写入才能返回 |
-parentOrderId | String | 457612313 | 根父订单号。当一个订单被拆多次时,此值为最上级父单 ID。 可选字段,需要在输入参数 optional_fields 中写入才能返回 |
-customs | String | 如广州南沙保税区、北京保税区等 | 保税区信息:如广州南沙保税区、北京保税区等(具体的保税区域地点) |
-customsModel | String | 直邮,保税集货,保税备货 | 保税模型:直邮,保税集货,保税备货(保税的模式,目前只有三种) |
-orderSource | String | 拍拍订单 | 订单来源。如:移动端订单、PC 端订单、手 Q 订单、微信订单、拍拍订单、农村电商 |
-storeOrder | String | 京仓订单 | 值为字符串的文字。当 ordertype 为 22 的时候, 如,“京仓订单“,“云仓订单”,空字符串(“”),京仓、云仓订单,商家请勿发货。 |
-idSopShipmenttype | Number | 68 | 是否京配。68= 京配,69= 京配自提,67= 第三方快递。71= 同城配送(当是 71 时请通过 jingdong.pop.order.getOrderExtInfoByOrderId 接口获取配送时效信息) |
-scDT | String | 2019-01-01 12:12:12 | 最早生产时间/客户的预约出库时间,在此时间之前,订单为暂停。 |
-serviceFee | String | 100 | 服务费。目前接口无法返回。 |
pauseBizInfo | com.jd.ac.domain.api.offline.OrderInfoResultPauseBizInfo | 订单暂停业务数据 | |
pauseBizStatusList | java.util.List | 订单暂停业务处理状态列表 | |
--- | com.jd.ac.domain.api.offline.OrderInfoResultPauseBizInfo.PauseBizStatus | ||
-bizType | Number | 1 | 业务类型 |
-bizStatus | Number | 2 | 业务处理状态 |
pauseBizDataYy | com.jd.ac.domain.api.offline.OrderInfoResultPauseBizInfo.PauseBizDataYy | 订单暂停业务数据(预约日历) | |
-codDT | String | 2018-02-02 00:00:00 | 用户预约时间。只有到了这个时间,订单才可生产(出库发货)。 |
-dbDT | String | 2018-02-02 00:00:00 | 最晚出库时间 |
-ljDT | String | 2018-02-02 00:00:00 | 最晚揽件时间 |
-taxFee | String | 100 | 全球购业务下的税费,包含了“税价分离”和“包税”模式。 |
-tuiHuoWuYou | String | 无 | 退货无忧 |
-orderSign | String | 无 | sendpay,京东侧的订单标记,可忽略。 |
-storeId | String | 12 | 仓库 Id。 |
-menDianId | String | 21 | 门店 Id。门店业务下,京东分单、商家分单时,此 ID 有值。 |
-mdbStoreId | String | 121 | 门店帮 Id。线下门店导购员销售时的订单。 |
-salesPin | String | testpin01 | 导购员 pin。线下门店导购员销售的订单,导购员的标记 |
originalConsigneeInfo | com.jd.open.api.sdk.domain.order.UserInfo | 集运订单客户真实收获地址(仅集运订单即 sendpay 第 124 位为 7 的订单有这个字段) | |
-fullname | String | 张三 | 姓名 |
-telephone | String | 0102553701 | 固定电话 |
-mobile | String | 18222222222 | 手机 |
-fullAddress | String | 河北廊坊市三河市齐心庄镇 | 详细地址 |
-province | String | 河北省 | 省 |
-city | String | 廊坊市 | 市 |
-county | String | 三河市 | 县 |
-town | String | 齐心庄镇 | 镇 |
-provinceId | String | 5 | 省 Id |
-cityId | String | 274 | 市 Id |
-countyId | String | 49707 | 县 Id |
-townId | String | 49968 | 镇 Id |
-desen_telephone | String | 0102553701 | 固定电话 |
-desen_mobile | String | 18222222222 | 手机 |
-orderExt | String | 订单维度扩展字段,json; | 订单维度扩展字段,json; |
orderMarkDesc | java.util.Map | 订单标注描述 | |
-TryBeforePayLater | String | 1 | 京品试订单标注描述。1 代表是京品试订单 |
-realPin | String | testPin | 买家的账号信息 真实 Pin 信息。可选字段,需要在输入参数 optional_fields 中写入才能返回 |
-sendpayMap | String | {“301”:“1”,“501”:“1”,“509”:“1”,”688”:”2”,“559”:“2”,“599”:”7”} | 包含 sendpay 所有打标逻辑,500 位后的 sendpay 打标逻辑只有这个字段有 * 示例:{“301”:“1”,“501”:“1”,“509”:“1”,”688”:”2”,“559”:“2”,“599”:”7”} |
-open_id_buyer | String | testpin | 买家的账号信息 。可选字段,需要在输入参数 optional_fields 中写入才能返回 |
-open_id_seller | String | testpin01 | 导购员 pin。线下门店导购员销售的订单,导购员的标记 |
withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
注:京东隐私号针对手机号与电话做了脱敏展示 如:152*******9
手机号加密字段:desen_mobile 由一个70字符长度组成的,建议持久化该字段,取号时需要将收货人mobile字段与phone字段分别替换成desen_mobile、desen_telephone字段
如果该字段为空请正常方式取号,具体取号方式参考 获取单号接口(无界电子面单)
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"withholding_money":4,
"jingdong_pop_order_search_responce": {
"code": "0",
"searchorderinfo_result": {
"orderInfoList": [
{
"orderStateRemark": "等待出库",
"orderRemark": "售后返修换新!服务单号:1084121296#返修发货#原订单号:210401983773",
"logisticsId": "",
"orderSellerPrice": "0.00",
"venderRemark": "测试,测试商品上限20,5565",
"orderState": "WAIT_SELLER_STOCK_OUT",
"consigneeInfo": {
"provinceId": "2",
"fullAddress": "上海静安区城区南京西路688临688广场写字楼",
"cityId": "2817",
"townId": "0",
"city": "静安区",
"county": "城区",
"province": "上海",
"telephone": "152*******9",
"fullname": "蔷薇",
"countyId": "51973",
"mobile": "152*******9",
"desen_mobile": "36306660fed30636897885eea70735bdc23808710feded8127719cd327c39ba579a7c8",
"desen_telephone": "36306660fed30636897885eea70735bdc23808710feded8127719cd327c39ba579a7c8"
},
"modified": "2021-07-01 13:51:16",
"orderPayment": "0.00",
"payType": "4-在线支付",
"itemInfoList": [
{
"productNo": "TTB06x56000",
"itemTotal": "1",
"jdPrice": "0.00",
"skuName": "OMS测试测试1-TNF升仓测试(不要拍)55周四14:22 Vans商品sit 42",
"invoiceContentId": "",
"itemExt": "{\"skuUuid\":\"10_0_0_10030799020248_1_0\",\"isVMI\":0,\"upc\":\"\",\"newStoreId\":\"0\"}",
"newStoreId": "0",
"outerSkuId": "VN00018BGZ5105000M",
"skuId": "10030799020248",
"wareId": "10020316102459",
"giftPoint": "0"
}
],
"storeId": "0",
"orderTotalPrice": "0.00",
"invoiceEasyInfo": {
"invoiceType": "0",
"invoiceContentId": "1",
"invoiceTitle": "个人"
},
"paymentConfirmTime": "2021-07-01 13:51:15",
"orderSign": "",
"orderExt": "{\"road\":\"019\"}",
"returnOrder": "1",
"storeOrder": "",
"invoiceInfo": "不需要开具发票",
"orderStartTime": "2021-07-01 13:51:15",
"orderId": "210411391226",
"waybill": "",
"orderSource": "PC端订单",
"deliveryType": "任意时间",
"balanceUsed": "0.00",
"pin": "吕15221035459",
"freightPrice": "0.00",
"sellerDiscount": "0.00"
}
],
"orderTotal": 37,
"apiResult": {
"englishErrCode": "success",
"success": true,
"chineseErrCode": "成功",
"numberCode": 10100000
}
}
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |