| 含义说明 | 示例 ---|---------|--- 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| 填录内容对象 | %| 填录内容百分数 | 空白| 代表没有需要披露的信息，通常为表单中的标题等提示信息 | ## 3.2 入参数据量约束 ``` 1：单次调用Datas节点数据条数不能超过10000条 ``` ## 3.4 其他约束 ``` 1：RandomCode 不超过30个字符长度的随机码，多次调用接口RandomCode如果在30分钟内一致，则废弃第二次接口调用 ``` # 4.接口入参说明 ## 4.1 凭证结构化数据接口入参 ### 4.1.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|---|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text PeriodNumber | 第多少期 | 是 | mm PeriodYear | 会计期间年 | 是 | yyyy DataType | 数据类型 0 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单 | 是 | text RandomCode|随机码|是|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 银行电子对账单", "RandomCode":"2023061417510000123456789", "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 RandomCode| 随机码 |是|text Datas | 业务单据结构化数据 | 是 |arr PK | 单据唯一标识（会根据此字段判断数据是否重复推送） | 是 | text BillPK | 单据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 | 业务单据承载的发票数据 | 是(参考4.2.3 入参约束说明) | arr SerialNumber | 发票流水号 | 是 | text InvoiceNumber | 发票号码 | 是 | text InvoiceType | 发票类型 | 否 | text InvoiceCode | 发票代码 | 是 | text UniquePK| 发票唯一标识 | 是 |text ### 4.2.2 入参数格式 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 1 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单", "RandomCode":"2023061417510000123456789", "Datas": [{ "Invoices": [ { "SerialNumber": "发票流水号001", "InvoiceNumber": "发票号码001", "InvoiceType": "发票类型", "UniquePK": "发票唯一标识", "InvoiceCode": "发票代码001" }, { "SerialNumber": "发票流水号001", "InvoiceNumber": "发票号码001", "InvoiceType": "发票类型", "UniquePK": "发票唯一标识", "InvoiceCode": "发票代码001" } ], "PK": "单据判断重复推送唯一标识", "BillPK": "单据唯一标识", "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：UniquePK 一般SerialNumber不为空，则该值为SerialNumber一致； 如果SerialNumber为空，那么该值为InvoiceCode拼接InvoiceNumber组合； 如果是发票流水号唯一，则直接赋值为发票流水号 2：Invoices 如果业务系统拿不到Invoices节点相关的数据，那么Invoices节点可以不需要； 如果Invoices节点为空，需要关注票据结构化数据单元里面的Bills节点不能为空 3：Vouchers 跟凭证结构化数据单元关联的关键字段 4：WhetherInvoiceIsRedInvoice，是否红字发票一般来自票据数据单元； 如果票据数据单元和业务数据单元都有该字段，以票据数据为准 5：WhetherInvoiceHasBeenChecked，是否已验真一般来自票据数据单元； 如果票据数据单元和业务数据单元都有该字段，以票据数据为准 6：以下字段可以参考财政部的数据标准规范说明 http://kjs.mof.gov.cn/zt/kuaijixinxihuajianshe/dzpzkjsjbzshsd/sjbz/202305/t20230517_3885004.htm WhetherInputVatHasBeenTransferredOut、是否进项税额转出 AmountOfTransferredOutInputVat、进项税额转出金额 ContractNumber、合同编号 MatchingStateBetweenBusinessDocumentsAndVatEInvoice、业务单据与发票的匹配状态 DepreciationMethodsOfFixedAssetsAndAmortizationMethodsOfIntangibleAssets、固定资产、无形资产折旧摊销方法 WhetherInvoiceHasBeenFactoredSoldOrSecuritized、是否已做保理、出售或资产证券化 WhetherInvoiceUsageHasBeenConfirmed、是否已用途确认 UsageConfirmation、确认用途 PeriodOfUsageConfirmation、用途确认所属期 WhetherInvoiceHasBeenBooked、是否已入账 WhetherInvoiceHasBeenPaid、是否已付款 NumberOfBankElectronicReceipt、银行回单编号 ``` ### 4.2.4 业务单据必输字段和票据映射表 参数名称 | 参数说明 | 必输票种 ---|----|------ ## 4.3 电子回单结构化入参 ### 4.3.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|------|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 2 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单 | 是 | text RandomCode| 随机码 |是|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 BillPK | 单据唯一标识 | 是 | text BillNumber | 业务单据编码 | 否 | text FileName | 回单文件名称 | 是 | text TypeOfInvoice | 票据类型 | 否 | text IdentifyingCode | 校验码 | 是 | text ### 4.3.2 入参格式 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 2 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单", "RandomCode":"2023061417510000123456789", "Datas": [{ "ContractNumber": "合同号", "WhetherInvoiceHasBeenClaimed": "校验码", "UniqueCodeOfInvoice": "票据唯一标识", "WhetherReceiptHasBeenTransferredToBank": "是否已流转", "WhetherReceiptHasBeenReconciled": "是否已对账", "Vouchers": "凭证PK，如果有多个凭证PK可以用,号分割;eg:voucherPK1,voucherPK2", "WhetherReceiptHasBeenBooked": "是否已入账", "DateOfIssue": "开票日期", "Currency": "币种", "AmountPayableAndReceivable": "付款项金额", "TransactionAmountInFigures": "小写金额", "PK": "单据判断重复推送唯一标识", "BillPK": "单据唯一标识", "BillNumber": "业务单据编码", "TypeOfInvoice": "票据类型", "IdentifyingCode": "校验码" }] } ``` ### 4.3.3 入参约束说明 ``` 1：PK 数据唯一重复性判断标识 2：Vouchers 跟凭证结构化数据单元关联的关键字段 ``` ## 4.4 银行电子对账单结构化入参 ### 4.4.1 入参格式 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|---|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text PeriodNumber | 第多少期 | 是 | mm PeriodYear | 会计期间年 | 是 | yyyy DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单 | 是 | text RandomCode|随机码|是|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": "会计期间年", "RandomCode":"2023061417510000123456789", "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.4.3 入参约束说明 ``` 1：PK 数据唯一重复性判断标识 ``` ## 4.5 票据结构化数据 ### 4.5.1 支持票据种类 票据名称 | 票据类型唯一标识 ---|------ 电子发票（航空运输电子客票行程单） | atr 增值税电子普通发票 | inv_ord 增值税电子专用发票 | inv_spcl 收费公路通行费增值税电子普通发票 | inv_tlf 电子发票（铁路电子客票） | rai 非税收入一般缴款书 | ntrev_gpm 财政电子票据 | efi 全面数字化的电子发票（增值税普通发票）|einv_ord 全面数字化的电子发票（增值税专用发票）|einv_spcl ### 4.5.2 票据类型说明 ``` 各票据云需要根据当前票据类型做一个映射 ``` ### 4.5.3 票据入参说明 ``` 1：UniquePK 系统会根据该字段判断票据是否唯一，如果多次调用接口UniquePK值一致，那么后一次会覆盖前一次结果； 如果Bills节点为空，那么4.2章节中Invoices中的UniquePK和当前票据节点中的UniquePK作为数据关联的重要信息 2：Bills是根据票据关联业务单据数据单元的重要节点信息，如果Bills不传，那么4.2章节中的Invoices必须传；否则结构化数据将无法生成 3：如果需要从业务系统导出上报财政部zip文件，那么IssuerXbrlurl必传 4：SerialNO、InvoiceCode、InvoiceNO票据如果存在这三个值，请务必推送过来 ``` ## 4.6 票据-电子发票（航空运输电子客票行程单） ### 4.6.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|----|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单，4 票据" | 是 | text RandomCode|随机码|是|text InvoiceType | 票据类型 | 是 | text Datas | 票据结构化数据集合 | 是 | arr TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller | 销售方纳税人识别号（统一社会信用代码） | 是 | text ElectronicInvoiceAirTransportReceiptNumber | 电子发票（航空运输电子客票行程单）号码 | 是 | text Fare | 票价 | 是 | X IssueParty | 填开单位 | 是 | text IssueDate | 填开日期 | 是 | yyyy-mm-dd InvoiceCode | 发票代码 | 是 |text InvoiceNO | 发票号码 | 是 |text SerialNO| 发票流水号 | 是 |text UniquePK | 数据唯一判重标识 | 是 |text InvoiceType | 发票类型 | 否 | text InvoiceTypeName | 发票类型名称 | 否 | text Originalurl | 发票原件地址 | 否 | text Pdfurl| 发票pdf地址 | 否 | text Snapshoturl| 发票快照地址 | 否 | text IssuerXbrlurl| 开具端xbrl文件地址 | 否 | text Bills | 单据唯一标识 | 是 | text WhetherInvoiceIsRedInvoice| 是否红字发票 | 是 |Y/N WhetherInvoiceHasBeenChecked| 是否已验真 | 是 |Y/N ### 4.6.2 入参格数 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单", "RandomCode":"2023061417510000123456789", "InvoiceType":"参考4.5章节-票据种类唯一值", "Datas": [ { "TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller":"销售方纳税人识别号（统一社会信用代码）", "ElectronicInvoiceAirTransportReceiptNumber":"电子发票（航空运输电子客票行程单）号码", "Fare":"票价", "IssueParty":"填开单位", "IssueDate":"填开日期", "InvoiceCode":"发票代码", "InvoiceNO":"发票号码", "SerialNO":"发票流水号", "UniquePK":"数据唯一判重标识", "InvoiceType":"发票类型", "InvoiceTypeName":"发票类型名称", "Originalurl":"发票原件地址", "Pdfurl":"发票pdf地址", "Snapshoturl":"发票快照地址", "IssuerXbrlurl":"开具端xbrl文件地址", "Bills":"单据唯一标识", "WhetherInvoiceIsRedInvoice":"是否红字发票", "WhetherInvoiceHasBeenChecked":"是否已验真" } ] } ``` ### 4.6.3 接口说明 ## 4.7 票据-增值税电子普通发票 ### 4.7.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|------|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单，4 票据" | 是 | text RandomCode|随机码|是|text InvoiceType | 票据类型 | 是 | text Datas | 票据结构化数据集合 | 是 | arr UniqueCodeOfInvoice | 发票唯一标识 | 是 | text NameOfSeller | 销售方名称 | 是 | text TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller | 销售方纳税人识别号（统一社会信用代码） | 是 | text TotalAmountExcludingTax | 不含税金额合计 | 是 | X TotalTaxAmount | 税额合计 | 是 | X TaxIncludedAmountInFigures | 价税合计（小写） | 是 | X DateOfIssue | 开票日期 | 是 | yyyy-mm-dd InvoiceCode | 发票代码 | 是 |text InvoiceNO | 发票号码 | 是 |text UniquePK | 数据唯一判重标识 | 是 |text SerialNO| 发票流水号 | 否 |text InvoiceType | 发票类型 | 否 | text InvoiceTypeName | 发票类型名称 | 否 | text Originalurl | 发票原件地址 | 否 | text Pdfurl| 发票pdf地址 | 否 | text Snapshoturl| 发票快照地址 | 否 | text IssuerXbrlurl| 开具端xbrl文件地址 | 否 | text Bills | 单据唯一标识 | 否 | text WhetherInvoiceIsRedInvoice| 是否红字发票 | 是 |Y/N WhetherInvoiceHasBeenChecked| 是否已验真 | 是 |Y/N ### 4.7.2 入参格数 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单", "RandomCode":"2023061417510000123456789", "InvoiceType":"参考4.5章节-票据种类唯一值" "Datas": [ { "UniqueCodeOfInvoice":"发票唯一标识", "NameOfSeller":"销售方名称", "TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller":"销售方纳税人识别号（统一社会信用代码）", "TotalAmountExcludingTax":"不含税金额合计", "TotalTaxAmount":"税额合计", "TaxIncludedAmountInFigures":"价税合计（小写）", "DateOfIssue":"开票日期", "InvoiceCode":"发票代码", "InvoiceNO":"发票号码", "SerialNO":"发票流水号", "UniquePK":"数据唯一判重标识", "InvoiceType":"发票类型", "InvoiceTypeName":"发票类型名称", "Originalurl":"发票原件地址", "Pdfurl":"发票pdf地址", "Snapshoturl":"发票快照地址", "IssuerXbrlurl":"开具端xbrl文件地址", "Bills":"单据唯一标识", "WhetherInvoiceIsRedInvoice":"是否红字发票", "WhetherInvoiceHasBeenChecked":"是否已验真" } ] } ``` ### 4.7.3 接口说明 ## 4.8 票据-增值税电子专用发票 ### 4.8.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|----|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单，4 票据" | 是 | text RandomCode|随机码|是|text InvoiceType | 票据类型（“”） | 是 | text Datas | 票据结构化数据集合 | 是 | arr UniqueCodeOfInvoice | 发票唯一标识 | 是 | text NameOfSeller | 销售方名称 | 是 | text TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller | 销售方纳税人识别号（统一社会信用代码） | 是 | text TotalAmountExcludingTax | 不含税金额合计 | 是 | X TotalTaxAmount | 税额合计 | 是 | X TaxIncludedAmountInFigures | 价税合计（小写） | 是 | X DateOfIssue | 开票日期 | 是 | yyyy-mm-dd InvoiceCode | 发票代码 | 是 |text InvoiceNO | 发票号码 | 是 |text SerialNO| 发票流水号 | 是 |text UniquePK | 数据唯一判重标识 | 是 |text InvoiceType | 发票类型 | 否 | text InvoiceTypeName | 发票类型名称 | 否 | text Originalurl | 发票原件地址 | 否 | text Pdfurl| 发票pdf地址 | 否 | text Snapshoturl| 发票快照地址 | 否 | text IssuerXbrlurl| 开具端xbrl文件地址 | 否 | text Bills | 单据唯一标识 | 否 | text WhetherInvoiceIsRedInvoice| 是否红字发票 | 是 |Y/N WhetherInvoiceHasBeenChecked| 是否已验真 | 是 |Y/N ### 4.8.2 入参格数 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单", "RandomCode":"2023061417510000123456789", "InvoiceType":"参考4.5章节-票据种类唯一值" "Datas": [ { "UniqueCodeOfInvoice":"", "NameOfSeller":"销售方名称", "TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller":"销售方纳税人识别号（统一社会信用代码）", "TotalAmountExcludingTax":"不含税金额合计", "TotalTaxAmount":"税额合计", "TaxIncludedAmountInFigures":"价税合计（小写）", "DateOfIssue":"开票日期", "InvoiceCode":"发票代码", "InvoiceNO":"发票号码", "SerialNO":"发票流水号", "UniquePK":"数据唯一判重标识", "InvoiceType":"发票类型", "InvoiceTypeName":"发票类型名称", "Originalurl":"发票原件地址", "Pdfurl":"发票pdf地址", "Snapshoturl":"发票快照地址", "IssuerXbrlurl":"开具端xbrl文件地址", "Bills":"单据唯一标识", "WhetherInvoiceIsRedInvoice":"是否红字发票", "WhetherInvoiceHasBeenChecked":"是否已验真" } ] } ``` ### 4.8.3 接口说明 ## 4.9 票据-电子发票（铁路电子客票） ### 4.9.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|-------|----|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单，4 票据" | 是 | text RandomCode|随机码|是|text InvoiceType | 票据类型（“”） | 是 | text Datas | 票据结构化数据集合 | 是 | arr ElectronicInvoiceRailwayETicketNumber | 电子发票（铁路电子客票）号码 | 是| text DateOfIssue | 开票日期 | 是 | yyyy-mm-dd TotalAmountExcludingTax | 不含税金额合计 | 是 | X TaxRate | 税率 | 是 | % TaxAmount| 税额 | 是 | X InvoiceCode | 发票代码 | 否 |text InvoiceNO | 发票号码 | 否 |text SerialNO| 发票流水号 | 否 |text UniquePK | 数据唯一判重标识 | 是 |text InvoiceType | 发票类型 | 否 | text InvoiceTypeName | 发票类型名称 | 否 | text Originalurl | 发票原件地址 | 否 | text Pdfurl| 发票pdf地址 | 否 | text Snapshoturl| 发票快照地址 | 否 | text IssuerXbrlurl| 开具端xbrl文件地址 | 否 | text WhetherInvoiceIsRedInvoice| 是否红字发票 | 是 |Y/N WhetherInvoiceHasBeenChecked| 是否已验真 | 是 |Y/N ### 4.9.2 入参格数 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单,4 票据", "RandomCode":"2023061417510000123456789", "InvoiceType":"参考4.5章节-票据种类唯一值", "Datas": [ { "ElectronicInvoiceRailwayETicketNumber":"电子发票（铁路电子客票）号码", "TotalAmountExcludingTax":"不含税金额合计", "TaxAmount":"税额", "TaxRate":"税率", "DateOfIssue":"开票日期", "InvoiceCode":"发票代码", "InvoiceNO":"发票号码", "SerialNO":"发票流水号", "UniquePK":"数据唯一判重标识", "InvoiceType":"发票类型", "InvoiceTypeName":"发票类型名称", "Originalurl":"发票原件地址", "Pdfurl":"发票pdf地址", "Snapshoturl":"发票快照地址", "IssuerXbrlurl":"开具端xbrl文件地址", "Bills":"单据唯一标识", "WhetherInvoiceIsRedInvoice":"是否红字发票", "WhetherInvoiceHasBeenChecked":"是否已验真" } ] } ``` ### 4.9.3 接口说明 ## 4.10 票据-收费公路通行费增值税电子普通发票 ### 4.10.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|--------|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单，4 票据" | 是 | text RandomCode|随机码|是|text InvoiceType | 票据类型（“”） | 是 | text Datas | 票据结构化数据集合 | 是 | arr UniqueCodeOfInvoice | 发票唯一标识 | 是 | text NameOfSeller | 销售方名称 | 是 | text TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller | 销售方纳税人识别号（统一社会信用代码） | 是 | text TotalAmountExcludingTax | 不含税金额合计 | 是 | X TotalTaxAmount | 税额合计 | 是 | X TaxIncludedAmountInFigures | 价税合计（小写） | 是 | X DateOfIssue | 开票日期 | 是 | yyyy-mm-dd InvoiceCode | 发票代码 | 是 |text InvoiceNO | 发票号码 | 是 |text SerialNO| 发票流水号 | 是 |text UniquePK | 数据唯一判重标识 | 是 |text InvoiceType | 发票类型 | 否 | text InvoiceTypeName | 发票类型名称 | 否 | text Originalurl | 发票原件地址 | 否 | text Pdfurl| 发票pdf地址 | 否 | text Snapshoturl| 发票快照地址 | 否 | text IssuerXbrlurl| 开具端xbrl文件地址 | 否 | text Bills | 单据唯一标识 | 否 | text WhetherInvoiceIsRedInvoice| 是否红字发票 | 是 |Y/N WhetherInvoiceHasBeenChecked| 是否已验真 | 是 |Y/N ### 4.10.2 入参格数 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单,4 票据", "RandomCode":"2023061417510000123456789", "InvoiceType":"参考4.5章节-票据种类唯一值", "Datas": [ { "UniqueCodeOfInvoice":"发票唯一标识", "NameOfSeller":"销售方名称", "TaxpayerIdentificationNumberUnifiedSocialCreditCodeOfSeller":"销售方纳税人识别号（统一社会信用代码）", "TotalAmountExcludingTax":"不含税金额合计", "TotalTaxAmount":"税额合计", "TaxIncludedAmountInFigures":"价税合计（小写）", "DateOfIssue":"开票日期", "InvoiceCode":"发票代码", "InvoiceNO":"发票号码", "SerialNO":"发票流水号", "UniquePK":"数据唯一判重标识", "InvoiceType":"发票类型", "InvoiceTypeName":"发票类型名称", "Originalurl":"发票原件地址", "Pdfurl":"发票pdf地址", "Snapshoturl":"发票快照地址", "IssuerXbrlurl":"开具端xbrl文件地址", "Bills":"单据唯一标识", "WhetherInvoiceIsRedInvoice":"是否红字发票", "WhetherInvoiceHasBeenChecked":"是否已验真" } ] } ``` ### 4.10.3 接口说明 ## 4.11 票据-非税收入一般缴款书 ### 4.11.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|--------|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单，4 票据" | 是 | text RandomCode|随机码|是|text InvoiceType | 票据类型（“”） | 是 | text Datas | 票据结构化数据集合 | 是 | arr EINVOICE_ID | 电子缴款书标识 | 是 | text BILL_DATE | 开票日期 | 是 | yyyy-mm-dd PAID_AMT | 缴款金额 | 是 | X InvoiceCode | 发票代码 | 是 |text InvoiceNO | 发票号码 | 是 |text SerialNO| 发票流水号 | 是 |text UniquePK | 数据唯一判重标识 | 是 |text InvoiceType | 发票类型 | 否 | text InvoiceTypeName | 发票类型名称 | 否 | text Originalurl | 发票原件地址 | 否 | text Pdfurl| 发票pdf地址 | 否 | text Snapshoturl| 发票快照地址 | 否 | text IssuerXbrlurl| 开具端xbrl文件地址 | 否 | text Bills | 单据唯一标识 | 否 | text WhetherInvoiceIsRedInvoice| 是否红字发票 | 是 |Y/N WhetherInvoiceHasBeenChecked| 是否已验真 | 是 |Y/N ### 4.11.2 入参格数 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单,4 票据", "RandomCode":"2023061417510000123456789", "InvoiceType":"参考4.5章节-票据种类唯一值", "Datas": [ { "EINVOICE_ID":"电子缴款书标识", "BILL_DATE":"开票日期", "PAID_AMT":"缴款金额", "InvoiceCode":"发票代码", "InvoiceNO":"发票号码", "SerialNO":"发票流水号", "UniquePK":"数据唯一判重标识", "InvoiceType":"发票类型", "InvoiceTypeName":"发票类型名称", "Originalurl":"发票原件地址", "Pdfurl":"发票pdf地址", "Snapshoturl":"发票快照地址", "IssuerXbrlurl":"开具端xbrl文件地址", "Bills":"单据唯一标识", "WhetherInvoiceIsRedInvoice":"是否红字发票", "WhetherInvoiceHasBeenChecked":"是否已验真" } ] } ``` ### 4.11.3 接口说明 ## 4.12 票据-财政电子票据 ### 4.12.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|--------|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单，4 票据" | 是 | text RandomCode|随机码|是|text InvoiceType | 票据类型（“”） | 是 | text Datas | 票据结构化数据集合 | 是 | arr EInvoiceID | 财政电子票据标识 | 是 | text InvoicingPartyName | 开票单位名称 | 是 | text InvoicingPartyCode | 开票单位代码 | 是 | text IssueDate | 开票日期 | 是 | yyyy-mm-dd TotalAmount | 总金额 | 是 | X InvoiceCode | 发票代码 | 是 |text InvoiceNO | 发票号码 | 是 |text SerialNO| 发票流水号 | 是 |text UniquePK | 数据唯一判重标识 | 是 |text InvoiceType | 发票类型 | 否 | text InvoiceTypeName | 发票类型名称 | 否 | text Originalurl | 发票原件地址 | 否 | text Pdfurl| 发票pdf地址 | 否 | text Snapshoturl| 发票快照地址 | 否 | text IssuerXbrlurl| 开具端xbrl文件地址 | 否 | text Bills | 单据唯一标识 | 否 | text WhetherInvoiceIsRedInvoice| 是否红字发票 | 是 |Y/N WhetherInvoiceHasBeenChecked| 是否已验真 | 是 |Y/N WhetherInvoiceHasBeenBooked| 是否已验真 | 是 |Y/N ### 4.12.2 入参格数 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单,4 票据", "RandomCode":"2023061417510000123456789", "InvoiceType":"参考4.5章节-票据种类唯一值", "Datas": [ { "EInvoiceID":"财政电子票据标识", "InvoicingPartyName":"开票单位名称", "InvoicingPartyCode":"开票单位代码", "IssueDate":"开票日期", "TotalAmount":"总金额", "InvoiceCode":"发票代码", "InvoiceNO":"发票号码", "SerialNO":"发票流水号", "UniquePK":"数据唯一判重标识", "InvoiceType":"发票类型", "InvoiceTypeName":"发票类型名称", "Originalurl":"发票原件地址", "Pdfurl":"发票pdf地址", "Snapshoturl":"发票快照地址", "IssuerXbrlurl":"开具端xbrl文件地址", "Bills":"单据唯一标识", "WhetherInvoiceIsRedInvoice":"是否红字发票", "WhetherInvoiceHasBeenChecked":"是否已验真" } ] } ``` ### 4.12.3 接口说明 ## 4.13 票据-全面数字化的电子发票（增值税普通发票） ### 4.13.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|-------|---|--- UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单，4 票据" | 是 | text RandomCode|随机码|是|text InvoiceType | 票据类型（“”） | 是 | text Datas | 票据结构化数据集合 | 是 | arr UniqueCodeOfInvoice | 发票唯一标识 | 是 | text SellerName | 销售方名称 | 是 | text SellerIdNum | 销售方纳税人识别号（统一社会信用代码） | 是 | text TotalAmWithoutTax | 不含税金额合计 | 是 | X TotalTaxAm | 税额合计 | 是 | X TaxIncludedAmountInFigures | 价税合计（小写） | 是 | X DateOfIssue | 开票日期 | 是 | yyyy-mm-dd InvoiceCode | 发票代码 | 是 |text InvoiceNO | 发票号码 | 是 |text SerialNO| 发票流水号 | 是 |text UniquePK | 数据唯一判重标识 | 是 |text InvoiceType | 发票类型 | 否 | text InvoiceTypeName | 发票类型名称 | 否 | text Originalurl | 发票原件地址 | 否 | text Pdfurl| 发票pdf地址 | 否 | text Snapshoturl| 发票快照地址 | 否 | text IssuerXbrlurl| 开具端xbrl文件地址 | 否 | text Bills | 单据唯一标识 | 否 | text WhetherInvoiceIsRedInvoice| 是否红字发票 | 是 |Y/N WhetherInvoiceHasBeenChecked| 是否已验真 | 是 |Y/N WhetherEinvoiceHasBeenBooked| 是否已入账 | 否 |Y/N ### 4.13.2 入参格数 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单,4 票据", "RandomCode":"2023061417510000123456789", "InvoiceType":"参考4.5章节-票据种类唯一值", "Datas": [ { "UniqueCodeOfInvoice":"", "SellerName":"销售方名称", "SellerIdNum":"销售方纳税人识别号（统一社会信用代码）", "TotalAmWithoutTax":"不含税金额合计", "TotalTaxAmount":"税额合计", "TaxIncludedAmountInFigures":"价税合计（小写）", "DateOfIssue":"开票日期", "InvoiceCode":"发票代码", "InvoiceNO":"发票号码", "SerialNO":"发票流水号", "UniquePK":"数据唯一判重标识", "InvoiceType":"发票类型", "InvoiceTypeName":"发票类型名称", "Originalurl":"发票原件地址", "Pdfurl":"发票pdf地址", "Snapshoturl":"发票快照地址", "IssuerXbrlurl":"开具端xbrl文件地址", "Bills":"单据唯一标识", "WhetherInvoiceIsRedInvoice":"是否红字发票", "WhetherInvoiceHasBeenChecked":"是否已验真" } ] } ``` ### 4.13.3 接口说明 ## 4.14 票据-全面数字化的电子发票（增值税专用发票） ### 4.14.1 入参简述 参数名称 | 参数说明 | 是否必输 | 参数格式 ---|-------|---|------------ UnifiedSocialCreditCodeOfAccountingEntity | 统一社会信用代码 | 是 | text NameOfAccountingEntity | 公司 | 是 | text DataType | 数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单，4 票据" | 是 | text RandomCode|随机码| 是 |text InvoiceType | 票据类型（“”） | 是 | text Datas | 票据结构化数据集合 | 是 | arr UniqueCodeOfInvoice | 发票唯一标识 | 是 | text SellerName | 销售方名称 | 是 | text SellerIdNum | 销售方纳税人识别号（统一社会信用代码） | 是 | text TotalAmWithoutTax | 不含税金额合计 | 是 | X TotalTaxAm | 税额合计 | 是 | X TaxIncludedAmountInFigures | 价税合计（小写） | 是 | X DateOfIssue | 开票日期 | 是 | yyyy-mm-dd InvoiceCode | 发票代码 | 是 | text InvoiceNO | 发票号码 | 是 | text SerialNO| 发票流水号 | 是 | text UniquePK | 数据唯一判重标识 | 是 | text InvoiceType | 发票类型 | 否 | text InvoiceTypeName | 发票类型名称 | 否 | text Originalurl | 发票原件地址 | 否 | text Pdfurl| 发票pdf地址 | 否 | text Snapshoturl| 发票快照地址 | 否 | text IssuerXbrlurl| 开具端xbrl文件地址 | 否 | text Bills | 单据唯一标识 | 否 | text WhetherInvoiceIsRedInvoice| 是否红字发票 | 是 | Y/N WhetherInvoiceHasBeenChecked| 是否已验真 | 是 | Y/N WhetherEinvoiceHasBeenBooked| 是否已入账 | 否 | Y/N WhetherEinvoiceUsageHasBeenConfirmed|是否已用途确认| 否 | Y/N UsageConfirmation|确认用途| 否 | text PeriodOfUsageConfirmation|用途所属期| 否 | yyyy-mm ### 4.14.2 入参格数 ``` { "UnifiedSocialCreditCodeOfAccountingEntity": "会计主体统一社会信用代码", "NameOfAccountingEntity": "会计主体名称", "DataType": "数据类型 3 , 0 凭证,1 业务单据(报销单、采购单...),2 电子回单,3 银行电子对账单,4 票据", "RandomCode":"2023061417510000123456789", "InvoiceType":"参考4.5章节-票据种类唯一值", "Datas": [ { "UniqueCodeOfInvoice":"", "SellerName":"销售方名称", "SellerIdNum":"销售方纳税人识别号（统一社会信用代码）", "TotalAmWithoutTax":"不含税金额合计", "TotalTaxAmount":"税额合计", "TaxIncludedAmountInFigures":"价税合计（小写）", "DateOfIssue":"开票日期", "InvoiceCode":"发票代码", "InvoiceNO":"发票号码", "SerialNO":"发票流水号", "UniquePK":"数据唯一判重标识", "InvoiceType":"发票类型", "InvoiceTypeName":"发票类型名称", "Originalurl":"发票原件地址", "Pdfurl":"发票pdf地址", "Snapshoturl":"发票快照地址", "IssuerXbrlurl":"开具端xbrl文件地址", "Bills":"单据唯一标识", "WhetherInvoiceIsRedInvoice":"是否红字发票", "WhetherInvoiceHasBeenChecked":"是否已验真" } ] } ``` ### 4.14.3 接口说明