电子凭证池 - 获取发票结构化信息二开文档
文档变更时间 | 变更人 | 变更章节 | 变更描述 |
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 | 否 | 发票 |
电子凭证池 - 获取发票结构化信息二开文档
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
