发票归集
接口描述
发票下载
请求方式
POST
请求地址
https://qst.imfbp.com/apihub/api
URL 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|
| Action | String | 是 | 操作的接口名称,本接口取值:ETax.Input.InvoiceCollection |
| 参数名称 | 类型 | 必选 | 说明 |
|---|
| Timestamp | String | 是 | 公共参数。 |
| SecretId | String | 是 | 公共参数。 |
| Signature | String | 是 | 公共参数。 |
| Algorithm | String | 否 | 公共参数。 |
| Content-Type | String | 是 | 取值:application/json |
Body 请求参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|
| taxpayerNumber | String | 是 | 纳税人识别号 |
| dataType | String | 是 | 数据类型 1:进项票 2:销项票 默认值为1 |
| invoiceType | String | 是 | 发票类型编码;发票类型详情如下表 |
| status | String | 是 | 发票状态 01,02,03,04。01 正常;02 已作废;03 已红冲-全额;04 已红冲-部分 |
| startDate | String | 是 | 开票(填发)日期起;YYYY-MM-DD 日期起止范围必须在同一个月内 |
| finishDate | String | 是 | 开票(填发)日期止;YYYY-MM-DD 日期起止范围必须在同一个月内 |
| otherTaxpayerNumber | String | 否 | 对方税号,进项则为销方,销项则为购方 |
| otherName | String | 否 | 对方名称,进项则为销方,销项则为购方 |
发票类型详情
| 编码 | 名称 |
|---|
| 0 | 增值税普通发票 |
| 1 | 增值税专用发票 |
| 2 | 增值税电子普通发票 |
| 3 | 增值税电子专用发票 |
| 12 | 增值税普通发票(卷票) |
| 13 | 机动车销售统一发票 |
| 14 | 二手车销售统一发票 |
| 17 | 通行费增值税电子普通发票 |
| 24 | 电子发票(增值税专用发票) |
| 25 | 电子发票(普通发票) |
| 30 | 电子发票(航空运输电子客票行程单) |
| 31 | 电子发票(铁路电子客票) |
| 35 | 数电纸质发票(普通发票) |
| 36 | 数电纸质发票(增值税专用发票) |
| 37 | 电子发票(机动车销售统一发票) |
| 38 | 电子发票(二手车销售统一发票) |
| 39 | 数电纸质发票(机动车销售统一发票) |
| 40 | 数电纸质发票(二手车销售统一发票) |
| 41 | 电子发票(通行费发票) |
返回参数
公共返回参数
| 参数名称 | 类型 | 说明 |
|---|
| code | Integer | 200 表示请求成功 |
| message | String | 错误提示信息 |
| startTime | long | 开始时间 |
| endTime | long | 结束时间 |
| callId | long | 调用记录标识 |
| data | {} | 返回数据 |
data 内容说明
| 参数名称 | 类型 | 说明 |
|---|
| invoiceList | List | 发票基础信息 |
发票基础信息 invoiceList
| 参数名称 | 类型 | 说明 |
|---|
| invoiceCode | String | 发票代码 |
| invoiceNum | String | 发票号码 |
| electronicNum | String | 数电票号码 |
| sellerRegisterNum | String | 销方识别号 |
| sellerName | String | 销方名称 |
| purchaserRegisterNum | String | 购方识别号 |
| purchaserName | String | 购买方名称 |
| issueDate | String | 开票日期 |
| totalAmount | String | 金额 |
| tax | String | 税额 |
| invoiceSource | String | 发票来源; 增值税发票管理系统、电子发票服务平台 |
| invoiceCatalog | String | 发票票种 |
| invoiceStatus | String | 发票状态 |
| riskLevel | String | 发票风险等级 |
| issuer | String | 开票人 |
| remarks | String | 备注 |
| itemList | List | 发票明细信息;货物清单 |
发票明细信息 itemList
| 参数名称 | 类型 | 说明 |
|---|
| invoiceCode | String | 发票代码 |
| invoiceNum | String | 发票号码 |
| electronicNum | String | 数电票号码 |
| commodityCode | String | 税收分类编码 |
| itemName | String | 货物或应税劳务名称 |
| specification | String | 规格型号 |
| unit | String | 单位 |
| quantity | String | 数量 |
| unitPrice | String | 单价 |
| amount | String | 金额 |
| taxRate | String | 税率 |
| tax | String | 税额 |