常见问题汇总

基本概念描述

Q:SPU、SKU的区别是什么?
A:如下:
SPU= Standard Product Unit(标准化产品单元),SPU是商品信息聚合的最小单位,属性值、特性相同的商品可以称为一个SPU。
SKU = Stock Keeping Unit(库存量单位),SKU即库存进出计量的单位。
例:iPhone 7就是一个SPU。黑色(规格信息)、32GB(规格信息)的iPhone 7为一个SKU。
OpenAPI中,商品id==itemId==SPUId。

Q:SKU、simpleDesc和displayString的区别是什么?
A:SKU是具体商品信息的概念,比如红色的高跟鞋,simpleDesc是高跟鞋的描述,displayString是具体规格的描述。

Q:OpenAPI的包裹(orderPackage)是什么?
A:OpenAPI的包裹(OrderPackage)是一个虚拟的概念,与实际物流包裹并不相等,一个包裹下面可能有多个物流包裹。若一个订单的商品不在同一发货仓,就会有多个包裹,packageId为虚拟包裹id,可作为确认收货接口的参数。

Q:子物流单列表(subExpressNos)是什么概念?
A:一个物流号可以有多个子物流单号。若出现一个包裹装不下的情况,就会有子物流单列表。

Q:primarySkuId和primaryPicUrl是什么概念?
A:primarySkuId(已弃用)和primaryPicUrl(已弃用)是严选主站默认显示的sku,请使用skuList的id和picUrl。

Q:网站传输协议用什么?
A:测试服使用http,线上服使用http、https。

Q:渠道需要提供的测试环境IP白名单是什么?
A:白名单是因为严选需要对渠道发起请求的IP做校验,IP白名单最多添加30个,超过上限需要提供IP段。

订单相关

关于订单内容填写

Q:订单(Order)中的收件人的地址怎么填写?
A:如下:

  • 地址按照数据说明填写准确即可
    (收件人省名称[receiverProvinceName]-收件人市名称[receiverCityName]-收件人区名称[receiverDistrictName]-收件人详细地址[receiverAddressDetail])
    例:浙江省-杭州市-滨江区-网商路599号-网易大厦
  • 对于直辖市,收件人省名称(receiverProvinceName)填写直辖市
  • 收件人地址是纯文本的

Q:订单(Order)中的邮费(expFee)怎么填写?

A: 看双方如何约定(合同中可能会提及),
比如满XX元(严选售价)包邮,不满统一为X元。

Q:订单(Order)中的支付方式(payMethod)怎么填写?
A:填写用户支付方式。比如支付宝、微信或渠道自己的支付工具等(XX支付)。

Q:订单(Order)下的订单SKU(orderSku)的商品名称(productName)等类似的描述信息怎么填写?
A:填写实际商品名即可(可参照商品信息查询接口得到的描述信息)。

Q:订单(Order)中的商品单价(originPrice)怎么填写?
A:originPrice就是商品信息查询接口中查询到的渠道售价channelPrice。

 

关于订单操作与状态

Q:怎样取消订单,取消后库存怎么变化?
A:说明如下:

  • 取消订单规则:
    • 取消订单只能在发货前操作;
    • 发货后,只能在收货后再发起退货
  • 订单取消后库存变化:
    • 商品发货前:可以取消订单,取消成功后划拨的库存会加回来;
    • 商品发货后:只能退货,划拨的库存不会加回来。退货信息需要渠道汇总给严选客服

Q:出现超卖、售后等异常订单怎么处理?
A:联系严选专门客服人工处理。

Q:订单何时算交易成功?
A:该订单下所有包裹都确认收货(确认收货需要调用确认收货接口)。

 

关于下单数据检查与校验

Q:下单接口会做数据检查吗?
A:会做以下检查。

  • 下单限制

    • SKU信息(orderSku)不能为空。
    • SKU的库存不能为0。
    • skuId不合法,即未向严选申请该商品。
    • 订单实付金额(realPrice)不为0、且不能小于邮费(expFee)。
  • 金额计算规则

    • 金额小计(subtotalAmount)= 商品单价(originPrice)× 数量 - 优惠卷金额(couponTotalAmount) - 活动优惠金额(activityTotalAmount)
    • 实付金额 = 金额小计(subtotalAmount)+ 邮费(expFee)
  • 下单地区校验

    • 因政策原因有部分区域不允许发货
    • 部分特殊时期,因政策原因,部分区域不允发货(会提前告知)

商品信息相关

关于商品分类信息

Q:商品信息(Item)的商品类目路径列表(categoryPathList)为什么是两层List?
(即Item的categoryPathList为List>

A:因为该产品可能属于多个分类,比如厨具->杯子,餐具->杯子。2层list拼接才是一个完整的分类。

 

关于测试用例

Q:有哪些适用特殊场景的skuId?
A:如下:

  • 新建渠道默认配置的sku:1085000、10019002、1042000、1042001、1106000、10019005、1087002、10038001、10212023、1206007
  • 配置信息接近真实sku的skuId:1206007
  • 取消需要客服审核skuId:10038001
  • 同个仓库的skuId:10212023、10019005

 

关于商品图片

Q:主图格式规则有哪些?
A:格式如下:

  • 主图形状:正方形
  • 最大尺寸:800*800px,图片容量大小无限制
  • 主图数量:五张
  • 主图格式:第1张主图格式为png 其他4张是JPG

Q:详情页图片格式规则有哪些?
A:宽:750px;高:不限。

配送相关

关于物流

Q:物流由谁提供?
A:由严选提供物流配送和物流单号,后续的物流追踪由渠道自行跟进。

Q:快递处理速度如何?
A:如下:

  • 处理快递时效:工作日1天(24h)、节假日3天(72小时)
    [部分订单速度会慢一点,2天内出核实结果]
  • 下午6点前的订单(除外部仓的商品外)基本当天能发出
  • 漏发错发问题,需要仓库监控核实(时效:1天)
    其余问题基本会在当天解决

Q:邮费如何计算?
A: 看双方如何约定(合同中可能会提及)。比如满XX元(基于严选售价)包邮,不满统一为X元。

 

关于库存

Q:库存查询接口参数格式是什么?
A:格式为 "skuIds":"[SKUID]"
例: "skuIds":"[1206007,1206009,10019005]" 。

Q:为什么需要维护库存?
A:因为回调可以及时通知渠道,而库存进行划拨回调后,库存数量会发生增减,所以需要渠道维护库存。

售后相关

关于售后

Q:是否支持部分退款?
A:支持的,退款是以SKU为维度的,退款数量可以多个。

Q:退货地址是否统一?
A:同一个发货地址的商品,退货地址是同一个,退货地址都是有设置的,一般是大件商品的退货地址不同。

Q:同个SKU多个数量是否支持重复退款?
A:支持的,前一次申请售后退款完成就可再次提起售后。

关于换货

Q:是否支持换货?
A:目前接口上只支持退货,如果需要换货请线下直接联系严选客服,另外严选不支持拒收。

其他数据问题

关于回调

Q:渠道为什么要提供回调接口?
A:因为有很多消息严选需要及时通知渠道,(例:渠道取消订单审核结果)若不提供回调接口,则会导致信息无法有效触达。
渠道正确接收到回调消息后,应只返回成功,不返回其他业务消息。

Q:订单包裹物流绑单回调规则是什么?
A:订单包裹物流绑单回调是一个包裹回调一次,一个订单可能会回调多次。

Q:严选回调请求时间为多少?
A:严选回调渠道,请求超时时间为30秒。

Q:严选回调的请求格式是怎样的?
A:回调请求的格式和渠道请求严选的一致。

Q:哪些回调是要求渠道一定要接入的?
A:为保证严选与渠道系统间消息通信完整,订单、售后等流程正常运转,严选所有回调都要求接入。

Q:线上环境若渠道未正常接收到回调该如何处理?
A:首先严选方回调渠道失败,会做必要的有限次数的重试。另外因线上环境流程是真实的,严选方无法再次触发回调,若渠道接收回调异常可通过查询接口同步相关订单信息。注意:正常情况下渠道须接入回调来更新订单的实时信息。

 

关于数据传输

Q:请求严选OpenAPI的格式规范是什么?
A:如下:

  • content-type=application/x-www-form-urlencoded
  • charset=UTF-8

Q:何时可以调用严选的下单接口?
A:订单状态为“已支付”时,可以调用。

Q:渠道请求严选OpenAPI超时时间为多久?
A:20秒。

Q:yanxuan.item.id.batch.get(商品ID查询接口)是否支持分页?
A:getIds返回了全部,不支持分页。

Q:满足什么条件才可以申请线上服?
A:满足以下条件,即可以向严选申请线上服,严选将会进行评估:

  • 满足接口、回调、流程测试全部通过
  • 频率、长度等限制全部满足
  • 自测通过
    确认对接完成后,请务必发送邮件,邮件格式如下:
    严选团队:           
      你们好,我方已完成线上环境的实单验证,现申请启动线上渠道。