增强型订单列表

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

1.请求参数:

请求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 订单号, 多个订单号用英文逗号隔开

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