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)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:我们的接口确实有优化空间,但目前只能采用这样的方式来实现换货订单的统计。