更新说明

根据市场、业务变更、对接便捷性、接口使用过程中客户反馈等，为了能有更好的用户体验，会按实际业务场景进行接口的新增；

如果用户系统已在线正式运行，则根据变更内容，自行选择是否升级，接口向后兼容，不会影响已对接的业务；

变更记录

格式为正式发布日期，变更内容

接口新增V2版本，主要变更内容为增加部分商品的散件购买

新增部分商品可不按打包数购买，之前版本严格按照采样量、打包数等进行判断，V2版本支持部分商品可任意数量购买

接口：3.2 商品详情新增字段 nonPackage 是否支持散件购买：1是，2否

接口：4.3 订单创建新增请求字段 allowNonPackage 是否运行散件购买：1是，2否，允许散件购买，并且订单内商品支持散件购买时，同一种商品可能会生成两个小商品订单，即同一种商品返回两条记录；调整响应字段，新增字段：packageType 打包方式：1整箱，2散件

接口：4.6 订单详情, 4.1 运费计算, 4.2 订单预览，4.8 运输方式运费等订单相关的接口，调整响应字段，新增字段：packageType 打包方式：1整箱，2散件

V1版本升级V2版本注意事项

根据上面接口变更字段，做好对应数据属性的存储

V1版本中创建订单时的限制条件，如打包数等，需要做对应的调整

订单生成规则：V1版本中同一种商品只会生成一个商品订单，该商品订单的唯一标识为orderId；V2及后续版本，可能会出现同一种商品，返回多条商品订单，每条商品订单的唯一标识为orderId，如果V1版本的业务侧有强关联的话，需要做对应的兼容处理

接快递通知，对于收件人的姓名，不得包含一下特殊字符：

~!@#$%^&*()=|{}':;\[].<>?！￥…（）—【】‘；：”“’。，、？

受影响接口：4.3 订单创建字段：consignee.receiver 该字段不得包含以上特殊字符；如果包含了以上的特殊字符，在创建订单时会失败，并且接口同步返回：收件人姓名格式错误，不得包含特殊字符

包含该字段但不受影响的接口：4.2 订单预览，订单预览只是根据收货地址返回对应的运费信息，所以此接口不做拦截，可以正常获取运费；

订单类别下，新增 4.8 运输方式运费，返回商品所有支持的运输方式及对应运费，应用场景：在商品详情页等需要展示商品运费及运输方式的地方，可以调用此接口；