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

检索单个 SOP 订单信息


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


接口介绍: 输入单个 SOP 订单 id,得到所有相关订单信息


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


请求方式: POST


返回格式: JSON


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


频率限制: 10 次/秒


请求头参数

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

请求参数

名称 类型 必须 示例值 描述
owner_id String 店铺 ownerId
order_state String WAIT_SELLER_DELIVERY 多订单状态可以用英文逗号隔开 请用英文逗号拼接英文状态传递给 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 venderId,orderType,payType 字段详见下述字段
order_id Number 123456789 订单号
vvtype int 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2

请求示例

{
owner_id:624092
order_id:233819152924
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
}

请求代码示例

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

响应参数

名称 类型 示例值 描述
orderDetailInfo com.jd.open.api.sdk.domain.order.OrderResult 订单详细信息
apiResult com.jd.ac.domain.api.ApiResult 返回结果
-success Boolean true 是否成功,true 或者 false
-englishErrCode String system exception 英文错误原因(Pls reduce the frequency and try again later;client validate does not pass or exist problem;system exception;orderId is not largger than 0 or is null;es exception),如果成功,此字段为空。
-chineseErrCode String 系统异常 中文错误原因(访问太频繁,请降低频率,稍后重试;客户端校验没通过或有问题;系统异常;订单 ID 不大于 0 或者为空;ES 查询异常),如果成功,此字段为空
-numberCode Number 999999 数字错误(-110000;10500001;999999;10100002;13200004)
orderInfo com.jd.open.api.sdk.domain.order.OrderSearchInfo orderInfo
-orderId String 67834311 订单 id
-venderId String 177187 商家 id,商家编号
-orderType String 22 订单类型(22 SOP; 75 LOC;21:FBP,112:FCS,142:IBS) 可选字段,需要在输入参数 optional_fields 中写入才能返回
-payType String 4 支付方式(1 货到付款, 2 邮局汇款, 3 自提, 4 在线支付, 5 公司转账, 6 银行卡转账)
-orderTotalPrice String 100 订单总金额。总金额 = 订单金额(不减优惠,不加运费服务费税费)
-orderSellerPrice String 80 订单货款金额(订单总金额-商家优惠金额)
-orderPayment String 90 用户应付金额。应付款 = 货款-用户优惠-余额 + 运费 + 税费 + 服务费
-freightPrice String 10 商品的运费
-sellerDiscount String 20 商家优惠金额
-orderState String WAIT_SELLER_STOCK_OUT 订单状态(英文);枚举值: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 订单特有状态) 9)PAUSE 暂停(等待出库之前的状态) 10)DELIVERY_RETURN 配送退货 11)UN_KNOWN 未知 请联系运营
-orderStateRemark String 等待出库 订单状态说明(中文)
-deliveryType String 只工作日送货(双休日、假日不用送) 送货(日期)类型(1-只工作日送货(双休日、假日不用送);2-只双休日、假日送货(工作日不用送);3-工作日、双休日与假日均可送货;其他值-返回“任意时间”)
invoiceEasyInfo com.jd.ac.domain.api.offline.InvoiceEasyInfo 发票组装信息。电子发票从这里获取。可替代 invoiceInfo
-invoiceType String 3 发票类型,0= 不开发票、1= 普通发票、2= 增值税发票(专票)、3= 电子发票
-invoiceTitle String 发票抬头 发票抬头。个人/公司名称
-invoiceContentId String 发票内容 发票内容
-invoiceConsigneeEmail String 电子发票联系人邮箱 电子发票联系人邮箱
-invoiceConsigneePhone String 13222222222 电子发票联系人手机号
-invoiceCode String 1WEUO2384329SD 发票纳税人识别号
-invoiceInfo String 发票信息。电子发票请从 invoiceEasyInfo 里取 “invoice_info: 不需要开具发票”下无需开具发票;其它返回值请正常开具发票 发票信息。电子发票请从 invoiceEasyInfo 里取 “invoice_info: 不需要开具发票”下无需开具发票;其它返回值请正常开具发票
-invoiceCode String 普通发票纳税人识别码 普通发票纳税人识别码
-orderRemark String 尽快发货 买家下单时订单备注
-orderStartTime String 2019-01-01 12:21:32 下单时间
-orderEndTime String 2019-02-01 12:21: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 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 手机
itemInfoList java.util.List 商品详细信息
--- com.jd.open.api.sdk.doamin.order.ItemInfo
-skuId String 12389871 京东内部 SKU 的 ID
-outerSkuId String SKU 外部 ID(极端情况下不保证返回,建议从商品接口获取 SKU 外部 ID(极端情况下不保证返回,建议从商品接口获取
-skuName String 商品名称 商品的名称 +SKU 规格
-jdPrice String 23.11 SKU 的京东价
-giftPoint String 1000 赠送积分
-wareId String 89112 京东内部商品 ID(极端情况下不保证返回,建议从商品接口获取)
-itemTotal String 2 数量
-productNo String 891112345 货号
-serviceName String 服务项名称 服务项名称
-newStoreId String 1 item 维度的仓库 id
-itemExt String tem 维度的扩展信息;JSON;服务项数据、黄金珠宝订单标识、医疗器械,门店 id 等。黄金珠宝标识:zszs=1; 门店 id 对应的 key:locShopId(只有门店服务的订单,扩展信息里面才有这个节点) item 维度的扩展信息;JSON;服务项数据、黄金珠宝订单标识、医疗器械,门店 id 等。黄金珠宝标识:zszs=1; 门店 id 对应的 key:locShopId(只有门店服务的订单,扩展信息里面才有这个节点)
couponDetailList java.util.List 优惠详细信息
--- com.jd.open.sdk.domain.order.CouponDetail
-orderId String 91379271133 订单编号
-skuId String 1233321 京东 sku 编号。(只有 30-单品促销优惠 才有 skuId,其他时值为””)
-couponType String 29 优惠类型: 20-套装优惠, 28-闪团优惠, 29-团购优惠, 30-单品促销优惠, 34-手机红包, 35-满返满送(返现), 39-京豆优惠,41-京东券优惠, 52-礼品卡优惠,100-店铺优惠
-couponPrice String 1 优惠金额。isv 请联系服务市场类目运营,商家请联系店铺运营。
-venderRemark String 可发货 商家订单备注(不大于 500 字符) 可选字段,需要在输入参数 optional_fields 中写入才能返回
-balanceUsed String 1 余额支付金额 可选字段,需要在输入参数 optional_fields 中写入才能返回
-pin String hys7975 买家的账号信息 可选字段,需要在输入参数 optional_fields 中写入才能返回
-returnOrder String 0 售后订单标记 0:不是换货订单 1 返修发货,直接赔偿,客服补件 2 售后调货 可选字段,需要在输入参数 optional_fields 中写入才能返回
-paymentConfirmTime String 2019-02-02 12:21:32 付款确认时间 如果没有付款时间 默认返回 0001-01-01 00:00:00 可选字段,需要在输入参数 optional_fields 中写入才能返回
-waybill String 运单号(当厂家自送时运单号可为空,不同物流公司的运单号用 分隔,如果同一物流公司有多个运单号,则用英文逗号分隔) 可选字段,需要在输入参数 optional_fields 中写入才能返回
-logisticsId String 21 物流公司 ID 可选字段,需要在输入参数 optional_fields 中写入才能返回
vatInfo com.jd.open.api.domain.order.VatIncoiceInfo 增值税发票(专票),普通发票,普通电子发票 可选字段,需要在输入参数 optional_fields 中写入才能返回(发票相关扩展字段)
-vatNo String 1 纳税人识别号
-addressRegIstered String 北京市海淀区 注册地址
-phoneRegIstered String 15034342222 注册电话
-depositBank String 中国人民银行 开户银行
-bankAccount String 银行账号 银行账户
-userAddress String 北京市大兴区科创十一街 收票人地址
-userName String 张三 收票人姓名
-userPhone String 18312333333 收票人电话
-invoicePersonalName String 李四 普通发票,电子普通发票的个人姓名
-modified String 2019-01-01 11:11:11 订单更新时间
-directParentOrderId String 1 直接父订单号 可选字段,需要在输入参数 optional_fields 中写入才能返回
-parentOrderId String 1 根父订单号 可选字段,需要在输入参数 optional_fields 中写入才能返回
-customs String 广州南沙保税区 保税区信息【广州南沙保税区,广州南沙保税区,杭州萧山保税区等】
-customsModel String 直邮 保税模型:【直邮,保税集货,保税备货】
-orderSource String 移动端订单 订单来源。移动端订单、PC 端订单、手 Q 订单、微信订单、拍拍订单、农村电商
-storeOrder String 京仓订单 当 ordertype 为 22 的时候。京仓订单/云仓订单/空值“”;京仓、云仓订单,商家请勿发货。
-idSopShipmenttype Number 68 配送方式,是否京配。68= 京配,69= 京配自提。71= 同城配送(当是 71 时请通过 jingdong.pop.order.getOrderExtInfoByOrderId 接口获取配送时效信息)
-scDT String 2019-02-02 12:21:32 最早生产时间。预约出库时间
-serviceFee String 1 服务费。目前没有此值
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 1 业务处理状态。0.未处理 1.处理成功
pauseBizDataYy com.jd.ac.domain.api.offline.OrderInfoResultPauseBizInfo.PauseBizDataYy 订单暂停业务数据(预约日历)
-codDT String 2019-01-01 12:21:32 用户预约时间
-dbDT String 2019-01-01 12:21:32 最晚出库时间
-ljDT String 2019-02-01 12:21:32 最晚揽件时间
-taxFee String 100 税价分离,保存税费,单位:分
-tuiHuoWuYou String 退货无忧 退货无忧
-orderSign String sendpay(京东内部标识业务类型的字符串,一般为 500 位) sendpay(京东内部标识业务类型的字符串,一般为 500 位)
-storeId String 21 仓库 Id
-menDianId String 32 门店 Id
-mdbStoreId String 23900 门店帮 Id。
-salesPin String jd_51b90fbbf3118 导购员 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 hyS7975 买家的账号信息 真实 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 hys7975 买家的账号信息 可选字段,需要在输入参数 optional_fields 中写入才能返回
-open_id_seller String jd_51b90fbbf3118 导购员 pin。
withholding_money int 该接口扣费金额(点券)

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
     "withholding_money":4,
  "jingdong_pop_order_get_response": {
"orderDetailInfo": {
"apiResult": {
"englishErrCode": "system exception",
"success": "true",
"chineseErrCode": "系统异常",
"numberCode": "999999"
},
"orderInfo": {
"orderSellerPrice": "80",
"orderType": "22",
"logisticsId": "21",
"orderSign": "sendpay(京东内部标识业务类型的字符串,一般为500位)",
"orderId": "67834311",
"paymentConfirmTime": "2019-02-02 12:21:32",
"orderStateRemark": "等待出库",
"orderState": "WAIT_SELLER_STOCK_OUT",
"payType": "4",
"itemInfoList": [
{
"---": {
"skuName": "商品名称",
"itemTotal": "2",
"wareId": "89112",
"outerSkuId": "SKU外部ID(极端情况下不保证返回,建议从商品接口获取",
"jdPrice": "23.11",
"serviceName": "服务项名称",
"itemExt": "tem维度的扩展信息;json;服务项数据、黄金珠宝订单标识、医疗器械,门店id等。黄金珠宝标识:zszs=1; 门店id对应的key:locShopId(只有门店服务的订单,扩展信息里面才有这个节点)",
"giftPoint": "1000",
"skuId": "12389871",
"productNo": "891112345",
"newStoreId": "1"
}
}
],
"pin": "hys7975",
"waybill": "运单号(当厂家自送时运单号可为空,不同物流公司的运单号用|分隔,如果同一物流公司有多个运单号,则用英文逗号分隔) 可选字段,需要在输入参数optional_fields中写入才能返回",
"customs": "广州南沙保税区",
"modified": "2019-01-01 11:11:11",
"salesPin": "jd_51b90fbbf3118",
"freightPrice": "10",
"tuiHuoWuYou": "退货无忧",
"balanceUsed": "1",
"serviceFee": "1",
"directParentOrderId": "1",
"originalConsigneeInfo": {
"town": "齐心庄镇",
"city": "廊坊市",
"mobile": "18222222222",
"county": "三河市",
"telephone": "0102553701",
"cityId": "274",
"townId": "49968",
"provinceId": "5",
"province": "河北省",
"countyId": "49707",
"fullAddress": "河北廊坊市三河市齐心庄镇",
"fullname": "张三",
"desen_telephone": "0102553701",
"desen_mobile": "18222222222"
},
"orderTotalPrice": "100",
"invoiceCode": "普通发票纳税人识别码",
"mdbStoreId": "23900",
"idSopShipmenttype": "68",
"sellerDiscount": "20",
"customsModel": "直邮",
"venderRemark": "可发货",
"couponDetailList": [
{
"---": {
"orderId": "91379271133",
"couponType": "29",
"couponPrice": "1",
"skuId": "1233321"
}
}
],
"menDianId": "32",
"sendpayMap": "{“301”:“1,“501”:“1”,“509”:“1”,”688”:”2”,“559”:“2”,“599”:”7”}",
"venderId": "177187",
"orderRemark": "尽快发货",
"orderMarkDesc": {
"TryBeforePayLater": "1"
},
"scDT": "2019-02-02 12:21:32",
"parentOrderId": "1",
"orderEndTime": "2019-02-01 12:21:32",
"taxFee": "100",
"vatInfo": {
"bankAccount": "银行账号",
"userAddress": "北京市大兴区科创十一街",
"depositBank": "中国人民银行",
"vatNo": "1",
"addressRegIstered": "北京市海淀区",
"userPhone": "18312333333",
"invoicePersonalName": "李四",
"userName": "张三",
"phoneRegIstered": "15034342222"
},
"open_id_buyer": "hys7975",
"open_id_seller": "jd_51b90fbbf3118",
"invoiceInfo": "发票信息。电子发票请从invoiceEasyInfo里取 “invoice_info: 不需要开具发票”下无需开具发票;其它返回值请正常开具发票",
"orderSource": "移动端订单",
"orderExt": "订单维度扩展字段,json;",
"deliveryType": "只工作日送货(双休日、假日不用送)",
"pauseBizInfo": {
"pauseBizDataYy": {
"dbDT": "2019-01-01 12:21:32",
"ljDT": "2019-02-01 12:21:32",
"codDT": "2019-01-01 12:21:32"
},
"pauseBizStatusList": [
{
"---": {
"bizType": "1",
"bizStatus": "1"
}
}
]
},
"storeId": "21",
"orderPayment": "90",
"consigneeInfo": {
"town": "齐心庄镇",
"city": "廊坊市",
"mobile": "18222222222",
"county": "三河市",
"telephone": "0102553701",
"cityId": "274",
"townId": "49968",
"provinceId": "5",
"province": "河北省",
"countyId": "49707",
"fullAddress": "河北廊坊市三河市齐心庄镇",
"fullname": "张三",
"desen_telephone": "0102553701",
"desen_mobile": "18222222222"
},
"returnOrder": "0",
"invoiceEasyInfo": {
"invoiceConsigneeEmail": "电子发票联系人邮箱",
"invoiceConsigneePhone": "13222222222",
"invoiceType": "3",
"invoiceContentId": "发票内容",
"invoiceTitle": "发票抬头",
"invoiceCode": "1WEUO2384329SD"
},
"storeOrder": "京仓订单",
"realPin": "hyS7975",
"orderStartTime": "2019-01-01 12:21:32"
}
}
}
}


响应代码

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