FBP:仓储和配送都用京东
SOP:仓储和配送都不用京东
LBP:仓储不用,配送用,京东代开发票,需要送货到分拣中心
SOPL:仓储不用,配送用,自己开发票,需要送货到分拣中心
1. 订单检索 | 2. 获取单个订单 |
3. FBP订单检索 | 4. FBP获取单个订单 |
5. 面单打印 | 6. 获取面单打印数据 |
7. SOP获取面单打印数据 | 8. LBP获取面单打印数据 |
9. SOPL获取面单打印数据 |
10. 订单SOP出库 | 11. 订单LBP出库 |
12. 订单SOPL出库 | |
13. 海外购订单出库 | 14. 海外购订单发货 |
15. SOP修改运单号 | 16. SOPL修改运单号 |
17. LBP修改运单号 |
18. 查询商家备注 | 19. 商家订单备注修改 |
20. 删单申请 | 21. 取消删单申请 |
l 接口名称
360buy.order.search
l 功能说明
根据条件检索订单信息 (仅适用于SOP、LBP,SOPL类型,FBP类型请调取FBP订单检索 )
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
start_date | String | 否 | 2010-12-20 17:15:00 | order_state=WAIT_SELLER_STOCK_OUT 等待出库,则start_date可以为"否"(开始时间和结束时间均为空,默认返回前一个月的订单);order_state=其他值,则start_date必须为"是"(开始时间和结束时间,不得相差超过1个月。此时间仅针对订单状态及运单号修改的时间) |
end_date | String | 否 | 2010-12-20 17:15:00 | order_state=WAIT_SELLER_STOCK_OUT 等待出库,则start_date可以为"否"(开始时间和结束时间均为空,默认返回前一个月的订单);order_state=其他值,则start_date必须为"是"(开始时间和结束时间,不得相差超过1个月。此时间仅针对订单状态及运单号修改的时间) |
dateType | String | 否 | 0 | 查询时间类型,默认按修改时间查询。 1为按订单创建时间查询;其它数字为按订单(订单状态、修改运单号)修改时间 |
order_state | String | 是 | WAIT_SELLER_STOCK_OUT | 多订单状态可以用英文逗号隔开 1)WAIT_SELLER_STOCK_OUT 等待出库 2)SEND_TO_DISTRIBUTION_CENER 发往配送中心(只适用于LBP,SOPL商家) 3)DISTRIBUTION_CENTER_RECEIVED 配送中心已收货(只适用于LBP,SOPL商家) 4)WAIT_GOODS_RECEIVE_CONFIRM 等待确认收货 5)RECEIPTS_CONFIRM 收款确认(服务完成)(只适用于LBP,SOPL商家) 6)WAIT_SELLER_DELIVERY等待发货(只适用于海外购商家,等待境内发货 标签下的订单) 7)FINISHED_L 完成 8)TRADE_CANCELED 取消 9)LOCKED 已锁定 |
page | String | 是 | 1 | 查询的页数(最大page 50条,请缩短时间间隔,以获取全部订单) |
page_size | String | 是 | 12 | 每页的条数(最大page_size 100条) |
optional_fields | String | 否 |
| 需返回的字段列表。可选值:orderInfo结构体中的所有字段;字段之间用","分隔 |
sortType | String | 否 | 1 | 排序方式,默认升序,1是降序,其它数字都是升序 |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_search | OrderSearch |
|
| 订单数据 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
OrderSearch结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_info_list | List |
|
| 订单数据 |
order_total | int |
|
| 查询订单的数量 |
OrderInfo结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String |
|
| 订单数据 |
vender_id | String |
|
| 商家id |
pay_type | String |
|
| 支付方式(1货到付款, 2邮局汇款, 3自提, 4在线支付, 5公司转账, 6银行转账 ) |
order_total_price | String |
|
| 订单总金额 |
order_payment | String |
|
| 用户应付金额 |
order_seller_price | String | 订单货款金额(订单总金额-商家优惠金额) | ||
freight_price | String |
|
| 商品的运费 |
seller_discount | String |
|
| 商家优惠金额 |
order_state | String |
|
| 订单状态(英文) |
order_state_remark | String |
|
| 订单状态说明(中文) |
delivery_type | String |
|
| 送货(日期)类型(1-只工作日送货(双休日、假日不用送);2-只双休日、假日送货(工作日不用送);3-工作日、双休日与假日均可送货;其他值-返回"任意时间") |
invoice_info | String |
|
| 发票信息 "invoice_info: 不需要开具发票"下无需开具发票; 其它返回值请正常开具发票 |
order_remark | String |
|
| 买家下单时订单备注 |
order_start_time | String |
|
| 下单时间 |
order_end_time | String |
|
| 结单时间 如返回信息为"0001-01-01 00:00:00"和"1970-01-01 00:00:00",可认为此订单为未完成状态。 |
consignee_info | UserInfo |
|
| 收货人基本信息 |
item_info_list | List |
|
| 订单商品列表 |
coupon_detail_list | List |
|
| 订单商家优惠列表 |
return_order | String |
| 1 | 换货订单标识 0:不是换货订单,1:换货订单(默认不返回) 可选字段,需要在输入参数optional_fields中写入才能返回 |
vender_remark | String | 商家订单备注(不大于500字符) 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
pin | String | 即买家的账号信息 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
balance_used | String | 余额支付金额 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
modified | String | 2011-06-22 13:25:03 | 订单更新时间 | |
payment_confirm_time | string | 2013-08-19 15:24:43 | 付款确认时间 如果没有付款时间 默认返回0001-01-01 00:00:00 可选字段,需要在输入参数optional_fields中写入才能返回 | |
logistics_id | String | 物流公司ID,多个物流公司以|分隔 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
waybill | String | 运单号,当物流公司是厂家自送时运单号可为空,不同物流公司的运单号用|分隔,如果同一物流公司有多个运单号,则用英文逗号分隔 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
vat_invoice_info | VatInvoiceInfo | 增值税发票 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
parent_order_id | String | 父订单号 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
order_type | String | 订单类型(22 SOP;23 LBP ;25 SOPL) 可选字段,需要在输入参数optional_fields中写入才能返回 |
ItemInfo结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
sku_id | String |
|
| 京东内部SKU的ID |
outer_sku_id | String |
|
| SKU外部ID(极端情况下不保证返回,建议从商品接口获取) |
sku_name | String |
|
| 商品的名称+SKU规格(比如 |
jd_price | String |
|
| SKU的京东价 |
gift_point | String |
|
| 赠送积分 |
ware_id | String |
|
| 京东内部商品ID(极端情况下不保证返回,建议从商品接口获取) |
item_total | String |
|
| 数量 |
UserInfo结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
fullname | String |
|
| 姓名 |
full_address | String |
|
| 地址 |
telephone | String |
|
| 固定电话 |
mobile | String |
|
| 手机 |
province | String |
|
| 省 |
city | String |
|
| 市 |
county | String |
|
| 县 |
CouponDetail结构
名称 | 类型 | 是否必填 | 示例值 | 描述 |
coupon_price | String |
|
| 优惠金额 |
coupon_type | String |
|
| 优惠类型: 34-手机红包, 35-满返满送(返现), 39-京豆优惠,41-京东券优惠,52-礼品卡优惠,100-店铺优惠
|
order_id | String |
|
| 订单编号 |
sku_id | String |
|
| 京东sku编号 |
VatInvoiceInfo结构
名称 | 类型 | 是否必填 | 示例值 | 描述 |
taxpayer_ident | String | 纳税人识别号 | ||
registered_address | String | 注册地址 | ||
registered_phone | String | 注册电话 | ||
deposit_bank | String | 开户银行 | ||
bank_account | String | 银行账户 |
l 返回示例
JSON数据格式
{l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605"); OrderSearchRequest request = new OrderSearchRequest(); request.setStartDate("2012-01-10 12:12:23"); request.setEndDate("2012-02-20 12:13:13"); request.setOrderState("WAIT_SELLER_STOCK_OUT"); request.setPage("1"); request.setPageSize("100"); request.setOptionalFields("vender_id,order_id,pay_type"); OrderSearchResponse response = client.execute(request); |
l 接口名称
360buy.order.get
l 功能说明
输入单个订单id,得到所有相关订单信息(仅适用于SOP、LBP,SOPL类型,FBP类型请调取FBP获取单个订单 )
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
order_state | String | 否 | WAIT_SELLER_STOCK_OUT | 多订单状态可以用英文逗号隔开 1)WAIT_SELLER_STOCK_OUT 等待出库 2)SEND_TO_DISTRIBUTION_CENER 发往配送中心(只适用于LBP,SOPL商家) 3)DISTRIBUTION_CENTER_RECEIVED 配送中心已收货(只适用于LBP,SOPL商家) 4)WAIT_GOODS_RECEIVE_CONFIRM 等待确认收货 5)RECEIPTS_CONFIRM 收款确认(服务完成)(只适用于LBP,SOPL商家) 6)WAIT_SELLER_DELIVERY等待发货(只适用于海外购商家) 7)FINISHED_L 完成 8)TRADE_CANCELED 取消 9)LOCKED 已锁定 |
optional_fields | String | 否 |
| 需返回的字段列表。可选值:orderInfo结构体中的所有字段;字段之间用","分隔 |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order | OrderDetail |
|
| 订单数据 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
OrderDetail结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
OrderInfo | OrderInfo |
|
| 订单数据 |
OrderInfo结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String |
|
| 订单数据 |
vender_id | String |
|
| 商家id |
pay_type | String |
|
| 支付方式 (1货到付款, 2邮局汇款, 3自提, 4在线支付, 5公司转账, 6银行转账) |
order_total_price | String |
|
| 订单总金额 |
order_payment | String |
|
| 用户应付金额 |
order_seller_price | String |
|
| 订单货款金额(订单总金额-商家优惠金额) |
freight_price | String |
|
| 商品的运费 |
seller_discount | String |
|
| 商家优惠金额 |
order_state | String |
|
| 订单状态(英文) |
order_state_remark | String |
|
| 订单状态说明(中文) |
delivery_type | String |
|
| 送货(日期)类型(1-只工作日送货(双休日、假日不用送);2-只双休日、假日送货(工作日不用送);3-工作日、双休日与假日均可送货;其他值-返回"任意时间") |
invoice_info | String |
|
| 发票信息 返回“不需要开具发票"时无需开具发票;其它返回值请正常开具发票 |
order_remark | String |
|
| 买家下单时订单备注 |
order_start_time | String |
|
| 下单时间 |
order_end_time | String |
|
| 结单时间 如返回信息为“0001-01-01 00:00:00”或“1970-01-01 00:00:00”等特殊值,可认为此订单为未完成状态。 |
consignee_info | UserInfo |
|
| 收货人基本信息 |
item_info_list | List |
|
| 订单商品列表 |
coupon_detail_list | List |
|
| 订单商家优惠列表 |
return_order | string | 1 | 换货订单标识 0:不是换货订单,1:换货订单(默认不返回) 可选字段,需要在输入参数optional_fields中写入才能返回 | |
vender_remark | String | 商家订单备注(不大于500字符) 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
pin | String | 即买家的账号信息 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
balance_used | String | 余额支付金额 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
modified | String | 2011-06-22 13:25:03 | 订单更新时间 | |
payment_confirm_time | string | 2013-08-19 15:24:43 | 付款确认时间 如果没有付款时间 默认返回0001-01-01 00:00:00 可选字段,需要在输入参数optional_fields中写入才能返回 | |
logistics_id | String | 物流公司ID,多个物流公司以|分隔 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
waybill | String | 运单号,当物流公司是厂家自送时运单号可为空,不同物流公司的运单号用|分隔,如果同一物流公司有多个运单号,则用英文逗号分隔 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
vat_invoice_info | VatInvoiceInfo | 增值税发票 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
parent_order_id | String | 父订单号 可选字段,需要在输入参数optional_fields中写入才能返回 | ||
order_type | String | 订单类型(22 SOP;23 LBP ;25 SOPL) 可选字段,需要在输入参数optional_fields中写入才能返回 |
ItemInfo结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
sku_id | String |
|
| 京东内部SKU的ID |
outer_sku_id | String |
|
| SKU外部ID(极端情况下不保证返回,建议从商品接口获取) |
sku_name | String |
|
| 商品的名称+SKU规格 |
jd_price | String |
|
| SKU的京东价 |
gift_point | String |
|
| 赠送积分 |
ware_id | String |
|
| 京东内部商品ID(极端情况下不保证返回,建议从商品接口获取 ) |
item_total | String |
|
| 数量 |
product_no | String |
|
| 商品货号(极端情况下不保证返回,建议从商品接口获取 ) |
UserInfo结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
fullname | String |
|
| 姓名 |
full_address | String |
|
| 地址 |
telephone | String |
|
| 固定电话 |
mobile | String |
|
| 手机 |
province | String |
|
| 省 |
city | String |
|
| 市 |
county | String |
|
| 县 |
CouponDetail结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
coupon_price | String | 否 |
| 优惠金额 |
coupon_type | String | 否 |
| 优惠类型: 34-手机红包, 35-满返满送(返现), 39-京豆优惠,41-京东券优惠,52-礼品卡优惠,100-店铺优惠 |
order_id | String | 否 |
| 订单编号 |
sku_id | String | 否 |
| 京东sku编号 |
VatInvoiceInfo结构
名称 | 类型 | 是否必填 | 示例值 | 描述 |
taxpayer_ident | String | 纳税人识别号 | ||
registered_address | String | 注册地址 | ||
registered_phone | String | 注册电话 | ||
deposit_bank | String | 开户银行 | ||
bank_account | String | 银行账户 |
l 返回示例
JSON数据格式
{ "order_get_response": { "code": "0" "order": { "orderInfo": { "vender_id": "20361", "order_id": "25002825", "order_state": "WAIT_SELLER_STOCK_OUT", "pay_type": "1-货到付款", "delivery_type": "只双休日、假日送货(工作日不用送)", "order_payment": "15643.10", "seller_discount": "1.00", "invoice_info": "发票类型:普通发票;发票抬头:个人;发票内容:明细;", "order_remark": "", "order_start_time": "2011-04-08 17:40:00", "consignee_info": { "province": "北京", "city": "海淀区", "county": "三环以内", "fullname": "ai", "telephone": "010-12345678", "mobile": " ", "full_address": "北京海淀区三环以内3333" }, "item_info_list": [ { "sku_id": "1100037898", "ware_id": "", "jd_price": "400.00", "sku_name": "大苹果", "product_no": "", "gift_point": "0", "outer_sku_id": "", "item_total": "1" } ], "coupon_detail_list": [ { "order_id": "25002825", "sku_id": "1100037898", "coupon_type": "29-团购优惠", "coupon_price": "1.00" }, { "order_id": "25002825", "sku_id": "1100037898", "coupon_type": "29-团购优惠", "coupon_price": "1.00" } ] } }, } } |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605"); OrderGetRequest request = new OrderGetRequest(); request.setOrderId("25007947"); request.setOrderState("WAIT_SELLER_STOCK_OUT"); OrderGetResponse response=client.execute(request); |
l 接口名称
360buy.order.fbp.search
l 功能说明Fbp类型商家根据条件检索订单信息
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
format | String | 否 | 暂时只支持json |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
start_date | String | 是 | 2010-12-20 17:15:00 | FBP订单查询的开始时间(开始时间和结束时间,不得相差超过1个月。此时间针对订单修改的时间) |
end_date | String | 是 | 2010-12-20 17:15:00 | FBP订单查询的结算时间(开始时间和结束时间,不得相差超过1个月。此时间针对订单修改的时间) |
page | String | 是 | 1 | 查询的页数,取值范围:大于零的整数;最大值: 99999 |
page_size | String | 是 | 12 | 每页的条数(取值范围:大于零的整数,最大page_size 100条) |
optional_fields | String | 否 | 商家希望返回的订单的信息字段, 可选值: OrderInfo数据结构中的以下字段: |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_search | OrderSearch | 订单数据 | ||
code | String | 错误码 |
OrderSearch结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_info_list | List | 订单数据 | ||
order_total | int | 结果总数,所有订单数 |
OrderSearchInfo结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 订单id,默认必须返回 | ||
vender_id | String | 商家id | ||
pay_type | String | 支付方式(1货到付款, 2邮局汇款, 3自提, 4在线支付, 5公司转账, 6银行转账 ) | ||
order_total_price | String | 订单总金额 | ||
order_payment | String | 用户应付金额 | ||
order_seller_price | String | 订单货款金额(订单总金额-商家优惠金额) | ||
freight_price | String | 商品的运费 | ||
seller_discount | String | 商家优惠金额 | ||
order_state | String | 订单状态(英文) 具体返回值列表请发邮件至jos#jd.com获取 | ||
order_state_remark | String | 订单状态说明(中文) 具体返回值列表请发邮件至jos#jd.com获取 | ||
delivery_type | String | 送货(日期)类型(1-只工作日送货(双休日、假日不用送);2-只双休日、假日送货(工作日不用送);3-工作日、双休日与假日均可送货;其他值-返回"任意时间" | ||
invoice_info | String | 发票信息"invoice_info: 不需要开具发票"下无需开具发票;其它返回值请正常开具发票 | ||
order_remark | String | 买家下单时订单备注 | ||
order_start_time | String | 下单时间 | ||
order_end_time | String | 结单时间 如返回信息为“0001-01-01 00:00:00”或“1970-01-01 00:00:00”等特殊值,可认为此订单为未完成状态。 | ||
consignee_info | UserInfo | 收货人基本信息 | ||
item_info_list | List | 订单商品列表 | ||
coupon_detail_list | List | 订单优惠列表 | ||
return_order | String | 1 | 换货订单标识 0:不是换货订单,1:换货订单(默认不返回) | |
vender_remark | String | 商家订单备注(不大于500字符) | ||
pin | String | 即买家的账号信息 | ||
balance_used | String | 余额支付金额 | ||
modified | String | 2011-06-22 13:25:03 | 订单更新时间 | |
payment_confirm_time | string | 2013-08-19 15:24:43 | 付款确认时间 如果没有付款时间 默认返回0001-01-01 00:00:00 | |
parent_order_id | string | 父订单号 |
ItemInfo结构(针对赠品、加价购 会出现相同的item)
名称 | 类型 | 是否必须 | 示例值 | 描述 |
sku_id | String | 京东内部SKU的ID | ||
outer_sku_id | String | SKU外部ID | ||
sku_name | String | 商品的名称+SKU规格(比如 艾米AMII2013秋装撞色休闲个性立体挖袋中长款T恤11300247 灰色 S) | ||
jd_price | String | SKU的京东价,优惠之前的 | ||
gift_point | String | 赠送积分 | ||
ware_id | String | 京东内部商品ID | ||
item_total | String | 数量 |
UserInfo结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
fullname | String | 姓名 | ||
full_address | String | 地址 | ||
telephone | String | 固定电话 | ||
mobile | String | 手机 | ||
province | String | 省 | ||
city | String | 市 | ||
county | String | 县 |
CouponDetail结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
coupon_price | String | 优惠金额 | ||
coupon_type | String | 优惠类型: 34-手机红包, 35-满返满送(返现), 39-京豆优惠,41-京东券优惠,52-礼品卡优惠,100-店铺优惠 | ||
order_id | String | 订单编号 | ||
sku_id | String | sku编号(优惠类型是: 35-满返满送(返现) 100-店铺优惠,sku_id值为"" ) |
l 返回示例
JSON数据格式
{ |
l SDK调用示例(java)
public JdClient client = new
|
接口名称
360buy.order.fbp.get
功能说明
输入单个订单id,得到所有相关订单信息
系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
format | String | 否 | 暂时只支持json |
v | String | 是 | API协议版本,可选值:2.0. |
应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
optional_fields | String | 否 | 商家希望返回的订单的信息字段, 可选值: OrderInfo数据结构中的以下字段: order_id,vender_id,pay_type等每个字段以逗号分隔 |
返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order | OrderDetail | 订单数据 | ||
code | String | 错误码 |
OrderDetail结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
OrderInfo | OrderInfo | 订单数据 |
OrderInfo结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 订单id, 默认必须返回 | ||
vender_id | String | 商家id | ||
pay_type | String | 支付方式(1货到付款, 2邮局汇款, 3自提, 4在线支付, 5公司转账, 6银行转账) | ||
order_total_price | String | 订单总金额 | ||
order_payment | String | 用户应付金额 | ||
order_seller_price | String | 订单货款金额(订单总金额-商家优惠金额) | ||
freight_price | String | 商品的运费 | ||
seller_discount | String | 商家优惠金额 | ||
order_state | String | 订单状态(英文) 具体返回值列表请发邮件至jos#jd.com获取 | ||
order_state_remark | String | 订单状态说明(中文) 具体返回值列表请发邮件至jos#jd.com获取 | ||
delivery_type | String | 送货(日期)类型(1-只工作日送货(双休日、假日不用送);2-只双休日、假日送货(工作日不用送);3-工作日、双休日与假日均可送货;其他值-返回“任意时间”) | ||
invoice_info | String | 发票信息 “invoice_info: 不需要开具发票”下无需开具发票;其它返回值请正常开具发票 | ||
order_remark | String | 买家下单时订单备注 | ||
order_start_time | String | 下单时间 | ||
order_end_time | String | 结单时间 如返回信息为“0001-01-01 00:00:00”和“1970-01-01 00:00:00”,可认为此订单为未完成状态。 | ||
consignee_info | UserInfo | 收货人基本信息 | ||
item_info_list | List | 订单商品列表 | ||
couponDetailList | List | 订单优惠列表 | ||
return_order | String | 1 | 换货订单标识 0:不是换货订单,1:换货订单(默认不返回) | |
vender_remark | String | 商家订单备注(不大于500字符) | ||
pin | String | 即买家的账号信息 | ||
balance_used | String | 余额支付金额 | ||
payment_confirm_time | string | 2013-08-19 15:24:43 | 付款确认时间如果没有付款时间默认返回0001-01-01 00:00:00 | |
parent_order_id | string | 父订单号 |
ItemInfo结构
针对赠品、加价购会出现相同的item
名称 | 类型 | 是否必须 | 示例值 | 描述 |
sku_id | String | 京东内部SKU的ID | ||
outer_sku_id | String | SKU外部ID | ||
sku_name | String | 商品的名称+SKU规格(比如艾米AMII2013秋装撞色休闲个性立体挖袋中长款T恤11300247 灰色 S) | ||
jd_price | String | SKU的京东价,优惠之前的 | ||
gift_point | String | 赠送积分 | ||
ware_id | String | 京东内部商品ID | ||
item_total | String | 数量 | ||
product_no | String | 商品货号 |
UserInfo结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
fullname | String | 姓名 | ||
full_address | String | 地址 | ||
telephone | String | 固定电话 | ||
mobile | String | 手机 | ||
province | String | 省 | ||
city | String | 市 | ||
county | String | 县 |
CouponDetail结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
coupon_price | String | 否 | 优惠金额 | |
coupon_type | String | 否 | 优惠类型: 34-手机红包, 35-满返满送(返现), 39-京豆优惠,41-京东券优惠,52-礼品卡优惠,100-店铺优惠 | |
order_id | String | 否 | 订单编号 | |
sku_id | String | 否 | 京东sku编号 (优惠类型是:35-满返满送(返现) 100-店铺优惠,sku_id值为””) |
返回示例
JSON数据格式
{ "order_fbp_get_response": { "code": "0", "order": { "orderInfo": { "order_id": "610200950", "vender_id": "20001", "pay_type": "1-货到付款", "order_total_price": "37.00", "order_seller_price": "37.00", "order_payment": "42.00", "freight_price": "5.00", "seller_discount": "0.00", "order_state": "DengDaiChuKu", "delivery_type": "只工作日送货(双休日、假日不用送)", "invoice_info": "发票类型:普通发票;发票抬头:个人;发票内容:明细", "order_remark": "", "order_start_time": "2012-03-14 09:43:00", "consignee_info": { "fullname": "李扬帆", "telephone": "13455555555", "mobile": "13455555555", "province": "北京", "city": "朝阳区", "county": "四环到五环之间", "full_address": "北京朝阳区四环到五环之间北辰" }, "item_info_list": [ { "sku_id": "1100407038", "outer_sku_id": "", "sku_name": "优惠类型2 礼品卡优惠)", "jd_price": "4688.00", "gift_point": "0", "ware_id": "1100268462", "item_total": "1", "product_no": "111151111232231" } ], "coupon_detail_list": [ { "order_id": "", "sku_id": "", "coupon_type": "", "coupon_price": "" } ], "payment_confirm_time": "2013-03-26 11:37:51" } } } } |
SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL,"65ed71ee-a789-4773-bc8e-16683b638f62", "B9CC3C50FA2A160F909B36A19E17CDF9","36a51ed364cc4feda25c2dc1f0dbc3b6"); OrderFbpGetRequest request = new OrderFbpGetRequest(); request.setOrderId("610200950"); OrderFbpGetResponse response=client.execute(request); |
l 接口名称
360buy.order.print
l 功能说明
输入单个订单id,得到面单打印内容
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
optional_fields | String | 否 |
| 商家希望返回的订单的信息字段,每个字段以逗号分隔 |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
print_result | PrintResult |
|
| 订单数据 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
PrintResult结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
html_content | String |
|
| html内容(base64编码,调用方需要将其进行转码)(sdk 已经将base64编码转成html内容) |
image_data | String |
|
| 打印订单的条形码(base64编码,调用方需要将内容拷贝拷贝到html中条形码 img的src里,即 src="base64编码的条形码")(sop商家返回的为空) |
l 返回示例
JSON数据格式
{ "order_print_response": { "code": "0""print_result": { "html_content": "", "image_data": "" }, } } |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605"); OrderPrintRequest request = new OrderPrintRequest(); request.setOrderId("210000130"); OrderPrintResponse response = client.execute(request); |
l 接口名称
360buy.order.print.data.get
l 功能说明
输入单个订单id,得到面单打印单的数据。
此接口包含所有类型商家的面单数据信息,商家可自行提取所需数据。
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_printdata | OrderPrintData |
|
| 面单打印数据 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
OrderPrintData结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
id | String |
|
| 订单编号 |
out_bound_date | String |
|
| 出库时间 |
bf_deli_good_glag | String |
|
| 是否送货前通知 |
cod_time_name | String |
|
| 送货时间 |
remark | String |
|
| 备注 |
cky2_name | String |
|
| 配送中心名称(适用于SOPL、LBP) |
sorting_code | String |
|
| 分拣代码(适用于SOPL、LBP) |
create_date | String |
|
| 订购时间 |
should_pay | String |
|
| 支付金额 |
payment_typeStr | String |
|
| 支付方式(中文名称) |
partner | String |
|
| 配送站点名称(适用于SOPL、LBP) |
generade | String |
|
| 条形码(base64编码)(适用于SOPL、LBP) |
items_count | String |
|
| 商品总数 |
order_item | List |
|
| 商品列表 |
Consignee | Consignee |
|
| 客户信息 |
freight | String | 运费(适用于SOP) | ||
invoice_title | String |
|
| 发票抬头(适用于SOP) |
invoice_type | String |
|
| 发票类型(适用于SOP) |
invoice_content | String |
|
| 发票内容 (适用于SOP) |
pickUpSign_type | String |
|
| 自提类型(0:非自提 1:地铁自提3:好邻居自提4:社区自提) (适用于SOPL、LBP) |
orderLevel_Type | int |
|
| 高新贵类型(2:贵重 3:高价值 4:贵重且高价值 5: 新用户) (适用于SOPL、LBP) |
Consignee结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
cons_name | String |
|
| 客户姓名 |
cons_phone | String |
|
| 客户电话 |
cons_address | String |
|
| 客户地址 |
cons_handset | String |
|
| 客户手机 |
OrderItem结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
ware_id | String |
|
| 商品编号 |
ware_name | String |
|
| 商品名称 |
num | String |
|
| 数量 |
jd_price | String |
|
| 价格 |
price | String |
|
| 小计 |
produce_no | String | 货号 |
l 返回示例
JSON数据格式
{ "order_printdata_response": { "code": "0""order_printdata": { "id": "25003765", "cod_time_name": "只双休日、假日送货(工作日不用送)", "should_pay": "297.00", "remark": "", "create_date": "2011-04-29 16:34:00", "out_bound_date": "2011-08-05 14:47:49", "bf_deli_good_glag": "否", "cky2_name": "LBP - 北京", "sorting_code": "", "payment_typeStr": "自提", "partner": "中关村自提点", "generade": "/9j/4AAQSkZJRgABAgEBLAEsAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UH", "items_count": "1", "order_item": [ { "ware": "1100038509", "jd_price": "99.00", "ware_name": "圆领印花T恤 XXL", "price": "297.00", "num": "3" } ], "Consignee": { "cons_name": "ochirly", "cons_address": "北京海淀区三环到四环之间广东省广州市天河区中旅大厦30A", "cons_phone": "010-12345678", "cons_handset": "13800000000 " } }, } } |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605"); OrderPrintDataGetRequest request = new OrderPrintDataGetRequest(); request.setOrderId("22721229"); request.setOptionalFields("image_data"); OrderPrintDataGetResponse response = client.execute(request); |
l 接口名称
360buy.order.sop.print.data.get
l 功能说明
输入单个订单id,得到面单打印单的数据
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_printdata | SopOrderPrintData |
|
| 面单打印数据 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
SopOrderPrintData 结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
id | String |
|
| 订单编号 |
out_bound_date | String |
|
| 出库时间 |
bf_deli_good_glag | String |
|
| 是否送货前通知 |
cod_time_name | String |
|
| 送货时间 |
remark | String |
|
| 备注 |
sorting_code | String |
|
| 分拣代码 |
create_date | String |
|
| 订购时间 |
should_pay | String |
|
| 支付金额 |
payment_typeStr | String |
|
| 支付方式(中文名称) |
partner | String |
|
| 配送站点名称 |
generade | String |
|
| 条形码(base64编码) |
invoice_title | String |
|
| 发票抬头 |
invoice_type | String |
|
| 发票类型 |
invoice_content | String |
|
| 发票内容 |
items_count | String |
|
| 商品总数 |
order_item | List |
|
| 商品列表 |
consignee | Consignee |
|
| 客户信息 |
freight | String | 运费 |
Consignee结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
cons_name | String |
|
| 客户姓名 |
cons_phone | String |
|
| 客户电话 |
cons_address | String |
|
| 客户地址 |
cons_handset | String |
|
| 客户手机 |
OrderItem结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
ware_id | String |
|
| 商品编号 |
ware_name | String |
|
| 商品名称 |
num | String |
|
| 数量 |
jd_price | String |
|
| 价格 |
price | String |
|
| 小计 |
produce_no | String | 货号 |
l 返回示例
JSON数据格式
{ "order_sop_printdata_response": { "code": "0""order_printdata": { "invoice_type": "普通发票", "invoice_title": "个人", "invoice_content": "明细", "id": "240000019", "out_bound_date": "2012-06-04 16:48:38", "bf_deli_good_glag": "否", "cod_time_name": "工作日、双休日与假日均可送货", "remark": "售后返修发货返修号7528545#返修发货#原订单号:205813512", "cky2_name": "", "sorting_code": "", "create_date": "2012-05-11 11:42:22", "should_pay": "90.00", "payment_typeStr": "", "partner": "", "generade": "", "items_count": "2", "order_item": [ { "price": "180.00", "ware": "1001671149", "jd_price": "90.00", "ware_name": "cuteway2012夏装新品 净色女士短袖无袖T恤工字背心 小吊带 2件套餐 912615001", "num": "2" } ], "Consignee": { "cons_name": "刘海林", "cons_address": "北京昌平水关新村3号楼4单元302 ", "cons_phone": "010-87636735", "cons_handset": "13717578711" } }, } } |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605"); OrderSopPrintDataGetRequest request = new OrderSopPrintDataGetRequest(); request.setOrderId("22721229"); OrderSopPrintDataGetResponse response = client.execute(request); |
l 接口名称
360buy.order.lbp.print.data.get
l 功能说明
输入单个订单id,得到面单打印单的数据
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_printdata | SoplOrLbpOrderPrintData |
|
| 面单打印数据 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
SoplOrLbpOrderPrintData 结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
id | String |
|
| 订单编号 |
out_bound_date | String |
|
| 出库时间 |
bf_deli_good_glag | String |
|
| 是否送货前通知 |
cod_time_name | String |
|
| 送货时间 |
remark | String |
|
| 备注 |
cky2_name | String |
|
| 配送中心名称 |
sorting_code | String |
|
| 分拣代码 |
create_date | String |
|
| 订购时间 |
should_pay | String |
|
| 支付金额 |
payment_typeStr | String |
|
| 支付方式(中文名称) |
partner | String |
|
| 配送站点名称 |
generade | String |
|
| 条形码(base64编码) |
pickUpSign | String |
|
| 自提标示(base64编码) |
pickUpSign_type | String |
|
| 自提类型(1:地铁自提3:好邻居自提4:社区自提) |
orderLevelSign | String |
|
| 高新贵标示(base64编码) |
orderLevel_Type | int |
|
| 高新贵类型(2:贵重 3:高价值 4:贵重且高价值 5: 新用户) |
items_count | String |
|
| 商品总数 |
order_item | List |
|
| 商品列表 |
consignee | Consignee |
|
| 客户信息 |
freight | String | 运费 |
Consignee结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
cons_name | String |
|
| 客户姓名 |
cons_phone | String |
|
| 客户电话 |
cons_address | String |
|
| 客户地址 |
cons_handset | String |
|
| 客户手机 |
OrderItem结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
ware_id | String |
|
| 商品编号 |
ware_name | String |
|
| 商品名称 |
num | String |
|
| 数量 |
jd_price | String |
|
| 价格 |
price | String |
|
| 小计 |
produce_no | String | 货号 |
l 返回示例
JSON数据格式
{ "order_lbp_printdata_response": { "code": "0""order_printdata": { "pickUpSign": "R0lGODlhKAAoAPeCAE11pYsryAJ0OvKBT1gRAYC+MWtABkYUVxSAQEAOw==", "pickUpSign_type": 1, "id": "610000455", "out_bound_date": "2012-05-31 18:33:21", "bf_deli_good_glag": "否", "cod_time_name": "只工作日送货(双休日、假日不用送)", "remark": "当日配送,17日下午6点前送达", "cky2_name": "LBP - 上海", "sorting_code": "", "create_date": "2012-05-30 10:26:00", "should_pay": "79.50", "payment_typeStr": "货到付款", "partner": "", "generade": "/9j/4AAQSkZJRgABAgEBKgdfhooAKKKKACiooooAKKKKACiiigAooooA//Z", "items_count": "1", "order_item": [ { "price": "116.00", "ware": "1000259802", "jd_price": "116.00", "ware_name": "鲜花速递 唯一 11枝粉玫瑰花束 高档包装 指定日期鲜花送上门 最佳女友生日礼物 非节日时间", "num": "1" } ], "Consignee": { "cons_name": "", "cons_address": "北京海淀区三环到四环之间广东省广州市天河区中旅大厦30B", "cons_phone": "010-12345678", "cons_handset": "18612345678" } }, } } |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605"); OrderLbpPrintDataGetRequest request = new OrderLbpPrintDataGetRequest(); request.setOrderId("22721229"); OrderLbpPrintDataGetResponse response = client.execute(request); |
l 接口名称
360buy.order.sopl.print.data.get
l 功能说明
输入单个订单id,得到面单打印单的数据
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_printdata | OrderPrintData |
|
| 面单打印数据 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
OrderPrintData结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
id | String |
|
| 订单编号 |
out_bound_date | String |
|
| 出库时间 |
bf_deli_good_glag | String |
|
| 是否送货前通知 |
cod_time_name | String |
|
| 送货时间 |
remark | String |
|
| 备注 |
cky2_name | String |
|
| 配送中心名称 |
sorting_code | String |
|
| 分拣代码 |
create_date | String |
|
| 订购时间 |
should_pay | String |
|
| 支付金额 |
payment_typeStr | String |
|
| 支付方式(中文名称) |
partner | String |
|
| 配送站点名称 |
generade | String |
|
| 条形码(base64编码) |
pickUpSign | String |
|
| 自提标示(base64编码) |
pickUpSign_type | String |
|
| 自提类型(1:地铁自提3:好邻居自提4:社区自提) |
orderLevelSign | String |
|
| 高新贵标示(base64编码) |
orderLevel_Type | int |
|
| 高新贵类型(2:贵重 3:高价值 4:贵重且高价值 5: 新用户) |
items_count | String |
|
| 商品总数 |
order_item | List |
|
| 商品列表 |
consignee | Consignee |
|
| 客户信息 |
freight | String | 运费 |
Consignee结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
cons_name | String |
|
| 客户姓名 |
cons_phone | String |
|
| 客户电话 |
cons_address | String |
|
| 客户地址 |
cons_handset | String |
|
| 客户手机 |
OrderItem结构
名称 | 类型 | 是否必须 | 示例值 | 描述 |
ware_id | String |
|
| 商品编号 |
ware_name | String |
|
| 商品名称 |
num | String |
|
| 数量 |
jd_price | String |
|
| 价格 |
price | String |
|
| 小计 |
produce_no | String | 货号 |
l 返回示例
JSON数据格式
{ "order_sopl_printdata_response": { "code": "0""order_printdata": { "pickUpSign": "R0lGODlhKAAoAR88sVEBkMCUOvgRAYC+MWtABkYUVxSAQEAOw==", "pickUpSign_type": 1, "id": "620000566", "out_bound_date": "2012-05-31 15:19:30", "bf_deli_good_glag": "否", "cod_time_name": "只工作日送货(双休日、假日不用送)", "remark": "当日配送,17日下午6点前送达", "cky2_name": "SOPL - 上海", "sorting_code": "", "create_date": "2012-05-30 10:26:00", "should_pay": "79.50", "payment_typeStr": "货到付款", "partner": "", "generade": "/9j/4AAQSkZJRgABUUAFFFFARRRQAUUUUAFFFFABRRRQAUUUUAFFFFAH//Z", "items_count": "1", "order_item": [ { "price": "116.00", "ware": "1000259802", "jd_price": "116.00", "ware_name": "鲜花速递 唯一 11枝粉玫瑰花束 高档包装 指定日期鲜花送上门 最佳女友生日礼物 非节日时间", "num": "1" } ], "Consignee": { "cons_name": "", "cons_address": "北京昌平水关新村3号楼4单元302", "cons_phone": "010-12345678", "cons_handset": "18612345678" } }, } } |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605"); OrderSoplPrintDataGetRequest request = new OrderSoplPrintDataGetRequest(); request.setOrderId("22721229"); OrderSoplPrintDataGetResponse response = client.execute(request); |
l 接口名称
360buy.order.sop.outstorage
l 功能说明
输入单个订单id,进行sop出库操作
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
logistics_id | String | 是 | 2100|4700 | 物流公司ID(只可通过获取商家物流公司接口获得),多个物流公司以|分隔 |
waybill | String | 否 | 1200458628372,111232|468778814888,323232323 | 运单号(当厂家自送时运单号可为空,不同物流公司的运单号用|分隔,如果同一物流公司有多个运单号,则用英文逗号分隔) |
trade_no | String | 否 |
| 流水号 |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String |
|
| 订单id |
vender_id | String |
| 20032 | 商家ID |
modified | String |
| 2011-06-22 13:25:03 | sop出库时间 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
l 返回示例
JSON数据格式
{ "order_sop_outstorage_response": { "code": "0""vender_id": "20032", "modified": "2011-06-22 09:47:34", "order_id": 16050909, } } |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605"); OrderSopOutstorageRequest request = new OrderSopOutstorageRequest(); request.setOrderId("200000492"); request.setTradeNo("400001117"); OrderSopOutstorageResponse response = client.execute(request); |
l 接口名称
360buy.order.lbp.outstorage
l 功能说明
输入单个订单id,进行lbp出库操作
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
package_num | int | 是 |
| 包裹数量 |
logistics_id | int | 是 | 65234 | 物流公司id(可通过获取商家物流公司接口获得,0,表示自送,) |
waybill | String | 是 | AFE234223 | 运单号(当自送时运单号可为空) |
trade_no | String | 否 |
| 流水号 |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String |
|
| 订单id |
vender_id | String |
| 20032 | 商家ID |
modified | String |
| 2011-06-22 13:25:03 | lbp出库时间 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
l 返回示例
JSON数据格式
{ "order_lbp_outstorage_response": { "code": "0""vender_id": "20032", "modified": "2011-06-22 09:46:58", "order_id": 16050909, } } |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605"); OrderLbpOutstorageRequest request = new OrderLbpOutstorageRequest(); request.setOrderId("400001068"); request.setLogisticsId("463"); request.setPackageNum("2"); request.setWaybill("1111"); request.setTradeNo("333123333"); OrderLbpOutstorageResponse response = client.execute(request); |
l 接口名称
360buy.order.sopl.outstorage
l 功能说明
输入单个订单id,进行sopl出库操作
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
package_num | int | 是 |
| 包裹数量 |
address_id | long | 否 |
| 发货地址所对应id(可通过商家获取发货地址接口获取到)保留参数 |
logistics_id | String | 是 |
| 物流公司id(可通过获取商家物流公司接口获得,0,表示自送,) |
waybill | String | 是 |
| 运单号(当自送时运单号可为空) |
trade_no | String | 否 |
| 流水号 |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String |
|
| 订单id |
vender_id | String |
| 20032 | 商家ID |
modified | String |
| 2011-06-22 13:25:03 | lbp出库时间 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
l 返回示例
JSON数据格式
{ "order_sopl_outstorage_response": { "code": "0""vender_id": "20032", "modified": "2011-06-22 09:48:28", "order_id": 16050909, } } |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605"); OrderSoplOutstorageRequest request = new OrderSoplOutstorageRequest(); request.setOrderId("25003607"); request.setPackageNum("2"); request.setSendType("1"); request.setTradeNo("333123333"); OrderSoplOutstorageResponse response = client.execute(request); |
l 接口名称
360buy.overseas.order.sop.outstorage
l 功能说明
输入单个订单id,进行sop 出库操作
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
trade_no | String | 否 |
| 流水号 |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String |
|
| 订单id |
vender_id | String |
| 20032 | 商家ID |
modified | String |
| 2011-06-22 13:25:03 | sop出库时间 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
l 返回示例
JSON数据格式
{ |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, |
l 接口名称
360buy.overseas.order.sop.delivery
l 功能说明
输入单个订单id,进行发货操作
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
logistics_id | String | 是 | 65234 | 物流公司ID(只可通过 获取商家物流公司接口获得) |
waybill | String | 否 | AFE234223 | 运单号(当商家直送时 |
trade_no | String | 否 |
| 流水号 |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String |
|
| 订单id |
vender_id | String |
| 20032 | 商家ID |
modified | String |
| 2011-06-22 13:25:03 | 订单发货操作时间 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
l 返回示例
JSON数据格式
{ |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, |
l 接口名称
360buy.order.sop.waybill.update
l 功能说明
输入单个订单id等修改运单号
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
logistics_id | int | 是 | 2100|4700 | 物流公司ID(只可通过获取商家物流公司接口获得),多个物流公司以|分隔 |
waybill | String | 否 | 1200458628372,111232|468778814888,323232323 | 运单号(当厂家自送时运单号可为空,不同物流公司的运单号用|分隔,如果同一物流公司有多个运单号,则用英文逗号分隔) |
trade_no | String | 否 |
| 流水号 |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String |
|
| 订单id |
vender_id | String |
| 20032 | 商家ID |
modified | String |
| 2011-06-22 13:25:03 | sop出库时间 |
code | String |
|
| 0为正常,其它值参见错误代码一览表 |
l 返回示例
JSON数据格式
{ "order_sop_waybill_update": { "code": "0""vender_id": "20032", "modified": "2011-06-22 09:47:34", "order_id": 16050909, } } |
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605"); OrderSopWaybillUpdateRequest request = new OrderSopWaybillUpdateRequest(); request.setOrderId("600000465"); request.setLogisticsId("1549"); request.setWaybill("179039090005"); OrderSopWaybillUpdateResponse response=client.execute(request); |
l 接口名称
360buy.order.sopl.waybill.update
l 功能说明
输入单个订单id等修改运单号
l 系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
logistics_id | int | 是 | 65234 | 物流公司ID |
waybill | String | 否 | AFE234223 | 运单号(当厂家自送时运单号可为空) |
trade_no | String | 否 |
| 流水号 |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String |
|
| 订单id |
vender_id | String |
| 20032 | 商家ID |
modified | String |
| 2011-06-22 13:25:03 | 更新时间 |
code | String |
|
| 错误码,0为正常,其它值参见错误代码一览表 |
l 返回示例
JSON数据格式
{
|
l SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, |
360buy.order.lbp.waybill.update
功能说明
输入单个订单id等修改运单号
系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
app_secret | String | 是 | 应用分配的密钥 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 | 123765123 | 订单id |
logistics_id | String | 是 | 65234 | 物流公司ID |
waybill | String | 否 | AFE234223 | 运单号(当厂家直送时运单号可为空) |
trade_no | String | 是 |
| 流水号 |
返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String |
|
| 订单id |
vender_id | String |
| 20032 | 商家ID |
modified | String |
| 2011-06-22 13:25:03 | 更新时间 |
code | String |
|
| 错误码 |
返回示例
JSON数据格式
{ |
SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL, 0da953632d0a4741beb0bbd096214605”); |
jingdong.order.venderRemark.queryByOrderId
功能说明
查询商家备注
系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
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服务端允许客户端请求时间误差为6分钟 |
format | String | 否 | 暂时只支持json |
v | String | 否 | API协议版本,可选值:2.0 |
应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
order_id | Number | 是 | 6000300009 | 订单编号 |
返回结果
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
venderRemarkQueryResult | VenderRemarkQueryResult | 接口返回结果 |
VenderRemarkQueryResult属性
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
api_jos_result | ApiJosResult | 否 | ||
vender_remark | VenderRemark | 否 | 商家备注内容,当查询结果不正确时,备注为Null |
ApiJosResult 属性
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
success | Boolean | 否 | true | 是否查询成功 |
result_code | String | 否 | 10100000 | 结果码 |
result_describe | String | 否 | 成功 | 结果描述 |
VenderRemark 属性
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
order_id | Number | 否 | 6000300009 | 订单编号 |
remark | String | 否 | 及时发货 | 备注信息 |
created | Date | 否 | 日期类型字段 | 备注创建时间 |
modified | Date | 否 | 日期类型字段 | 备注最后修改时间 |
flag | Number | 否 | 备注颜色标识 | 备注颜色标识 默认值 0:灰色 可选值 0:灰色、1:红色、2:黄色、3:绿色、4:蓝色、5:紫色 |
返回示例
JSON数据格式
{ } |
SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
接口名称
360buy.order.vender.remark.update
功能说明
商家订单备注修改。
系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
method | String | 是 | API接口名称 |
access_token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
app_secret | String | 是 | 应用分配的密钥 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-ddHH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟 |
v | String | 是 | API协议版本,可选值:2.0. |
应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
order_id | String | 是 |
| 订单号 |
remark | String | 是 |
| 订单备注(可为空备注信息) |
trade_no | String | 否 |
| 流水号,不能重复的随机数 |
flag | String | 否 | 0 | 商家备注提示文字颜色值 GRAY 0,RED 1,YELLOW 2,GREEN 3,BLUE 4,PURPLE 5,默认为灰色 |
返回结果
名称 | 类型 | 示例值 | 描述 |
vender_id | String |
| 商家id |
modified | String |
| 修改时间 |
order_id | String |
| 订单id |
code | string |
| 0为正常,其它值参见错误代码一览表 |
返回示例
JSON数据格式
{ "order_vender_remark_update": { "code": "0", "modified": "2013-01-08 21:32:25", "vender_id": "21304", "order_id": "434092389" } } |
SDK调用示例(java)
public JdClient client = new DefaultJdClient(SERVER_URL,"98b793dc-44df-495a-b2dd-06c9de5fd1c2", "7843A398CCE3397EC50C495458F64B64","6d5524eb1c6c4f9caf8c7b430d1fdef9"); OrderVenderRemarkUpdateRequest request = new OrderVenderRemarkUpdateRequest(); request.setOrderId("334042389"); request.setRemark("京东测试"); OrderVenderRemarkUpdateResponse orderVenderRemarkUpdateResponse = client.execute(request); |
jingdong.order.orderDelete.apply
功能说明
删单申请
系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
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服务端允许客户端请求时间误差为6分钟 |
format | String | 否 | 暂时只支持json |
v | String | 否 | API协议版本,可选值:2.0 |
应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
order_id | Number | 是 | 6000261082 | 订单编号 |
del_apply_type | Number | 是 | 2 | 删单类型,用数字1-9来表示.数字含意如下: 1、商品无货/有瑕疵,请京东联系客户取消订单; 2、商品无货/有瑕疵,已经联系客户同意取消,请京东直接删单; 3、客户要求取消订单,请京东直接删单; 4、3COD货到付款订单,客户拒收,已经联系客户同意取消,请京东直接删单; 5、3COD货到付款订单,客户拒收,无法联系上客户; 6、客户电话无法接通,无法安排发货; 7、客户下单不符合购买规则,无法安排发货; 8、客户地址无法配送,请京东联系客户取消订单; 9、其他(请在删单描述中写明具体原因) |
del_apply_reason | String | 否 | 由于某些原因,不能发货。 | 删单原因描述,长度不能超过500.当删单类型为9时,该字段不能为空。 |
返回结果
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | ApiJosResult | 接口返回结果 |
ApiJosResult 属性
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
success | Boolean | 否 | true | 删单申请是否成功 |
result_code | String | 否 | 10100000 | 结果码 |
result_describe | String | 否 | 成功 | 结果描述 |
返回示例
JSON数据格式
{ |
SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
jingdong.order.orderDelete.cancelApply
功能说明
取消删单申请
系统级别输入参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
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服务端允许客户端请求时间误差为6分钟 |
format | String | 否 | 暂时只支持json |
v | String | 否 | API协议版本,可选值:2.0 |
应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
order_id | Number | 是 | 251171962 | 订单编号 |
返回结果
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | ApiJosResult | 接口返回结果 |
ApiJosResult 属性
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
success | Boolean | 否 | true | 取消删单是否成功 |
result_code | String | 否 | 10100000 | 结果码 |
result_describe | String | 否 | 成功 | 结果描述 |
返回示例
JSON数据格式
{ |
SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |