OCR票据查询

开发中

测试环境

https://openapi-uat.z-trip.cn

GET

/tmc/v1/ocr/info

通过账单号查询 OCR电子扫描后的映像文件地址，出行人纬度的电子影像件

请求参数

Query 参数

access_token

string

必需

示例值:

billCode

string

账单编号

必需

示例值:

4RLQaXVqQ5yK4oicpSEccA

返回响应

🟢200成功

application/json

Body

data

array [object {14}]

返回结果

必需

string

唯一标识ID

必需

fileType

string

必需

文件类型: ofd、pdf

fileName

string

文件名称

必需

filePath

string

必需

不带域名的文件访问路径
eg：/liquidation/a395ec4d-ee83-4933-8e3c-d1ad636e9eb6.jpg
测试环境域名： https://img-uat.z-trip.cn
生产环境域名： https://img.z-trip.cn
需要自己拼接域名到访问路径上进行访问。

invoiceType

string

必需

发票类型
火车票：train_ticket；
火车数电票：railway_digital_ticket；
行程单：air_transport；
增值税普通发票：vat_common_invoice；
增值税专用发票：vat_special_invoice；
增值税电子普通发票：vat_electronic_invoice；
增值税电子专用发票：vat_electronic_special_invoice；
通用定额：quota_invoice；
电子发票（增值税专用发票）：vat_electronic_special_invoice_new；
电子发票（普通发票）：vat_electronic_invoice_new；
电子行程单：flight_digital_ticket；

isDelete

boolean

必需

影像是否已经删除: false 未删除； true 已删除

orderId

string

可选

影像关联的订单号，如果是酒店订单订单，开的是大票据时此字段为空

travellerId

string

必需

出行人纬度的唯一编码

travellerName

string

出行人姓名

必需

vatCommonInvoiceTicketInfo

object

可选

增值税发票，invoiceType为以下类型时此对象存在;
vat_common_invoice：增值税普通发票；
vat_special_invoice：增值税专用发票；
vat_electronic_invoice：增值税电子普通发票；
vat_electronic_invoice_new：增值税电子普通发票；
vat_electronic_special_invoice：增值税电子专用发票；
vat_electronic_special_invoice_new：增值税电子专用发票；

trainTicketInfo

object

可选

火车票票据，invoiceType为以下类型时，此对象存在;
train_ticket：火车票票根；

quotaInvoiceTicketInfo

object

可选

通用定额发票，invoiceType为以下类型时，此对象存在;
quota_invoice：通用定额；

airTransportTicketInfo

object

可选

机票行程单票据，invoiceType为以下类型时，此对象存在;
air_transport：行程单；
flight_digital_ticket：电子行程单；

eTrainTicketInfo

object

可选

火车数电票信息，，invoiceType为以下类型时，此对象存在;
railway_digital_ticket：火车数电票；

示例

{
    "error": "0",
    "data": [
        {
            "filePath": "/liquidation/a395ec4d-ee83-4933-8e3c-d1ad636e9eb6.jpg",
            "isDelete": false,
            "orderId": "10102002030020",
            "travellerId": "1",
            "travellerName": "张三"
        },
        {
            "filePath": "/liquidation/a395ec4d-ee83-4933-8e3c-d1ad636e9eb9.jpg",
            "isDelete": false,
            "orderId": "10102002030020",
            "travellerId": "2",
            "travellerName": "李四"
        }
    ],
    "error_description": "成功"
}

修改于 2025-04-22 08:05:28

个付电子发票查询

订单数电票