获取订单列表

根据条件检索订单信息 (仅适用于SOP、LBP,SOPL类型,FBP类型请调取FBP订单检索 )
建议使用《获取订单列表增强型》接口,查询条件更全,同时返回oaid(用于合单)

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/jd/order/ensearch

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
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