电子凭证池 - 获取发票结构化信息二开文档

栏目：eas cloud知识作者：金蝶来源：金蝶云社区发布：2024-09-22浏览：1

文档变更时间	变更人	变更章节	变更描述
2023.08.30	安振强	初始版本

1.文档背景

电子凭证池标准产品默认对接发票云发票系统，存在客户使用其他类型发票系统，此时需要通过二次开发从发票系统获取发票结构化数据。

2. 版本支持

EAS版本	领域名	补丁号
EAS8.0	BOS_EVS
EAS8.5	BOS_EVS	PT173746
EAS8.6	BOS_EVS	PT173660
EAS8.8	BOS_EVS

3. 接口介绍

3.1接口定义

package com.kingdee.eas.base.evs.unitdata.pcloud.fpSys;

public abstract class FpSysHelper {

public abstract Map<InvoiceDoc,JSONObject> getInvoiceInfos(Context ctx, List<InvoiceDoc> numCodes, CompanyOrgUnitInfo orgUnitInfo) throws EASBizException;

}

3.2 入参说明

参数名	参数类型	参数说明
ctx	Context	eas上下文
numCodes	List	发票信息对象list
orgUnitInfo	CompanyOrgUnitInfo	组织信息

InvoiceDoc 对象说明：

全类名：com.kingdee.eas.base.evs.unitdata.billData.InvoiceDoc

成员变量：

变量名	类型	说明
code	String	发票代码
number	String	发票号码
serialNum	String	发票流水号
invoiceType	String	发票类型
billPk	String	单据唯一标识
billNumber	String	单据编码

3.3出参说明

返回值为Map类型参数，key 为 IncoiceDoc 对象， value 为发票结构化数据JsonObject对象，不同的发票类型返回的结构化数据不同，发票数据格式详见 5发票数据格式规范

4 实现步骤

1. 继承FpSysHelper类实现抽象方法 getInvoiceInfos

2. 在发票系统配置中选择其他发票系统，填写二开类的全类名，操作路径：电子凭证标准 - 系统配置 - 发票系统配置。

参考实现：com.kingdee.eas.base.evs.unitdata.pcloud.fpSys.FpSysHelper_KD#getInvoiceInfos

5发票数据格式规范

发票类型汇总

发票类型	类型标识
电子发票普票	inv_ord
电子发票专票	inv_spcl
电子铁路客票电子发票（铁路电子客票）	rai
通行费发票收费公路通行费发票	inv_tlf
电子航空客票	atr
电子非税收入缴款书	ntrev_gpm
财政电子票据	efi
全面数字化的电子发票（增值税普通发票）	einv_ord
全面数字化的电子发票（增值税专用发票）	einv_spcl

5.1 普通电子发票

参数	长度	必填	描述	对应的接收方xbrl字段
invoiceType		是	发票类型：“inv_ord”
serialNo	36	否	发票流水号
invoiceCode	32	是	发票代码
invoiceNo	32	是	发票号码
invoiceDate	0	是	开票日期格式： 2001-01-01	DateOfIssue
salerName	100	是	销方名称	NameOfSeller
salerTaxNo	20	是	销方税号	TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller
invoiceAmount	23	是	合计金额(不含税)	TotalAmountExcludingTax
totalTaxAmount	23	是	合计税额	TotalTaxAmount
totalAmount	19	是	价税合计	TaxIncludedAmountInFigures
buyerName	100	否	买方名称
buyerTaxNo	20	否	买方税号
invoiceStatus	202	否	买方税号发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常、5：非正常、6：红字发票待确认、7：部分红冲、8：全部红冲
type	1	否	0-蓝字发票；1-红字发票
checkStatus	2	否	查验状态1：通过，2，不通过，3：未查验
downloadUrl	512	否	pdf下载地址
pdfurl	512	否	原件下载地址
pdfurl	512	否	原件下载地址
xbrlName	1000	否	开具端xbrl的文件名
xbrlUrl	512	否	开具端xbrl的下载地址

5.2 电子发票专票

参数	长度	必填	描述	对应的接收方xbrl字段
invoiceType	50	是	发票类型：“inv_spcl”
serialNo	36	否	发票流水号
invoiceCode	32	是	发票代码
invoiceNo	32	是	发票号码
invoiceDate	0	是	开票日期 2001-01-01	DateOfIssue
salerName	100	是	销方名称	NameOfSeller
salerTaxNo	20	是	销方税号	TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller
buyerName	100	否	买方名称
buyerTaxNo	20	否	买方税号
invoiceAmount	23	是	合计金额(不含税)	TotalAmountExcludingTax
totalTaxAmount	23	是	合计税额	TotalTaxAmount
totalAmount	19	是	价税合计	TaxIncludedAmountInFigures
taxPeriod	10	否	所属税期(如：202104)
invoiceStatus	2	否	发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常、5：非正常、6：红字发票待确认、7：部分红冲、8：全部红冲
checkStatus	2	否	查验状态1：通过，2，不通过，3：未查验
downloadUrl	512	否	pdf下载地址
pdfurl	512	否	原件下载地址
snapshotUrl	512	否	发票快照地址
type	1	否	0-蓝字发票；1-红字发票
deductionPurpose	1	否	抵扣用途 1抵扣 2不抵扣 3用于退税 4用于代办退税 5未准予代办退税 6未准予退税
xbrlName	1000	否	开具端xbrl的文件名
xbrlUrl	512	否	开具端xbrl的下载地址

5.3 电子铁路客票电子发票（铁路电子客票）

参数	长度	必填	描述	对应的接收方xbrl字段
invoiceType		是	发票类型：“rai”
serialNo	36	否	发票流水号
invoiceNo	32	是	发票号码	ElectronicInvoiceRailwayETicketNumber
issueDate		是	开票日期 yyyy-mm-dd	DateOfIssue
invoiceAmount	13	是	金额（不含税）	TotalAmountExcludingTax
taxRate	13	是	税率	TaxRate
totalTaxAmount	13	是	税额	TaxAmount
buyerName	100	是	购方名称	NameOfAccountingEntity
buyerTaxNo	20	是	购方税号	UnifiedSocialCreditCodeOfAccountingEntity
checkStatus	2	是	查验状态1：通过，2，不通过，3：未查验
pdfurl	512	否	原件下载地址
snapshotUrl	512	否	发票快照地址
xbrlName	1000	否	开具端xbrl的文件名
xbrlUrl	512	否	开具端xbrl的下载地址

5.4 通行费发票收费公路通行费发票

参数	长度	必填	描述	对应的接收方xbrl字段
invoiceType	50	是	发票类型：“inv_tlf”
serialNo	36	否	发票流水号
invoiceCode	12	是	发票代码
invoiceNo	8	是	发票号码
invoiceDate	0	是	开票日期 2001-01-01	DateOfIssue
salerName	100	是	销方名称	NameOfSeller
salerTaxNo	20	是	销方税号	TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller
buyerName	100	是	买方名称	NameOfAccountingEntity
buyerTaxNo	20	是	买方税号	UnifiedSocialCreditCodeOfAccountingEntity
invoiceAmount	23	是	合计金额(不含税)	TotalAmountExcludingTax
totalTaxAmount	23	是	合计税额	TotalTaxAmount
totalAmount	19	是	价税合计	TaxIncludedAmountInFigures
taxPeriod	10	否	所属税期(如：202104)
invoiceStatus	2	否	发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常、5：非正常、6：红字发票待确认、7：部分红冲、8：全部红冲
checkStatus	2	否	查验状态1：通过，2，不通过，3：未查验
downloadUrl	512	否	pdf下载地址
pdfurl	512	否	原件下载地址
snapshotUrl	512	否	发票快照地址
type	1	否	0-蓝字发票；1-红字发票
deductionPurpose	1	否	抵扣用途 1抵扣 2不抵扣 3用于退税 4用于代办退税 5未准予代办退税 6未准予退税
xbrlName 1000		否	开具端xbrl的文件名
xbrlUrl 512		否	开具端xbrl的下载地址

5.5电子航空客票

参数	长度	必填	描述	对应的接收方xbrl字段
invoiceType	2	是	发票类型：“atr”
serialNo	36	否	发票流水号
invoiceNo	32	是	发票号码
invoiceAmount	13	是	票价	Fare
fillingUnit	100	是	填开单位	IssueParty
issueDate		是	填开日期 yyyy-mm-dd	IssueDate
invoiceStatus	2	否	开具状态：0:正常、3：红冲
buyerName	100	是	购方名称	NameOfAccountingEntity
unifiedSocialCreditCodeOfPurchaser	20	是	购买方统一社会信用代码	UnifiedSocialCreditCodeOfAccountingEntity
checkStatus	2	是	查验状态1：通过，2，不通过，3：未查验
downloadUrl	512	否	pdf下载地址
pdfurl	512	否	原件下载地址
snapshotUrl	512	否	发票快照地址
xbrlName	1000	否	开具端xbrl的文件名
xbrlUrl	512	否	开具端xbrl的下载地址

5.6非税收入缴款书

参数	长度	必填	描述	对应的接收方xbrl字段
invoiceType	2	是	发票类型：“ntrev_gpm”
serialNo	36	否	发票流水号
invoiceCode	8	是	电子票据代码
invoiceNo	10	是	电子票据号码
invoiceDate	10	是	开票日期yyyy_MM_dd	IssueDate
totalAmount	18	是	总金额	TotalAmount
invoicingPartyCode	30	是	开票单位代码	InvoicingPartyCode
invoicingPartyName	100	是	开票单位名称	InvoicingPartyName
relatedInvoiceCode	8	否	红票票据代码
checkStatus	2	是	查验状态1：通过，2，不通过，3：未查验
downloadUrl	512		pdf下载地址
pdfurl	512		原件下载地址
snapshotUrl	512		发票快照地址
xbrlName	1000		开开具端xbrl的文件名
xbrlUrl	512		开具端xbrl的下载地址

5.7财政电子票据

参数	长度	必填	描述	对应的接收方xbrl字段
invoiceType	2	是	发票类型：“efi”
serialNo	36	否	发票流水号
invoiceCode	8	是	电子票据代码
invoiceNo	10	是	电子票据号码
invoiceDate	10	是	开票日期yyyy_MM_dd	IssueDate
totalAmount	18	是	总金额	TotalAmount
invoicingPartyCode	30	是	开票单位代码	InvoicingPartyCode
invoicingPartyName	100	是	开票单位名称	InvoicingPartyName
relatedInvoiceCode	8	否	红票票据代码
checkStatus	2	是	查验状态1：通过，2，不通过，3：未查验
downloadUrl	512		pdf下载地址
pdfurl	512		原件下载地址
snapshotUrl	512		发票快照地址
xbrlName	1000		开开具端xbrl的文件名
xbrlUrl	512		开具端xbrl的下载地址

5.8 全面数字化的电子发票（增值税普通发票）

参数	长度	必填	描述	对应的接收方xbrl字段
invoiceType	50	是	发票类型：“einv_ord”
serialNo	36	否	发票流水号
invoiceNo	32	是	发票号码
invoiceDate	0	是	开票日期 2001-01-01	DateOfIssue
salerName	100	是	销方名称	SellerName
salerTaxNo	20	是	销方税号	SellerIdNum
buyerName	100	是	买方名称	NameOfAccountingEntity
buyerTaxNo	20	是	买方税号	UnifiedSocialCreditCodeOfAccountingEntity
invoiceAmount	23	是	合计金额(不含税)	TotalAmWithoutTax
totalTaxAmount	23	是	合计税额	TotalTaxAmount
totalAmount	19	是	价税合计	TaxIncludedAmountInFigures
taxPeriod	10	否	所属税期(如：202104)
invoiceStatus	2	否	发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常、5：非正常、6：红字发票待确认、7：部分红冲、8：全部红冲
checkStatus	2	否	查验状态1：通过，2，不通过，3：未查验
downloadUrl	512	否	pdf下载地址
pdfurl	512	否	原件下载地址
snapshotUrl	512	否	发票快照地址
type	1	否	0-蓝字发票；1-红字发票
xbrlName	1000	否	开具端xbrl的文件名
xbrlUrl	512	否	开具端xbrl的下载地址

5.9 全面数字化的电子发票（增值税专用发票）

参数	长度	必填	描述	对应的接收方xbrl字段
invoiceType	50	是	发票类型：“einv_spcl”
serialNo	36	否	发票流水号
invoiceNo	32	是	发票号码
invoiceDate	0	是	开票日期 2001-01-01	DateOfIssue
salerName	100	是	销方名称	SellerName
salerTaxNo	20	是	销方税号	SellerIdNum
buyerName	100	是	买方名称	NameOfAccountingEntity
buyerTaxNo	20	是	买方税号	UnifiedSocialCreditCodeOfAccountingEntity
invoiceAmount	23	是	合计金额(不含税)	TotalAmWithoutTax
totalTaxAmount	23	是	合计税额	TotalTaxAmount
totalAmount	19	是	价税合计	TaxIncludedAmountInFigures
taxPeriod	10		所属税期(如：202104)
invoiceStatus	2		发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常、5：非正常、6：红字发票待确认、7：部分红冲、8：全部红冲
checkStatus	2		查验状态1：通过，2，不通过，3：未查验
downloadUrl	512		pdf下载地址
pdfurl	512		原件下载地址
snapshotUrl	512		发票快照地址
type	1		0-蓝字发票；1-红字发票
deductionPurpose	1		抵扣用途 1抵扣 2不抵扣 3用于退税 4用于代办退税 5未准予代办退税 6未准予退税
xbrlName	1000		开具端xbrl的文件名
xbrlUrl	512		开具端xbrl的下载地址