方法名称
hotel.order.addinvoice
使用说明
简单介绍
使用hotel.order.create接口下单时，如果没有传入发票信息，那么在订单流程正常结束后（即用户离店后），可以调用本接口补开发票。
本接口调用成功仅代表补开发票申请成功，发票状态和邮递情况请使用hotel.order.detail接口查询。
注：入住日在6个月前的的订单不支持开具或修改发票，如有需求请联系客服跟进
须使用https访问本接口。
输入参数
根节点
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| DeliveryInfo | 配送信息 | DeliveryAddress | N | |
| OrderId | 订单号 | Long | N | |
| Title | 发票抬头 | String | Y | 用户类型为企业、政府必填 |
| UserType | 用户类型 | Int | N | 用户类型，1-个人 2- 企业 3-政府机关行政单位 |
| ItemName | 发票内容 | String | N | 发票内容，必填，填写代订房费或代订住宿费 |
| Amount | 开票金额 | Double | N | |
| InvoiceType | 发票类型 | Int | N | 用来区分电子发票还是纸质发票，0：纸质，1：电子 |
| InvoiceLevel | 发票级别 | Int | N | 用来区分专用发票还是普通发票，0：普通发票，1：专用发票 |
| Itin | 税号 | String | Y | 税号，用户类型为企业必填 |
| needRelationOrder | 是否关联订单 | Int | N | 是否关联订单，即在发票备注栏中添加酒店预订信息（酒店名称、入住日期、离店日期、房间数）,0-不关联，1-关联 |
| DedicatedInvoice | 专用发票信息 | DedicatedInvoice | Y | 专票必填，专用发票信息，参考DedicatedInvoice节点 |
| EncryptOption | 用户信息加密选项 | Int | Y | 0：无需加密，1：对称加密 传1时，需要对入参中的以下字段进行加密: DeliveryAddress节点 DedicatedInvoice节点 加密方式同成单接口中的信用卡号加密方式 |
DeliveryAddress节点
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| Province | 省 | String | Y | 省，纸质发票必填 |
| City | 市 | String | Y | 市，纸质发票必填 |
| District | 区 | String | Y | 区，纸质发票必填 |
| Street | 街道 | String | Y | 街道，纸质发票必填 |
| RecipientName | 收件人姓名 | String | Y | 收件人姓名，纸质发票必填 |
| PostEmail | 邮寄电子邮箱地址 | String | Y | 邮寄电子邮箱地址，电子发票必填 |
| Phone | 电话 | String | N | 电话号码 |
| 邮箱地址 | String | Y | 邮箱地址。已废弃 |
DedicatedInvoice节点
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| TaxPayerNum | 纳税人识别号 | String | N | |
| TaxRegisterBank | 开户银行 | String | N | |
| RegisterBankNum | 行政区 | String | N | |
| ShotelAddress | 注册地址 | String | N | |
| RegisterPhoneNum | 电话 | String | N |
响应结果
根节点
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| Success | 补开发票是否提交成功 | Boolean | N |
输入参数示例
https://api-test.elong.com/rest?format=json&method=hotel.order.addinvoice&user={userid}×tamp=1488508207&signature=1b34c24f5c31381a67c666f4dc211077&data={"Version":"1.36","Request":{"Amount":911.79,"DedicatedInvoice":{"RegisterBankNum":"2232323232323","RegisterPhoneNum":"12244445555","ShotelAddress":"北京市朝阳区","TaxRegisterBank":"中国银行"},"DeliveryInfo":{"Phone":"13573572***","PostEmail":"99999999@xx.com","Recipient":{"Email":"9999999@xx.com","Name":"李**","Phone":"135735*****","Street":"酒仙桥北路同程艺龙大厦"},"RecipientName":"李**","Street":"酒仙桥北路同程艺龙大厦"},"InvoiceLevel":0,"InvoiceType":1,"ItemName":"代订住宿费","Itin":"234132413253232432","OrderId":66666666,"Title":"艺龙旅行网","UserType":1,"needRelationOrder":1},"Local":"zh_CN"}输出参数示例
{
"Code":"0",
"Result":{
"Success":true
}
"Guid":"196d84d9-19b1-4aa2-8891-1c699e806a3c"
}常见错误码
| 错误码 | 解释 | 解决方案 |
|---|---|---|
| H001053 | 订单号必须填写 | 填写同程艺龙订单号 |
| H001054 | 订单ID错误，订单号不存在 | 请确保订单已经存在，另外下单成功后，订单入库需要一段时间，此间调用本接口也会报该错误，请等待1分钟再尝试。 |
| H001055 | 订单ID错误! OrderFrom不一致 | 非法订单号，无解决方案 |
| H001149 | 订单不支持开票 | 订单暂不支持开票，只有预付且发票模式为艺龙开票的订单，才可以进行补开发票。 |
| H001143 | 产品不支持专票 | 订单不支持专票 |
| H001147 | 未获取到发票信息 | 重试，反复出现请联系开发支持。 |
| H001148 | 发票金额错误，可开票金额:{0} | 发票金额错误，如对开票金额有异议，请联系商务。 |
| H000025 | 企业账户信息不能为空 | 请检查API账号是否正确。 |
| H001046 | 系统不能接受贵司的发票请求 | 如有需要请联系商务开通发票权限。 |
| H000996 | 请求参数错误,请检查 | 请求参数不符合业务逻辑，更改后重试。 |
| H001142 | 无专票权限 | 如有需要请联系商务开通专票权限。 |
| H001145 | 补开发票失败 | 系统底层调用问题，反复出现请联系开发支持。 |