旅游度假
飞猪度假schema商品发布
更新时间：2021/06/08
访问次数：7040
文档说明
本文档面向对象为飞猪（度假）商品管理的第三方开发者或者自研发商家。
背景
Schema体系是开放平台与天猫/淘宝商品团队共同定义的一套新的开放API规范，用以解决商品管理平台的频繁变动给开发者带来的开发维护成本。天猫/淘宝商品平台通过开放平台API将商品管理涉及的元素及规则使用更接近开发者的语言通过xml的方式返回，开发者解析xml后，根据xml中的规则及元素生成一个商品信息xml，调用开放平台API上传完成商品管理。
基于Schema体系开发商品管理工具时，建议的最优方案是开发者在应用中建立动态映射管理获取的xml与本地DB的数据关系，这样在当天猫/淘宝变化时，获取的xml也会随着变动，这个时候只需要在动态映射管理中设置好xml和本地DB的新映射关系，即可适应变化，从而改变原有天猫/淘宝一变化，开发者需要随着修改代码的状态。
飞猪schema体系同天猫/淘宝。
开放资源
- APISchema体系完成商品管理将使用以下API（图片上传使用原有API）
- top SDK去开放平台后台下载
- Schema SDK（目前仅支持java）下载地址：见文档底部
支持范围
类目：出境自由行(50278002)、境内自由行(50272002)、出境跟团游(50258005)、境内跟团游(50258004)、境外一日游/多日游(50276003),境内酒景套餐(201301317)
Schema体系说明
详见天猫商品发布Schema体系说明：天猫schema商品发布介绍
商品发布（schemaAPI接口注意事项）
整体步骤
- 发布商品：
a.获取发布商品所需要填的信息（schema获取）：alitrip.item.add.schema.get（xml模版示例说明）
b.发布商品：alitrip.item.schema.add - 编辑商品（全量&增量）:
a.获取编辑商品所需要填的信息，含商品已有值（schema获取）：alitrip.item.update.schema.get
b.编辑商品（支持全量&增量）：alitrip.item.schema.update
商品相关接口总览
商品发布&编辑（schema）
| 接口 | 说明 |
|---|---|
| alitrip.item.add.schema.get | 根据类目id，返回商品发布规则（schema）,如果返回为空,则说明该类目不支持。 |
| alitrip.item.schema.add | 根据类目id, 商品规则发布商品,返回商品id |
| alitrip.item.update.schema.get | 根据商品id，返回商品更新规则（schema），含商品数据 |
| alitrip.item.schema.update | 根据类目id, 商品更新数据，更新对应商品,返回更新结果（支持全量&增量） |
商品增量快速接口（非schema）
| 接口 | 说明 |
|---|---|
| alitrip.ticket.skus.upload | 单票种门票价格库存同步接口（废弃） |
| alitrip.ticket.skus.batch.upload | 多票种门票价格库存同步接口（支持多票种&单票种） |
| taobao.alitrip.travel.item.sku.override | 商品级别日历价格库存修改，全量覆盖 |
| taobao.alitrip.travel.item.sku.package.modify | 套餐级别日历价格库存增删操作 |
| taobao.alitrip.travel.item.sku.price.modify | 日期级别日历价格库存修改，增量维护 |
| taobao.alitrip.travel.item.shelve | 商品上下架接口 |
其他相关接口（非schema）
| 接口 | 说明 |
|---|---|
| taobao.picture.upload | 上传图片至图片空间 |
| taobao.itemprops.get | 获取标准商品类目属性 |
| alitrip.travel.elements.search | 通过关键字查询元素信息 |
| taobao.alitrip.travel.item.element.query | 通过id查询元素信息 |
