-
抖音接口
点击展开 点击收起 -
快手接口
点击展开 点击收起 -
拼多多接口
点击展开 点击收起 -
京东接口
点击展开 点击收起 -
小红书接口
点击展开 点击收起 -
视频号接口
点击展开 点击收起 -
淘宝接口
点击展开 点击收起
jingdong.pop.order.enSearch
( 根据条件检索订单信息 )
根据条件检索订单信息
（仅适用于SOP、LBP，SOPL类型，FBP类型请调取FBP订单检索 ）
公共参数
请求地址及方法
| 预发布环境地址 | 生产环境地址 | 调用方法 |
|
https://api-dev.jd.com/routerjson |
https://api.jd.com/routerjson |
API调用方法，点击查看 |
公共请求参数:
| 名称 | 类型 | 必须 | 描述 |
| method | String | 是 | API接口名称 |
| access_token | String | 是 | 采用OAuth授权方式为必填参数 |
| app_key | String | 是 | 应用的app_key |
| sign | String | 是 | 签名 |
| timestamp | String | 是 | 时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为10分钟 |
| format | String | 否 | 暂时只支持json |
| v | String | 否 | 版本：2.0 |
请求参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|
-
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为按订单创建时间查询；其它数字为按订单（订单状态、修改运单号）修改时间 |
响应参数
| 名称 | 类型 | 示例值 | 描述 |
 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 | 133*******1 | 电子发票联系人手机号 |
|
-
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 | 010*******1 | 固定电话 |
|
-
mobile
|
String | 133*******1 | 手机 |
|
-
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 |
|
-
oaid
|
String | Qq1n94pda1EQrStSqtaqT3A4GGEDi63Mfrz1ay7EAcbCZo1a2YNR2PaCwwY5N6UJnTHYVykvsEbkG16Zd2urHXtJsqMLrSjnqvnDixd2A6Afmqzc9mgtZXiw2CJajYrWqXJtVcbhDXQGhqS3UYspUq6Mi9VEBmQzbeYgnfwwoc3MMGSF1vhPTXvfJe6QwGF | 收件人唯一标识，长度为256 |
|
-
desen_telephone
|
String | 010*******1 | 固定电话 |
|
-
desen_mobile
|
String | 133*******1 | 手机 |
|
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 | 133*******1 | 收票人电话 |
|
-
modified
|
String | 0001-01-01 00:00:00 | 订单更新时间 |
|
-
directParentOrderId
|
String | 123213123123 | 直接父订单号 可选字段，需要在输入参数optional_fields中写入才能返回 |
|
-
parentOrderId
|
String | 123213123123 | 根父订单号 可选字段，需要在输入参数optional_fields中写入才能返回 |
|
-
customs
|
String | BX12993 | 保税区信息 |
|
-
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 | 业务类型 1-预约日历业务暂停 2-3C号卡业务暂停 |
|
-
bizStatus
|
Number | 2 | 业务处理状态 0-未处理 1-处理成功 |
|
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 | 1.00 | 退货无忧 |
|
-
orderSign
|
String | 0000000000000000111110000 | sendpay |
|
-
storeId
|
String | 23 | 仓库Id |
|
-
realPin
|
String | 135566666888_p | 买家的账号信息(区分大小写) 可选字段，需要在输入参数optional_fields中写入才能返回 |
|
orderMarkDesc
|
java.util.Map | 订单标注信息 | |
|
-
TryBeforePayLater
|
String | 1 | 京品试订单标注。 1代表是京品试订单 |
|
ctpOrderInfo
|
com.jd.ac.domain.api.offline.OutPlatformOrderInfo | ctp订单信息 | |
|
-
ctpOrderId
|
String | 123456 | ctp订单号 |
|
-
ctpParentOrderId
|
String | 12345678 | ctp父订单号 |
|
-
ctpShopId
|
String | 12345 | ctp店铺id |
|
-
ctpWhere
|
String | 北京亦庄经济技术开发区科创十一街18号院(加密) | ctp用户收件人详细地址 |
|
-
ctpName
|
String | 张三（加密） | ctp用户收件人姓名 |
|
-
ctpMobile
|
String | 12345678（加密） | ctp用户的收件人电话 |
|
partialLogisticsInfoModel
|
java.util.List | 分批发货信息集合 | |
|
---
|
com.jd.ac.domain.api.offline.PartialLogisticsInfoModel | ||
|
-
shipmentId
|
Number | 1 | 分批发货的批次号 |
|
-
logicId
|
String | 21 | 物流公司ID |
|
-
waybillId
|
String | SF534221 | 运单号 |
|
-
packageNum
|
Number | 1 | 包裹数量 |
|
-
shipmentTime
|
Number | 1701832886381 | 包裹发货时间 |
|
-
shipmentModifyTime
|
Number | 1701834160260 | 包裹修改时间 |
|
skus
|
java.util.List | 分批发货商品详细信息列表 | |
|
---
|
com.jd.ac.domain.api.offline.PartialShipmentGoodsModel | ||
|
-
skuUuid
|
String | 1012_12345 | 商品uuid |
|
-
skuId
|
Number | 12345 | 商品ID |
|
-
num
|
Number | 1 | 商品数量 |
|
-
popSignMap
|
String | {“17”：“2”,“11”：“1”} | POP订单标记 |
|
-
open_id
|
String | jd | 买家的账号信息 可选字段，需要在输入参数optional_fields中写入才能返回 |
|
-
open_id_buyer
|
String | 135566666888_p | 买家的账号信息(区分大小写) 可选字段，需要在输入参数optional_fields中写入才能返回 |