订单接口问题


Q:订单检索接口(360buy.order.search)、获取单个订单接口(360buy.order.get)中的订单状态字段(order_state)有很多取值,请问分别是什么意思?触发事件是什么?
A:“WAIT_SELLER_STOCK_OUT 等待出库”即卖家准备发货状态;触发事件为完成支付(先款订单),买家下单(后款订单);
“SEND_TO_DISTRIBUTION_CENER 发往配送中心(只适用于LBP,SOPL商家)”即卖家将货物发往配送中心;触发事件为订单出库;
“DISTRIBUTION_CENTER_RECEIVED 配送中心已收货(只适用于LBP,SOPL商家)”即配送中心收到货物;触发事件为配送中心扫描货件;
“WAIT_GOODS_RECEIVE_CONFIRM 等待确认收货”即货物在途,等待买家收货;触发事件为订单出库;
“RECEIPTS_CONFIRM 收款确认(服务完成)(只适用于LBP,SOPL商家)”即京东财务确认收到货款;触发事件为京东财务系统对账完成;
“WAIT_SELLER_DELIVERY等待发货(只适用于海外购商家,等待境内发货 标签下的订单)”即卖家准备将货物发给买家(国内);触发事件为国内发货;
“FINISHED_L 完成”即买家确认收货;触发事件为买家点击收货或默认收货;
“TRADE_CANCELED 取消”即订单删除;触发事件为删单及拒收(删单包括用户、商家、客服的删单,拒收是指用户拒收);
“LOCKED  已锁定”即订单锁定,无法进行其他操作;触发事件为京东客服锁定订单(买家申请退款、取消订单)。


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:对京东环球buy卖家而言,配送阶段中的境内发货部分用哪个接口呢?
A:配送阶段中的境内发货部分请调取订单SOP出库接口(360buy.order.sop.outstorage)


Q:如何在订单服务接口中查找该订单的下单用户信息(如邮箱、电话等)?
A:订单接口仅支持获取consignee_info收货人基本信息。为保护用户隐私,下单人(买家)信息暂不提供。

Q:调取订单出库接口,报“运单号不符合对应物流公司的校验规则”,是什么问题?
A:如确认运单号与对应物流公司是准确匹配的,那么此问题就是物流公司运单号规则有变化导致。京东配送部门会协调物流公司,与新的运单号规则做对接,此项工作完成之前,请先在商家后台通过“厂家自送”方式出库。“厂家自送”功能需由商家联系京东pop运营人员开通。

Q:接口是否支持修改订单的状态?如将订单的状态改成“已发货”?
A:接口不直接支持订单状态的修改。发货即出库,已发货即已出库。调取订单出库接口,订单状态会随之改变。

Q:FBP类型商家订单,order_state为何值时,可以判定此订单已经发货在途了?
A:10-自提途中  11-上门自提,都有发货在途状态。

Q:订单检索(360buy.order.search)和获取单个订单(360buy.order.get)接口文档的返回结果都是默认返回的么?
A:不是,其中有一些是可选字段,只有在输入参数中设置了,才会在结果中返回。如:pin、vender_remark等字段。

Q:调用360buy.order.sop.waybill.update(SOP修改运单号接口)时,报“当前状态的订单不能修改运单号”,而该订单的状态是“等待出库”,是不是要先使用其他接口?
A:SOP修改运单号接口(360buy.order.sop.waybill.update)的功能是修改物流运单号,只有在完成出库操作(调取出库接口或在商家后台点击出库)后,方可调用该接口。

Q:如果没有调用出库接口,直接调用修改运单号接口,会不会成功?
A:不会成功。调取出库接口后,订单才会有对应的物流运单号,才可以修改物流运单号。没有物流运单号时,无法做修改操作。

Q:如果多次调用出库接口,会不会成功?
A:订单出库接口,只能调用一次,多次调取无效。

Q:如果多次调用修改运单号接口,会不会成功?
A:会的,接口支持多次修改运单号。

Q:如果需要在系统中输入物流运单号,物流公司,然后通过API更新店铺的订单,且希望订单能自动设置为“发货”状态。在文档中找到360buy.order.sop.waybill.update与360buy.order.sop.outstorage,请问哪个接口能实现此功能?
A:请使用订单SOP出库接口(360buy.order.sop.outstorage)完成出库操作,订单状态也会随之变为“WAIT_GOODS_RECEIVE_CONFIRM 等待确认收货”。

Q:订单检索接口文档中提到“开始时间和结束时间,不得相差超过1个月”,那么次接口对于开始时间的范围有规定吗?能取到所有时间段内的订单数据吗?如果不能,是怎么规定时间范围的?
A:360buy.order.search(订单检索接口)对于开始时间的范围没有做规定,能取到所有时间段内的订单数据。但只有最近2个月的订单才会返回结单时间及付款时间,历史订单不会。历史订单需根据订单状态来判断是否结单。

Q:除了结单时间、付款时间,两个月前的订单信息中,其他的时间信息都有吗?结单时间、付款时间为什么不能取到?
A:对历史订单而言,除了结单时间外,付款时间外,其他信息都可以获取到。接口可以获取的信息以商家后台为准,如商家后台没有相关数据(如历史订单的结单时间、付款时间),接口无法获取。

Q:调取360buy.order.search(订单检索)接口,报“合作类型不正确”,是什么问题?
A:报“合作类型不正确”,说明商家类型与接口不匹配。是否为FBP类型商家?如果是,请调取FBP订单检索接口(360buy.order.fbp.search)及FBP获取单个订单接口(360buy.order.fbp.get)。

Q订单接口中,“TRADE_CANCELED取消”状态是在什么场景下产生的?
A:订单接口中,“TRADE_CANCELED取消”状态是在删单和拒收的业务场景下产生的。删单包括用户、商家、客服的删单,拒收是指用户拒收。

Q:订单接口中的输入参数,页数page和每页的条数(最大page_size 100条)
page_size,表示的意思是第page页的page_size条订单么?
A:是的。

Q:在哪些订单状态下可以执行删除订单?
A:理论上订单删除跟订单状态无关,取决于其他因素。后款的订单通过删单审核后,就删除了,先款的订单要退款成功后,才能删除。

Q:京东未付款自动关闭订单的等待时间是多久?
A:24小时。

Q:所有未完成的订单都是“TRADE_CANCELED取消”状态么?
A:“TRADE_CANCELED取消”状态订单有如下可能:订单取消、退款成功、(用户、商家、客服)删单、卖家拒收。

Q:货到付款的订单,通过接口如何判别?
A:可以根据订单接口中的pay_type字段,判断是否为货到付款订单。

Q:订单服务中,通过“FINISHED_L完成”状态所查到的所有订单里是否包含退货的订单?
A:包含。“FINISHED_L完成”状态订单包含退款成功的订单,退款未完成的订单为“LOCKED  已锁定”状态。

Q:“FINISHED_L完成”状态订单一定是交易成功的,不管是否有结单时间?
A:是的。

Q:两个月之前的订单是交易成功的,还是退款成功(交易未成功)如何判断?
A:退款成功在商家后台会变为“删单”状态,对应接口状态为“TRADE_CANCELED取消”;但“TRADE_CANCELED 取消”状态的订单不完全为“删单”订单,需要自行判断。

Q:调用订单检索(360buy.order.search)接口,导出历史订单信息后,发现接口返回的数据和商家后台查询到的数据条数不一致,这是怎么回事,应该如何解决?
A:360buy.order.search接口检索输入参数的start_date和end_date指的是订单状态及运单号修改的时间点,即“modified”订单更新时间,此字段在接口中有返回。商家后台检索“全部订单”输入的开始时间和结束时间统计口径为“下单时间”。在此情况下,如果您通过接口和商家后台同时检索某一时间段,返回的结果自然不可能相同。

Q:通过360buy.order.search检索到的订单物流公司ID,如何获取该物流公司的中文全称?
A:请通过360buy.delivery.logistics.get获取物流公司id及名称,与360buy.order.search获取到的物流公司id做对应。

Q:订单结构中,有没有能标识并区分该订单是哪位客服人员落实下单或者是落实付款的吗?
A:订单接口无法设置此字段,建议您通过聊天记录查询接口(jingdong.im.pop.chatlog.get)获取客服聊天记录,并与订单中的商品信息做匹配,以实现您需要的功能。

Q:客户下单之后,在商家还未发货之前,如果客户取消订单,能否通过接口将订单状态反馈给商家的ERP系统,是否提供此类接口?
A:请通过订单接口TRADE_CANCELED(取消)字段获取,但取消的订单不返回收货人基本信息。

Q:订单接口中的(付款确认时间)是什么意思?
A:付款确认时间基本可以理解为订单付款时间。

Q:同一个物流单号在商家后台可以同时给两个不同的客户发货吗?
A:不可以。

Q:有没有返回买家账号ID的接口?
A:请通过订单接口pin字段(即买家的账号信息)获取,此字段为可选字段,需在输入参数optional_fields中传入,才会返回。

Q:在使用优惠券的情况下seller_discount的值会包含优惠券的金额吗?
A:仅包含店铺级优惠券的金额,不包含全网优惠券的金额。

Q:调取订单出库接口,报“订单已出库”,是什么问题?
A:已经出库的订单不能再次出库,订单出库只能操作一次。

Q:订单接口中,Modified(订单更新时间)字段具体是指什么更新时间?
A:Modified(订单更新时间)字段是指订单状态及更新运单号的更新时间。

Q:订单检索接口返回结果中,seller_discount在什么情况下有值?
A:在订单中有商家优惠金额时,seller_discount有值。

Q:如果的优惠类型是都不在seller_discount字段中体现?那么seller_discount的值是什么折扣呢?
A:seller_discount仅体现商家优惠对应金额,不包含京东优惠(礼品卡、优惠券)。具体优惠类型及对应金额请通过CouponDetail结构查看。

Q:360buy.order.fbp.get接口中optional_fields可以传的参数有多少?具体是哪些?
A:optional_fields字段传入参数没有限制,传入需要返回的字段即可。

Q:已删除的订单就不能出库了?
A:是的。

Q:订单接口中,能获取商品的活动价么?如商品价80元,活动价格是50元,这个50元能获取吗?
A:不能。订单接口coupon_type字段(优惠类型)中,有一项是“30-单品促销”会返回单品的优惠金额。比如商品价是80元,活动价是50元,coupon_type字段返回值为优惠金额30元,活动价50元获取不到。

Q:WAIT_SELLER_STOCK_OUT 等待出库,这个是理解为京东配送中心发往客户的出库还是店铺仓库发往京东配送中心?
A:WAIT_SELLER_STOCK_OUT等待出库是指买家已付款(在线支付订单),商家可以对此订单执行出库操作。

Q:如何通过订单地址判断该订单应该被分配到京东哪个库房呢?
A:暂时可以通过360buy.order.sopl.print.data.get接口中cky2_name字段判断,在返回结果"SOPL - 上海"中除去“SOPL - ”。

Q:订单检索接口(360buy.order.search)怎么才能取到某一天下单的订单或付款订单?
A:无法直接检索此类订单,但可以通过360buy.order.search接口payment_confirm_time(付款确认时间)字段自行匹配。


Q:有没有通过订单号,获取运单号的接口?
A:请通过360buy.order.get(获取单个订单接口)获取运单号,waybill字段需在输入参数中设置才能返回。

Q:通过360buy.order.get(获取单个订单接口)获取的数据与360buy.order.search(订单检索接口)获取的数据有差异,字段少了很多?
A:360buy.order.get与360buy.order.search的返回字段基本一致。这两个接口的输入参数中都有optional_fields,得把需要返回的字段写入optional_fields中方可返回。

Q:请问“京东优惠券”和“店铺优惠券”这两种券在API接口中有没有对应的参数显示?我们系统在导出订单的时候,订单金额因为客户有使用优惠券而出现了差异。
A:订单接口中,CouponDetail结构下coupon_type及coupon_price字段会返回这两种优惠类型及优惠金额(41-京东券优惠,100-店铺优惠)。

Q:有客户来申请退款,但是提供接口没有下载到这个订单的详细资料,为什么?
A:由于订单还处在未生产状态,买家就申请了退款。因此商家后台看不到详细信息,接口也不能获取。您只需在售后服务中审核退款申请,此订单即完成所有流程,无需再做其他操作。

Q:我们店铺之前是LBP中转仓模式,现在开通了京东快递上门取件服务,但是订单后台出不了库,请问这个要如何处理?
A:请商家联系POP运营人员,在商家后台开通“自送”的物流公司。接口回传物流公司id=0,运单号留空即可。可参考360buy.order.lbp.outstorage(订单LBP出库接口)。

Q:360buy.order.search(订单检索接口)返回的sku_name,是商品名称和颜色等的组合。如何才能分开这两项内容呢?
A:由于系统问题,此处目前没有调整计划。如需商品名称及颜色信息,请通过360buy.ware.sku.get(获取单个SKU信息接口)获取SKU信息,再通过360buy.ware.get(根据商品ID查询单个商品的详细信息接口)获取商品名称。

Q:锁定的订单无法出库么?
A:是的。订单锁定一般是由于买家申请退款、取消订单,此类订单无法出库。

Q:如果订单状态是“已完成”,调用出库接口会不会把订单的状态再改成“已出库”?
A:等待出库的订单状态才能操作出库,订单已经完成了,就不能出库了。只有订单状态为等待出库时,调用接口会正常出库,别的状态是不会操作成功的,原来是什么状态,还是会什么状态。

Q:订单如果已经取消(或锁定),还能调取获取面单打印数据(360buy.order.print.data.get)及面单打印接口(360buy.order.print)么?
A:不能,以防止商家误操作。

Q:修改订单备注接口(360buy.order.vender.remark.update)新增加了flag字段,但是订单检索api好像还没有返回flag字段吧?
A:为了缓解订单接口压力,订单检索接口不会返回此信息,请通过jingdong.order.venderRemark.queryByOrderId查询商家备注接口获取flag字段。

Q:订单商品里的“SKU的京东价”(jd_price字段)是指商品在京东商城的成交价格吗?
A:jd_price不是成交价格,而是商家后台中设置的sku的价格。

Q:SOP模式的订单流程应该是:等待出库—等待确认收货—完成—取消,对么?
A:SOP订单状态一般为:等待出库—等待确认收货—完成。

Q:订单“已锁定”、订单“已取消”是什么状态?
A:已锁定是指买家申请退款的订单,已取消是指退款成功以及退货成功的订单。

Q:使用订单SOP出库这个接口,物流公司id和物流单号要怎么填?也必须使用支持货到付款的物流公司吗?
A:物流公司id请通过360buy.delivery.logistics.get接口获取。如对接京东快递,物流单号请通过jingdong.etms.waybillcode.get(获取京东物流运单号接口)获取。货到付款可使用的物流公司请咨询pop运营人员。

Q:订单状态何时会从“锁定”变为“取消”?
A:在货款打给买家后,订单状态会从LOCKED(锁定)变为TRADE_CANCELED(取消)。

Q:现有一个订单在商家后台及接口查看都是“货到付款”订单,但代收金额为0,经查看已经使用余额支付完了,请问此类问题是否正常?
A:正常。可将余额支付理解为一种优惠,类似京东礼品卡。请按支付方式判断是否货到付款,而不要用代收货款金额做为判断依据。此类订单代收货款金额也会返回“0”。

Q:调取360buy.order.get(获取单个订单接口),报“商家ID为空或者不大于0”,是什么问题?
A:此报错是由于商家店铺未开通或已到期未续约,请商家联系pop运营确认店铺是否有效开通。另,如是个人账号转为企业账号,请重新授权即可。

Q:调用360buy.order.sop.waybill.update这个接口修改运单号,返回“此类型商家无权调用本接口”,为什么呢?
A:此接口为sop类型商家修改运单号接口,如为其他类型商家,请使用相应的接口进行操作。

Q:360buy.order.search(订单检索接口)返回的order_total字段,是订单的总数量还是当前页的数量?
A:符合检索条件的订单总量。

Q:客户取消的订单如何获取?
A:买家取消的订单请通过360buy.order.search(订单检索接口)order_state 字段传TRADE_CANCELED(取消)获取。

Q:调取360buy.order.sop.outstorage(订单出库接口),报“sop3cod商家物流公司错误”,是什么问题?
A:请确认订单是否为货到付款订单,货到付款订单仅能使用京东快递及宅急送出库。

Q:订单支付方式为“自提”是什么意思?属于货到付款么?这个不是物流方式么?
A:京东设有很多自提点,买家可以到自提点自己提取货物并现场付款。不等同于货到付款。具体可以参考商家帮助文档 http://help.jd.com/Vender/viewQuestion-781-1837.html

Q:下载订单的时候start_date 和end_date 传入的参数不是订单创建时间和结束时间么?可以详细说明下这两个字段么?
A:这两个时间参数是指订单状态及运单号修改的时间,具体参考http://help.jd.com/jos/question-569.html#A1

Q:调取360buy.order.get接口,得到的outer_sku_id与商家后台中“商家sku”不符,为什么?
A:此处获取的outer_sku_id,是来源于生成订单时产生的快照信息,若订单产生后修改了“商家sku”,则获取到的仍为原“商家sku”。

Q:换货订单为什么在锁定订单中查不到?换货订单和普通订单有什么区别?
A:换货订单相当于是个新的订单,所以不会出现在锁定订单(原始订单)中。

Q:换货订单是先查询全部订单然后对返回字段进行判断,如果我设置的页面显示为二十条,那么返回的第一页数据有20条,如果第一页的20条中只有1条换货订单,那我这边换货订单只会显示1条;但是第二页20条数据中可能还有2条换货订单数据,那是不是意味着我要先获取到全部的订单(比如1000条)然后再进行遍历,判断是否为换货订单?
A:我们的接口确实有优化空间,但目前只能采用这样的方式来实现换货订单的统计。