获取订单列表(增强版）

增强型订单列表

本接口为增强型订单列表接口，除了订单列表标准的查询条件之外，还可以订单旗帜、卖家备注、宝贝Id等条件查询订单。

一、请求参数

请求URL:

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

公共参数

参数名称	参数类型	是否必须	示例值	参数描述
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	订单号, 多个订单号用英文逗号隔开
sysid	Number	是		应用ID

二、请求示例代码

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);
    }

三、返回结果

{
    "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",
                        "itemExt": "{\"skuUuid\":\"1012_F1Z2WA1437114534173663232\",\"isVMI\":0,\"tsfw\":\"p24,p96\",\"newStoreId\":\"0\",\"cid\":\"35048\"}"
                    }
                ],
                "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"
            }
        ]
    }
}

四、返回字段说明

名称	类型	示例值	描述
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](mailto: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中写入才能返回