识别接口

接口描述

请求地址：/api/ocr/mixtureTicket

http请求方式：POST

接口诞生版本：

所属系统：π平台

接口说明：用于企业识别票据

单次调用最大条数：1

支持的文件类型：jpg, jpeg, png, bmp, tiff, pdf, OFD, XML. 文件最大支持8M。其中，单个pdf的最大支持页数为30页。

使用场景

当前支持识别发票类型：增值税专用发票、增值税普通发票、增值税电子专用发票、增值税电子普通发票、电子发票（增值税专用发票）、电子发票（普通发票）、区块链发票、车船票（实名制&非实名制）、火车票、航空运输电子客票行程单、出租车发票、机打发票、增值税普通发票(卷票)、机动车销售统一发票、二手车销售统一发票、海关专用缴款书、电子发票（航空运输电子客票行程单）、电子发票（铁路电子客票）等等。

请求报文

派平台
字段编码	类型	是否必填	字段名称	说明
imgBase64	String	是	图片base64数据
checkBusShipFlag	String	否	归类车船票	true：是，为true时，会将车船票区分为是否实名制，否则，会识别为其他票，一般最好默认传true
extendCategory	String	否	扩展分类字段

请求报文范例

{
	"appId": "ztefssc",
	"format": "json",
	"sign": "sqB966BTm36xSNcTi2EuhGTPHMw=",
	"version": "V2.0",
	"noncestr": "58ce21fe-e586-46f1-ae8a-47017a84e72e",
	"checkBusShipFlag": "true",
	"timestamp": "2024-06-20 14:50:53"
}

响应报文

返回参数：
派平台
字段编码	类型	字段名称	说明

airTickets	List	机票列表
invoices	List	增值税发票列表	（含：增值税专用发票、增值税普通发票、增值税电子普通发票）
otherTickets	List	其他票据列表
trainTickets	List	火车票列表
taxiTickets	List	出租车票列表
machineTickets	List	机打发票列表
volumeTickets	List	卷票列表
carTickets	List	机动车发票列表
secondCarTickets	List	二手车发票列表
busShipTickets	List	车船票
electricTickets	List	全电票
customsTickets	List	海关缴款书
errorCode	String	错误码	详见下方说明
detailMessage	String	错误信息


返回参数：invoices
派平台
字段编码	类型	字段名称	说明
agentMark	String	是否代开	0：否，1：是
blockChain	String	区块链标志	0：否，1：是
buyerName	String	购方名称
buyerAddressAndPhone	String	购方地址电话
buyerBankAccount	String	购方开户行及账号
buyerNumber	String	购方识别号
checkCode	String	校验码
ciphertext	String	密码区	四行密码，每行以逗号隔开
city	String	市
billingNo	String	发票代码
machineCode	String	机打代码
companySeal	String	是否有公司印章	0：没有，1：有
companySealMark	String	是否有销售方（章）标记	0：没有，1：有
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
electronicMark	String	电子标志	0：否，1：是
electronicNumber	String	全电发票号码	当存在该字段时，无ciphertext，全电纸票有此字段
formName	String	发票联次
formType	String	发票是第几联
maker	String	开票人
itemNames	String	品名	多个以逗号隔开
items	String	发票明细行信息
items.endDate	String	通行日期止	通行费票
items.licensePlate	String	通行费车牌号	通行费票
items.name	String	项目（商品）名称
items.price	String	单价
items.quantity	String	项目数量
items.specification	String	规格型号
items.startDate	String	通行日期起
items.tax	String	税额
items.taxRate	String	税率
items.total	String	金额
items.unit	String	项目单位
items.vehicleType	String	车辆类型	通行费票
kind	String	消费类型
taxDiskCode	String	机器编号
billingCode	String	发票号码
machineNumber	String	机打号码
feeWithoutTax	String	税前金额
province	String	省
receiptor	String	收款人
remarks	String	备注
reviewer	String	复核人
sellerName	String	销方名称
sellerAddressAndPhone	String	销方地址电话
sellerBankAccount	String	销方开户行及账号
sellerNumber	String	销方识别号
serviceName	String	服务类型
stampInfo	String	发票章内容
tax	String	税额
title	String	标题
fee	String	合计金额
totalCn	String	合计金额(大写)
transitMark	String	通行费标志	0：否，1：是
vehicleMark	String	机动车标志	0：否，1：是
extra	String	其他信息
extra.checkCodeCandidates	String	校验码备选
extra.checkCodeLastSix	String	校验码后六位备选
extra.numberOrderError	String	发票号码备选
extra.qrcode	String	二维码
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee
sellerBank	String	销方开户行及账号	机动车票，同sellerBankAccount
cashier	String	收款人	同receiptor
fuhr	String	复核人	同reviewer
airNumber	String	电子客票号码	同billingCode
executedOnDate	String	填开日期	yyyy-MM-dd，同billingTime



返回参数：volumeTickets
派平台
字段编码	类型	字段名称	说明
buyerName	String	购方名称
buyerNumber	String	购方识别号
checkCode	String	校验码
city	String	市
billingNo	String	发票代码
machineCode	String	机打代码
companySeal	String	是否有公司印章	0：没有，1：有
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
itemNames	String	品名	多个以逗号隔开
items	String	发票明细行信息
items.name	String	项目（商品）名称
items.price	String	单价
items.quantity	String	项目数量
items.total	String	金额
kind	String	消费类型
billingCode	String	发票号码
machineNumber	String	机打号码
province	String	省
sellerName	String	销方名称
sellerNumber	String	销方识别号
serviceName	String	服务类型
title	String	标题
fee	String	合计金额
totalCn	String	合计金额(大写)
extra	String	其他信息
extra.checkCodeCandidates	String	校验码备选
extra.checkCodeLastSix	String	校验码后六位备选
extra.numberOrderError	String	发票号码备选
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee
airNumber	String	电子客票号码	同billingCode
executedOnDate	String	填开日期	yyyy-MM-dd，同billingTime


返回参数：carTickets
派平台
字段编码	类型	字段名称	说明
account	String	卖方开户行账号
address	String	卖方单位/个人地址
buyerName	String	购方名称
buyerIdOrOrginCode	String	买方单位代码/身份证号码
carCode	String	车辆识别代号/车架号码
carEngineCode	String	发动机号
carModel	String	厂牌型号
carType	String	车辆类型
certificateNumber	String	合格证号
city	String	市
billingNo	String	发票代码
commodityNumber	String	商品编号
companySeal	String	是否有公司印章	0：没有，1：有
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
formName	String	发票联次
formType	String	发票是第几联
maker	String	开票人
kind	String	消费类型
taxDiskCode	String	机器编号
machineNumber	String	机打号码
maxPeopleNum	String	限乘人数
billingCode	String	发票号码
origin	String	产地
phone	String	卖方单位电话
feeWithoutTax	String	税前金额
province	String	省
sellerName	String	销方名称
sellerBank	String	销方开户行
sellerNumber	String	销方识别号
tax	String	税额
taxOfficeName	String	主管税务机关名称及代码	名称与代码拼接得出
taxOfficeName	String	主管税务机关名称及代码	名称与代码拼接得出
taxNum	String	完税证明号
taxRate	String	税率
title	String	标题
fee	String	合计金额
extra	String	其他信息
extra.checkCodeCandidates	String	校验码备选
extra.checkCodeLastSix	String	校验码后六位备选
extra.numberOrderError	String	发票号码备选
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee
sellerBankAccount	String	销方开户行及账号	同sellerBank
airNumber	String	电子客票号码	同billingCode
executedOnDate	String	填开日期	yyyy-MM-dd，同billingTime



返回参数：secondCarTickets
派平台
字段编码	类型	字段名称	说明
buyerName	String	购方名称
buyerAddress	String	买方单位/个人地址
buyerIdOrOrginCode	String	买方单位代码/身份证号码
buyerTel	String	买方单位电话
carCode	String	车辆识别代号/车架号码
carModel	String	厂牌型号
carType	String	车辆类型
city	String	市
billingNo	String	发票代码
companyAddress	String	二手车市场地址
companyBankAccount	String	二手车市场开户银行及账号
marketName	String	二手车市场名称
companyPhone	String	二手车市场电话
companySeal	String	是否有公司印章	0：没有，1：有
marketNumber	String	二手车市场纳税人识别号
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
formName	String	发票联次
formType	String	发票是第几联
kind	String	消费类型
licensePlate	String	车照牌号
taxDiskCode	String	机器编号
machineId	String	机器ID
machineNumber	String	机打号码
billingCode	String	发票号码
province	String	省
registrationNumber	String	登记证号
sellerName	String	销方名称
sellerAddress	String	卖方单位/个人地址
sellerIdOrOrginCode	String	卖方单位代码/身份证号码
sellerTel	String	卖方单位电话
title	String	标题
fee	String	合计金额
extra	String	其他信息
extra.checkCodeCandidates	String	校验码备选
extra.checkCodeLastSix	String	校验码后六位备选
extra.numberOrderError	String	发票号码备选
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee
airNumber	String	电子客票号码	同billingCode
executedOnDate	String	填开日期	yyyy-MM-dd，同billingTime


返回参数：electricTickets
派平台
字段编码	类型	字段名称	说明
buyerName	String	购方名称
buyerNumber	String	购方识别号
checkCode	String	校验码
city	String	市
billingNo	String	发票代码
machineCode	String	机打代码
companySeal	String	是否有公司印章	0：没有，1：有
companySealMark	String	是否有销售方（章）标记	0：没有，1：有
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
buildingMark	String	是否为建筑标志	仅专用建筑发票返回此字段
electronicMark	String	电子标志	0：否，1：是
formType	String	发票是第几联
maker	String	开票人
itemNames	String	品名	多个以逗号隔开
items	String	发票明细行信息
items.name	String	项目（商品）名称
items.price	String	单价
items.quantity	String	项目数量
items.specification	String	规格型号
items.tax	String	税额
items.taxRate	String	税率
items.total	String	金额
items.unit	String	项目单位
items.areaUnit	String	面积单位	service_type为不动产经营租赁服务返回字段
items.buildingName	String	建筑项目名称	service_type为建筑服务返回此字段
items.placeOfBuildingService	String	建筑服务发生地	service_type为建筑服务返回此字段
items.titleCertificateNumber	String	产权证书/不动产权证号	service_type为不动产经营租赁服务返回字段
kind	String	消费类型
billingCode	String	发票号码
pageCount	String	总页数	仅当多页时显示
pageNumber	String	当前页数	仅当多页时显示
feeWithoutTax	String	税前金额
province	String	省
receiptor	String	收款人
remarks	String	备注
reviewer	String	复核人
sellerName	String	销方名称
sellerNumber	String	销方识别号
serviceName	String	服务类型
serviceType		全电票标签	建筑服务，货物运输服务，不动产经营租赁服务，旅客运输服务
tax	String	税额
title	String	标题
transports	String	发票明细行信息2	service_type为货物运输服务，旅客运输服务返回字段
transports.date	String	出行日期	service_type为旅客运输服务返回此字段
transports.from	String	起始地	service_type为货物运输服务返回此字段
transports.goodsName	String	运输货物名称	service_type为货物运输服务返回此字段
transports.passenger	String	出行人	service_type为旅客运输服务返回此字段
transports.seat	String	等级	service_type为旅客运输服务返回此字段
transports.to	String	到达地	service_type为货物运输服务返回此字段
transports.transportNumber	String	运输工具牌号	service_type为货物运输服务返回此字段
transports.transportType	String	项目名称	service_type为货物运输服务返回此字段
transports.userId	String	有效身份证号	service_type为旅客运输服务返回此字段
fee	String	合计金额
totalCn	String	合计金额(大写)
vehicleMark	String	机动车标志	0：否，1：是
extra	String	其他信息
extra.checkCodeCandidates	String	校验码备选
extra.checkCodeLastSix	String	校验码后六位备选
extra.numberOrderError	String	发票号码备选
extra.qrcode	String	二维码
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee
cashier	String	收款人	同receiptor
fuhr	String	复核人	同reviewer
airNumber	String	电子客票号码	同billingCode
executedOnDate	String	填开日期	yyyy-MM-dd，同billingTime

返回参数：trainTickets
派平台
字段编码	类型	字段名称	说明
billingTime	String	乘车日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
gateNumber	String	检票口
kind	String	消费类型
passengerName	String	乘客姓名
billingCode	String	票号
pickUpAddress	String	取票地址
trainSeatLevel	String	座位等级
seatNumber	String	车厢座位号
serialNumber	String	序列号
stationGetoff	String	下车车站
stationGeton	String	上车车站
time	String	乘车时间
fee	String	合计金额
flightNumber	String	车次
identityNumber	String	身份证号
extra	String	其他信息
extra.qrcode	String	二维码
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee
tripDate	String	上车日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss，同billingTime
airNumber	String	电子客票号码	同billingCode
executedOnDate	String	填开日期	yyyy-MM-dd，同billingTime
taxDeductible	String	进项税额	火车票、车船票计算公式=合计金额/1.090.09；飞机票公式=（票价+燃油附加费）/1.090.09
electronicMark	String	电子标志	0：否，1：是
typeOfBusiness	String	商务类型	售或退
feeWithoutTax	String	税前金额
buyerName	String	购方名称
buyerNumber	String	购方识别号
originBillingCode	String	原发票号码
taxRate	String	税率
tax	String	税额
typeOfVoucher	String	凭证种类
phStationGeton	String	起始站拼音
phStationGetoff	String	终点站拼音
voucherMark	String	电子凭证标记	0：否，1：是
discountMark		折扣标志


返回参数：taxiTickets
派平台
字段编码	类型	字段名称	说明
city	String	市
billingNo	String	发票代码
billingTime	String	乘车日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
fare	String	票价
kind	String	消费类型
licensePlate	String	车照牌号
mileage	String	里程
billingCode	String	发票号码
place	String	发票所在地
province	String	省
timeGetoff	String	下车时间
timeGeton	String	上车时间
fee	String	合计金额
extra	String	其他信息
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
seatLevel	String	车船票标记	SHIP：船票，BUS：汽车票
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee
tripDate	String	上车日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss，同billingTime
airNumber	String	电子客票号码	同billingCode
executedOnDate	String	填开日期	yyyy-MM-dd，同billingTime


返回参数：machineTickets
派平台
字段编码	类型	字段名称	说明
buyerName	String	购方名称
buyerNumber	String	购方识别号
checkCode	String	校验码
city	String	市
billingNo	String	发票代码
companySeal	String	是否有公司印章	0：没有，1：有
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
electronicMark	String	电子标志	0：否，1：是
items	String	发票明细行信息
items.name	String	项目（商品）名称
items.price	String	单价
items.quantity	String	项目数量
items.total	String	金额
items.unit	String	项目单位
kind	String	消费类型
billingCode	String	发票号码
province	String	省
sellerName	String	销方名称
sellerNumber	String	销方识别号
time	String	时间
title	String	标题
fee	String	合计金额
totalCn	String	合计金额(大写)
extra	String	其他信息
extra.checkCodeCandidates	String	校验码备选
extra.checkCodeLastSix	String	校验码后六位备选
extra.numberOrderError	String	发票号码备选
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee
airNumber	String	电子客票号码	同billingCode
executedOnDate	String	填开日期	yyyy-MM-dd，同billingTime

返回参数：airTickets
派平台
字段编码	类型	字段名称	说明
agentcode	String	销售单位代号
caacDevelopmentFund	String	民航发展基金
checkCode	String	校验码
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
endorsement	String	签注
fare	String	票价
details	String	发票明细行信息
details.allow	String	免费行李重量
details.carrier	String	承运人
details.className	String	座位等级
details.date	String	乘机日期	2020年12月8日
details.departDate	String	乘机日期时间	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
details.fareBasis	String	客票级别
details.flightNumber	String	航班号
details.origin	String	出发地
details.notValidAfter	String	有效截至日期
details.notValidBefore	String	客票生效日期
details.seat/details.airSeatLevel	String	座位等级
details.time	String	乘机时间
details.destination	String	到达地
fuelSurcharge	String	燃油附加费
insurance	String	保险费
internationalFlag	String	国内国际标签
issueBy	String	填开单位
kind	String	消费类型
billingCode	String	发票号码
printNumber	String	印刷序号
tax	String	税额
title	String	标题
fee	String	合计金额
identityNumber	String	身份证号
passengerName	String	乘机人姓名
extra	String	其他信息
extra.checkCodeCandidates	String	校验码备选
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee
tripDate	String	上车日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss，同billingTime
airNumber	String	电子客票号码	同billingCode
executedOnDate	String	填开日期	yyyy-MM-dd，同billingTime
taxDeductible	String	进项税额	火车票、车船票计算公式=合计金额/1.090.09；飞机票公式=（票价+燃油附加费）/1.090.09
ElectronicMark		电子票标记
voucherMark		电子凭证标记
issuingStatus		出票状态
qrcode		二维码
receiptNumber		收据号码
numberOfGpOrder		GP订单号
promptInformation		提示信息
otherTaxes		其他税费
buyerName		购方名称
sellerName		销方名称
buyerNumber		购方识别号
taxRate		增值税税率
typeOfBusiness	String	商务类型	售或退


返回参数：busShipTickets
派平台
字段编码	类型	字段名称	说明
billingNo	String	发票代码
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
kind	String	消费类型
passengerName	String	乘客姓名
billingCode	String	发票号码
stationGetoff	String	到达车站
stationGeton	String	出发车站
time	String	时间
title	String	标题
fee	String	合计金额
identityNumber	String	身份证号
extra	String	其他信息
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
seatLevel	String	车船票标记	SHIP：船票，BUS：汽车票
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee
tripDate	String	乘车日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss，同billingTime
airNumber	String	电子客票号码	同billingCode
executedOnDate	String	填开日期	yyyy-MM-dd，同billingTime
taxDeductible	String	进项税额	火车票、车船票计算公式=合计金额/1.090.09；飞机票公式=（票价+燃油附加费）/1.090.09

返回参数：otherTickets
派平台
字段编码	类型	字段名称	说明
buyerName	String	购方名称
buyerNumber	String	购方识别号
city	String	市
billingNo	String	发票代码
companySeal	String	是否有公司印章	0：没有，1：有
currencyCode	String	币种编码
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
discount	String	折扣金额
entrance	String	收费入口
exit	String	收费出口
highwayFlag	String	高速标志	0：否，1：是
kind	String	消费类型
nonCommercialMark	String	非商业标志	0：否，1：是
billingCode	String	发票号码
province	String	省
remarks	String	备注
stampInfo	String	发票章内容
storeName	String	商店名称
subtotal	String	小计
tax	String	税额
taxAuthorities	String	主管税务机关名称
time	String	时间
tips	String	小费
title	String	标题
fee	String	合计金额
totalCn	String	合计金额(大写)
extra	String	其他信息
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee
airNumber	String	电子客票号码	同billingCode
executedOnDate	String	填开日期	yyyy-MM-dd，同billingTime

返回参数：otherTickets，完税证明
派平台
字段编码	类型	字段名称	说明
buyerName	String	购方名称
buyerNumber	String	购方识别号
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
items	String	发票明细行信息
items.actualPaidAmount	String	实缴金额
items.entryDate	String	入库日期
items.name	String	项目（商品）名称
items.originalNumber	String	原凭证号
items.taxPeriod	String	税款所属时期
items.taxType	String	税种
billingCode	String	发票号码
remarks	String	备注
taxAuthorities	String	主管税务机关名称
title	String	标题
fee	String	合计金额
totalCn	String	合计金额(大写)
extra	String	其他信息
extra.qrcode	String	二维码
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型	固定为10902
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本
price	String	单价	取值合计金额，同fee

返回参数：otherTickets，非税收入
派平台
字段编码	类型	字段名称	说明
billingNo	String	票据代码
billingCode	String	票据号码
checkCode	String	校验码
reviewer	String	复核人
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
electronicMark	String	电子标志	0：否，1：是
items	String	发票明细行信息
items.amount	String	明细金额
items.comment	String	备注
items.projectCode	String	项目编码
items.projectName	String	项目名称
items.quantity	String	项目数量
items.standardOfCharge	String	收费标准
items.uom	String	金额单位
kind	String	消费类型
otherInfo	String	其他信息
payee	String	收款单位
payer	String	交款人
receiptor	String	收款人
socialCreditCode	String	交款人统一社会信用代码
fee	String	合计金额
totalWords	String	合计金额（大写）
extra	String	其他信息
extra.checkCodeCandidates	String	校验码备选
extra.checkCodeLastSix	String	校验码后六位备选
extra.numberOrderError	String	发票号码备选
extra.qrcode	String	二维码
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型	固定为102015
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本
cashier	String	收款人	同receiptor
fuhr	String	复核人	同reviewer

返回参数：otherTickets，电子医疗票据
派平台
字段编码	类型	字段名称	说明
billingNo	String	票据代码
billingCode	String	票据号码
checkCode	String	校验码
billingTime	String	开票日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
electronicMark	String	电子标志	0：否，1：是
items	String	发票明细行信息
items.amount	String	明细金额
items.comment	String	备注
items.projectCode	String	项目编码
items.projectName	String	项目名称
items.quantity	String	项目数量
items.uom	String	金额单位
kind	String	消费类型
payer	String	交款人
socialCreditCode	String	交款人统一社会信用代码
title	String	标题
fee	String	合计金额
totalWords	String	合计金额（大写）
extra	String	其他信息
extra.checkCodeCandidates	String	校验码备选
extra.checkCodeLastSix	String	校验码后六位备选
extra.numberOrderError	String	发票号码备选
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型	固定为102021
billTypeInvoice	String	票据类型编码	根据原始票价类型（originType）转换后的类型编码，详见附录A.2
totalPrice	String	合计金额	兼容V1.0版本

返回参数：customsTickets
派平台
字段编码	类型	字段名称	说明
account	String	缴款单位（人）账号
accountBank	String	缴款单位（人）开户银行
marketName	String	缴款单位（人）名称
contractNumber	String	合同（批文）号
currencyComment	String	备注币种
customsName	String	海关名称
customsNumber	String	报关单编号
billingTime	String	填发日期	yyyy-MM-dd或yyyy-MM-dd HH:mm:ss
deliveryNumber	String	提/装货单号
fillingCompany	String	填制单位
items	String	明细行信息
items.dutiablePrice	String	完税价格
items.nameOfGoods	String	货物名称
items.quantity	String	项目数量
items.tax	String	税额
items.taxNumber	String	税号
items.taxRate	String	税率
items.unit	String	项目单位
kind	String	消费类型
billingCode	String	发票号码
portCode	String	海关口岸代码
revenueAgency	String	收入机关
subject	String	科目
taxExchangeRateComment	String	备注计税汇率
fee	String	合计金额
totalWords	String	大写金额
transportationTools	String	运输工具（号）
extra	String	其他信息
extra.checkCodeCandidates	String	校验码备选
extra.checkCodeLastSix	String	校验码后六位备选
extra.numberOrderError	String	发票号码备选
imageSize	String	图片尺寸
orientation	String	发票顺时针旋转角度
page	String	页码
region	String	坐标[x1, y1, x2, y2]	左上点和右下点
originType	String	原始票据类型
billTypeInvoice	String	票据类型编码	根据原始票据类型（originType）转换后的类型编码，详见附录A.2

响应报文范例

{
	"paiResponseId": "6a9aec16a9a14156bf77e0653b789749",
	"invoices": [{
		"date": "2020年11月29日",
		"stampInfo": "北京京东国际贸易有限公司,911201163409833307",
		"totalCn": "壹佰柒拾贰圆整",
		"feeWithoutTax": "170.30",
		"totalPrice": "172.00",
		"fee": "172.00",
		"sellerBank": "北京夏星纳餐饮管理有限公司020008508200021751",
		"sellerName": "北京夏集纳餐饮管理有限公司",
		"sellerAddressAndPhone": "北京市朝阳区神路机39号十截125段576598530",
		"electronicMark": "1",
		"billTypeInvoice": "17",
		"title": "北京增值税电子普通发票",
		"buyerNumber": "91440300MA5EXWHW6F",
		"vehicleMark": "0",
		"companySealMark": "1",
		"total": "172.00",
		"province": "北京市",
		"sellerNumber": "91110105MA01N8LB9E",
		"executedOnDate": "2020-11-29",
		"price": "172.00",
		"extra": {
			"checkCodeLastSix": [],
			"numberOrderError": [],
			"checkCodeCandidates": []
		},
		"cashier": "系租坐",
		"id": "0d5b7c1cce3c41ef9a6fb61187a9cdca",
		"imageSize": "[720,1290]",
		"itemNames": "*餐饮服务*餐饮费",
		"ciphertext": "0378>2>744*>7+61/290562758><,06860->*05<2366/4-46*010/+46,0/->2+<71>2710/-63+60/6>-406,<-681<076>011956195**6960881",
		"orientation": "90",
		"machineCode": "011001600211",
		"kind": "餐饮",
		"billingTime": "2020-11-29",
		"fuhr": "秦丽友",
		"billingNo": "011001600211",
		"maker": "管理员",
		"tax": "1.70",
		"companySeal": "1",
		"reviewer": "秦丽友",
		"serviceName": "餐饮服务",
		"buyerName": "深圳市中兴新云服务有限公司",
		"checkCode": "04802533995167744501",
		"billingCode": "91500120",
		"originType": "10102",
		"receiptor": "系租坐",
		"sellerBankAccount": "北京夏星纳餐饮管理有限公司020008508200021751",
		"page": "0",
		"region": "[0,0,579,748]",
		"items": [{
			"taxRate": "1%",
			"total": "170.30",
			"unit": "",
			"quantity": "1",
			"price": "170.29703",
			"name": "*餐饮服务*餐饮费",
			"specification": "",
			"tax": "1.70"
		}],
		"airNumber": "91500120"
	}],
	"paiResponseCost": 1046,
	"trainTickets": [{
		"date": "2022年08月02日",
		"trainSeatLevel": "二等座",
		"passengerName": "曹云桥",
		"totalPrice": "131.00",
		"fee": "131.00",
		"billTypeInvoice": "5",
		"seatNumber": "08车12A号",
		"total": "131.00",
		"identityNumber": "3607821996****1547",
		"executedOnDate": "2022-08-02",
		"price": "131.00",
		"extra": {},
		"id": "1c131f4b745e42ff93df356b0d22a482",
		"imageSize": "[720,1290]",
		"typeOfBusiness": "售",
		"stationGeton": "杭州东",
		"gateNumber": "JB",
		"orientation": "90",
		"serialNumber": "90041300670803M016338",
		"kind": "交通",
		"pickUpAddress": "JM",
		"flightNumber": "G7372",
		"seat": "二等座",
		"billingCode": "Z89M016338",
		"originType": "10503",
		"stationGetoff": "无锡",
		"tripDate": "2022-08-02 08:07",
		"taxDeductible": "10.82",
		"page": "0",
		"time": "08:07",
		"region": "[79,668,548,1290]",
		"airNumber": "Z89M016338"
	}],
	"ok": true,
	"paiResponseTime": "2024-06-20 14:50:54"
}

附录A

A.1:错误代码

错误代码：A.1
派平台
错误码	错误信息	说明
10000	服务器内部错误
10002	授权错误
10003	无效参数
10004	不支持的发票类型
10005	发票类型不对
10006	无效图片
10007	无可用的流量包
10008	图片缓存功能未开启
10025	无效App Key
10026	token过期
10300	pdf文件处理异常
10400	使用image_url参数时图片下载失败
10500	调用接口次数太频繁
10600	不支持的票据类型
10700	接口没访问权限

A. 2 发票类型

发票类型映射：A.2
派平台
类型编码（billTypeInvoice）	收费类别	类型名称	说明
10	大票	车船票（非实名制）	busShipTickets
31	大票	电子发票（普通发票）	electricTickets
32	大票	电子发票（增值税专用发票）	electricTickets
2	大票	车船票（实名制）	busShipTickets
14	大票	增值税专用发票	invoices
16	大票	增值税普通发票	invoices
17	大票	增值税电子普通发票	invoices
19	大票	区块链发票	invoices
5	小票	火车票	trainTickets
4	小票	航空运输电子客票行程单	airTickets
8	小票	出租车发票	taxiTickets
20	小票	机打发票	machineTickets
11	小票	增值税普通发票(卷票)	volumeTickets
12	大票	机动车销售统一发票	carTickets
13	大票	二手车销售统一发票	secondCarTickets
3	10200/10900按定额发票，102015按大票，102021按大票，其他按小票	其他	兜底类型，otherTickets
21	大票	增值税电子专用发票	invoices
35	大票	海关专用缴款书	customsTickets
38	小票	电子发票（航空运输电子客票行程单）	airTickets
39	小票	电子发票（铁路电子客票）	trainTickets

识别接口

关联知识库

识别接口

关于作者

关联知识库

目录