查询发票接口

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

接口概述

查询发票详情接口，在开票接口或发票红冲接口调用之后会持续轮询该接口，尝试获取已开具的发票信息 如果携程收到票包中的任意一张发票处于开票中状态，携程会在5分钟后发起下一次查询发票请求，所以，除非非常确认目标发票没有可能达到开票成功的结果（如，公司税号不存在等），请勿将发票开具状态置为开票失败 值得注意的是：一般来说，发票将会在24h内开具成功，建议供应商在12h左右设置系统监控，及时发现开票可能存在的系统的故障

请求地址

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

请求内容

QueryInvoiceRequest

参数 类型 必传 描述 示例 备注
serviceProviderId Long 是 服务商ID 1000000 用于多服务商接入场景，需要的供应商请联系我方技术添加
ctripInvoiceId Long 是 携程票包唯一编码 198379 n位数字
vendorInvoiceId String 是 供应商发票包id    
redVendorInvoiceId String 否 供应商冲红发票包id，当目标票包已发起红冲后该值为必填    

返回内容

QueryInvoiceResponse

参数 类型 必传 描述 示例 备注
msgCode String 是 响应码 OK  
message String 否 响应详情 成功  
invoiceInfo List 是 开票成功后，红票详情   如果超过单张发票的最大金额，需要开多张票的场景，这个invoiceInfo就是多张发票
redInvoiceInfo List 是 冲红成功后，蓝票详情    
deliveryInfo DeliveryStatusDTO 否 快递信息，纸质票必填    

返回内容

InvoiceInfoDTO

参数 类型 必传 描述 示例 备注
vendorInvoiceId String 是 开票成功后，供应商发票唯一码，如果是冲红的票（蓝票）则是redVendorInvoiceId    
invoiceNumber String 是 发票号    
invoiceCode String 是 发票编码    
invoiceStatus Integer 是 开票状态：1：待开票 2：已开票 3：已作废/已红冲 4：开票失败   一个票组的多张发票的开票状态原则上应该保持一致
invoiceCreateTime String 否 发票开具时间，状态2,3必填 2022-08-01 12:00:00 yyyy-MM-dd HH:mm:ss
invoicePdfUrl String 否 电子票URL，电子票状态2必填 http://www.yangguangchuxing.com/aaa.pdf 域名需要申请携程的出访白名单，需要在正式环境上线后保持不变
invoiceOfdUrl String 否 如果是数电发票状态为2必填，电子票OFD URL http://www.yangguangchuxing.com/aaa.ofd 域名需要申请携程的出访白名单，需要在正式环境上线后保持不变
invoiceXmlUrl String 否 如果是数电发票状态为2必填，电子票XML URL http://www.yangguangchuxing.com/aaa.xml 域名需要申请携程的出访白名单，需要在正式环境上线后保持不变
errorMessage String 否 错误码：1,4必填    

返回内容

DeliveryStatusDTO

参数 类型 必传 描述 示例 备注
deliveryStatus Integer 是 寄出状态：1：未寄出 2：已寄出    
expressNo String 否 已寄出必填，快递单号    
expressCompany String 否 已寄出必填，快递公司    

发票样张

发票样张

请求示例

{
    "serviceProviderId": 1000009,
    "ctripInvoiceId": "1660651438696",
    "vendorInvoiceId": "123"
}

响应示例

{
    "msgCode": "OK",
    "message": "成功",
    "invoiceInfo": [{
        "vendorInvoiceId": "123",
        "invoiceStatus": 1,
        "errorMessage": "待开票"
    }],
    "redInvoiceInfo": []
}

results matching ""

    No results matching ""