抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店行业新预售券解决方案
  • 酒店行业日历房解决方案
  • 酒店日历房接口
  • 酒店静态信息匹配/创建/更新能力
  • 酒店静态信息自助获取能力
  • 代理商-酒店静态信息自助获取
  • 物理房型静态信息匹配/创建/更新
  • 物理房型静态信息自助获取能力
  • 物理房型上下架能力
  • 售卖房型创建/更新能力
  • 房价/房态/房量更新
  • 酒店会员管理
  • 日历房交易正向
  • 日历房上下架能力
  • 日历房线上开票
  • 开票结果通知
  • 酒店日历房线上开票
  • 入住/离店状态同步能力
  • 营销查询
  • 营销规则价格模式推送
  • 营销规则价格推送
  • 营销价量态拉取
  • 营销库存推送
  • 营销退出报名
  • 主动拉取价量态
  • 创建及修改佣金计划
  • 修改佣金计划状态
  • 根据商品查佣金计划
  • 根据佣金计划查商品
  • 日历房交易逆向
  • 营销规则推送
  • 度假行业解决方案
  • 景区行业解决方案
  • 通用错误码
  • 综合
  • 历史版本文档(不推荐)
  • 接口说明

    抖音侧调用酒店系统方接口,申请开发票

    基本信息

    Scope
    life.capacity.trip_hotel_invoice
    权限要求
    酒店日历房解决方案-日历房线上开票
    回调场景
    酒店日历房线上开票

    请求头

      Content-Type:application/json
      X-Bytedance-Logid: 请求 logid, 用于问题排查用
      x-life-clientkey: 服务商应用的 client_key

    请求体

    参数名称
    参数类型
    必须参数
    备注
    » apply_id
    string
    必填
    开票申请id
    » order_id_list
    list<string>
    必填
    订单id列表
    » apply_time
    int
    必填
    申请时间
    » amount
    int
    必填
    发票金额
      单位:分
    » invoice_type
    enum
    必填
    发票类别(结构见公共结构2.2.32)
      目前仅支持增值税电子普通发票
    » content
    string
    必填
    发票内容
    » invoice_title
    object
    必填
    抬头
    »» invoice_title_type
    enum
    必填
    发票抬头类型(结构见公共结构2.2.34)
    »» title
    string
    必填
    发票抬头
    »» tax_number
    string
    选填
    税号
      当发票抬头类型为企业发票时,必填
    » remark
    string
    必填
    备注
    » reception
    object
    必填
    发票接收方式
    »» receive_mode
    enum
    必填
    发票接收类型(结构见公共结构2.2.35)
      目前仅支持电子邮箱接收
    »» receive_address
    string
    必填
    发票接收地址
      字段加密传输
      解密规则参考文档底部解密方法章节

    请求示例

    { "apply_id":"123", "order_id_list":["4","5"], "apply_time":12345, "amount":100, "invoice_type":3, "content":"xxxxx", "invoice_title":{ "invoice_title_type":1, "title":"xx", "tax_number":"234" }, "remark":"xx酒店xx房间xx晚", "reception":{ "receive_mode":1, "receive_address":"xxx" } }

    响应参数

    参数名称
    参数类型
    必须参数
    备注
    data
    struct
    必填
    » error_code
    int
    必填
    错误码
      0 成功
      非0 失败
    » description
    string
    选填
    描述信息

    响应示例

    { "data":{ "error_code": 0, "description": "成功" } }