全部
淘宝
拼多多
抖音
京东
快手
当当
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 | 未授权店铺 | 根据返回链接进行扫码授权 |