文档中心 > API类目 > 酒店交易API

taobao.xhotel.order.distribution.invoicing (飞猪酒店分销开票接口)

飞猪酒店分销开票接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
invoice_order_req InvoiceOrderReq 必须 补开发票请求入参
  • └ dis_order_id
  • String
  • 可选
  • 4684153154
  • 外部分销商订单号,与fliggy_order_id二选一必填
  • hotel_invoice_do
  • HotelInvoiceDO
  • 必须
  • 发票详细信息
  • └ invoice_content
  • String
  • 必须
  • 代订房费
  • 发票内容,传递验价结果invoice_type中仍一
  • receiver_do
  • ReceiverDO
  • 可选
  • 发票收件人信息
  • └ receiver_address
  • String
  • 可选
  • 中国浙江省杭州市余杭区文一西路969号
  • 发票收件人完整地址
  • └ receiver_tel
  • String
  • 可选
  • 18888888888
  • 发票收件人联系电话
  • └ receiver_name
  • String
  • 可选
  • 言五
  • 发票收件人姓名
  • └ express_payer_type
  • Number
  • 可选
  • 2
  • 邮费承担方,0:未知,1:卖家承担,2:买家承担
  • └ invoice_type
  • Number
  • 必须
  • 21
  • 需要开票的类型,电子普票/纸质普票等,在验价结果support_invoice_type中选择
  • sp_invoice_do
  • SpInvoiceDO
  • 可选
  • 专票信息,开专票或公司主体开票时必填
  • └ account_no
  • String
  • 可选
  • 测试银行账户
  • 公司银行账号
  • └ register_addr
  • String
  • 可选
  • 中国浙江省杭州市余杭区文一西路969号
  • 公司注册地址
  • └ tel
  • String
  • 可选
  • 18888888888
  • 公司电话
  • └ tax_no
  • String
  • 可选
  • 52430400MJJ1176700
  • 公司税号,发票抬头,开专票或公司主体开票必填
  • └ opening_bank
  • String
  • 可选
  • 中国银行余杭支行
  • 公司开户行
  • └ invoice_email
  • String
  • 可选
  • yanwu@alibaba-inc.com
  • 发票接收邮箱
  • └ invoice_category
  • Number
  • 必须
  • 1
  • 发票种类,0:公司 1:个人
  • └ invoice_title
  • String
  • 可选
  • 飞猪网络技术有限公司
  • 发票抬头,开专票或公司主体开票时必填
  • └ invoice_remark
  • String
  • 可选
  • 发票备注
  • └ ex_params
  • String
  • 可选
  • {}
  • 扩展信息
  • └ distributor
  • String
  • 必须
  • kuaipao
  • 分销渠道
  • └ fliggy_order_id
  • Number
  • 可选
  • 3949483574206950404
  • 飞猪订单号

响应参数

名称 类型 示例值 描述
error_msg String 系统错误 错误信息
result Boolean true 是否开票成功
error_resp_code Number 104 错误码
attributes Json {} 用于获取trace,排查问题使用
msg_for_dev String 酒店的发票信息实体不能为空 开发查看的错误信息
is_success Boolean true 接口是否调用成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelOrderDistributionInvoicingRequest req = new XhotelOrderDistributionInvoicingRequest();
XhotelOrderDistributionInvoicingRequest.InvoiceOrderReq obj1 = new XhotelOrderDistributionInvoicingRequest.InvoiceOrderReq();
obj1.setDisOrderId("4684153154");
XhotelOrderDistributionInvoicingRequest.HotelInvoiceDO obj2 = new XhotelOrderDistributionInvoicingRequest.HotelInvoiceDO();
obj2.setInvoiceContent("代订房费");
XhotelOrderDistributionInvoicingRequest.ReceiverDO obj3 = new XhotelOrderDistributionInvoicingRequest.ReceiverDO();
obj3.setReceiverAddress("中国浙江省杭州市余杭区文一西路969号");
obj3.setReceiverTel("18888888888");
obj3.setReceiverName("言五");
obj3.setExpressPayerType(2L);
obj2.setReceiverDo(obj3);
obj2.setInvoiceType(21L);
XhotelOrderDistributionInvoicingRequest.SpInvoiceDO obj4 = new XhotelOrderDistributionInvoicingRequest.SpInvoiceDO();
obj4.setAccountNo("测试银行账户");
obj4.setRegisterAddr("中国浙江省杭州市余杭区文一西路969号");
obj4.setTel("18888888888");
obj4.setTaxNo("52430400MJJ1176700");
obj4.setOpeningBank("中国银行余杭支行");
obj2.setSpInvoiceDo(obj4);
obj2.setInvoiceEmail("yanwu@alibaba-inc.com");
obj2.setInvoiceCategory(1L);
obj2.setInvoiceTitle("飞猪网络技术有限公司");
obj2.setInvoiceRemark("无");
obj1.setHotelInvoiceDo(obj2);
obj1.setExParams("{}");
obj1.setDistributor("kuaipao");
obj1.setFliggyOrderId(3949483574206950404L);
req.setInvoiceOrderReq(obj1);
XhotelOrderDistributionInvoicingResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_order_distribution_invoicing_response>
    <error_msg>系统错误</error_msg>
    <result>true</result>
    <error_resp_code>104</error_resp_code>
    <attributes>{}</attributes>
    <msg_for_dev>酒店的发票信息实体不能为空</msg_for_dev>
    <is_success>true</is_success>
</xhotel_order_distribution_invoicing_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

返回
顶部