获取订单列表
根据条件检索订单信息 (仅适用于SOP、LBP,SOPL类型,FBP类型请调取FBP订单检索 )
建议使用《获取订单列表增强型》接口,查询条件更全,同时返回oaid(用于合单)
1.请求参数:
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
| seller_nick | String | 是 | 38173182 | 京东的账号,对应蜂巢授权返回jdseller字段 |
| sign | String | 是 |
业务参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| - start_date | String | 否 | 2020-04-04 00:20:35 | WAIT_SELLER_STOCK_OUT 等待出库,则start_date可以为否(开始时间和结束时间均为空,默认返回前一个月的订单),order_state为其他值,则start_date必须为是(开始时间和结束时间,不得相差超过1个月。此时间仅针对订单状态及运单号修改的时间) |
| - end_date | String | 否 | 2020-04-04 00:20:35 | WAIT_SELLER_STOCK_OUT 等待出库,则start_date可以为否(开始时间和结束时间均为空,默认返回前一个月的订单),order_state为其他值,则start_date必须为是(开始时间和结束时间,不得相差超过1个月。此时间仅针对订单状态及运单号修改的时间) |
| - order_state | String | 是 | 21 | 多订单状态可以用英文逗号隔开,请用英文逗号拼接英文状态传递给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 | 是 | orderId,venderId | 需返回的字段列表。可选值,请参考返回结果集中的对象参数描述:orderInfo结构体中的所有字段;字段之间用,分隔 |
| - page | String | 是 | 1 | 查询的页数 (最多300页) |
| - page_size | String | 是 | 10 | 每页的条数(最大page_size 100条) |
| - sortType | Number | 否 | 1 | 排序方式,默认升序,1是降序,其它数字都是升序 |
| - dateType | Number | 否 | 0 | 查询时间类型,默认按修改时间查询。 1为按订单创建时间查询;其它数字为按订单(订单状态、修改运单号)修改时间 |
2. 请求示例代码(Java)
请求示例代码
@Test
public void getOrderList() throws Exception {
String sellerNick = Config.JDSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("seller_nick", sellerNick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("order_state", "FINISHED_L");
data.put("start_date","2022-11-10 13:42:00" );
data.put("end_date", "2022-11-11 13:42:11");
data.put("page", "1");
data.put("page_size", "30");
// 非必填 排序类型 1- 降序 ,其它数字:升序
data.put("sortType", "0");
// 非必填 查询时间类型
data.put("dateType", "0");
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.JDOrderListUrl, data);
}
3. 返回结果如下:
3.1 成功返回
{
"code": 0,
"message": "ok",
"data": {
"orderInfoList": [
{
"balanceUsed": "0.00",
"consigneeInfo": {
"city": "清远市",
"cityId": "1704",
"county": "连州市",
"countyId": "1795",
"desen_mobile": "623961b9ac5ae02805335e5c0cb6225e1ed4f2e64465ea17b130d75cfd1d08da1a39a6",
"desen_telephone": "623961b9ac5ae02805335e5c0cb6225e1ed4f2e64465ea17b130d75cfd1d08da1a39a6",
"fullAddress": "AASzduov2Q+zBWGaLR2JVQx41QGzoJ+qgdL5Nk/bIaQLpgZExoXUnvJIpbXk1YmFs7D4X6LsDWWvIQ8ccmST37gkYLF/1eaMi/w5ASQ7DWM/OEGnrEuLNYaykkRQsLJy5+E=",
"fullname": "AASzduov2Q+zBWGaLR2JVQx4momBsEry/h4rNctCfo0WPjmryKtplKJ6iIzUorD1JAM=",
"mobile": "137*******1",
"province": "广东",
"provinceId": "19",
"telephone": "137*******1",
"town": "连州镇",
"townId": "37845"
},
"couponDetailList": [
{
"couponPrice": "14.90",
"couponType": "30-单品促销优惠",
"orderId": "256467576067",
"skuId": "10060672777743"
}
],
"deliveryType": "任意时间",
"freightPrice": "0.00",
"idSopShipmenttype": 67,
"invoiceEasyInfo": {
"invoiceContentId": "1",
"invoiceTitle": "AASzduov2Q+zBWGaLR2JVQx41zyCm4uZxPOcX9PHa82LMKjbFeb4Ao3UN0NKMVXCq4c=",
"invoiceType": "0"
},
"invoiceInfo": "不需要开具发票",
"itemInfoList": [
{
"giftPoint": "0",
"invoiceContentId": "",
"itemTotal": "1",
"jdPrice": "149.00",
"newStoreId": "0",
"outerSkuId": "",
"productNo": "aWxjTEfb",
"skuId": "10060672777743",
"skuName": "依迪筱 亲子装母女装2022秋冬新款红色女童毛衣连衣裙时尚洋气新年灯笼袖长袖针织衫 红色 均码",
"wareId": "10023122232371"
}
],
"logisticsId": "1499",
"modified": "2022-11-10 16:16:54",
"orderEndTime": "2022-11-10 16:16:49",
"orderId": "256467576067",
"orderPayment": "134.10",
"orderRemark": "",
"orderSellerPrice": "134.10",
"orderSource": "历史订单暂无来源",
"orderStartTime": "2022-11-05 19:16:13",
"orderState": "FINISHED_L",
"orderStateRemark": "完成",
"orderTotalPrice": "149.00",
"orderType": "22",
"payType": "4-在线支付",
"paymentConfirmTime": "2022-11-05 19:16:25",
"pin": "P3OSgUqDjV7OVHCddVya1Rui5s8ZuYCw+d+i3YNpD6KaL2fDfJVRWSwGpiOlCn76",
"realPin": "DLj0jB6Pt/XA1sQ0pUn9ahui5s8ZuYCw+d+i3YNpD6KaL2fDfJVRWSwGpiOlCn76",
"returnOrder": "0",
"sellerDiscount": "14.90",
"storeId": "0",
"storeOrder": "",
"vatInfo": {},
"venderId": "12412981",
"venderRemark": "",
"waybill": "78303925835833"
},
{
"balanceUsed": "0.00",
"consigneeInfo": {
"city": "清远市",
"cityId": "1704",
"county": "连州市",
"countyId": "1795",
"desen_mobile": "623961b9ac5ae02805335e5c0cb6225e1ed4f2e64465ea17b130d75cfd1d08da1a39a6",
"desen_telephone": "623961b9ac5ae02805335e5c0cb6225e1ed4f2e64465ea17b130d75cfd1d08da1a39a6",
"fullAddress": "AASzduov2Q+zBWGaLR2JVQx4MgiENLVytAdS2Sh6pIbfQ0OWIpyx5KCEi4qELxOgrOOFgl0una3SYY+z9i+a8nUgWlRG920HiB85vkOiVZo1z2pt3m1FiHMabnsGi8BthOw=",
"fullname": "AASzduov2Q+zBWGaLR2JVQx4I/4r3t6cZYrTX5SsbsQ5Yq7SQSE9Tu1fOGeLOIKJMTw=",
"mobile": "137*******1",
"province": "广东",
"provinceId": "19",
"telephone": "137*******1",
"town": "连州镇",
"townId": "37845"
},
"couponDetailList": [
{
"couponPrice": "14.90",
"couponType": "30-单品促销优惠",
"orderId": "255596373523",
"skuId": "10060672777740"
}
],
"deliveryType": "任意时间",
"freightPrice": "0.00",
"idSopShipmenttype": 67,
"invoiceEasyInfo": {
"invoiceContentId": "1",
"invoiceTitle": "AASzduov2Q+zBWGaLR2JVQx4pZy+ln3pZlf76axa2pIqpT3gfOCpVrPy3vJT7YRxqf8=",
"invoiceType": "0"
},
"invoiceInfo": "不需要开具发票",
"itemInfoList": [
{
"giftPoint": "0",
"invoiceContentId": "",
"itemTotal": "1",
"jdPrice": "149.00",
"newStoreId": "0",
"outerSkuId": "",
"productNo": "aWxjTEfb",
"skuId": "10060672777740",
"skuName": "依迪筱 亲子装母女装2022秋冬新款红色女童毛衣连衣裙时尚洋气新年灯笼袖长袖针织衫 红色 130cm",
"wareId": "10023122232371"
}
],
"logisticsId": "1499",
"modified": "2022-11-10 16:16:54",
"orderEndTime": "2022-11-10 16:16:49",
"orderId": "255596373523",
"orderPayment": "134.10",
"orderRemark": "",
"orderSellerPrice": "134.10",
"orderSource": "历史订单暂无来源",
"orderStartTime": "2022-11-05 19:15:22",
"orderState": "FINISHED_L",
"orderStateRemark": "完成",
"orderTotalPrice": "149.00",
"orderType": "22",
"payType": "4-在线支付",
"paymentConfirmTime": "2022-11-05 19:15:33",
"pin": "P3OSgUqDjV7OVHCddVya1Rui5s8ZuYCw+d+i3YNpD6KaL2fDfJVRWSwGpiOlCn76",
"realPin": "DLj0jB6Pt/XA1sQ0pUn9ahui5s8ZuYCw+d+i3YNpD6KaL2fDfJVRWSwGpiOlCn76",
"returnOrder": "0",
"sellerDiscount": "14.90",
"storeId": "0",
"storeOrder": "",
"vatInfo": {},
"venderId": "12412981",
"venderRemark": "",
"waybill": "78303925835833"
}
],
"orderTotal": 2
}
}
3.2 返回失败情况
{"code":0,"message":"ok","data":{"apiResult":{"chineseErrCode":"订单状态不正确","englishErrCode":"order state is wrong","success":false,"numberCode":10500001},"orderTotal":0}}
说明: code为0表示成功,非0为失败,message会包含失败原因。
4. 返回字段说明
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| searchorderinfo_result | com.jd.ac.domain.api.offline.OrderListResult | 结果集 | |
| apiResult | com.jd.ac.domain.api.ApiResult | 返回结果 | |
| - success | Boolean | true | 是否成功 |
| - englishErrCode | String | failed | 英文错误原因,如果成功,此字段为空 |
| - chineseErrCode | String | 失败 | 中文错误原因 |
| - numberCode | Number | 999999 | 数字错误 |
| - orderTotal | Number | 20 | 查询订单的数量 |
| orderInfoList | java.util.List | 订单信息列表 | |
| — | com.jd.open.api.sdk.domain.order.OrderSearchInfo | ||
| - orderId | String | 12314124124 | 订单id |
| - venderId | String | 1223123 | 商家id |
| - orderType | String | 121 | 订单类型(22 SOP;75 LOC) 可选字段,需要在输入参数optional_fields中写入才能返回 |
| - payType | String | 10 | 支付方式(1货到付款, 2邮局汇款, 3自提, 4在线支付, 5公司转账, 6银行卡转账) |
| - orderTotalPrice | String | 212.0 | 订单总金额。总金额=订单金额(不减优惠,不加运费服务费税费) |
| - orderSellerPrice | String | 212.0 | 订单货款金额(订单总金额-商家优惠金额) |
| - orderPayment | String | 212.0 | 用户应付金额。应付款=货款-用户优惠-余额+运费+税费+服务费。 |
| - freightPrice | String | 10 | 商品的运费 |
| - sellerDiscount | String | 10 | 商家优惠金额 |
| - orderState | String | 21 | 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 等待发码 |
| - 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 | 发票 | 发票内容 |
| - invoiceConsigneeEmail | String | jingjd@163.com | 电子发票联系人邮箱 |
| - invoiceConsigneePhone | String | 13603340098 | 电子发票联系人手机号 |
| - invoiceCode | String | 1231231 | 发票纳税人识别号 |
| - invoiceInfo | String | 不需要开具发票 | 发票信息 “invoice_info: 不需要开具发票”下无需开具发票;其它返回值请正常开具发票 。(没有电子发票具体信息) |
| - invoiceCode | String | 1231231 | 普通发票纳税人识别码 |
| - orderRemark | String | 红色 | 买家下单时订单备注 |
| - orderStartTime | String | 2020-04-15 12:55:44 | 下单时间 |
| - orderEndTime | String | 2020-04-15 12:55:44 | 结单时间 如返回信息为“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 | 13603340098 | 固定电话 |
| - mobile | String | 13603340098 | 手机 |
| - fullAddress | String | 广东河源市紫金县瓦溪镇老道班代收 | 地址 |
| - province | String | 19 | 省 |
| - city | String | 1627 | 市 |
| - county | String | 紫金县 | 县 |
| - town | String | 瓦溪镇 | 镇 |
| - provinceId | String | 19 | 省Id |
| - cityId | String | 1627 | 市Id |
| - countyId | String | 1630 | 县Id |
| - townId | String | 6066 | 镇Id |
| - desen_telephone | String | 13603340098 | 固定电话 |
| - desen_mobile | String | 13603340098 | 手机 |
| itemInfoList | java.util.List | 商品详细信息 | |
| — | com.jd.open.api.sdk.doamin.order.ItemInfo | ||
| - skuId | String | 123123123123 | 京东内部SKU的ID |
| - outerSkuId | String | HYDSW | SKU外部ID(极端情况下不保证返回,建议从商品接口获取 |
| - skuName | String | 华为手机 | 商品的名称+SKU规格 |
| - jdPrice | String | 8888.0 | SKU的京东价 |
| - giftPoint | String | 234 | 赠送积分 |
| - wareId | String | 123123123123 | 京东内部商品ID(极端情况下不保证返回,建议从商品接口获取) |
| - itemTotal | String | 2 | 数量 |
| - productNo | String | GNZ206 | |
| - serviceName | String | 服饰 | 服务项名称 |
| - newStoreId | String | 21 | item维度的仓库id |
| couponDetailList | java.util.List | 优惠详细信息 | |
| — | com.jd.open.sdk.domain.order.CouponDetail | ||
| - orderId | String | 213123123123 | 订单编号 |
| - skuId | String | 213123123123 | 京东sku编号。(只有30-单品促销优惠 此skuId才不是空) |
| - couponType | String | 20 | 优惠类型: 20-套装优惠, 28-闪团优惠, 29-团购优惠, 30-单品促销优惠, 34-手机红包, 35-满返满送(返现), 39-京豆优惠,41-京东券优惠, 52-礼品卡优惠,100-店铺优惠 |
| - couponPrice | String | 618.0 | 优惠金额。详细的sku优惠/分摊金额 请联系jos找ofc提供对应接口。 |
| - venderRemark | String | 红色 | 商家订单备注(不大于500字符) 可选字段,需要在输入参数optional_fields中写入才能返回 |
| - balanceUsed | String | 123.0 | 余额支付金额 可选字段,需要在输入参数optional_fields中写入才能返回 |
| - pin | String | jd | 买家的账号信息 可选字段,需要在输入参数optional_fields中写入才能返回 |
| - returnOrder | String | 0 | 售后订单标记 0:不是换货订单 1返修发货,直接赔偿,客服补件 2售后调货 可选字段,需要在输入参数optional_fields中写入才能返回 |
| - paymentConfirmTime | String | 0001-01-01 00:00:00 | 付款确认时间 如果没有付款时间 默认返回0001-01-01 00:00:00 可选字段,需要在输入参数optional_fields中写入才能返回 |
| - waybill | String | 23123123 | 运单号(当厂家自送时运单号可为空,不同物流公司的运单号用|分隔,如果同一物流公司有多个运单号,则用英文逗号分隔) 可选字段,需要在输入参数optional_fields中写入才能返回 |
| - logisticsId | String | 1 | 物流公司ID 可选字段,需要在输入参数optional_fields中写入才能返回 |
| vatInfo | com.jd.open.api.domain.order.VatIncoiceInfo | 增值税发票 可选字段,需要在输入参数optional_fields中写入才能返回 | |
| - vatNo | String | 333344445555 | 纳税人识别号 |
| - addressRegIstered | String | 北京市大兴区 | 注册地址 |
| - phoneRegIstered | String | 13500000000 | 注册电话 |
| - depositBank | String | 北京交通银行大兴支行 | 开户银行 |
| - bankAccount | String | 12131231231231 | 银行账户 |
| - userAddress | String | 北京市大兴区 | 收票人地址 |
| - userName | String | 小张 | 收票人姓名 |
| - userPhone | String | 13500000000 | 收票人电话 |
| - modified | String | 0001-01-01 00:00:00 | 订单更新时间 |
| - directParentOrderId | String | 123213123123 | 直接父订单号 可选字段,需要在输入参数optional_fields中写入才能返回 |
| - parentOrderId | String | 123213123123 | 根父订单号 可选字段,需要在输入参数optional_fields中写入才能返回 |
| - customs | String | 保税区信息 | 保税区信息 |
| - customsModel | String | 直邮 | 保税模型:直邮,保税集货,保税备货 |
| - orderSource | String | 移动端订单 | 订单来源。如:移动端订单 |
| - storeOrder | String | 京仓订单 | 京仓订单/云仓订单/空“” |
| - idSopShipmenttype | Number | 68 | 是否京配。68=京配,69=京配自提 |
| - scDT | String | 最早生产时间 | 最早生产时间/客户的预约出库时间,在此时间之前,订单为暂停。 |
| - serviceFee | String | 618 | 服务费。目前接口无法返回。 |
| 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 | 0001-01-01 00:00:00 | 用户预约时间 |
| - dbDT | String | 0001-01-01 00:00:00 | 最晚出库时间 |
| - ljDT | String | 0001-01-01 00:00:00 | 最晚揽件时间 |
| - taxFee | String | 618 | 税价分离 税费 |
| - tuiHuoWuYou | String | 退货无忧 | 退货无忧 |
| - orderSign | String | 0000000000000000111110000 | sendpay |
| - storeId | String | 23 | 仓库Id |
| - realPin | String | 135566666888_p | 买家的账号信息(区分大小写) 可选字段,需要在输入参数optional_fields中写入才能返回 |
| orderMarkDesc | java.util.Map | 订单标注信息 | |
| - TryBeforePayLater | String | 1 | 京品试订单标注。 1代表是京品试订单 |
| - open_id | String | jd | 买家的账号信息 可选字段,需要在输入参数optional_fields中写入才能返回 |
| - open_id_buyer | String | 135566666888_p | 买家的账号信息(区分大小写) 可选字段,需要在输入参数optional_fields中写入才能返回 |
文档更新时间: 2024-08-01 17:15 作者:admin