跳转到内容
Cheeli 文档
返回官网

获取订单详情

输入单个订单id，得到所有相关订单信息,支持最多支持100个订单

一、请求参数

请求URL:

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

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
appid String 是 合作伙伴AppId
timestamp String 是 1657525936 当前Unix时间戳，秒
seller_nick String 是 38173182 京东的账号，对应蜂巢授权返回jdseller字段
sign String 是

业务参数

参数名 类型 是否必须 示例值 说明
order_id String 否 253929851654 订单号, 多个订单号用英文逗号隔开

二、请求示例代码

Java

请求示例代码

@Test
      public void getOrder() 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_id","252402592365,254921934608" );
        // 参数签名
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.JDGetOrderUrl, data);
    }

三、返回结果

三（一）、成功返回

{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "code": 0,
            "msg": "",
            "orderId": 252402592365,
            "orderInfo": {
                "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",
                "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": "通过蜂巢写入!!!!!!",
                "waybill": "78622347828059"
            }
        },
        {
            "code": 0,
            "msg": "",
            "orderId": 254921934608,
            "orderInfo": {
                "balanceUsed": "0.00",
                "consigneeInfo": {
                    "city": "房山区",
                    "county": "良乡地区",
                    "fullAddress": "北京房山区良乡地区北京市良乡镇大学城理工睿府*号院*号楼*单元*",
                    "fullname": "马**",
                    "mobile": "136*******0",
                    "province": "北京",
                    "telephone": "136*******0"
                },
                "couponDetailList": [
                    {
                        "couponPrice": "",
                        "couponType": "",
                        "orderId": "",
                        "skuId": ""
                    }
                ],
                "customs": "",
                "customsModel": "",
                "deliveryType": "任意时间",
                "freightPrice": "0.00",
                "invoiceInfo": "不需要开具发票",
                "itemInfoList": [
                    {
                        "giftPoint": "0",
                        "itemTotal": "1",
                        "jdPrice": "229.00",
                        "outerSkuId": "",
                        "productNo": "eYemF2E7",
                        "skuId": "10060645851303",
                        "skuName": "依迪筱 女童涤纶(聚酯纤维)马甲秋冬装2022新款洋气中大童女外穿儿童加厚连帽马甲外套 粉红色 140cm",
                        "wareId": "10023120664039"
                    }
                ],
                "logisticsId": "",
                "modified": "2022-10-19 17:53:23",
                "orderEndTime": "",
                "orderId": "254921934608",
                "orderPayment": "229.00",
                "orderRemark": "",
                "orderSellerPrice": "229.00",
                "orderStartTime": "2022-10-19 17:53:17",
                "orderState": "WAIT_SELLER_STOCK_OUT",
                "orderStateRemark": "等待出库",
                "orderTotalPrice": "229.00",
                "parentOrderId": "",
                "payType": "4-在线支付",
                "paymentConfirmTime": "2022-10-19 17:53:22",
                "pin": "g8cU0eW6nntMwWYTL7R/5fNJnUy9hN8ufWY3HN1Fxh9opATs5SMV6NgeERqCKNGe",
                "returnOrder": "0",
                "sellerDiscount": "0.00",
                "storeOrder": "",
                "vatInvoiceInfo": {
                    "bankAccount": "",
                    "depositBank": "",
                    "registeredAddress": "",
                    "registeredPhone": "",
                    "taxpayerIdent": ""
                },
                "venderId": "12412981",
                "venderRemark": "明天再发",
                "flag":"1",
                "waybill": ""
            }
        }
    ]
}

说明： code为0表示成功，非0为失败，message会包含失败原因,每个订单的获取成功与否见内层的code值.

四、返回字段说明

名称 类型 示例值 描述
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 xxxxxxxxxx 固定电话密文
- desen_mobile String xxxxxxxxxx 手机密文
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中写入才能返回