导航


1. 术语解释 2. 授权问题
3. 沙箱及测试问题 4. 开发规范问题
5. 商品及sku接口问题 6. 订单接口问题
7. 京东快递问题  

术语解释

1.  通用应用

通用应用是指ISV第三方软件开发商为京东的商家提供软件或相关服务时创建的应用类型。如果您想为京东的商家提供ERP软件、CRM软件、代运营、订单生产、物流软件、分析工具、模板装修等服务,需要申请“通用应用”。ISV软件开发商接入流程请参见http://help.jd.com/jos/question-705.html


2.  无线买家应用

移动手机端适用,无需授权,可调用无线API

 

3.  网站应用

广告网盟,无需授权,可调用CPS接口

 

4.  授权登录

京东账号授权登录第三方网站,指京东的用户可直接使用京东账号登录您自有的网站,又称联合登录或单点登录(SSO)

授权问题

1.  商家应用,授权时报“容器检查登录用户不在应授权用户中”

提示容器检查登录用户不在应授权用户中,是指在授权验证时,授权系统会去POP商家信息库中查询并比对您的店铺账号和密码,这个验证过程未通过。

可能的原因有:

1)您的用户名不正确,使用您登录shop.jd.com的用户名密码进行授权; 

2)您未在京东开通店铺;

3)您的店铺已到期。请您先与POP运营人员(您开通店铺时,POP会指定一名运营人员与您对接,如您是技术人员,可咨询您公司负责开通京东店铺的负责人)联系确认店铺账号的有效性。


2.  授权时报“系统繁忙”

请确认您的应用类型与对应的授权方式。

通用应用请参考http://help.jd.com/jos/question-594.html;

商家应用请您留意创建应用时的流程提示信息

无线应用、网站应用、授权登录无需进行授权


3.  授权时报“用户暂被锁定,请联系400-xxxx-xxxx”

原因 1)您的用户名不正确,使用您登录shop.jd.com的用户名密码进行授权;2)您的用户名被系统定为风险用户,您可尝试修改密码后再次进行授权,或联系POP运营确认您账户的安全性。


4.  授权时报:没有权限的授权类型

您使用了错误的授权方式,请检查您的应用类型与相对应的授权方式


沙箱及测试问题

1.  我在正式环境下申请的token在沙箱中使用时报“无效token”

正式环境与沙箱环境是两套系统,沙箱环境等于测试环境,appkey,secret和token需要重新申请

 

2.  沙箱环境:平台连接后端服务处理过程中出现未知异常信息

如果您是在沙箱中,表示沙箱环境暂时无法提供这个接口

 

3.  沙箱环境:添加商品接口,SDK中显示outer_id可以为空,但如果不输入outer_id会报“参数outer_id不合法”

2013年4月25日更新的sdk增加了outer_id,但沙箱环境未同步更新


4.  沙箱环境:调用接口时报“方法名不存在”

沙箱环境从2012年11月部署之后未更新,此后在接口和sdk方面的升级和更新内容,在沙箱中均无法使用,请您尝试在正式环境中调用接口。


开发规范问题

Q:调用API接口的入口地址是什么?

A:沙箱环境入口地址:http://gw.api.sandbox.360buy.com/routerjson

正式环境入口地址:http://gw.api.360buy.com/routerjson


商品及sku接口问题
Q:sku是什么意思?
A:决定于一款可下单、可访问的最小商品单位。

Q:商品价格、库存和商品sku价格、库存有何区别?
A:价格包含product价格(商品价格)和sku价格、库存包含product库存和sku库存。

Q:京东商品页面上显示的库存量,是商品库存还是sku库存?
A:若是卖家后台商品查询展示页面,则指商品库存;若是前台单品页,则指sku库存。

Q:sku总库存是否可以修改为0?若sku总库存修改为0,或者售卖为0,商品是否自动下架?
A:sku总库存为0,商品不会自动下架,如需下架,需要调取商品下架接口(360buy.ware.update.delisting)操作。

Q:修改商品接口可以修改库存量么?
A:修改商品接口(360buy.ware.update)不能修改商品库存量,但是可以根据sku_stocks字段修改sku的库存。

Q:商家后台有140条上架商品,但是API只能下载到86条上架商品,为什么?
A:在商家后台检索出的是全部产品信息,而通过获取商品上架的商品信息接口(360buy.ware.listing.get)调取时,start_modified和end_modified如果不输入,默认返回半年内的上架产品信息。另外,请确认token是否有误。

Q:上传日志中发现,有大量的因为图片因素上传失败的记录,而且是全部是连续相同的上传失败描述。失败描述:11201100:这不是一个有效的图片地址。随机抽查几件商品,单独上传,发现全部可以正常上传。为什么?
A:非京东链接的图片,在保存后,系统会尝试对此类链接进行抓取替换,若抓取不成功或超时,将对原链接进行删除处理。如果连续相同上传失败,有可能是那个时段贵司图片系统网络问题所致。

Q:商品若处于下架状态,商品详情会正常显示么?
A:商品下架,京东前台不显示价格及库存,其他信息会正常显示。

Q:商家后台添加商品时描述图片显示正常,保存并上架后在产品页面就无法显示图片了,为什么?
A:非京东链接的图片,在保存后,系统会尝试对此类链接进行抓取替换,若抓取不成功或超时,将对原链接进行删除处理。建议还是采用稳定的图片空间服务来生成图片链接,例如京东图片空间系统。

Q:若必须使用线上环境测试,是否可以隐藏相关测试商品不被京东顾客查询和购买?或其它方式方法即可实现测试又不影响到顾客体验?正式环境如果产生交易怎么办?
A:非常抱歉,目前正式环境上无法隐藏数据真实数据,测试环境(沙箱)和正式环境是分开的两套系统。您可以在正式环境测试,尝试执行商品上架、商品购买、商品出库等流程,建议您将商品名称定为“测试商品请勿购买”等以防止外部交易。对于产生订购的测试商品,需要按流程发货,且会按照入驻合同扣除相应扣点,体现在月底结算中。

Q:同步库存延时一般多长时间?是否会造成超卖?
A:库存同步延时,一般不会超过两分钟,原因是数据需要在京东内部系统流转。您可以将库存多备一些,不会经常造成超卖,一般都是极特殊的情况。

Q:通过哪个接口可以查询到冻结库存(已占用数),或者通过哪个接口可以间接的计算出冻结库存?
暂A:时没有接口能够查出冻结库存。

Q:用PHP调用根据商品ID,销售属性值ID增加图片接口(360buy.ware.propimg.add),不把image验签就报“无效签名”,签了就报“参数image不合法”,请问怎么处理?
A:图片image以流的方式发送。具体请参考http://bbs.zone.jd.com/forum.php?mod=viewthread&tid=1112&extra=page%3D1

Q:商品详情PV是否有相关接口?
A:京东数据罗盘接口后续会有更新,可以满足部分数据统计功能。商品详情PV接口目前还未推出。

Q:获取商品上架的商品信息(360buy.ware.listing.get)如不传时间参数,是返回全部上架商品信息么?
A:不是,默认返回半年内的上架商品信息。

Q:商品上架后,多久能被搜索引擎搜索到?
A:商品上架三个小时后,搜索引擎才可以搜到该商品。

Q:添加商品API自定义属性inputStr包含符号“/”就导致调用失败,报商品的属性列表格式错误,怎么办?
A:请您将“ / ”换成“ \ ”重试一下。

Q:图书品类添加商品允许的特殊字符有?
A:数字 字母 中文 空格 @ # $ % + - [ ] _ • . & = 、 : : , , 《 》 ( ) < > “ ” ' "

Q:新开的京东店铺,刚添加的品牌在京东后台可以添加商品,但是调用添加商品API时出现错误:“品牌数据校验错误”,为什么?
A:这个问题需要商家联系POP运营对接人,在店铺中做相应的品牌绑定设置即可。

Q:添加商品接口中的图片参数,文档中只有一个,如果多图的情况怎么发送图片呢?主图和明细图如何区分?
A:可以通过根据商品Id,销售属性值ID增加图片接口(360buy.ware.propimg.add
)上传更多商品图片,并设定某张图片为主图。通过此接口新增的图片会覆盖添加商品时上传的主图。

Q:添加商品这个接口,如果在描述字段添加图片,接口支持吗?
A:Notes相当于一个编辑器的作用,支持html代码,可以通过代码添加图片。

Q:添加商品接口ware_image字段,通过url获取图片,报错"11201100:this is not a valid image url11201100:这不是一个有效的图片地址",请问会是什么问题呢?
A:非京东链接的图片,系统会尝试对此类链接进行抓取替换,若抓取不成功或超时,可能提示图片无效。请尝试采用稳定的图片空间服务来生成图片链接,例如京东图片空间系统。

Q:添加商品接口(360buy.ware.add)有个字段attributes(商品属性列表)是必填项,如果该类目没有商品属性(下拉框及勾选框)应该填写什么呢?
A:如果确定没有,可以不设置该参数。

Q:是否有方法能让缺货的尺码不做展示或者顾客点不下去呢?
A:前台不做展示的商品是下架商品,您的这款商品只是断码,如果做了下架,后续补货的时候是会增加工作量的。另外,顾客是无法下单缺货商品的,缺货商品在购物车中是置灰的。

Q:在京东后台做质检以及批量分类时发现好几百页的商品都是重复商品,请问可否解决此问题?
A:请先排查重复信息的产生方式,如商家后台手工录入、商家助手上传、接口上传,确认是否有重复上传。

Q:当根据商品ID,销售属性ID增加图片(360buy.ware.propimg.add)时,会不会覆盖掉增加商品时的那张主图呢?
A:当根据商品ID,销售属性ID增加图片时,只要不把新增图片设置成主图,即主图标志不变,就不会覆盖掉增加商品时的那张主图。

Q:添加商品接口(360buy.ware.add)的length、wide、high、weight几个字段是必填字段,对于图书商品是否可以变成可选字段?
A:length、wide、high、weight等字段是为计算商品运费所用,是每个商品必须的。由于每个图书商品间大小重量差异不是太大,可以给每本书一个均值。但还请尽量精确,以免体积重量差异过大,影响后期运费结算。

Q:添加商品接口(360buy.ware.add)返回如下错误:{"error_response":{"code":"11100010","zh_desc":"11100010:商家类目没有设置扣点","en_desc":"11100010:vender category not rate"}}",为什么?
A:首先请确认下是否已经设置了扣点。如果已经设置,要等10分钟API即能获取。

Q:如何知道某个属性是否为必须输入的属性?
A:通过获取类目属性信息接口(360buy.ware.get.attribute )返回字段中的is_req(是否必填)字段,true表示必填的属性,在添加商品时需要设置。

Q:添加商品接口(360buy.ware.add)中,option_type传值onsale,是不是默认就把商品上架?不需要再执行360buy.ware.update.listing接口?
A:如果option_type传值onsale,即实现商品上架,不需要再执行商品上架接口(360buy.ware.update.listing),但如果option_type不传值,默认商品下架。

Q:上传商品图片大小的限制是多少?
A:关于商品主图大小限制,比例为1:1,长宽不低于800像素,大小须在1M以内。

Q:修改SKU价格信息接口(360buy.sku.price.update),price和jd_price哪个才是商品在京东前台显示的实际销售价格?
A:price为sku京东价,是京东前台显示的价格。

Q:添加商品时,报sku_prices,sku_properties,sku_stocks(FBP类型商家不需要验证sku_stocks),outer_id个数不相同,是什么问题?
A:sku_prices、sku_properties、sku_stocks和outer_id四个参数的sku组数必须保持一致,如不一致就会报错。

Q:图书商品(没有sku的商品)如何输入sku?
A:由于图书类商品比较特殊,基本没有sku概念。因此如确定没有sku属性,则sku_prices、sku_properties、sku_stocks和outer_id四个参数均无需输入,但通过接口添加商品时,系统会默认返回一个skuid。

Q:如果添加商品时不输入sku相关信息,如何更新库存呢?
A:即使添加商品时不输入sku属性,系统也会默认返回一个sku_id,根据这个sku_id更新库存即可。

Q:请问商品主图怎么修改?
A:可以先通过360buy.ware.propimg.add接口,将参数is_main_pic设置为true以添加新主图,再通过360buy.ware.propimg.delete接口删除先前的主图。

Q:上传商品接口为什么比其他接口慢?
A:由于上传商品接口需要上传图片等信息,确实比其他接口稍慢一些。

Q:流水号trade_no是什么意思?
A:流水号trade_no可以说是表示一次操作,不与已经使用的流水号重复就可以了。

Q:SKU外部ID表示什么意思?
A:SKU外部ID(outer_id)是指商品本身的货号,对应商家后台“商家skuid”。

Q:京东内部SKU的ID和SKU的京东价表示该商品在京东上的商品编号和价格么?
A:是的。

Q:请问哪个字段是标识商家后台“主体”部分信息的?
A:“主体”信息对应接口中attributes字段。

Q:添加商品attributes(商品属性列表)字段,多组之间用"|"分隔,格式:aid:vid或 aid:vid|aid1:vid1或aid1:vid1,不知道aid和vid是指什么值?
A:aid表示是属性的id,vid表示属性值的id,如何取得这些值可以参考面向商家服务->类目服务中的接口。

Q:查询单个商品详情信息接口,返回的图片是什么样的?我这通过商品ID返回的是一张图片的从大到小的不同尺寸,有没有返回商品的多个不同图片的?
A:根据商品ID,查询单个商品的详细信息接口(360buy.ware.get)只能返回商品主图地址,不能返回多个不同图片。根据商品ID,销售属性值ID查询图片接口(360buy.ware.propimgs.get),这个接口可以获取多张产品图片。

Q:已知一个skuid,怎么组装成一个URL,点击这个URL,就跳到商品详情页呢?如http://item.jd.com/1005141304.html
A:按照item.jd.com/skuid.html直接拼接即可。

Q:添加商品的时候如何通过代码去添加商品属性里的值?
A:// 添加商品属性示例:
wareAddRequest.setStockNum("100");
wareAddRequest.setAttributes("3205:64734|3206:22107"); //商品属性列表,多组之间用"|"分隔,格式:aid:vid|aid1:vid1(需要从类目服务接口获取)
// 添加SKU属性示例:
wareAddRequest.setSkuProperties("1000000041:150029941^1000000046:150029944|1000000041:150029941^1000000046:150029943");
wareAddRequest.setSkuPrices("300|500");
wareAddRequest.setSkuStocks("10|90");
// 获取类目属性值信息,可以参考接口360buy.ware.get.attvalue
调用示例:
CategoryAttributeValueSearchRequest request = new CategoryAttributeValueSearchRequest();
request.setAvs("8739");
request.setFields("name,status,index_id,aid,vid");// 不是必须的
CategoryAttributeValueSearchResponse response = client.execute(request);

Q:有获取从未上架的商品的接口吗?
A:现在没有直接获取从未上架的商品接口,您可以调取检索商品信息接口(360buy.wares.search),根据返回结果中的ware_status来筛选未上架的商品。

Q:商家后台是否可以添加商品属性和属性值?
A:仅可添加自定义属性值。

Q:produt_no表示什么呢?京东内部SKU的ID与京东内部商品ID有什么区别么?
A:produt_no对应商家后台“商品货号”。SKU指的是可销售商品的最小单位,一个ware_id对应多个sku_id(是指按商品的尺码颜色细化后的id,比如:商品id为12345,尺码有X和L,则skuid可以定义为12345x和12345l)。Ware_id和skuid指的是京东内部可识别的id,而我们也提供了商家自有的ware_id(对应商家自有的produt_no)和细化后的sku_id(对应商家自有的outer_id)。

Q:现在我们使用的API系统对接,同一款不同色的商品对接后都是单独的链接,如何实现同款不同颜色放到一个链接里面呢?
A:不支持此功能。同款不同色不同型号的商品在京东的商品系统中是作为不同sku来标识的,代表可销售的最小单位,生成的也是不同的链接。

Q:调取添加商品接口,报“11201048:商品描述过长”,请问商品的notes字段最长不能超过多少个英文字符?
A:Notes字段最长不能超过3万个英文字符。

Q:从商家后台,点击商品名称的链接时,已经能够看到商品详情了,但是为什么进入店铺首页后,仍然是看不到商品呢?
A:需要20左右的时间才能在前台可见。

Q:调取360buy.ware.sku.update,报“该商家外部ID重复了”,是什么问题?
A:目前针对outerid重复的限制不仅限于单个商品内,是针对于与整个店铺里面的所有商品,还请您检查所有商品的outerid是否重复。

Q:sku总库存就是商品信息的库存么?似乎没有商品库存接口,如果修改商品信息来达到这个效果,有那么多必填字段,似乎成本太高了?
A:sku总库存可以理解为商品库存,没有商品库存相关接口,修改库存请调取修改SKU库存信息接口(360buy.sku.stock.update),不必通过修改商品接口来实现。

Q:上传图片是不是和提交商品时上传主图的参数数据类型一样?都需要base64_encode?
A:如果是指上传主图,通过360buy.ware.propimg.add(根据商品Id,销售属性值Id增加图片)操作即可,不需要经过base64_encode转码。

Q:京东平台商品批量自动下架,服务器没有异常,系统也没有作任何改动,是什么原因?
A:如果是店铺合同到期了,可能会导致这种情况发生。

Q:请问添加商品api中描述的attributes参数:输入类型input_type为1或2,则attributes为必填属性;发现input_type为1、2的属性有很多,难道这边开发这些属性都必须上传的吗?还是只需要上传部分关键属性和销售属性即可?
A:属性是否必填,请通过360buy.ware.get.attribute接口is_req字段获取。

Q:京东是否为下单立减库存?
A:用户下单后,系统冻结已拍库存,总库存不变,冻结库存在商家后台可见,暂时无法通过接口获取;订单出库后,实时减库存。

Q:接口是否支持某商品部分sku上架,待售完后再将其他sku上架?
A:目前,接口仅支持商品级上架(360buy.ware.update.listing),无法做到部分sku上架,部分sku下架的功能。

Q:通过接口上传商品,商品属性里有CSS代码,但商品上架以后发现CSS代码被删除了。是这方面有屏蔽吗?
A:商品描述不允许有CSS代码,但允许出现行内样式,京东商品中心会进行规则过滤。

Q:查询或添加商品主图时,报“属性值所属属性不是颜色”,是什么问题?
A:此接口输入参数为商品ID及颜色属性ID,若提交的属性值ID不是颜色属性,即会报错。

Q:360buy.ware.propimg.add这个接口在处理image字段时的方法和360buy.ware.add处理ware_image字段是不一样的吗?有示例么?
A:【添加商品接口】360buy.ware.add调用示例 (JAVA PHP .NET)
http://bbs.zone.jd.com/forum.php?mod=viewthread&tid=1111&extra=page%3D1
【添加商品属性主图接口】360buy.ware.propimg.add 调用示例 (JAVA PHP .NET)
http://bbs.zone.jd.com/forum.php?mod=viewthread&tid=1112&extra=page%3D1

Q:京东后台“库存总数”包含“已占用数”么?这是sku库存还是商品库存?如库存总数为9,已占用数为1,可以了解为前台页面可售数量为8吗?
A:商家后台“库存总数”包含“已占用数”,这个库存是sku库存。另,通过360buy.ware.sku.get接口获取的库存总数(stock_num)也是包含“已占用数”的。

Q:调取添加商品接口,报“商品的属性列表格式错误”,是什么问题?
A:请确认是自定义属性inputStr是否包含了特殊符号,目前仅支持\\ + - ! ( : ^ [ ] \ { } ~ * | & ;

Q:调取添加商品接口,报“数字格式非法,不是有效的数字”,为什么?
A:Attributes字段对应京东商家后台中下拉框或勾选框等无需手动填写的属性。
input_pids字段及input_strs字段对应京东商家后台中需要手动填写的属性。
ISBN及|版次等属性在商家后台需要手动填写,因此需要通过input_pids字段及input_strs字段提交。


Q:添加商品接口中,input_type为1或2时,值填写到哪?input_type为3时,是不是填写到input_strs这里呢?那input_pids又是什么?
A:input_type为1或2时,对应商家后台勾选框、下拉框等无需手动填写的属性,通过获取类目属性信息接口(360buy.ware.get.attribute)获取。input_type为3时,对应商家后台需要手动填写的属性,通过获取类目属性信息接口(360buy.ware.get.attribute)获取。input_strs是用户自行输入的类目属性ID;input_pids是用户自行输入的属性值。

订单接口问题
Q:订单接口是否能获取配送中心名称?
A:获取面单打印数据(360buy.order.print.data.get)
SOP获取面单打印数据(360buy.order.sop.print.data.get)
LBP获取面单打印数据(360buy.order.lbp.print.data.get)
这三个接口提供了配送中心字段(cky2_name),您可以先使用订单下载,再调用此接口获取配送中心信息。


Q:接口是否支持修改快递单号?
A:接口支持SOP、SOPL、LBP类型商家修改运单号。


Q:接口是否支持多库发货?
A:接口支持SOP类型商家多库发货,不同物流公司名及运单号用逗号分隔。


Q:商家后台是有数据,但是通过API获取订单数据为空?
A:错误的输入参数(如时间等)会导致接口返回为空,请查看。


Q:在使用订单检索(360buy.order.search)获取订单时,当status=TRADE_CANCELED时,返回的json数据结构与别的状态有所不同,导致解析时出错。主要是consignee_info这个字段,当status=TRADE_CANCELED时它是一个字符串属性,当为其他状态时,它是一个对象。请问这个应该怎么处理?
A:这个接口是这样设计的,当查询的订单是已删除的,不会返回用户信息的,所以就没有返回一个对象,而是返回一个字符串。
在status=TRADE_CANCELED时返回的是字符串consignee_info 为""
其他非status=TRADE_CANCELED 状态时查询出的ConsigneeInfo 对象consignee_info 一定不为null
在解析json串时可以先判断consignee_info是否是"",然后分开解析。


Q:京东数据罗盘/经营概况中的“下单单量”与接口获取的订单数量不一致,请问我怎样核对每天的订单,防止漏单?
A:数据罗盘与商家后台的订单系统分属不同部门,统计的标准和时效是不同的,对于数据罗盘的统计标准,您可以咨询客服或POP运营人员。如果您是为了防止漏单,你只需要对照商家后台的“订单管理”即可。


Q:京东是否提供修改订单的接口,如删除/修改订单商品数量?
A:我们有订单查询的接口,可以进行出库等操作,但不支持商家删除订单或修改订单的商品数量。您可以请客户在订单中申请这件商品的退货(可退订单其中的一件),按退货流程解决(我们有退货接口)。你的商品在京东平台展示,客户下单,等于已经达成了协议,所以修改订单是需要客户来发起的。如果商家可以修改订单的数据,那库存的概念也就没有意义了。


Q:商家后台有一个订单没有付款时间,也没有从API返回,为什么?能出库么?
A:用户付款之后还要经过对账过程,走不同的系统,最后确认才能显示在商家后台里,这个过程需要一段时间,所以无法及时显示出来。但可以肯定,只要商家后台出现的订单(在线支付类型)都是确认已付款的,您可进行出库操作。


Q:库存对接方面不稳定,一款商品明明没货了,但是京东前台还是可以购买,然后造成缺货订单。为什么?库存对接时间是多久?
A:因为商品数据实时更新。如果不能重现现象,我们是暂时无法排查到问题原因。我们自测的库存同步时间平均是2分钟。


Q:京东对商家要求的发货时间是从什么时间算起的?
A:京东所指的发货延迟是按照可生成订单时间算起的,以商家后台能看到订单的时间为准。


Q:在商家后台“订单查询与跟踪”可以查到的订单,在“订单打印”查不到,为什么?
A:订单是“等待出库”状态,“等待出库”状态的订单与“订单打印”中的订单数据来源不一样,因此“等待出库”状态的订单在“订单打印”里查不到,只有出库后才能查到。


Q:京东FBP店铺,在调用订单接口时,任何一种状态都不能拿到数据,都报“订单状态不适用于当前商家”,为什么?
A:FBP类型商家,需调取FBP订单检索接口(360buy.order.fbp.search)检索订单,调取FBP获取单个订单接口(360buy.order.fbp.get)获取订单。


Q:通过接口获取结单时间 (order_end_time)为0001-01-01 00:00:00,是什么原因?
A:建议您在程序中做一下验证,如果返回的内容为“0001-01-01 00:00:00”和“1970-01-01 00:00:00”,可认为此订单为未完成状态。


Q:订单批量导出时,没有商家skuid 信息,这样我们无法识别售卖的是哪个商品,有何途径在导出订单时能有商家skuid?
A:订单接口实际只提供了sku_id字段,而ware_id(商品ID)、product_no(商品货号)、outer_sku_id(商家sku_id)三个商品信息字段是订单中心通过接口去商品中心调取的,如中间环节有问题,会导致订单数据不准确。
目前我们建议各位直接使用360buy.ware.sku.get(获取单个SKU信息)来获取商品信息的数据,以保证信息的准确性。


Q:360buy.order.print获取面单打印,得到的html_content是经过base64转码的字符,但是我用Convert.FromBase64String()来解码时,却提示Base-64 字符串中的无效字符。这是什么原因,还是要注意些什么?
A:请您再搜索其他base64解码 web应用尝试一下,是否可以完成解码,是否是解码工具的问题。


Q:订单检索接口,能否给一个换货标识?
A:return_order字段即为换货标识。


Q:在使用订单检索api时,返回的商品信息ItemInfo中如果商品被商家给删除了,那么在用商品的根据id获取商品的时候就查不到这个商品了?
A:商品是由商家提供的,如果商品已断货,商家当然有权利删除此商品,商品是否在售或是否删除当然都由商家来决定。如果无法取到商品的相关信息,可直接在应用中显示此商品已下架或删除。


Q:换货的退货单怎么与一般退货单区分?
A:获取退货单请通过360buy.after.search接口,获取换货单请通过360buy.order.search或360buy.order.get接口中的return_order字段。


Q:什么状态的订单可以出库?
A:只要商家后台出现的订单(在线支付类型),无论是否有付款时间,都是已经付过款的订单,您可以进行正常的出库操作。因此,只要是通过接口获取到的订单(在线支付类型),都是已经付过款的订单,您可以进行正常的出库操作。


Q:能否通过接口数据反推对账数据?
A:API接口中获取的金额数据不可作为结算依据,结算时仍应按照商家后台系统结算功能中的数据作为依据进行结算。JOS仅能提供金额数据,不能提供对账公式,具体对账问题还请联系POP运营部门。


Q:余额支付金额如何通过接口获取?
A:订单接口中,balance_used字段为余额支付金额。


Q:订单检索(360buy.order.search)接口文档中提到默认可以不写start_date和end_date的,但是如果order_state等于SEND_TO_DISTRIBUTION_CENER或其他状态的时候是必须得写开始时间和结束时间的,所以我在程序中默认的把开始时间和结束时间给赋值成了本月的第一天和本月的最后一天。今天是7月1号,这样做明显不正确了,请问怎么处理才好?
A:如果您想按本月第一天和本月最后一天,可将开始时间定义为 2013-07-01 00:00:00,早上8点钟执行程序,查询不到订单是正常的,因为这个时段内不一定会产生订单,不能说明您的程序有问题。如果您想在执行系统时都能看到订单,可以先检测系统时间,定义为end_date,日期减N天(N为小于28天的任意值),定义为start_date即可。


Q:订单接口收货人基本信息(UserInfo)数据结构中,为何没有返回收货人的邮编地址?
A:邮编信息字段经内部评估判断优先级不高,暂时不予开放。


Q:订单接口中的开始时间和结束时间,是不是必须是24小时制的?
A:JOS所有接口涉及的时间字段都是24h制。


Q:订单接口中,价格及优惠字段的意义具体是?
A:订单总金额(order_total_price)是指商品原始价格,未减优惠,未加运费。
用户应付金额(order_payment)是指用户最终支付的金额,订单总金额-优惠+商品运费。
订单货款金额(order_seller_price)是指订单结算金额,订单总金额-商家优惠金额。
商品的运费(freight_price)只有sop类型商家可用。
商家优惠金额(seller_discount)是指商家实际的优惠总金额,不包含京东优惠(礼品卡、优惠券)。
订单商家优惠列表(coupon_detail_list)是指所有商家优惠的详细列表,不包含京东优惠。
余额支付金额(balance_used)是指商家使用余额付款的金额。
优惠金额(coupon_price)是指所有优惠的金额,包含京东优惠及商家优惠。
优惠类型(coupon_type)是指所有优惠的类型,包含京东优惠及商家优惠。


Q:订单检索(360buy.order.search)和获取单个订单(360buy.order.get)接口文档的返回结果中都有商家订单备注信息字段(Vender_remark)字段,为何我实际操作的时候确实没有的?
A:Vender_remark是可选字段,只有在输入参数中设置了此字段,才会在结果中返回。


Q:订单信息查询的结果为什么不是默认把所有字段都返回?
A:订单信息查询并不是默认返回所有字段。在数据量较大的情况下,如果默认返回全部字段,对双方的服务器压力都会比较大。另外,有些用户并不需要检索所有字段。


Q:批量查询规定时间段内的订单,结果修改商家备注的订单没有返回,所以想确认修改商家备注是不是属于订单修改?
A:订单检索中start_date及end_date参数仅仅是对订单状态及运单号修改时间而言的,商家备注修改不属于订单修改。


Q:对于传送多个运单号给一个订单,是否有API文档描述怎么操作?
A:SOP类型商家出库及修改运单号接口支持一个订单传多个运单号,多个运单号以逗号分割即可。


Q:下载订单时,有时有些商品的ware_id为何为空?
A:订单接口实际只提供了sku_id字段,而ware_id(商品ID)、product_no(商品货号)、outer_sku_id(外部sku_id)三个商品信息字段是订单中心通过接口去商品中心调取的,如中间环节有问题,会导致订单数据不准确。
目前我们建议各位直接使用360buy.ware.sku.get(获取单个SKU信息)来获取商品信息的数据,以保证信息的准确性。


Q:获取订单接口中,有没有办法知道这个订单是哪种商家类型的,如:LBP SOP SOPL?
A:请通过获取商家信息接口(jingdong.seller.vender.info.get)获取商家类型。


Q:是什么原因造成客户下单时间和上传到我们系统的间隔时间这么长?
A:买家下单后,订单会在京东内部各个系统流转,会有一定的时间延迟。


Q:能在京东后台查到生成订单时间(付款时间)吗?
A:可以,相关接口也将开放。


Q:订单是已经Finishe_L的状态,返回的结单时间为空?
A:只有近2个月的订单才会返回结单时间,历史订单不会。历史订单根据订单状态来判断是否结单就可以了。


Q:订单明细ID或子订单号是否可以通过接口获取?
A:由于订单明细ID暂时无法开放,请您尝试下其他标注方式 。比如:“商品id+订单id+价格”的形式,或者直接采用数字递增的方式标注每条明细记录。


Q:当用户申请了退款后,订单变为“锁定状态”,此刻商家后台不能对该订单进行任何操作(仅可“查看”)。那么,该类订单的后续流转是何情况?是需要京东方对订单进行处理?每种处理方式及其对应的时间周期和结果有哪些呢?商家方是否不需要对“锁定订单”进行任何处理?
A:如果商品未出库,买家提交退款申请--需要商家通过退款申请,京东会将货款退还买家,订单完成。
如果商品已出库,买家提交退款申请--需要商家驳回退款申请;买家需提交退货申请--需要商家通过退货申请,待收到商品后确认退款,京东会将货款退还买家,订单完成。
如果商品已出库,买家提交退货申请--需要商家通过退货申请,待收到商品后确认退款,京东会将货款退还买家,订单完成。


Q:在获取订单信息接口(360buy.order.get)返回的ItemInfo结构对应哪个字段返回“商家skuid”信息?
A:在获取订单信息接口(360buy.order.get)返回“商家skuid”信息的字段是outer_sku_id。


Q:调用订单检索接口的方式是http://360buy.order.search + get或者post传参数么?
A:使用post传参数。


Q:订单状态一共会返回哪几种状态呢?
A:WAIT_SELLER_STOCK_OUT等待出库
SEND_TO_DISTRIBUTION_CENER 发往配送中心(只适用于LBP、SOPL商家)
DISTRIBUTION_CENTER_RECEIVED 配送中心已收货(只适用于LBP、SOPL商家)
WAIT_GOODS_RECEIVE_CONFIRM 等待确认收货
RECEIPTS_CONFIRM 收款确认(服务完成)(只适用于LBP、SOPL商家)
FINISHED_L 完成
TRADE_CANCELED 取消
LOCKED 已锁定


Q:关于订单优惠信息,怎么区分返回的优惠是商品的优惠,还是整个订单的优惠呢?只通过优惠类型来判断么?
A:通过优惠类型来判断即可,针对整单的优惠类型:
20-套装优惠、35-满返满送(返现)、41-京东券优惠、52-礼品卡优惠、100-店铺优惠
针对商品的优惠类型:28-闪团优惠、29-团购优惠、30-单品促销优惠,


Q:在京东后台订单详情中,商品编码***出现2条明细,然后使用ERP系统拉取的只有一个明细,导致发货漏发了,所以想了解下情况,是ERP系统的问题么?
A:商家后台这个订单里出现两条一样的记录,是因为sku参加了促销,其中一个sku是赠品。暂时无法通过接口区分出普通sku和赠品sku,我们已经和产品部门提出优化建议。


Q:店铺满减促销,后台订单显示的优惠信息的字段是什么?
A:订单接口中,CouponDetail结构下的coupon_type字段可以获取满返满送(返现)信息。


Q:请问OrderGetResponse response=client.execute(response)中的response怎么解析啊?能不能给示例代码?
A:请参照以下示例:
if(StringUtils.isEmpty(response.getZhDesc())){
OrderInfo orderInfo = response.getOrderDetailInfo().getOrderInfo(); // 获得订单数据实体类
System.out.println("商品的运费: "+orderInfo.getFreightPrice());
System.out.println("订单id: "+orderInfo.getOrderId());
System.out.println("支付方式: "+orderInfo.getPayType());
System.out.println("订单总金额: "+orderInfo.getOrderTotalPrice());
System.out.println("用户应付金额: "+orderInfo.getOrderPayment());
System.out.println("订单货款金额: "+orderInfo.getOrderSellerPrice());
System.out.println("商家优惠金额: "+orderInfo.getSellerDiscount());
System.out.println("订单状态: "+orderInfo.getOrderState());
System.out.println("订单状态说明: "+orderInfo.getOrderStateRemark());
System.out.println("送货(日期)类型: "+orderInfo.getDeliveryType());
System.out.println("发票信息: "+orderInfo.getInvoiceInfo());
System.out.println("商家id: "+orderInfo.getVenderId());
System.out.println("买家下单时订单备注: "+orderInfo.getOrderRemark());
System.out.println("下单时间: "+orderInfo.getOrderStartTime());
System.out.println("结单时间: "+orderInfo.getOrderEndTime());
System.out.println("收货人基本信息:");
System.out.println(" 市: "+orderInfo.getConsigneeInfo().getCity());
System.out.println(" 县: "+orderInfo.getConsigneeInfo().getCounty());
System.out.println(" 全地址: "+orderInfo.getConsigneeInfo().getFullAddress());
System.out.println(" 全名: "+orderInfo.getConsigneeInfo().getFullname());
System.out.println(" 手机号: "+orderInfo.getConsigneeInfo().getMobile());
System.out.println(" 省: "+orderInfo.getConsigneeInfo().getProvince());
System.out.println(" 固定电话: "+orderInfo.getConsigneeInfo().getTelephone());
System.out.println("订单商品列表信息:");
for(ItemInfo itemInfo : orderInfo.getItemInfoList()){
System.out.println(" 京东内部SKU的ID:"+itemInfo.getSkuId());
System.out.println(" SKU外部ID:"+itemInfo.getOuterSkuId());
System.out.println(" 商品的名称+SKU规格(比如:"+itemInfo.getSkuName());
System.out.println(" 京东价:"+itemInfo.getJdPrice());
System.out.println(" 赠送积分:"+itemInfo.getGiftPoint());
System.out.println(" 京东内部商品ID:"+itemInfo.getWareId());
System.out.println(" 数量:"+itemInfo.getItemTotal());
System.out.println(" 商品货号:"+itemInfo.getProductNo());
System.out.println("-------------------------------------------------------");
}
System.out.println("订单商家优惠列表");
for(CouponDetail couponDetail : orderInfo.getCouponDetailList()){
System.out.println(" 优惠金额:"+couponDetail.getCouponPrice());
System.out.println(" 优惠类型:"+couponDetail.getCouponType());
System.out.println(" 订单编号"+couponDetail.getOrderId());
System.out.println(" 京东sku编号:"+couponDetail.getSkuId());
System.out.println("-------------------------------------------------------");
}
System.out.println("订单查询可选字段");
System.out.println("************************************************************");
System.out.println("卖家备注: "+orderInfo.getVenderRemark());
System.out.println("使用余额的数量: "+orderInfo.getBalanceUsed());
System.out.println("************************************************************");

}else{
System.out.println("执行结果: "+formReturnMsg(response.getMsg()));
}


Q:订单状态有没有一个备货中的状态啊?我们一般是10分钟下载一次订单,发货肯定没有这么快,现在只能下载等待出库的订单,那也就是说会总是会下载到一些已经下过的订单?

A:订单状态目前没有备货的状态,可以在下载等待出库订单时,在程序上做一下过滤以提高效率。


Q:什么是父订单号(parent_order_id)?

A:买家在下单时,可能同时拍下自营商品及pop商家商品,后续会将这些商品拆分到不同的订单中。父订单号(parent_order_id)为买家下单时的订单号。


京东物流

Q:SOP出库时提示“运单没有在青龙系统生成 ”

A:请按以下步骤操作:
1)获取京东物流运单号接口(批量取回京东物流单号)
2)京东物流接单接口(匹配运单号和订单号,向京东物流系统回传运单信息。商品的长宽高,体积;以及收货人信息等)
3)SOP出库(原业务逻辑不变,回传京东物流id2087,运单号即可)

注:请按照顺序调用接口。1)获取运单号;2)提交运单信息;3)出库
如果顺序正确,请检查运单号的数据类型,要求为string;
商家后台的京东物流运单号为9开头,不能用于接口出库使用

Q:是否提供SOP货到付款京东快递单打印数据接口?

A:目前未提供。请按照京东运单的参数说明进行模板设置。

Q:打印运单中的”代收金额“从哪里取得?

A:请使用SOP面单打印数据中的“should_pay"字段,参考http://help.jd.com/jos/question-569.html#A7

Q:商家编码(customerCode)是什么?

A:customerCode是京东物流后台的商家编码,并非POP商家后台显示的商家编号。

商家签约京东物流后,由物流运营人员分配用户名密码,登录www.jd-ex.com进行查看(首页顶部”商家登陆“)。

Q:京东运单设计版式上,可扫描部分是什么参数?

A:可扫描部分为包裹号。

Q:目前的接口可以对接SOP商家,是否可以用于SOPL、LBP等商家?

A:目前的模式只针对sop的对接,不适用于SOPL、LBP

Q:订单合单如何回传运单号?内部是否会验证订单号与运单号一一对应?

A:订单号与运单号可一对一,也可多对一。SOP出库时将多个订单回传相同运单号即可。

Q:运单号不存在或者已使用?

A:请使用jingdong.etms.waybillcode.get重新获取运单号。

Q:收货人 和寄件人 电话格式做了长度限制?

A:手机有校验,收货地址和寄件人地址不能超过100个字符;

收货人和寄件人名字不超过25字符;description 33个字符。

(字符,包括汉字长度)

Q:一个商家有多个店铺,是否对应京东物流系统中多个customerCode?

A:POP系统中的商家id与京东物流系统中的customerCode为一一对应关系。

Q:我们取得京东运单号后,有一个客户有两个订单,我们是不是可以把两个订单合并成一个订单发货

A:京东平台订单不支持。非京东平台订单支持合并发货。

Q:商家获取的运单号是否有“有效期”或保留时长?

A:目前未设置有效期。商家获取的运单号将一直可用。

Q:我已经向京东物流系统提交了运单信息,为什么订单出库时还在报“运单没有在青龙系统生成 ”?

A:由于提交运单信息后,数据在物流系统及POP系统中流转需要一定时间,请延迟约3分钟后,再调用SOP出库接口进行出库操作。


返回顶部