文档中心 > 旅游度假

度假商品发布/编辑

更新时间:2017/03/29 访问次数:10349

商品发布、维护

绿色节点为可选节点,蓝色节点为必选节点

业务场景1

国内跟团游,出境跟团游

image

业务场景2

国内自由行,出境自由行

image

业务场景3

国内邮轮,国际邮轮

image

业务场景4

国内当地玩乐,境外玩乐套餐

image

业务场景5

境外一日游/多日游

image

商品发布各节点说明

查询景点信息

  • 获取景点数据信息,用于含景点元素的商品发布

查询邮轮信息

  • 获取邮轮商品的上下船地点、邮轮公司、航线等邮轮商品相关的枚举值,用于邮轮商品发布

管理资源元素

  • 添加国内当地玩乐、境外玩乐套餐类目下商品套餐的时候,需要关联元素库信息(每个元素都需要设置唯一外部商家编码,用于API上传套餐信息时关联该元素。可以通过 资源元素查询接口 确认一个外部商家编码是否已使用过)。

  • 目前接口只支持类型为酒店、门票、其他的元素类型添加,其余类型元素请在元素管理后台添加

image

映射商家目的地

  • 商家目的地映射主要用于解决商家地址库与飞猪地址库不匹配问题,导致商品发布、维护时频繁出现“无效的目的地/出发地”。为彻底解决该问题,对接商家可以使用飞猪提供的目的地映射工具,一次性批量上传、建立双方系统地址库的映射关系(映射关系只需建立一次,以后所有业务场景API接口可共用该映射关系)。建立映射关系是可选的,如果商家不建立映射关系则商品发布、编辑时必须使用飞猪的标准地址名称
    目的地映射工具使用如下:首先“下载目的地模板”,按照格式往模板填充数据,然后“上传目的地模板”,完成目的地映射关联,重新查询刷新页面即可看到新添加的映射关系。对于个别自动匹配有误的目的地,可以手动“编辑”修正

image

维护商品(通用接口)

image

  • 1、发布商品基本信息(价格库存除外),发布成功后商品默认在仓库中且不可销售

  • 2、商品主副图链接支持外链图片,以及淘宝用户空间内图片,即接口中pic_urls字段中的图片链接可以直接使用商家自己系统中图片链接(需要外网可访问),对于这些外链图片,在发布商品时将自动下载并上传到用户的淘宝图片空间。如果某张外链图片上传失败,则该图片在发布商品时将被忽略。特殊说明:若商品主图上传(base_info下的pic_urls第一个元素)失败则商品将发布失败,副图上传失败则副图将被自动忽略。

维护境外日游产品

  • 1、境外日游产品接口均以商品的外部商家编码(out_product_id)为主键。

  • 2、该接口同时支持商品的新发布和增量更新功能。对于新发商品有一些参数是必填,对于商品更新情况大部分都是可选,请注意看参数说明。系统会根据out_product_id判断是新发布商品还是编辑商品,判断规则如下:
    1)对于只上传out_product_id的情况:如果out_product_id已经关联过某个商品id,则认为是编辑现有商品,否则认为是新发布一个商品。
    2)同时上传out_product_id和item_id,则认为是将out_product_id与item_id进行关联,同时对item_id对应的商品进行编辑。

  • 3、产品维护时,出发地、目的地支持飞猪标准地址或商家自定义地址。如果要使用商家自定义地址 则必须先建立商家目的地映射。

  • 4、商品详情 提供简版字段(desc_xml)和复杂字段(desc_html),新商品发布时二者至少需要填写一个。

维护跟团游产品

  • 跟团游产品维护接口使用注意事项同境外日游产品维护接口。详见“维护境外日游产品”

维护价格库存

  • 补全商品有效的日历价格库存信息。在未补全日历价格库存信息前该商品无法上架

上下架商品

  • 商品默认是仓库中状态且可销售,此时可调用该接口将商品上架

常见问题

发布商品时提示:找不到对应出发地城市(或目的地城市)或上下船地点不可用

问题原因:开发者发布请求中的城市名称在飞猪的地址库中不存在,这类字段只允许在指定值中选填,且通常还与商品类目有关。
解决方法1、使用飞猪提供的目的地映射工具,一次性批量上传、建立双方系统地址库的映射关系
解决方法2、使用飞猪的标准地址名称

FAQ

关于此文档暂时还没有FAQ
返回
顶部