全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

根据条件检索订单信息(基础接口)


接口地址: http://api.vv-tool.com/tool/erps/jdordersearch


接口介绍: 根据条件检索订单信息 (仅适用于 SOP 类型,且只能查出达到生产条件的订单,FBP 类型请调取 FBP 订单检索 )


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 请求次数收费,联系运营


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

名称 类型 必须 示例值 描述
owner_id String 店铺 ownerId
start_date String 示例:2018-11-14 10:00:00 以订单创建时间或者更新时间检索(开始时间和结束时间,不得相差超过 1 个月。)
end_date String 示例:2018-12-14 10:00:00 (开始时间和结束时间,不得相差超过 1 个月。)
order_state String 示例: WAIT_SELLER_STOCK_OUT, WAIT_GOODS_RECEIVE_CONFIRM 多订单状态可以用英文逗号隔开,请不要使用数字,请用英文逗号拼接英文状态传递给 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 temInfoList,orderId,isShipmenttype,scDT,idSopShipmenttype,orderStartTime 需返回的字段列表。必填,不填或者为空则请求被拒绝。请参考返回结果集中的对象参数描述:orderInfo 结构体中的所有字段;字段之间用,分隔
page String 1 查询的页数。
page_size String 20 每页的条数(最大 page_size 50 条)建议:50
vvtype int 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2

请求示例

{
   owner_id:12345
start_date:2022-01-14 10:00:00
end_date:2022-02-14 10:00:00
page:1
order_state:WAIT_SELLER_STOCK_OUT
page_size:20
optional_fields:orderId,payType,orderTotalPrice,orderPayment,orderSellerPrice,freightPrice,sellerDiscount,orderState,orderStateRemark,deliveryType,invoiceInfo,orderRemark,orderStartTime,orderEndTime,consigneeInfo,itemInfoList,couponDetailList,returnOrder,venderRemark,pin,balanceUsed,modified,paymentConfirmTime,logisticsId,waybill,invoiceCode,orderSource,storeOrder,waybill
order_id:236587500875
}

请求代码示例

cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例

响应参数

名称 类型 示例值 描述
searchorderinfo_result com.jd.ac.domain.api.offline.OrderListResult 结果集
apiResult com.jd.ac.domain.api.ApiResult 返回结果
-success Boolean false 是否成功
-englishErrCode String client validate does not pass or exist problem 英文错误信息(client validate does not pass or exist problem;system exception;there is no available order state parameter;contain empty order state;order state is wrong;order state is not suitable for the business;page is not numeric;pageSize is not numeric;page is littler than 1 or too large;pageSize is littler than 1 or larger than 100;there is only available endDate or only available beginDate;endDate is not date type;beginDate is not date type;endDate is before beginDate;interval between beginDate and endDate is more than one month;es exception;search order detail is error)
-chineseErrCode String 客户端校验没通过或有问题 中文错误信息(客户端校验没通过或有问题;系统异常;订单状态参数为空或不存在;含有空的订单状态;订单状态不正确;订单状态不适用于当前商家;页数不是数字格式;每页行数不是数字格式;页数小于 1 或者太大;每页行数大于 100 或者小于 1;只有开始时间或者只有结束时间;结束时间不是日期类型;开始时间不是日期类型;结束时间早于开始时间;结束时间和开始时间的间隔大于 1 个月;ES 查询异常;查询订单明细失败)
-numberCode Number 10500001 错误码(10500001;999999;10100019;10100020;10100021;10100022;10100023;10100024;10100025;10100026;10100031;10100028;10100027;10100029;10100030;13200004;10100043)
-orderTotal Number 100 订单的总数量
orderInfoList java.util.List 订单信息列表
--- com.jd.open.api.sdk.domain.order.OrderSearchInfo
-orderId String 45612313 订单 id
-venderId String 281201 商家 id
-orderType String 22 订单类型(22 SOP;75 LOC;21 FBP 订单,112 FCS,FBP 请用 fbp.search 接口查询) 可选字段,需要在输入参数 optional_fields 中写入才能返回
-payType String 1 支付方式(1 货到付款, 2 邮局汇款, 3 自提, 4 在线支付, 5 公司转账, 6 银行卡转账)
-orderTotalPrice String 20.00 订单总金额。总金额 = 订单金额(不减优惠,不加运费服务费税费)
-orderSellerPrice String 100 订单货款金额(订单总金额-商家优惠金额)
-orderPayment String 50 用户应付金额。应付款 = 货款-用户优惠-余额 + 运费 + 税费 + 服务费。
-freightPrice String 10 商品的运费
-sellerDiscount String 20 商家优惠金额。如:20-套装优惠, 28-闪团优惠, 29-团购优惠, 30-单品促销优惠, 35-满返满送(返现),100-店铺优惠
-orderState String DengDaiChuKu 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 等待发码 9)PAUSE 暂停(等待出库之前的状态) 10)DELIVERY_RETURN 配送退货 11)UN_KNOWN 未知 请联系运营
-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 21 发票内容。如明细。
-invoiceConsigneeEmail String 电子发票联系人邮箱
-invoiceConsigneePhone String 18311111111 电子发票联系人手机号
-invoiceCode String VLN2131312321 发票纳税人识别号
-invoiceInfo String 1 发票信息: 1. “不需要开具发票”情况下无需开具发票;2.其它返回值请正常开具发票 。(没有电子发票具体信息)
-invoiceCode String 普通发票纳税人识别码
-orderRemark String 尽快发货 买家下单时订单备注
-orderStartTime String 2019-01-01 12:12:12 下单时间,订单创建时间
-orderEndTime String 2019-01-01 12:12:12 结单时间 。如返回信息为“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-2553791 固定电话
-mobile String 18311111111 手机
-fullAddress String 河北廊坊市三河市齐心庄镇 地址
-province String 河北省
-city String 廊坊市
-county String 三河市
-town String 齐心庄镇
-provinceId String 5 省 Id
-cityId String 274 市 Id
-countyId String 49707 县 Id
-townId String 49968 镇 Id
-desen_telephone String 010-2553791 固定电话
-desen_mobile String 18311111111 手机
itemInfoList java.util.List 商品详细信息列表
--- com.jd.open.api.sdk.doamin.order.ItemInfo
-skuId String 45123213 京东内部 SKU 的 ID
-outerSkuId String 1233242 SKU 外部 ID(极端情况下不保证返回,建议从商品接口获取)
-skuName String 测试商品 商品的名称 +SKU 规格
-jdPrice String 100 SKU 的京东价
-giftPoint String 50 赠送积分
-wareId String 451261 京东内部商品 ID(极端情况下不保证返回,建议从商品接口获取)
-itemTotal String 1 商品总数量
-productNo String 45671231 货号。
-serviceName String 服务项名称
-newStoreId String 21 item 维度的仓库 id。
-itemExt String item 维度的扩展信息;包括服务项数据、黄金珠宝、医疗器械,门店 id 等订单标识。黄金珠宝标识:zszs=1;serviceId,家具服务,市区站点自提 1101,送货上门 1102,送货上门安装 1103,送货上门安装 (200 城市免送装)1104;建材服务,市区站点自提 1105,送货上门 1106,送货上门安装 1107;运动器材服务,市区站点自提 3702,送货上门 3902,送货上门安装 3903 ; 门店 id 对应的 key:locShopId(只有门店服务的订单,扩展信息里面才有这个节点)
couponDetailList java.util.List 优惠详细信息列表
--- com.jd.open.sdk.domain.order.CouponDetail
-orderId String 4521311 订单编号
-skuId String 京东 sku 编号。(只有 30-单品促销优惠 此 skuId 才非空)
-couponType String 20 优惠类型: 20-套装优惠, 28-闪团优惠, 29-团购优惠, 30-单品促销优惠, 34-手机红包, 35-满返满送(返现), 39-京豆优惠,41-京东券优惠, 52-礼品卡优惠,100-店铺优惠
-couponPrice String 100 优惠金额。isv 请联系服务市场类目运营,商家请联系店铺运营。
-venderRemark String 会尽快发货(请去备注接口获取) 请去备注接口获取
-balanceUsed String 100 余额支付金额 。可选字段,需要在输入参数 optional_fields 中写入才能返回
-pin String testpin 买家的账号信息 。可选字段,需要在输入参数 optional_fields 中写入才能返回
-returnOrder String 0 售后订单标记。 0:不是换货订单 1 返修发货,直接赔偿,客服补件 2 售后调货 。可选字段,需要在输入参数 optional_fields 中写入才能返回
-paymentConfirmTime String 2019-01-01 12:12:12 付款确认时间 。如果没有付款时间 返回 null。可选字段,需要在输入参数 optional_fields 中写入才能返回
-waybill String VL21309123 运单号(当厂家自送时运单号可为空,不同物流公司的运单号用“
-logisticsId String 21 物流公司 ID 。可选字段,需要在输入参数 optional_fields 中写入才能返回
vatInfo com.jd.open.api.domain.order.VatIncoiceInfo 增值税发票(专票),普通发票,普通电子发票 可选字段,需要在输入参数 optional_fields 中写入才能返回(发票相关扩展字段)
-vatNo String VL23213109 纳税人识别号
-addressRegIstered String 注册地址
-phoneRegIstered String 18311111111 注册电话
-depositBank String 北京市银行 开户银行
-bankAccount String 银行账户
-userAddress String 北京市大兴区 收票人地址
-userName String 张三 收票人姓名
-userPhone String 1831111111 收票人电话
-invoicePersonalName String 李四 普通发票,电子普通发票的个人姓名
-desen_userPhone String 1831111111 收票人电话
-modified String 2019-01-01 12:12:12 订单更新时间
-directParentOrderId String 457612313 直接父订单号 。当一个订单被拆多次时,此值为直接上级父单 ID。需要在输入参数 optional_fields 中写入才能返回
-parentOrderId String 457612313 根父订单号。当一个订单被拆多次时,此值为最上级父单 ID。 可选字段,需要在输入参数 optional_fields 中写入才能返回
-customs String 如广州南沙保税区、北京保税区等 保税区信息:如广州南沙保税区、北京保税区等(具体的保税区域地点)
-customsModel String 直邮,保税集货,保税备货 保税模型:直邮,保税集货,保税备货(保税的模式,目前只有三种)
-orderSource String 拍拍订单 订单来源。如:移动端订单、PC 端订单、手 Q 订单、微信订单、拍拍订单、农村电商
-storeOrder String 京仓订单 值为字符串的文字。当 ordertype 为 22 的时候, 如,“京仓订单“,“云仓订单”,空字符串(“”),京仓、云仓订单,商家请勿发货。
-idSopShipmenttype Number 68 是否京配。68= 京配,69= 京配自提,67= 第三方快递。71= 同城配送(当是 71 时请通过 jingdong.pop.order.getOrderExtInfoByOrderId 接口获取配送时效信息)
-scDT String 2019-01-01 12:12:12 最早生产时间/客户的预约出库时间,在此时间之前,订单为暂停。
-serviceFee String 100 服务费。目前接口无法返回。
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 2018-02-02 00:00:00 用户预约时间。只有到了这个时间,订单才可生产(出库发货)。
-dbDT String 2018-02-02 00:00:00 最晚出库时间
-ljDT String 2018-02-02 00:00:00 最晚揽件时间
-taxFee String 100 全球购业务下的税费,包含了“税价分离”和“包税”模式。
-tuiHuoWuYou String 退货无忧
-orderSign String sendpay,京东侧的订单标记,可忽略。
-storeId String 12 仓库 Id。
-menDianId String 21 门店 Id。门店业务下,京东分单、商家分单时,此 ID 有值。
-mdbStoreId String 121 门店帮 Id。线下门店导购员销售时的订单。
-salesPin String testpin01 导购员 pin。线下门店导购员销售的订单,导购员的标记
originalConsigneeInfo com.jd.open.api.sdk.domain.order.UserInfo 集运订单客户真实收获地址(仅集运订单即 sendpay 第 124 位为 7 的订单有这个字段)
-fullname String 张三 姓名
-telephone String 0102553701 固定电话
-mobile String 18222222222 手机
-fullAddress String 河北廊坊市三河市齐心庄镇 详细地址
-province String 河北省
-city String 廊坊市
-county String 三河市
-town String 齐心庄镇
-provinceId String 5 省 Id
-cityId String 274 市 Id
-countyId String 49707 县 Id
-townId String 49968 镇 Id
-desen_telephone String 0102553701 固定电话
-desen_mobile String 18222222222 手机
-orderExt String 订单维度扩展字段,json; 订单维度扩展字段,json;
orderMarkDesc java.util.Map 订单标注描述
-TryBeforePayLater String 1 京品试订单标注描述。1 代表是京品试订单
-realPin String testPin 买家的账号信息 真实 Pin 信息。可选字段,需要在输入参数 optional_fields 中写入才能返回
-sendpayMap String {“301”:“1”,“501”:“1”,“509”:“1”,”688”:”2”,“559”:“2”,“599”:”7”} 包含 sendpay 所有打标逻辑,500 位后的 sendpay 打标逻辑只有这个字段有 * 示例:{“301”:“1”,“501”:“1”,“509”:“1”,”688”:”2”,“559”:“2”,“599”:”7”}
-open_id_buyer String testpin 买家的账号信息 。可选字段,需要在输入参数 optional_fields 中写入才能返回
-open_id_seller String testpin01 导购员 pin。线下门店导购员销售的订单,导购员的标记
withholding_money int 该接口扣费金额(点券)

返回数据

{
    注:京东隐私号针对手机号与电话做了脱敏展示 如:152*******9 
手机号加密字段:desen_mobile 由一个70字符长度组成的,建议持久化该字段,取号时需要将收货人mobile字段与phone字段分别替换成desen_mobile、desen_telephone字段
如果该字段为空请正常方式取号,具体取号方式参考 获取单号接口(无界电子面单)
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
     "withholding_money":4,
  "jingdong_pop_order_search_responce": {
    "code": "0",
    "searchorderinfo_result": {
      "orderInfoList": [
        {
          "orderStateRemark": "等待出库",
          "orderRemark": "售后返修换新!服务单号:1084121296#返修发货#原订单号:210401983773",
          "logisticsId": "",
          "orderSellerPrice": "0.00",
          "venderRemark": "测试,测试商品上限20,5565",
          "orderState": "WAIT_SELLER_STOCK_OUT",
          "consigneeInfo": {
            "provinceId": "2",
            "fullAddress": "上海静安区城区南京西路688临688广场写字楼",
            "cityId": "2817",
            "townId": "0",
            "city": "静安区",
            "county": "城区",
            "province": "上海",
            "telephone": "152*******9",
            "fullname": "蔷薇",
            "countyId": "51973",
            "mobile": "152*******9",
            "desen_mobile": "36306660fed30636897885eea70735bdc23808710feded8127719cd327c39ba579a7c8", 
            "desen_telephone": "36306660fed30636897885eea70735bdc23808710feded8127719cd327c39ba579a7c8"
          },
          "modified": "2021-07-01 13:51:16",
          "orderPayment": "0.00",
          "payType": "4-在线支付",
          "itemInfoList": [
            {
              "productNo": "TTB06x56000",
              "itemTotal": "1",
              "jdPrice": "0.00",
              "skuName": "OMS测试测试1-TNF升仓测试(不要拍)55周四14:22 Vans商品sit 42",
              "invoiceContentId": "",
              "itemExt": "{\"skuUuid\":\"10_0_0_10030799020248_1_0\",\"isVMI\":0,\"upc\":\"\",\"newStoreId\":\"0\"}",
              "newStoreId": "0",
              "outerSkuId": "VN00018BGZ5105000M",
              "skuId": "10030799020248",
              "wareId": "10020316102459",
              "giftPoint": "0"
            }
          ],
          "storeId": "0",
          "orderTotalPrice": "0.00",
          "invoiceEasyInfo": {
            "invoiceType": "0",
            "invoiceContentId": "1",
            "invoiceTitle": "个人"
          },
          "paymentConfirmTime": "2021-07-01 13:51:15",
          "orderSign": "",
          "orderExt": "{\"road\":\"019\"}",
          "returnOrder": "1",
          "storeOrder": "",
          "invoiceInfo": "不需要开具发票",
          "orderStartTime": "2021-07-01 13:51:15",
          "orderId": "210411391226",
          "waybill": "",
          "orderSource": "PC端订单",
          "deliveryType": "任意时间",
          "balanceUsed": "0.00",
          "pin": "吕15221035459",
          "freightPrice": "0.00",
          "sellerDiscount": "0.00"
        }
      ],
      "orderTotal": 37,
      "apiResult": {
        "englishErrCode": "success",
        "success": true,
        "chineseErrCode": "成功",
        "numberCode": 10100000
      }
    }
  }
}


响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权