文档中心 > API类目 > 酒店在线预订API

taobao.xhotel.fastinvoice.request (极速开票开票请求回传)

极速开票开票请求回传,用于记录航信开票请求数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
invoice_info_param InvoiceInfoParam 必须
  • └ post_type
  • Number
  • 必须
  • 0
  • 领取方式( 0:前台自取 3: 送至房间)
  • └ short_id_number
  • String
  • 必须
  • 6211
  • 身份证后4位
  • └ request_id
  • String
  • 必须
  • 1234xxx
  • 请求id (32位唯一值)
  • └ plan_invoice_room_price
  • Number
  • 必须
  • 10000
  • 预计开票房费金额(分)
  • └ company_title
  • String
  • 必须
  • 未来酒店有限公司
  • 公司抬头
  • └ room_num
  • String
  • 必须
  • 501
  • 房间号
  • └ invoice_type
  • Number
  • 必须
  • 1
  • 发票类型(1:普通发票;2:增值税专用发票)
  • └ want_time
  • String
  • 必须
  • 2017-01-01 12:01:01
  • 需要发票时间(格式yyyy-MM-dd HH:mm:ss)
  • └ plan_invoice_other_price
  • Number
  • 必须
  • 5000
  • 预计开票杂费金额(分)
  • └ user_nick
  • String
  • 可选
  • zhangsan
  • 用户名
  • └ tax_num
  • String
  • 必须
  • 10001991
  • 酒店开票点税号
  • └ user_channel
  • Number
  • 可选
  • 1
  • 用户渠道(0:未知,1:淘宝)
  • └ out_order_num
  • String
  • 可选
  • 22323321
  • 酒店外部订单号(从查询pms账单接口中获取)
  • value_added_info
  • ValueAddedInfo
  • 可选
  • 专票信息
  • └ register_addr
  • String
  • 可选
  • 杭州市余杭区和睦路1号
  • 注册地址
  • └ account_no
  • String
  • 可选
  • 60012121
  • 银行账号
  • └ opening_bank
  • String
  • 可选
  • 中国人民银行
  • 开户行
  • └ tax_no
  • String
  • 可选
  • 12234342
  • 增值税发票税号
  • └ tel
  • String
  • 可选
  • 0571-21222223
  • 电话

响应参数

名称 类型 示例值 描述
issuccess Boolean false success
errcode String -1 errorCode
errmsg String 操作失败 errorMsg

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelFastinvoiceRequestRequest req = new XhotelFastinvoiceRequestRequest();
XhotelFastinvoiceRequestRequest.InvoiceInfoParam obj1 = new XhotelFastinvoiceRequestRequest.InvoiceInfoParam();
obj1.setPostType(0L);
obj1.setShortIdNumber("6211");
obj1.setRequestId("1234xxx");
obj1.setPlanInvoiceRoomPrice(10000L);
obj1.setCompanyTitle("未来酒店有限公司");
obj1.setRoomNum("501");
obj1.setInvoiceType(1L);
obj1.setWantTime("2017-01-01 12:01:01");
obj1.setPlanInvoiceOtherPrice(5000L);
obj1.setUserNick("zhangsan");
obj1.setTaxNum("10001991");
obj1.setUserChannel(1L);
obj1.setOutOrderNum("22323321");
XhotelFastinvoiceRequestRequest.ValueAddedInfo obj2 = new XhotelFastinvoiceRequestRequest.ValueAddedInfo();
obj2.setRegisterAddr("杭州市余杭区和睦路1号");
obj2.setAccountNo("60012121");
obj2.setOpeningBank("中国人民银行");
obj2.setTaxNo("12234342");
obj2.setTel("0571-21222223");
obj1.setValueAddedInfo(obj2);
req.setInvoiceInfoParam(obj1);
XhotelFastinvoiceRequestResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_fastinvoice_request_response>
    <issuccess>false</issuccess>
    <errcode>-1</errcode>
    <errmsg>操作失败</errmsg>
</xhotel_fastinvoice_request_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部