增强型订单列表
本接口为增强型订单列表接口,除了订单列表标准的查询条件之外,还可以订单旗帜、卖家备注、宝贝Id等条件查询订单。
1.请求参数:
请求URL:
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴AppId | |
timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
seller_nick | String | 是 | 38173182 | 京东的账号,对应蜂巢授权返回jdseller字段 |
sign | String | 是 |
业务参数
参数名 | 类型 | 是否必须 | 示例值 | 说明 |
---|---|---|---|---|
start_date | Date | True | 2022-08-01 10:00:00 | 订单创建时间或是修改订单 |
end_date | Date | True | 2022-08-01 12:00:00 | 订单创建时间或是修改订单 |
order_state | String | True | 2 | 订单状态, 传入数字(非英文名称), 多个状态用英文逗号隔开. 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号卡/履约/黄金的业务,可传此状态。 |
page | int | 否 | 1 | 当前页,默认1 |
page_size | int | 否 | 50 | 每页大小, 最大500, 每100为一个阶梯 |
sort_type | int | 否 | 0 | 排序类型 1- 降序 ,其它数字:升序 |
date_type | int | 否 | 1 | 查询时间类型,默认按修改时间查询。 1为按订单创建时间查询;2 为按订单(订单状态、修改运单号)修改时间 |
product_id | String | 否 | 10023397463670 | 产品ID |
seller_memo_op | String | 否 | 对卖家备注的操作。 all 或是不传值,卖家备注将不参与查询; eq: 等于 ; ne: 不等于; like: 模糊匹配(包含) | |
seller_flag | int | 否 | 旗帜颜色, 灰(0),RED(1),黄(2),绿(3),蓝(4),紫(5) | |
product_id | Number | 否 | 商品id | |
order_id | Number | 否 | 253929851654 | 订单号, 多个订单号用英文逗号隔开 |
2. 请求示例代码(Java)
请求示例代码
@Test
public void getExtOrderList() 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());
// 必填 状态 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号卡/履约/黄金的业务,可传此状态。
data.put("order_state", "2");
data.put("start_date","2022-11-09 00:00:00" );
data.put("end_date", "2022-11-11 11:00:00");
// 必填 返回页码 默认 1,页码从 1 开始 PS:当前采用分页返回,数量和页数会一起传,如果不传,则采用 默认值
data.put("page", "1");
// 必填 返回数量,默认 100。最大 100
data.put("page_size", "50");
// 非必填 排序类型 1- 降序 ,其它数字:升序
data.put("sortType", "0");
// 非必填 查询时间类型
data.put("dateType", "0");
data.put("product_id", "10023397463670");
// data.put("order_id", "253929851654,253927981481");
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.JDExtOrderListUrl, data);
}
3. 返回结果
{
"code": 0,
"message": "ok",
"data": {
"page": 1,
"total": 1,
"size": 50,
"shop_order_list": [
{
"balanceUsed": "0.00",
"consigneeInfo": {
"city": "普陀区",
"county": "城区",
"fullAddress": "上海普陀区城区连亮路*弄*号* 拒绝丰巢智能柜签收谢谢",
"fullname": "董**",
"mobile": "177*******5",
"province": "上海",
"telephone": "177*******5",
"desen_mobile":"3366663ffdaa11a71ed7ba3cb1d59f919fe278c72e07bc5d5159923478e999bf3f3249",
"desen_telephone":"3366663ffdaa11a71ed7ba3cb1d59f919fe278c72e07bc5d5159923478e999bf3f3249",
"oaid":"YTczNWZmABT5Yz05DTH47QCKVJNOXZu1Yjk1Mnd6GeIdNpe0uZzWY0zGQqKDUe”
},
"couponDetailList": [
{
"couponPrice": "5.07",
"couponType": "39-京豆优惠",
"orderId": "252402592365",
"skuId": ""
},
{
"couponPrice": "5.00",
"couponType": "100-店铺优惠",
"orderId": "252402592365",
"skuId": ""
}
],
"customs": "",
"customsModel": "",
"deliveryType": "任意时间",
"freightPrice": "0.00",
"invoiceInfo": "发票类型:普通发票;发票抬头:个人;发票内容:明细",
"itemInfoList": [
{
"giftPoint": "0",
"itemTotal": "1",
"jdPrice": "149.00",
"outerSkuId": "",
"productNo": "pWDiepjd",
"skuId": "10059455347227",
"skuName": "依迪筱 儿童童装春秋款2022新款风卡通衬衫两件套男童套装 长袖小汽车衬衫套装白色 110cm",
"wareId": "10023049989248"
}
],
"logisticsId": "1499",
"modified": "2022-10-19 10:44:52",
"orderEndTime": "2022-10-12 16:44:58",
"orderId": "252402592365",
"orderPayment": "138.93",
"orderRemark": "",
"orderSellerPrice": "144.00",
"orderSign": "",
"orderStartTime": "2022-10-09 17:59:35",
"orderState": "FINISHED_L",
"orderStateRemark": "完成",
"orderTotalPrice": "149.00",
"parentOrderId": "",
"payType": "4-在线支付",
"paymentConfirmTime": "2022-10-09 17:59:47",
"pin": "jd_77586ceb4b98e",
"returnOrder": "0",
"sellerDiscount": "5.00",
"storeOrder": "",
"vatInvoiceInfo": {
"bankAccount": "",
"depositBank": "",
"registeredAddress": "",
"registeredPhone": "",
"taxpayerIdent": ""
},
"venderId": "12412981",
"venderRemark": "通过蜂巢写入!!!!!!",
"flag":"1",
"waybill": "78622347828059"
}
]
}
}
4. 返回字段说明
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
orderDetailInfo | com.jd.open.api.sdk.domain.order.OrderResult | 订单详细信息 | |
apiResult | com.jd.ac.domain.api.ApiResult | 返回结果 | |
- success | Boolean | true | 是否成功 |
- englishErrCode | String | system exception | 英文错误原因,如果成功,此字段为空 |
- chineseErrCode | String | 系统异常 | 中文错误原因 |
- numberCode | Number | 99999 | 数字错误 |
orderInfo | com.jd.open.api.sdk.domain.order.OrderSearchInfo | 订单信息 | |
- orderId | String | 1212312231 | 订单id |
- venderId | String | 1212312 | 商家id |
- orderType | String | 22 | 订单类型(22 SOP; 75 LOC) 可选字段,需要在输入参数optional_fields中写入才能返回 |
- payType | String | 1 | 支付方式(1货到付款, 2邮局汇款, 3自提, 4在线支付, 5公司转账, 6银行卡转账) |
- orderTotalPrice | String | 618.0 | 订单总金额。总金额=订单金额(不减优惠,不加运费服务费税费) |
- orderSellerPrice | String | 618.0 | 订单货款金额(订单总金额-商家优惠金额) |
- orderPayment | String | 618.0 | 用户应付金额。应付款=货款-用户优惠-余额+运费+税费+服务费 |
- freightPrice | String | 618.0 | 商品的运费 |
- sellerDiscount | String | 618.0 | 商家优惠金额 |
- orderState | String | WAIT_SELLER_DELIVERY | 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 等待发码(LOC订单特有状态) |
- 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 | 2132123123@QQ.com | 电子发票联系人邮箱 |
- invoiceConsigneePhone | String | 13456788765 | 电子发票联系人手机号 |
- invoiceCode | String | 1213213231231 | 发票纳税人识别号 |
- invoiceInfo | String | 发票信息 | 发票信息。电子发票请从invoiceEasyInfo里取 “invoice_info: 不需要开具发票”下无需开具发票;其它返回值请正常开具发票 |
- invoiceCode | String | 343434 | 普通发票纳税人识别码 |
- orderRemark | String | 红色 | 买家下单时订单备注 |
- orderStartTime | String | 2020-03-16 22:28:32 | 下单时间 |
- orderEndTime | String | 2020-03-16 22:28:32 | 结单时间 如返回信息为“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 | 13556788765 | 固定电话 |
- mobile | String | 13556788765 | 手机 |
- fullAddress | String | 广东河源市紫金县瓦溪镇老道班代收 | 地址 |
- province | String | 河北 | 省 |
- city | String | 承德市 | 市 |
- county | String | 围场县 | 县 |
- town | String | 围场镇 | 镇 |
- provinceId | String | 1234 | 省Id |
- cityId | String | 222 | 市Id |
- countyId | String | 234 | 县Id |
- townId | String | 4567 | 镇Id |
- desen_telephone | String | 13556788765 | 固定电话密文 |
- desen_mobile | String | 13556788765 | 手机密文 |
itemInfoList | java.util.List | 商品详细信息 | |
— | com.jd.open.api.sdk.doamin.order.ItemInfo | ||
- skuId | String | 1213213231231 | 京东内部SKU的ID |
- outerSkuId | String | 1213213231231 | SKU外部ID(极端情况下不保证返回,建议从商品接口获取 |
- skuName | String | 手机 | 商品的名称+SKU规格 |
- jdPrice | String | 618.0 | SKU的京东价 |
- giftPoint | String | 618 | 赠送积分 |
- wareId | String | 1213213231231 | 京东内部商品ID(极端情况下不保证返回,建议从商品接口获取) |
- itemTotal | String | 2 | 数量 |
- productNo | String | 1213213231231 | 货号 |
- serviceName | String | 服务项名称 | 服务项名称 |
- newStoreId | String | 34 | item维度的仓库id |
couponDetailList | java.util.List | 优惠详细信息 | |
— | com.jd.open.sdk.domain.order.CouponDetail | ||
- orderId | String | 1213213231231 | 订单编号 |
- skuId | String | 1213213231231 | 京东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中写入才能返回 |
flag | String | 1 | 旗标颜色标识, 灰(0),RED(1),黄(2),绿(3),蓝(4),紫(5) |
- balanceUsed | String | 618.0 | 余额支付金额 可选字段,需要在输入参数optional_fields中写入才能返回 |
- pin | String | jd | 买家的账号信息 可选字段,需要在输入参数optional_fields中写入才能返回 |
- returnOrder | String | 00 | 售后订单标记 0:不是换货订单 1返修发货,直接赔偿,客服补件 2售后调货 可选字段,需要在输入参数optional_fields中写入才能返回 |
- paymentConfirmTime | String | 2020-03-16 22:28:32 | 付款确认时间 如果没有付款时间 默认返回0001-01-01 00:00:00 可选字段,需要在输入参数optional_fields中写入才能返回 |
- waybill | String | 132312 | 运单号(当厂家自送时运单号可为空,不同物流公司的运单号用|分隔,如果同一物流公司有多个运单号,则用英文逗号分隔) 可选字段,需要在输入参数optional_fields中写入才能返回 |
- logisticsId | String | 12 | 物流公司ID 可选字段,需要在输入参数optional_fields中写入才能返回 |
vatInfo | com.jd.open.api.domain.order.VatIncoiceInfo | 增值税发票 可选字段,需要在输入参数optional_fields中写入才能返回 | |
- vatNo | String | 普通纳税人识别码 | 纳税人识别号 |
- addressRegIstered | String | 北京市大兴区 | 注册地址 |
- phoneRegIstered | String | 13233345678 | 注册电话 |
- depositBank | String | 中国人民银行 | 开户银行 |
- bankAccount | String | 银行账号 | 银行账户 |
- userAddress | String | 北京大兴区 | 收票人地址 |
- userName | String | 张三 | 收票人姓名 |
- userPhone | String | 13233345678 | 收票人电话 |
- modified | String | 2020-03-16 22:28:32 | 订单更新时间 |
- directParentOrderId | String | 1213213123 | 直接父订单号 可选字段,需要在输入参数optional_fields中写入才能返回 |
- parentOrderId | String | 1213213123 | 根父订单号 可选字段,需要在输入参数optional_fields中写入才能返回 |
- customs | String | 保税区信息 | 保税区信息 |
- customsModel | String | 保税集货 | 保税模型:直邮,保税集货,保税备货 |
- orderSource | String | 移动端订单 | 订单来源。如:移动端订单 |
- storeOrder | String | 京仓订单 | 京仓订单/云仓订单/空值“” |
- idSopShipmenttype | Number | 68 | 是否京配。68=京配,69=京配自提。 |
- scDT | String | 2020-03-16 22:28:32 | 最早生产时间。预约出库时间 |
- serviceFee | String | 618.0 | 服务费。目前没有此值 |
pauseBizInfo | com.jd.ac.domain.api.offline.OrderInfoResultPauseBizInfo | 订单暂停业务数据 | |
pauseBizStatusList | java.util.List | 订单暂停业务处理状态集 | |
— | com.jd.ac.domain.api.offline.OrderInfoResultPauseBizInfo.PauseBizStatus | ||
- bizType | Number | 2 | 业务类型 |
- bizStatus | Number | 21 | 业务处理状态 |
pauseBizDataYy | com.jd.ac.domain.api.offline.OrderInfoResultPauseBizInfo.PauseBizDataYy | 订单暂停业务数据(预约日历) | |
- codDT | String | 2020-03-16 22:28:32 | 用户预约时间 |
- dbDT | String | 2020-03-16 22:28:32 | 最晚出库时间 |
- ljDT | String | 2020-03-16 22:28:32 | 最晚揽件时间 |
- taxFee | String | 618.0 | 税价分离 税费 |
- tuiHuoWuYou | String | 退货无忧 | 退货无忧 |
- orderSign | String | 00000000001100000 | sendpay |
- storeId | String | 12 | 仓库Id |
- realPin | String | 12699992922_p | 买家的账号信息(区分大小写) 可选字段,需要在输入参数optional_fields中写入才能返回 |
orderMarkDesc | java.util.Map | 订单标注信息 | |
- TryBeforePayLater | String | 1 | 京品试订单标注。1代表是京品试订单 |
- declarationStatus | String | 1 | 订单申报状态 |
- declarationDesc | String | 清关成功 | 订单申报状态描述 |
- open_id | String | jd | 买家的账号信息 可选字段,需要在输入参数optional_fields中写入才能返回 |
- open_id_buyer | String | 12699992922_p | 买家的账号信息(区分大小写) 可选字段,需要在输入参数optional_fields中写入才能返回 |
文档更新时间: 2024-07-05 15:02 作者:admin