POP Open API
京东商城 Open API （WebService 版）
1
使用说明 ................................................................................................................................................................ 1 1.1 1.2 1.3 2
在线文档 ........................................................................................................................................................ 1 接入说明 ........................................................................................................................................................ 1 技术说明 ........................................................................................................................................................ 1
订单API . ................................................................................................................................................................ 2 2.1 2.2 2.3 2.4 2.5
获取订单信息列表API ................................................................................................................................ 2 获取单个订单信息API ................................................................................................................................ 6 商家出库操作API ........................................................................................................................................ 7 面单打印API （发货到京东） . ................................................................................................................... 8 SOP 发货操作API ..................................................................................................................................... 11
3 商品API . .............................................................................................................................................................. 12 3.1 3.2 3.3 3.4 3.5
SKU 信息查询API...................................................................................................................................... 12 SKU 信息修改API...................................................................................................................................... 13 通过条件查询商品ID 列表 API（初版） .............................................................................................. 14 通过商品ID 查询商品信息API （初版） . .............................................................................................. 15 商品上下架API . .......................................................................................................................................... 16
4 库存API . .............................................................................................................................................................. 17 4.1
更新SKU 库存API .................................................................................................................................... 17
5 售后API . .............................................................................................................................................................. 18 5.1 5.2
退货收货查询API ...................................................................................................................................... 18 退货收货确认API ...................................................................................................................................... 20
6 其他API . .............................................................................................................................................................. 21 6.1 6.2
获取商家发货地址API .............................................................................................................................. 21 获取商家物流公司API .............................................................................................................................. 22
7 8
商家合作类型说明 ............................................................................................................................................. 23 签名说明 .............................................................................................................................................................. 23
POP Open API
京东POP Open API
（WebService 版） 2011-05-20
1 使用说明
主页：http://gw.shop.360buy.com/
正式版：http://gw.shop.360buy.com/doc/doc.html 测试版：http://220.231.59.70/doc/doc.html 文档会进行定期更新，请以最新在线文档为准！ 正式版文档里面包含正式发布的API ；
测试版文档一般要比正式版更新，里面包含了还没发布的新API 或者更新。
1.1 在线文档
1.2 接入说明
使用API 需要提供商家编号(venderId) ，商家密钥(venderKey、secretcode) ，如何使用，请参考签名说明。
测试时，向API 产品经理提供商家基本信息（尤其是合作类型），API 产品经理会根据情况给予测试环境的商家编号和密钥。商家的开发人员可以在测试环境的地址使用测试账号信息进行测试。
正式对接时，商家编号可以在京东商家后台(http://shop.360buy.com/) 中看到（首页“用户ID ：10XXX ”或者 我的店铺“商家编号：10XXX ”，注意不是“店铺ID ”）；正式环境的商家密钥，在向API 产品经理确认测试完成并且给予基本信息、IP 后，由API 产品经理开通并将密钥以邮件附件的形式发送给商家的京东负责人。
1.3 技术说明
京东开放平台API ，目前以SOAP WebService的方式提供。
目前主流语言平台，比如：.Net 、Java 、PHP 、vb6、C/C++等，都可以接入。 由于要使用IP
本API 文档由 杨宇帆 整理
POP Open API
2
订单API
功能说明： 根据检索条件，进行订单的查询，获取订单列表（支持分页）。 适用商家： 所有类型商家
注意事项： 开始时间和结束时间不得超过1个月！此查询类接口不能过于频繁的调用！
字段列表，如果为空，则返回默认字段；不为空，返回选择的字段，订单ID 不选也会返回
2.1 获取订单信息列表API
查询的时候，时间是下单的时间，考虑到等待付款的问题，请把开始时间调整到当前时间24个小时以上（一般26-48个小时应该没问题），就不会漏单了。请不要把间隔调太大，否则很容易查询超时！
方法名： searchOrderInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/orderSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/orderSearchService?wsdl
输入参数
查询的订单的状态
POP Open API
可选字段
POP Open API
输出参数
数据类型
✧ API 返回结果（ApiResult ）
*！
✧ 订单查询返回结果（ApiOrderQueryDetail ）
✧ 订单信息（Order ）
POP Open API
✧ 订单中商品（Ware ）
✧ 订单中收货人信息（Consignee ）
POP Open API
2.2 获取单个订单信息API
功能说明： 根据京东订单ID 获取单笔交易订单的详细信息。 适用商家： 所有类型商家
注意事项： 此API 必须通过批量查询API 获取京东订单ID 后才能使用 方法名： searchOrderInfoByOrderId
正式WSDL ： http://gw.shop.360buy.com/services/services/orderSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/orderSearchService?wsdl
输入参数
输出参数
POP Open API
2.3 商家出库操作API
功能说明：
通知京东订单已经出库，京东会按照订单信息，自动减去相应库存。 LBP 和SOPL ，由于发往京东配送中心，还需输入一些额外信息。
适用商家： 非FBP （LBP 、SOPL 、SOP ）
注意事项： 一次只能出库一个订单。各个类型商家输入的参数有所不同。
LBP 、SOPL 商家必须设置默认发货地址！
方法名： outStorage
正式WSDL ： http://gw.shop.360buy.com/services/services/orderSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/orderOutStorageService?wsdl
输入参数
输出参数
数据类型
✧ 出库信息（OrderOutData ）（请注意不同类型商家可以输入的值）
为“空”的字段，系统会忽略里面的内容，请不要填写！
POP Open API
2.4 面单打印API （发货到京东）
功能说明： LBP 、SOPL 出库时，需要把打印的面单贴在包装上 适用商家： 仅LBP 、SOPL （SOP 不适用此API ）
注意事项： 必须先获取订单id 。最好先出库后打印订单，否则打印结果的出库时间是错误的。
打印必须使用京东的彩色面单纸进行套打！
方法名： print
正式WSDL ： http://gw.shop.360buy.com/services/services/orderPrintService?wsdl 测试WSDL ： http://220.231.59.70/services/services/orderPrintService?wsdl
输入参数
输出参数
数据类型
✧ 打印结果（PrintResult ）
● htmlContent ：返回面单页面的HTML 代码，使用时把{barcode_url}替换成图片的地址即可。 ● imageData ：是条形码图片二进制内容进行base64编码的结果，内容为图片文件根据data uri协议编
码的结果。比如data:image/jpeg;base64,/9j/4AAQ...(图片内容base64编码) image/jpeg表示是jpg 文件，image/gif、image/png分别表示gif 、png 文件。
POP Open API
● 如果打印的系统安装的浏览器是IE6、IE7，由于不支持data uri，必须将图片的base64编码（不含前面
data:image/jpeg;base64,）进行base64解码形成二进制内容，然后根据定义的图片格式保存成图片，然后将图片地址替换掉html 中的{barcode_url}既可。
● 如果不考虑IE6、7，浏览器是IE8或以上版本，或者使用Firefox 、Chrome 浏览器，可以直接把
imageData 中的内容替换掉html 中的{barcode_url}既可。
（打印结果、彩色面单纸参见下两页）
京东面单示例
图1面单打印结果示意（纵向A4，内容可能会有略微不同）
POP Open API
图2京东面单纸示意图（纵向A4，从京东购买）
POP Open API
2.5 SOP 发货操作API
功能说明： SOP 对订单进行发货操作，先出库后发货；发货操作意味着货物上路 适用商家： 仅SOP
注意事项： 一次只能发货一个订单。物流公司为0自送时，运单号必须为空，否则必填！ 方法名： delivery
正式WSDL ： http://gw.shop.360buy.com/services/services/orderDeliveryService?wsdl 测试WSDL ： http://220.231.59.70/services/services/orderDeliveryService?wsdl
输入参数
输出参数
数据类型
✧ SOP 发货信息（SopDeliveryData ）
POP Open API
3 商品API
通过输入商品ID 列表、京东SKUID 或者商家SKUID ，来查询SKU 信息。 京东商品ID 列表： 返回所有选定商品的所有SKU 信息列表
功能说明：
返回对应SKU 的信息列表（顺序一一对应）， 京东SKUID 列表：
如果某个ID 查询失败，对应的SKU 信息为空 商家SKUID 列表： 返回对应SKU 信息列表，规则同上
3.1 SKU 信息查询API
适用商家： 所有类型商家
注意事项： 根据“ID 类型Type ”选择输入哪种ID 的列表 方法名： searchSkuInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/skuInfoSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/skuInfoSearchService?wsdl
输入参数
输出参数
POP Open API
数据类型
✧ SKU 信息（SkuInfo ）
3.2 SKU 信息修改API
功能说明： 根据商家ID 和京东SKUID 修改SKU 的信息，包括SKU 的京东价、库存和外部ID 。 适用商家： 所有类型商家，但
FBP 不能修改库存
SKU 的属性信息，暂不提供！
注意：
如果商家SKUID 、京东价、库存都不填，即没有修改任何信息，报错 一次只能修改一个字段，不可以同时修改多个字段 目前暂不支持修改京东价！
方法名： updateSkuInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/skuInfoUpdateService?wsdl 测试WSDL ： http://220.231.59.70/services/services/skuInfoUpdateService?wsdl
输入参数
输出参数
POP Open API
3.3 通过条件查询商品ID 列表 API（初版）
功能说明： 通过各种商品的字段进行搜索，返回商品ID 列表，并支持分页 适用商家： 所有类型商家
注意：
目前只能分别查询在售和待售的商品列表；开始时间和结束时间不能相差超过3个月 此API 目前还未定型，可能在未来进行改进
方法名： searchWareIdInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/wareIdSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/wareIdSearchService?wsdl
输入参数
输出参数
POP Open API
3.4 通过商品ID 查询商品信息API （初版）
功能说明： 通过京东的水平ID 查询商品，可以比较精确的查询 适用商家： 所有类型商家
注意： 此API 目前还未定型，可能在未来进行改进 方法名： searchWareInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/wareInfoSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/wareInfoSearchService?wsdl
输入参数
输出参数
数据类型
✧ 商品信息（WareInfo ）
POP Open API
3.5 商品上下架API
功能说明： 通过京东商品ID ，上架或下架对应商品。 适用商家： 所有类型商家
注意： 每次只能操作一个商品，不支持批量；操作后，系统会有较长的延迟，展示页面才会变化 方法名： updateSaleSate
正式WSDL ： http://gw.shop.360buy.com/services/services/saleStateUpdateService?wsdl 测试WSDL ： http://220.231.59.70/services/services/saleStateUpdateService?wsdl
输入参数
输出参数
POP Open API
4
库存API
功能说明： 根据京东SKU 的id 更新SKU 库存量。 适用商家： 仅LBP 、SOP
通过京东SKU ID获取接口或其他接口已经获取了京东SKU 的ID 。
前提条件： 由于skuId 是Java 的Long 类，所以如果是.Net 对接，则必须把一个叫做skuIdSpecial
的属性设置为true ！
注意： 此API 功能以被SKU 信息修改API 包含，但是可能没有这个API 效率高。 方法名： stockUpdate
正式WSDL ： http://gw.shop.360buy.com/services/services/stockService?wsdl 测试WSDL ： http://220.231.59.70/services/services/stockService?wsdl
4.1 更新SKU 库存API
输入参数
输出参数
数据类型
✧ 库存更新信息（SkuStockUpdata ）
POP Open API
5 售后API
查询退货单及其SKU 信息。
功能说明： 用户退货、拒收后，商品被退回京东备件库，在备件库积累一段时间或一定数量后，将商品
寄回商家，并产生退货单，此API 提供退货单信息查询的功能。
适用商家： 所有类型商家
注意： 商家收货地址是包括邮编的字符串，比如：
“邮编：321061。地址：浙江省金华市婺城区白龙桥镇山回铺村”。 拒收商品一定不会有退货原因，退货商品的退货原因不一定会录入。 发货地址、发货人联系方式，目前没有内容，字段预留。
方法名： searchReturnInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/returnGoodsSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/returnGoodsSearchService?wsdl
5.1 退货收货查询API
输入参数
✧ 查询字段（queryFields 中Field 类型的name ）
POP Open API
输出参数
数据类型
✧ 字段键值对（Field ）
✧ 退货单信息（ReturnInfo ）
POP Open API
✧ 退货物品信息（ReturnItem ）
5.2 退货收货确认API
功能说明： 商家收到退货后，对退货单进行收货确认操作 适用商家： 所有类型商家
注意： 不支持批量确认和部分确认 方法名： searchReturnInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/returnGoodsConfirmService?wsdl 测试WSDL ： http://220.231.59.70/services/services/returnGoodsConfirmService?wsdl
输入参数
输出参数
POP Open API
6
其他API
功能说明： 用于SOPL 订单出库时，获取发货地址列表，LBP 无需调用此接口 适用商家： 仅LBP 、SOPL （SOP 无此功能）
前提条件： 商家通过商家客户端设置了我的发货地址信息，并且设置了默认地址
注意：
SOPL 如果有多个发货地址可以使用本接口，SOP 、LBP 无需调用此接口 LBP 、SOPL 商家，出库使可以使用0表示默认地址
6.1 获取商家发货地址API
方法名： getStockAddress
正式WSDL ： http://gw.shop.360buy.com/services/services/venderOutAddressService?wsdl 测试WSDL ： http://220.231.59.70/services/services/venderOutAddressService?wsdl
输入参数
输出参数
数据类型
✧ AddressInfo 类型
POP Open API
6.2 获取商家物流公司API
功能说明： 获取物流公司列表，用于LBP 、SOPL 出库时、SOP 商家发货时，填写物流公司ID 适用商家： 仅LBP 、SOP （SOPL 此功能）
前提条件： 商家通过商家客户端设置了物流公司信息 方法名： getCompanyCustom
正式WSDL ： http://gw.shop.360buy.com/services/services/logisticsCompanyService?wsdl 测试WSDL ： http://220.231.59.70/services/services/logisticsCompanyService?wsdl
输入参数
输出参数
数据类型
✧ LogisticsCompany 类型
POP Open API
7 商家合作类型说明
8 签名说明
调用接口时需要做签名 签名用参数
加密算法
采用md5加密算法，加密规则暂定为：
venderSign=md5 ( venderKey+ venderId+ tradeNo + venderKey) 其中venderKey 为分配给商家的key （32位数字和大写字母组成的字符串）； venderId 为商家ID ；tradeNo 为操作的流水号；md5加密的结果应转换成大写。 另外，md5为标准的md5算法，主流语言平台都提供了这个算法的支持； 以上伪代码中“+”是字符串连接，PHP 语言中，请使用“. ”而不是“+”。
比如：
商家ID （venderId ）：10001
商家Key （venderKey ）：6F471B736CA9E7A41479F13B6AB496EB 流水号（tradeNo ）：asdf1234
那么 签名（venderSign ）=md5("6F471B736CA9E7A41479F13B6AB496EB"+"10001"+"asdf1234"+ "6F471B736CA9E7A41479F13B6AB496EB")="90CA6C52A17D5D085437887B2162B353"
POP Open API
京东商城 Open API （WebService 版）
1
使用说明 ................................................................................................................................................................ 1 1.1 1.2 1.3 2
在线文档 ........................................................................................................................................................ 1 接入说明 ........................................................................................................................................................ 1 技术说明 ........................................................................................................................................................ 1
订单API . ................................................................................................................................................................ 2 2.1 2.2 2.3 2.4 2.5
获取订单信息列表API ................................................................................................................................ 2 获取单个订单信息API ................................................................................................................................ 6 商家出库操作API ........................................................................................................................................ 7 面单打印API （发货到京东） . ................................................................................................................... 8 SOP 发货操作API ..................................................................................................................................... 11
3 商品API . .............................................................................................................................................................. 12 3.1 3.2 3.3 3.4 3.5
SKU 信息查询API...................................................................................................................................... 12 SKU 信息修改API...................................................................................................................................... 13 通过条件查询商品ID 列表 API（初版） .............................................................................................. 14 通过商品ID 查询商品信息API （初版） . .............................................................................................. 15 商品上下架API . .......................................................................................................................................... 16
4 库存API . .............................................................................................................................................................. 17 4.1
更新SKU 库存API .................................................................................................................................... 17
5 售后API . .............................................................................................................................................................. 18 5.1 5.2
退货收货查询API ...................................................................................................................................... 18 退货收货确认API ...................................................................................................................................... 20
6 其他API . .............................................................................................................................................................. 21 6.1 6.2
获取商家发货地址API .............................................................................................................................. 21 获取商家物流公司API .............................................................................................................................. 22
7 8
商家合作类型说明 ............................................................................................................................................. 23 签名说明 .............................................................................................................................................................. 23
POP Open API
京东POP Open API
（WebService 版） 2011-05-20
1 使用说明
主页：http://gw.shop.360buy.com/
正式版：http://gw.shop.360buy.com/doc/doc.html 测试版：http://220.231.59.70/doc/doc.html 文档会进行定期更新，请以最新在线文档为准！ 正式版文档里面包含正式发布的API ；
测试版文档一般要比正式版更新，里面包含了还没发布的新API 或者更新。
1.1 在线文档
1.2 接入说明
使用API 需要提供商家编号(venderId) ，商家密钥(venderKey、secretcode) ，如何使用，请参考签名说明。
测试时，向API 产品经理提供商家基本信息（尤其是合作类型），API 产品经理会根据情况给予测试环境的商家编号和密钥。商家的开发人员可以在测试环境的地址使用测试账号信息进行测试。
正式对接时，商家编号可以在京东商家后台(http://shop.360buy.com/) 中看到（首页“用户ID ：10XXX ”或者 我的店铺“商家编号：10XXX ”，注意不是“店铺ID ”）；正式环境的商家密钥，在向API 产品经理确认测试完成并且给予基本信息、IP 后，由API 产品经理开通并将密钥以邮件附件的形式发送给商家的京东负责人。
1.3 技术说明
京东开放平台API ，目前以SOAP WebService的方式提供。
目前主流语言平台，比如：.Net 、Java 、PHP 、vb6、C/C++等，都可以接入。 由于要使用IP
本API 文档由 杨宇帆 整理
POP Open API
2
订单API
功能说明： 根据检索条件，进行订单的查询，获取订单列表（支持分页）。 适用商家： 所有类型商家
注意事项： 开始时间和结束时间不得超过1个月！此查询类接口不能过于频繁的调用！
字段列表，如果为空，则返回默认字段；不为空，返回选择的字段，订单ID 不选也会返回
2.1 获取订单信息列表API
查询的时候，时间是下单的时间，考虑到等待付款的问题，请把开始时间调整到当前时间24个小时以上（一般26-48个小时应该没问题），就不会漏单了。请不要把间隔调太大，否则很容易查询超时！
方法名： searchOrderInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/orderSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/orderSearchService?wsdl
输入参数
查询的订单的状态
POP Open API
可选字段
POP Open API
输出参数
数据类型
✧ API 返回结果（ApiResult ）
*！
✧ 订单查询返回结果（ApiOrderQueryDetail ）
✧ 订单信息（Order ）
POP Open API
✧ 订单中商品（Ware ）
✧ 订单中收货人信息（Consignee ）
POP Open API
2.2 获取单个订单信息API
功能说明： 根据京东订单ID 获取单笔交易订单的详细信息。 适用商家： 所有类型商家
注意事项： 此API 必须通过批量查询API 获取京东订单ID 后才能使用 方法名： searchOrderInfoByOrderId
正式WSDL ： http://gw.shop.360buy.com/services/services/orderSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/orderSearchService?wsdl
输入参数
输出参数
POP Open API
2.3 商家出库操作API
功能说明：
通知京东订单已经出库，京东会按照订单信息，自动减去相应库存。 LBP 和SOPL ，由于发往京东配送中心，还需输入一些额外信息。
适用商家： 非FBP （LBP 、SOPL 、SOP ）
注意事项： 一次只能出库一个订单。各个类型商家输入的参数有所不同。
LBP 、SOPL 商家必须设置默认发货地址！
方法名： outStorage
正式WSDL ： http://gw.shop.360buy.com/services/services/orderSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/orderOutStorageService?wsdl
输入参数
输出参数
数据类型
✧ 出库信息（OrderOutData ）（请注意不同类型商家可以输入的值）
为“空”的字段，系统会忽略里面的内容，请不要填写！
POP Open API
2.4 面单打印API （发货到京东）
功能说明： LBP 、SOPL 出库时，需要把打印的面单贴在包装上 适用商家： 仅LBP 、SOPL （SOP 不适用此API ）
注意事项： 必须先获取订单id 。最好先出库后打印订单，否则打印结果的出库时间是错误的。
打印必须使用京东的彩色面单纸进行套打！
方法名： print
正式WSDL ： http://gw.shop.360buy.com/services/services/orderPrintService?wsdl 测试WSDL ： http://220.231.59.70/services/services/orderPrintService?wsdl
输入参数
输出参数
数据类型
✧ 打印结果（PrintResult ）
● htmlContent ：返回面单页面的HTML 代码，使用时把{barcode_url}替换成图片的地址即可。 ● imageData ：是条形码图片二进制内容进行base64编码的结果，内容为图片文件根据data uri协议编
码的结果。比如data:image/jpeg;base64,/9j/4AAQ...(图片内容base64编码) image/jpeg表示是jpg 文件，image/gif、image/png分别表示gif 、png 文件。
POP Open API
● 如果打印的系统安装的浏览器是IE6、IE7，由于不支持data uri，必须将图片的base64编码（不含前面
data:image/jpeg;base64,）进行base64解码形成二进制内容，然后根据定义的图片格式保存成图片，然后将图片地址替换掉html 中的{barcode_url}既可。
● 如果不考虑IE6、7，浏览器是IE8或以上版本，或者使用Firefox 、Chrome 浏览器，可以直接把
imageData 中的内容替换掉html 中的{barcode_url}既可。
（打印结果、彩色面单纸参见下两页）
京东面单示例
图1面单打印结果示意（纵向A4，内容可能会有略微不同）
POP Open API
图2京东面单纸示意图（纵向A4，从京东购买）
POP Open API
2.5 SOP 发货操作API
功能说明： SOP 对订单进行发货操作，先出库后发货；发货操作意味着货物上路 适用商家： 仅SOP
注意事项： 一次只能发货一个订单。物流公司为0自送时，运单号必须为空，否则必填！ 方法名： delivery
正式WSDL ： http://gw.shop.360buy.com/services/services/orderDeliveryService?wsdl 测试WSDL ： http://220.231.59.70/services/services/orderDeliveryService?wsdl
输入参数
输出参数
数据类型
✧ SOP 发货信息（SopDeliveryData ）
POP Open API
3 商品API
通过输入商品ID 列表、京东SKUID 或者商家SKUID ，来查询SKU 信息。 京东商品ID 列表： 返回所有选定商品的所有SKU 信息列表
功能说明：
返回对应SKU 的信息列表（顺序一一对应）， 京东SKUID 列表：
如果某个ID 查询失败，对应的SKU 信息为空 商家SKUID 列表： 返回对应SKU 信息列表，规则同上
3.1 SKU 信息查询API
适用商家： 所有类型商家
注意事项： 根据“ID 类型Type ”选择输入哪种ID 的列表 方法名： searchSkuInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/skuInfoSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/skuInfoSearchService?wsdl
输入参数
输出参数
POP Open API
数据类型
✧ SKU 信息（SkuInfo ）
3.2 SKU 信息修改API
功能说明： 根据商家ID 和京东SKUID 修改SKU 的信息，包括SKU 的京东价、库存和外部ID 。 适用商家： 所有类型商家，但
FBP 不能修改库存
SKU 的属性信息，暂不提供！
注意：
如果商家SKUID 、京东价、库存都不填，即没有修改任何信息，报错 一次只能修改一个字段，不可以同时修改多个字段 目前暂不支持修改京东价！
方法名： updateSkuInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/skuInfoUpdateService?wsdl 测试WSDL ： http://220.231.59.70/services/services/skuInfoUpdateService?wsdl
输入参数
输出参数
POP Open API
3.3 通过条件查询商品ID 列表 API（初版）
功能说明： 通过各种商品的字段进行搜索，返回商品ID 列表，并支持分页 适用商家： 所有类型商家
注意：
目前只能分别查询在售和待售的商品列表；开始时间和结束时间不能相差超过3个月 此API 目前还未定型，可能在未来进行改进
方法名： searchWareIdInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/wareIdSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/wareIdSearchService?wsdl
输入参数
输出参数
POP Open API
3.4 通过商品ID 查询商品信息API （初版）
功能说明： 通过京东的水平ID 查询商品，可以比较精确的查询 适用商家： 所有类型商家
注意： 此API 目前还未定型，可能在未来进行改进 方法名： searchWareInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/wareInfoSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/wareInfoSearchService?wsdl
输入参数
输出参数
数据类型
✧ 商品信息（WareInfo ）
POP Open API
3.5 商品上下架API
功能说明： 通过京东商品ID ，上架或下架对应商品。 适用商家： 所有类型商家
注意： 每次只能操作一个商品，不支持批量；操作后，系统会有较长的延迟，展示页面才会变化 方法名： updateSaleSate
正式WSDL ： http://gw.shop.360buy.com/services/services/saleStateUpdateService?wsdl 测试WSDL ： http://220.231.59.70/services/services/saleStateUpdateService?wsdl
输入参数
输出参数
POP Open API
4
库存API
功能说明： 根据京东SKU 的id 更新SKU 库存量。 适用商家： 仅LBP 、SOP
通过京东SKU ID获取接口或其他接口已经获取了京东SKU 的ID 。
前提条件： 由于skuId 是Java 的Long 类，所以如果是.Net 对接，则必须把一个叫做skuIdSpecial
的属性设置为true ！
注意： 此API 功能以被SKU 信息修改API 包含，但是可能没有这个API 效率高。 方法名： stockUpdate
正式WSDL ： http://gw.shop.360buy.com/services/services/stockService?wsdl 测试WSDL ： http://220.231.59.70/services/services/stockService?wsdl
4.1 更新SKU 库存API
输入参数
输出参数
数据类型
✧ 库存更新信息（SkuStockUpdata ）
POP Open API
5 售后API
查询退货单及其SKU 信息。
功能说明： 用户退货、拒收后，商品被退回京东备件库，在备件库积累一段时间或一定数量后，将商品
寄回商家，并产生退货单，此API 提供退货单信息查询的功能。
适用商家： 所有类型商家
注意： 商家收货地址是包括邮编的字符串，比如：
“邮编：321061。地址：浙江省金华市婺城区白龙桥镇山回铺村”。 拒收商品一定不会有退货原因，退货商品的退货原因不一定会录入。 发货地址、发货人联系方式，目前没有内容，字段预留。
方法名： searchReturnInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/returnGoodsSearchService?wsdl 测试WSDL ： http://220.231.59.70/services/services/returnGoodsSearchService?wsdl
5.1 退货收货查询API
输入参数
✧ 查询字段（queryFields 中Field 类型的name ）
POP Open API
输出参数
数据类型
✧ 字段键值对（Field ）
✧ 退货单信息（ReturnInfo ）
POP Open API
✧ 退货物品信息（ReturnItem ）
5.2 退货收货确认API
功能说明： 商家收到退货后，对退货单进行收货确认操作 适用商家： 所有类型商家
注意： 不支持批量确认和部分确认 方法名： searchReturnInfo
正式WSDL ： http://gw.shop.360buy.com/services/services/returnGoodsConfirmService?wsdl 测试WSDL ： http://220.231.59.70/services/services/returnGoodsConfirmService?wsdl
输入参数
输出参数
POP Open API
6
其他API
功能说明： 用于SOPL 订单出库时，获取发货地址列表，LBP 无需调用此接口 适用商家： 仅LBP 、SOPL （SOP 无此功能）
前提条件： 商家通过商家客户端设置了我的发货地址信息，并且设置了默认地址
注意：
SOPL 如果有多个发货地址可以使用本接口，SOP 、LBP 无需调用此接口 LBP 、SOPL 商家，出库使可以使用0表示默认地址
6.1 获取商家发货地址API
方法名： getStockAddress
正式WSDL ： http://gw.shop.360buy.com/services/services/venderOutAddressService?wsdl 测试WSDL ： http://220.231.59.70/services/services/venderOutAddressService?wsdl
输入参数
输出参数
数据类型
✧ AddressInfo 类型
POP Open API
6.2 获取商家物流公司API
功能说明： 获取物流公司列表，用于LBP 、SOPL 出库时、SOP 商家发货时，填写物流公司ID 适用商家： 仅LBP 、SOP （SOPL 此功能）
前提条件： 商家通过商家客户端设置了物流公司信息 方法名： getCompanyCustom
正式WSDL ： http://gw.shop.360buy.com/services/services/logisticsCompanyService?wsdl 测试WSDL ： http://220.231.59.70/services/services/logisticsCompanyService?wsdl
输入参数
输出参数
数据类型
✧ LogisticsCompany 类型
POP Open API
7 商家合作类型说明
8 签名说明
调用接口时需要做签名 签名用参数
加密算法
采用md5加密算法，加密规则暂定为：
venderSign=md5 ( venderKey+ venderId+ tradeNo + venderKey) 其中venderKey 为分配给商家的key （32位数字和大写字母组成的字符串）； venderId 为商家ID ；tradeNo 为操作的流水号；md5加密的结果应转换成大写。 另外，md5为标准的md5算法，主流语言平台都提供了这个算法的支持； 以上伪代码中“+”是字符串连接，PHP 语言中，请使用“. ”而不是“+”。
比如：
商家ID （venderId ）：10001
商家Key （venderKey ）：6F471B736CA9E7A41479F13B6AB496EB 流水号（tradeNo ）：asdf1234
那么 签名（venderSign ）=md5("6F471B736CA9E7A41479F13B6AB496EB"+"10001"+"asdf1234"+ "6F471B736CA9E7A41479F13B6AB496EB")="90CA6C52A17D5D085437887B2162B353"