抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 通用接口
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店通用错误码
  • 酒店行业日历房解决方案
  • 酒店行业新预售券解决方案
  • 度假行业解决方案
  • 旅行社直连相关枚举&常见错误码
  • KA核销对账
  • 预售券
  • 旅行社 POI 查询
  • 酒旅-旅行社退款结果通知
  • 酒旅-旅行社创建订单
  • 酒旅旅行社-预售券价量态操作
  • 更新预售券价格库存及其加价规则
  • 预售券价量态-更新预定商品日历库存
  • 商家获取商品价量态信息
  • 旅行社确认
  • 酒旅-旅行社创建预售订单
  • 酒旅商品上架和下架信息推送
  • 酒旅-旅行社订单取消通知
  • 酒旅-旅行社支付结果通知
  • 日历品
  • 景区行业日历票解决方案
  • 景区团购三方码方案
  • 综合
  • 能力
  • 历史版本文档(不推荐)
  • 接口说明

    商家在来客后台创建商品成功后,通过接口调整预售券的价格库存信息

    以最新商品模板为准,商品模板需要有被更新的属性

    抖音侧商品分为草稿态和在线态,处于草稿态但无在线态的商品(即商品刚创建但尚未审核通过时)是无法更新预售商品的加价规则的

    商品属性的更新为以接口入参为准的全量覆盖

    更新后需要审核通过才能生效。

    旅行社选择浮动加价模式时,浮动加价金额需要大于等于商品预售券金额。

    使用限制

    SLA:支持的最大QPS:50;

    基本信息

    名称描述
    HTTP URL
    https://open.douyin.com/goodlife/v1/trip/trade/travelagency/presale_coupon/save/presale/ari/
    HTTP Method
    POST
    Scope
    life.capacity.trip_travel_presale_ari_operate
    权限要求
    度假行业解决方案-酒旅旅行社-预售券价量态操作

    请求参数

    请求头
    access-token必填String
    示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
    content-type必填String
    固定值"application/json"
    Rpc-Transit-Life-AccountString

    来客商户根账户ID

    Body展开全部子属性
    account_idString
    商家ID。商家在抖音平台的id
    actual_amountInt64
    预售商品实际支付价格。实际支付价格
    children_definitionStruct
    儿童定义。日历库存加价结构体中有儿童出行人加价,并且需要覆盖之前的儿童定义,则填。原商品内有增加出行人加价属性或本次新增增加出行人加价时才可更新儿童定义
    展开子属性
    date_add_price_ruleStruct
    热门日期加价。当前C端展示规则:各种加价规则有重叠的时候,会取最大值。如一个时间段加价规则内也有有节假日加价,取最大加价值
    展开子属性
    marketing_amountInt64

    预售商品营销最低价。营销时改价不可低于该价格。(仅旅行社,邮轮商家不支持)

    origin_amountInt64

    预售商品原价。划线价格,origin_amount金额需要与来客创品时设置的商品搭配的总额一致。

    product_idString
    抖音平台商品ID
    room_add_price_ruleStruct
    单房差加价。当前C端展示规则:各种加价规则加价有重叠的时候,会取最大值。如一个时间段加价规则内也有有节假日加价,取最大加价值
    展开子属性
    stock_qty_limit_typeInt32
    预售商品是否无限库存。1 限制库存,2不限库存
    total_stock_qtyInt64
    预售商品库存数量。总库存(库存数量需大于等于下单已支付和下单未支付的库存总量)
    user_add_price_ruleStruct
    增加出行人加价。1. 当前C端展示规则:各种加价规则有重叠的时候,会取最大值。如一个时间段加价规则内也有有节假日加价,取最大加价值 2.增加出行人加价必须区分不同人群的加价金额
    展开子属性
    请求示例
    curl --location --request POST 'https://open.douyin.com/goodlife/v1/trip/trade/travelagency/presale_coupon/save/presale/ari/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"date_add_price_rule":{"hot_day_markup_type":1,"add_price_rule_list":[{"date_type":5838579157809680425,"holidays":[4951732800842079361],"start_date":"60PjhowjBF","adult_price":4885841866007758680,"days_of_week":[7475080574001936450],"end_date":"klLMPPpYap","child_price":3241887618525259247,"dates_list":[{"start_date":"q755exQN8y","end_date":"oUnrjOt2xb","date_type":1,"days_of_week":[1]}],"price":231577893347118893}],"enable":false},"user_add_price_rule":{"hot_day_markup_type":1,"add_price_rule_list":[{"date_type":4153513254231185500,"price":2237394472241810069,"child_price":972724771629821072,"adult_price":6052187072346412729,"dates_list":[{"end_date":"vRdyUX5128","date_type":1,"days_of_week":[1],"start_date":"TELginJo4j"}],"holidays":[5412793310152565373],"start_date":"ypMRVqDecU","end_date":"oLWcGy1f8g","days_of_week":[3309514182753227089]}],"enable":false},"marketing_amount":2412300300281857471,"total_stock_qty":95792858710715634,"room_add_price_rule":{"hot_day_markup_type":1,"add_price_rule_list":[{"end_date":"lOoqiXoSPH","days_of_week":[5454392929714311438],"date_type":8857167272169642262,"holidays":[1807932127979124491],"price":1224889386000022874,"child_price":6133326659140548766,"adult_price":5155713492035273860,"start_date":"ZPmeB8pEUq","dates_list":[{"start_date":"GvgrPXkCKu","end_date":"4PLdrtIGRM","date_type":1,"days_of_week":[1]}]}],"enable":false},"account_id":"CX5CprErPJ","stock_qty_limit_type":2114163847216227791,"product_id":"VM8psH0G90","origin_amount":7594566326675160233,"children_definition":{"min_age":6858003758129946435,"max_age":2190076001026878859,"min_height":7488785009400739622,"max_height":3912701403024735455},"actual_amount":6840869259280987463}'

    响应参数

    Body展开全部子属性
    extra必填Struct
    扩展信息
    展开子属性
    dataStruct
    展开子属性
    响应示例
    正常响应示例异常响应示例
    { "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20260331174410474205C3D07A43F7376B", "now": 1774950253 }, "data": { "error_code": 0, "descripiton": "CnNv9SShqx", "description": "" } }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    2002100001
    未知错误
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100004
    系统繁忙,此时请开发者稍候再试
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100005
    参数不合法
    更换参数
    2002190002
    access_token无效
    调用接口重新生成access_token
    2002190004
    应用未获得该能力, 请去https://open.douyin.com/申请
    应用申请接口权限
    2002190008
    access_token过期,请刷新或重新授权
    规范token刷新机制,检查是否有测试环境在同步刷新token
    2002119001
    参数不合法
    更换参数
    2002119002
    系统繁忙,请稍候再试
    重试
    2002119003
    请求太过频繁,请稍后再试
    重试
    2002119005
    应用未获商家授权
    联系合作商家在商家后台发起授权,并在服务商后台同意授权
    2003000001
    根据实际业务错误返回
    对照接口文档规范参数并重试
    2004000001
    根据实际业务错误返回
    补充参数
    2004000002
    根据实际业务错误返回
    对照接口文档规范参数并重试
    2005000001
    根据实际业务错误返回
    联系抖音处理
    2005000001
    服务器打瞌睡了,请稍后再试。
    2003000001
    以实际错误信息为准