线上开票
收藏接口说明
抖音侧调用酒店系统方接口，申请开发票
基本信息
Scope | life.capacity.trip_hotel_invoice | |||
权限要求 | 酒店新预售券解决方案-预售券线上开票 | |||
回调场景 | 酒店新预售券线上开票 | |||
请求头
•Content-Type：
application/json•X-Bytedance-Logid: 请求 logid， 用于问题排查用
•x-life-clientkey: 服务商应用的 client_key
•X-life-sign: 请求签名，签名规则
请求体
参数名称 | 参数类型 | 必须参数 | 备注 |
» 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": "成功"}}
