文档中心 > API类目 > 旅行度假API

qimen.alitrip.travel.invoice.submit (飞猪度假-发票提交接口)

用于飞猪平台向第三方服务商提交开发票(补开发票)请求

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
traceId String 必须 1223 本次请求的标识
bizType Number 可选 1 业务类型:0-接送机 1-即时打车 2-国内租车 3-国际租车(不传默认是接送机)
channelId String 可选 20010 渠道id
userId Number 可选 1212 用户id
channelName String 可选 crs 渠道名称
orderId Number 必须 12345 飞猪订单id(必填)
outOrderId String 必须 22222 外部商家订单号(必填)
isElecInvoice Boolean 可选 true 是否电子发票。true:电子发票,false:纸质发票
isCompanyInvoice Boolean 可选 true 是否企业发票。true:企业发票,false:个人发票
invoiceContent String 可选 代收租车费 发票内容,如代收租车费
invoiceTitle String 可选 发票抬头 发票抬头
invoiceSendWay Number 可选 1 发票寄送方式。1-预付邮费 2-到付。isElecInvoice为false情况下,填写纸质发票寄送方式
invoiceSendFee Number 可选 122 发票寄送费用, 单位分。当invoiceSendWay为1情况下,填写发票预付费用
invoiceFee String 可选 1 开票金额-用户实际支付金额
invoiceReceiverInfo InvoiceReceiverInfo 可选 发票接收人信息
  • └ invoiceSendAddr
  • String
  • 可选
  • 杭州市西湖区
  • 发票寄送地址信息
  • └ invoiceReceivePhone
  • String
  • 可选
  • 13777777777
  • 发票接收人电话
  • └ invoiceReceiverName
  • String
  • 可选
  • 张三
  • 发票接收人姓名
  • └ eInvoiceSendEmail
  • String
  • 可选
  • 123@qq.com
  • 发票寄送邮箱(用于电子发票)
invoiceCompanyInfo InvoiceCompanyInfo 可选 企业发票,相关企业信息。isCompanyInvoice为true时必填
  • └ taxNo
  • String
  • 可选
  • 1234
  • 企业(公司)税号
  • └ coAddress
  • String
  • 可选
  • 杭州市西湖区
  • 公司注册地址
  • └ coPhone
  • String
  • 可选
  • 1111
  • 公司电话
  • └ coBank
  • String
  • 可选
  • 公司开户银行的名称
  • 公司开户银行的名称
  • └ coBankNo
  • String
  • 可选
  • 1234
  • 公司开户银行帐号
outOrderIds String [] 可选
  • 最大列表长度:999
  • 合并开票商家订单id列表(多个订单一起开票的场景,目前只支持单个)

    响应参数

    名称 类型 示例值 描述
    success Boolean true 接口调用是否成功
    outInvoiceId String 12323 注:1.成功情况下一定要返回,商家系统发票id(商家系统的id,非国家统一的发票税号),不然会重试开票,2.需要幂等,否则会产生开多张票问题
    errorInfo ErrorInfo 错误信息
    • └ message
    • String
    • 错误信息
    • 自定义错误信息。记录各链路错误详细描述,以“|”分隔,如:商家接口出现系统异常/业务错误(uac)|商家具体错误描述。
    • └ code
    • String
    • 1001
    • 自定义错误码。1001:商家接口 系统异常。2001:商家接口 业务异常。3001:uac内部系统异常。4001:uac业务校验异常。
    • └ subCode
    • String
    • -1
    • 子错误码
    • └ subMessage
    • String
    • 子错误信息
    • 子错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AlitripTravelInvoiceSubmitRequest req = new AlitripTravelInvoiceSubmitRequest();
    req.setTraceId("1223");
    req.setBizType(1L);
    req.setChannelId("20010");
    req.setUserId(1212L);
    req.setChannelName("crs");
    req.setOrderId(12345L);
    req.setOutOrderId("22222");
    req.setIsElecInvoice(true);
    req.setIsCompanyInvoice(true);
    req.setInvoiceContent("代收租车费");
    req.setInvoiceTitle("发票抬头");
    req.setInvoiceSendWay(1L);
    req.setInvoiceSendFee(122L);
    req.setInvoiceFee("1");
    AlitripTravelInvoiceSubmitRequest.InvoiceReceiverInfo obj1 = new AlitripTravelInvoiceSubmitRequest.InvoiceReceiverInfo();
    obj1.setInvoiceSendAddr("杭州市西湖区");
    obj1.setInvoiceReceivePhone("13777777777");
    obj1.setInvoiceReceiverName("张三");
    obj1.setEInvoiceSendEmail("123@qq.com");
    req.setInvoiceReceiverInfo(obj1);
    AlitripTravelInvoiceSubmitRequest.InvoiceCompanyInfo obj2 = new AlitripTravelInvoiceSubmitRequest.InvoiceCompanyInfo();
    obj2.setTaxNo("1234");
    obj2.setCoAddress("杭州市西湖区");
    obj2.setCoPhone("1111");
    obj2.setCoBank("公司开户银行的名称");
    obj2.setCoBankNo("1234");
    req.setInvoiceCompanyInfo(obj2);
    req.setOutOrderIds("");
    AlitripTravelInvoiceSubmitResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <success>true</success>
    <outInvoiceId>12323</outInvoiceId>
    <errorInfo>
        <message>错误信息</message>
        <code>1001</code>
        <subCode>-1</subCode>
        <subMessage>子错误信息</subMessage>
    </errorInfo>
    

    异常示例

    • 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

    返回
    顶部