开票接口

Point-to-point支持：必须接入

更新时间： 2022-08-01 必须接入 在线调试（沙箱环境）

接口概述

1、该接口用来支持用户在携程平台申请电子发票或纸质发票。
2、发票接口不区分产线，接送/包车/打车都要支持，如无特殊说明，上述订单可能会打包在同一次开票请求中。
3、为保证开票成功率，供应商尽可能在接口中响应成功。
4、后续会通过查询发票详情接口（QueryInvoice）获取对应的电子票PDF文件或快递单号。

请求地址

地址格式:  {Domain}/JNT/createinvoice/2.0/{timeStamp}/{sign}

请求内容

CreateInvoiceRequest

InvoiceOrderDTO

零税率标识

1 - 当税率 taxRate为：0%，且增值税特殊管理：为“免税”， 零税率标识：需传“1” 2 - 当税率 taxRate 为：0%，且增值税特殊管理：为"不征税" 零税率标识：需传“2” 3 - 当税率 taxRate 为：0%，且增值税特殊管理：为空 零税率标识：需传“3”

DeliveryInfoDTO

OtaInvoiceTravellerDTO

返回内容

CancelOrderResponse

请求示例

{
    "serviceProviderId": 1000009,
    "ctripInvoiceId": "1660651438696",
    "invoiceTitle": "测试发票抬头",
    "invoiceContent": "旅游服务费",
    "invoiceType": 1,
    "identityType": 1,
    "identityCode": "1234567890abc",
    "companyAddress": "金钟路968号",
    "companyPhone": "12345678",
    "invoiceRemark": "发票备注",
    "orderInfo": [{
        "ctripPurchaseOrderId": 881823967638342968,
        "masterOrderId": 16143177718,
        "vendorOrderId": "20220801194545418324",
        "parentCategoryCode": "jnt",
        "invoiceAmount": 100,
        "taxRate": 0,
        "count": 1,
        "unit": "次",
        "zeroRateFlag": 1
    }, {
        "ctripPurchaseOrderId": 14143177719,
        "masterOrderId": 14143177718,
        "vendorOrderId": "20220801194545516978",
        "parentCategoryCode": "rtn",
        "invoiceAmount": 50,
        "taxRate": 0,
        "count": 1,
        "unit": "次",
        "zeroRateFlag": 1
    }],
    "travellers":[{
        "traveller":"张三",
        "travelDate":"2026-06-10",
        "travellerCardType":"101",
        "travellerCardNo":"111111111",
        "travelPlace":"上海市政府",
        "arrivePlace":"虹桥火车站",
        "vehicleType":"5",
        "vehicleLevel":""
        }]
}

响应示例

{
  "msgCode": "OK",
  "message": "成功",
  "vendorInvoiceId": "123"
}

异常示例

{
  "msgCode": "ERROR",
  "message": "企业发票税号为空"
}