电子凭证数据标准

| 含义说明 | 示例 ---|---------|--- text | 填录内容为字符类型字符串 | "字符串" X| 填录内容为货币类型字符串 |"102.00" X.XX| 填录内容为小数类型字符串 | Y/N| 填录内容为布尔类型字符串 |"true" 或者 "false" yyyy-mm-dd| 填录内容为日期类型字符串 | "2023-05-31" yyyy-mm| 填录内容为年月类型字符串 | "2023-05" yyyy| 填录内容为年份字符串 |"2023" 表示2023年 mm| 填录内容为月份字符串 |"05" 表示5月份 num| 填录内容为整数类型字符串 |"12" 表示数字12 arr| 填录内容为数组 | obj| 填录内容对象 | %| 填录内容百分数 | 空白| 代表没有需要披露的信息，通常为表单中的标题等提示信息 | # 4.接口入参说明 ## 4.1 凭证结构化数据接口入参 ### 4.1.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|---|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text PeriodNumber | 第多少期 | 是 | mm PeriodYear | 会计期间年 | 是 | yyyy DataType | 数据类型 0 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单 | 是 | text Datas | 凭证结构化数据节点 | 是 | arr PostingDate | 记账日期 | 是 | yyyy-mm-dd NumberOfAccountingDocuments | 记账凭证编号 | 是 | text PK | 凭证唯一标识 | 是 | text SummaryOfAccountingDocuments | 记账凭证摘要 | 是 | text InformationOfDebitAndCreditEntryTuple | 借贷方会计信息 | 是 | arr RecordedAmount | 入账金额 | 是 | X DebitOrCredit | 借贷方向 | 是 | text NameOfGeneralLedgerSubject | 总科目名称 | 是 | text NameOfSubsidiaryLedgerSubject | 明细科目名称 | 是 | text ### 4.1.2 入参格式示例 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "PeriodNumber": "第多少期", "PeriodYear": "会计期间年", "DataType": "数据类型 0 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单", "Datas": [ { "InformationOfDebitAndCreditEntryTuple": [ { "RecordedAmount": "97029.70", "DebitOrCredit": "借方", "NameOfGeneralLedgerSubject": "合同履约成本", "NameOfSubsidiaryLedgerSubject": "分包成本" }, { "RecordedAmount": "970.30", "DebitOrCredit": "借方", "NameOfGeneralLedgerSubject": "应交税费", "NameOfSubsidiaryLedgerSubject": "进项税额" }, { "RecordedAmount": "98000.00", "DebitOrCredit": "贷方", "NameOfGeneralLedgerSubject": "应付账款", "NameOfSubsidiaryLedgerSubject": "工程款" } ], "PostingDate": "记账日期", "NumberOfAccountingDocuments": "记账凭证编号", "PK": "凭证唯一标识，一般使用凭证ID字段", "SummaryOfAccountingDocuments": "记账凭证摘要" } ] } ``` ## 4.2 业务单据结构化入参 ### 4.2.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|--------|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 0 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单 | 是 | num Datas | 业务单据结构化数据 | 是 |arr PK | 单据唯一标识 | 是 | text WhetherInputVatHasBeenTransferredOut | 是否进项税额转出 | 是 | Y/N AmountOfTransferredOutInputVat | 进项税额转出金额 | 是 | Y/N ContractNumber| 合同编号 | 否 | text MatchingStateBetweenBusinessDocumentsAndVatEInvoice| 业务单据与发票的匹配状态 | 否 |text DepreciationMethodsOfFixedAssetsAndAmortizationMethodsOfIntangibleAssets| 固定资产、无形资产折旧摊销方法 | 否 |text WhetherInvoiceHasBeenFactoredSoldOrSecuritized| 是否已做保理、出售或资产证券化 | 否 |text WhetherInvoiceIsRedInvoice| 是否红字发票 | 是 |Y/N WhetherInvoiceHasBeenChecked| 是否已验真 | 是 |Y/N WhetherInvoiceUsageHasBeenConfirmed| 是否已用途确认 | 是 |Y/N UsageConfirmation| 确认用途 | 是 |text PeriodOfUsageConfirmation| 用途确认所属期 | 是 |yyyy-mm WhetherInvoiceHasBeenBooked| 是否已入账 | 是 |Y/N Vouchers | 凭证PK，如果有多个凭证PK可以用,号分割;eg:pk1,pk2 | 是 | text BillNumber | 业务单据编码 | 是 | text Invoices | 业务单据承载的发票数据 | 是 | arr SerialNumber | 发票流水号 | 是 | text InvoiceNumber | 发票号码 | 是 | text InvoiceType | 发票类型 | 是 | text InvoiceCode | 发票代码 | 是 | text UniqueCodeOfInvoice|发票唯一标识|是 |text ### 4.2.2 入参数格式 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 1 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单", "Datas": [{ "Invoices": [ { "SerialNumber": "发票流水号001", "InvoiceNumber": "发票号码001", "InvoiceType": "发票类型", "InvoiceCode": "发票代码001" }, { "SerialNumber": "发票流水号001", "InvoiceNumber": "发票号码001", "InvoiceType": "发票类型", "InvoiceCode": "发票代码001" } ], "PK": "单据唯一标识，eas单据一般使用单据id字段", "Vouchers": "凭证唯一标识，如果有多个凭证PK可以用,号分割;eg:pk1,pk2", "BillNumber": "业务单据编码", "WhetherInputVatHasBeenTransferredOut":"true", "AmountOfTransferredOutInputVat":"100.00", "ContractNumber","合同编号", "MatchingStateBetweenBusinessDocumentsAndVatEInvoice","业务单据与发票的匹配状态", "DepreciationMethodsOfFixedAssetsAndAmortizationMethodsOfIntangibleAssets","固定资产、无形资产折旧摊销方法", "WhetherInvoiceHasBeenFactoredSoldOrSecuritized","是否已做保理、出售或资产证券化", "WhetherInvoiceIsRedInvoice","是否红字发票", "WhetherInvoiceHasBeenChecked","是否已验真", "WhetherInvoiceUsageHasBeenConfirmed","是否已用途确认", "UsageConfirmation","确认用途", "PeriodOfUsageConfirmation","用途确认所属期", "WhetherInvoiceHasBeenBooked","是否已入账", "WhetherInvoiceHasBeenPaid","是否已付款", "NumberOfBankElectronicReceipt","银行回单编号", }] } ``` ### 4.2.3 入参约束 ``` 1：UniqueCodeOfInvoice：如果发票代码和发票号码组合为唯一标识则拼接以发票代码+"_"+发票号码；如果是发票流水号唯一，则直接赋值为发票流水号 2： ``` ## 4.3 电子回单结构化入参 ### 4.3.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|---------|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 2 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单 | 是 | text Datas | 电子回单结构化数据集合 | 是 | arr ContractNumber | 合同编号 | 是 | text WhetherInvoiceHasBeenClaimed | 是否已认领 | 是 | Y/N UniqueCodeOfInvoice | 票据唯一标识 | 是 | text WhetherReceiptHasBeenTransferredToBank | 是否已流转 | 是 | Y/N WhetherReceiptHasBeenReconciled | 是否已对账 | 是 | Y/N Vouchers | 凭证PK，如果有多个凭证PK可以用,号分割;eg:voucherPK1,voucherPK2 | 是 | text WhetherReceiptHasBeenBooked | 是否已入账 | 是 | Y/N DateOfIssue | 开票日期 | 是 | yyyy-mm-dd Currency | 币种 | 是 | text AmountPayableAndReceivable | 付款项金额 | 是 | X TransactionAmountInFigures | 小写金额 | 是 | X PK | 单据唯一标识 | 是 | text BillNumber | 业务单据编码 | 是 | text FileName | 回单文件名称 | 是 | text TypeOfInvoice | 票据类型 | 是 | text IdentifyingCode | 校验码 | 是 | text ### 4.3.2 入参格式 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "Datas": [{ "ContractNumber": "合同号", "WhetherInvoiceHasBeenClaimed": "校验码", "UniqueCodeOfInvoice": "票据唯一标识", "WhetherReceiptHasBeenTransferredToBank": "是否已流转", "WhetherReceiptHasBeenReconciled": "是否已对账", "Vouchers": "凭证PK，如果有多个凭证PK可以用[,]号分割;eg:voucherPK1,voucherPK2", "WhetherReceiptHasBeenBooked": "是否已入账", "DateOfIssue": "开票日期", "Currency": "币种", "AmountPayableAndReceivable": "付款项金额", "TransactionAmountInFigures": "小写金额", "PK": "单据唯一标识", "BillNumber": "业务单据编码", "TypeOfInvoice": "票据类型", "IdentifyingCode": "校验码" }], "DataType": "数据类型 2 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单" } ``` ## 4.4 银行电子对账单结构化入参 ### 4.4.1 入参格式 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|---|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text PeriodNumber | 第多少期 | 是 | mm PeriodYear | 会计期间年 | 是 | yyyy DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单 | 是 | text Datas | 对账单结构化数据集合 | 是 | arr IdentificationCodeOfIssuer | 签发机构 | 是 | text NumberOfBankBranch | 营业网点编号 | 是 | text Currency | 币种 | 是 | text CustomerSettlementBankAccount | 客户结算账号 | 是 | text NameOfCustomerAccount | 客户账户名称 | 是 | text CodeOfBankCustomer | 银行客户编码 | 是 | text YearOfBankReconciliationStatement | 银行对账单年份 | 是 | yyyy MonthOfBankReconciliationStatement | 银行对账单月份 | 是 | text PrintTimes | 打印次数 | 是 | text PrintDate | 打印日期 | 是 | yyyy-mm-dd InformationOfReconcileDetailsTuple | 对账单明细信息 TypeOfSourceDocument | 原始凭证种类 | 是 | text BusinessSerialNumber | 业务流水号 | 是 | text IdentificationOfCreditOrDebit | 借贷标志 | 是 | text TimeOfBookkeeping | 记账时间 | 是 | hh:mm:ss AccountBalance | 账户余额 | 是 | X DateOfBookkeeping | 记账日期 | 是 | yyyy-mm-dd TransactionCode | 交易代码 | 是 | text NumberOfBankElectronicReceipt | 银行电子回单编号 | 是 | text DebitOrCreditOfBalance | 余额方向 | 是 | text NotesOfBankElectronicReceipt | 银行电子回单信息摘要 | 是 | text NumberOfSourceDocument | 原始凭证号码 | 是 | text AccountOfCounterparty | 对方账号 | 是 | text DepositoryBankOfCounterparty | 对方开户行 | 是 | text TypesOfBusinessProducts | 业务产品种类 | 是 | text NameOfCounterparty | 对方户名 | 是 | text TransactionAmount | 交易金额 | 是 | X JournalAccountOfBookkeeping | 记账流水 | 是 | text Bookkeeper | 记账柜员 | 是 | text OtherAccountingInformation | 其他记账信息 | 是 | text PK | 单据唯一标识 | 是 | text BillNumber | 业务单据编码 | 否 | text FileName | 对账单文件名称 | 是 |text ReserveBalanceAtTheEndOfReconciliationCycle | 对账周期末保留余额 | 是 | X FrozenBalanceAtTheEndOfReconciliationCycle | 对账周期末冻结余额 | 是 | X AvailableBalanceAtTheEndOfReconciliationCycleAmount | 对账周期末可用余额（额度） | 是 | X OverdraftBalanceAtEndOfReconciliationCycle | 对账周期末透支余额 | 是 | X AccountBalanceAtTheEndOfReconciliationCycleAmount | 对账周期末账户余额（额度） | 是 | X ### 4.4.2 入参示例 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "PeriodNumber": "第几月", "PeriodYear": "会计期间年", "Datas": [ { "IdentificationCodeOfIssuer":"签发机构", "NumberOfBankBranch":"营业网点编号", "Currency":"币种", "CustomerSettlementBankAccount":"客户结算账号", "NameOfCustomerAccount":"客户账户名称", "CodeOfBankCustomer":"银行客户编码", "YearOfBankReconciliationStatement":"银行对账单年份", "MonthOfBankReconciliationStatement":"银行对账单月份", "PrintTimes":"打印次数", "PrintDate":"打印日期", "InformationOfReconcileDetailsTuple":[ "TypeOfSourceDocument":"原始凭证种类", "BusinessSerialNumber":"业务流水号", "IdentificationOfCreditOrDebit":"借贷标志", "TimeOfBookkeeping":"记账时间", "AccountBalance":"账户余额", "DateOfBookkeeping":"记账日期", "TransactionCode":"交易代码", "NumberOfBankElectronicReceipt":"银行电子回单编号", "DebitOrCreditOfBalance":"余额方向", "NotesOfBankElectronicReceipt":"银行电子回单信息摘要", "NumberOfSourceDocument":"原始凭证号码", "AccountOfCounterparty":"对方账号", "DepositoryBankOfCounterparty":"对方开户行", "TypesOfBusinessProducts":"业务产品种类", "NameOfCounterparty":"对方户名", "TransactionAmount":"交易金额", "JournalAccountOfBookkeeping":"记账流水", "Bookkeeper":"记账柜员", "OtherAccountingInformation":"其他记账信息", "FileName":"对账单文件名称" ], "BillNumber":"业务单据编码", "PK":"业务单据编码PK", "ReserveBalanceAtTheEndOfReconciliationCycle":"对账周期末保留余额", "FrozenBalanceAtTheEndOfReconciliationCycle":"对账周期末冻结余额", "AvailableBalanceAtTheEndOfReconciliationCycleAmount":"对账周期末可用余额（额度）", "OverdraftBalanceAtEndOfReconciliationCycle":"对账周期末透支余额", "AccountBalanceAtTheEndOfReconciliationCycleAmount":"对账周期末账户余额（额度）" } ], "DataType": "数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单" } ``` ## 4.5 票据结构化数据 ### 4.5.1 支持票据种类 票据名称 | 票据类型唯一标识 ---|------ 电子发票（航空运输电子客票行程单） | atr 增值税电子普通发票 | inv_ord 增值税电子专用发票 | inv_spcl 收费公路通行费增值税电子普通发票 | inv_tlf 电子发票（铁路电子客票） | rai 非税收入一般缴款书 | ntrev_gpm ## 4.6 票据-电子发票（航空运输电子客票行程单） ### 4.6.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|--------|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单，4 票据" | 是 | text InvoiceType | 票据类型 | 是 | text Datas | 票据结构化数据集合 | 是 | arr TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller | 销售方纳税人识别号（统一社会信用代码） | 是 | text ElectronicInvoiceAirTransportReceiptNumber | 电子发票（航空运输电子客票行程单）号码 | 是 | text Fare | 票价 | 是 | X IssueParty | 填开单位 | 是 | text IssueDate | 填开日期 | 是 | yyyy-mm-dd InvoiceCode | 发票代码 | 是 |text InvoiceNO | 发票号码 | 是 |text SerialNO| 发票流水号 | 是 |text InvoiceType | 发票类型 | 否 | text InvoiceTypeName | 发票类型名称 | 否 | text Originalurl | 发票原件地址 | 否 | text Pdfurl| 发票pdf地址 | 否 | text Snapshoturl| 发票快照地址 | 否 | text IssuerXbrlurl| 开具端xbrl文件地址 | 否 | text Bills | 单据唯一标识 | 否 | text ### 4.6.2 入参格数 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单" "InvoiceType":"参考4.5章节-票据种类唯一值" "Datas": [ { "TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller":"销售方纳税人识别号（统一社会信用代码）", "ElectronicInvoiceAirTransportReceiptNumber":"电子发票（航空运输电子客票行程单）号码", "Fare":"票价", "IssueParty":"填开单位", "IssueDate":"填开日期", "InvoiceCode":"发票代码", "InvoiceNO":"发票号码", "SerialNO":"发票流水号", "InvoiceType":"发票类型", "InvoiceTypeName":"发票类型名称",