发票查询
接口描述
获取发票全票面信息，只支持单张查询。
请求方式
POST
请求地址
URL 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| Action | String | 是 | 操作的接口名称，本接口取值：ETax.Output.QueryInvoice |
Header 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| Timestamp | String | 是 | 公共参数。 |
| SecretId | String | 是 | 公共参数。 |
| Signature | String | 是 | 公共参数。 |
| Content-Type | String | 是 | 取值：application/json |
Body 请求参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| areaCode | String | 是 | 地区编码，参见地区编码 |
| taxpayerNumber | String | 是 | 销售方纳税人识别号 |
| taxOfficerIDCard | String | 是 | 办税人身份证号 |
| requestNo | String | 否 | 请求流水号 (长度32位,调用端保证唯一) 已调用的流水号只传此字段，以下四个字段可以不传 |
| paperInvoiceCode | String | 否 | 纸质发票代码 查询数电纸质发票时需要同时传纸质发票代码、纸质发票号码、数电发票号码。 |
| paperInvoiceNum | String | 否 | 纸质发票号码 查询数电纸质发票时需要同时传纸质发票代码、纸质发票号码、数电发票号码。 |
| issueDate | String | 是 | 开票日期 格式: yyyy-MM-dd HH:mm:ss |
| invoiceNum | String | 否 | 数电发票号码 数电发票时必填 |
返回参数
公共返回参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| code | Integer | 200 表示请求成功 详见状态码 |
| message | String | 错误提示信息 |
| startTime | long | 开始时间 |
| endTime | long | 结束时间 |
| callId | long | 调用记录标识 |
| data | {} | 返回数据 |
data 内容说明
| 参数名称 | 类型 | 说明 |
|---|---|---|
| invoiceTypeCode | String | 发票类型编码。 0：增值税普通发票 1：增值税专用发票 2：增值税电子普通发票 3：增值税电子专用发票 |
| remarks | String | 备注 |
| qrCode | String | 二维码 |
| checker | String | 复核人 |
| invoiceNum | String | 数电发票号码 |
| invoiceCode | String | 发票代码 |
| additionalInformationList | [] | 详见附加信息集合 |
| specificInformation | {} | 详见特定业务信息 |
| + buildingServiceList | [] | 详见建筑服务 |
| + transportServiceList | [] | 详见旅客运输服务 |
| purchaserAddressPhonem | String | 购买方地址电话 |
| purchaserAddress | String | 购买方地址 |
| purchaserPhone | String | 购买方联系电话 |
| purchaserBankName | String | 购买方开户行 |
| purchaserBankAccount | String | 购买方银行账号 |
| purchaserName | String | 购买方名称 |
| purchaserRegisterNum | String | 购方纳税人识别号 |
| totalAmount | String | 不含税金额合计 |
| totalTax | String | 税额合计 |
| amountInFigures | String | 价税合计(小写) |
| checkCode | String | 校验码 |
| deductedAmount | String | 扣除额 |
| issuedType | String | 开具类型。 0-蓝票 1-红票 |
| issuer | String | 开票人 |
| issueDate | String | 开票日期 |
| taxCode | String | 税控码 |
| payee | String | 收款人 |
| sellerName | String | 销方名称 |
| sellerTaxpayerNumber | String | 销方税号 |
| sellerAddress | String | 销方地址 |
| sellerPhone | String | 销方联系电话 |
| sellerBankName | String | 销方开户行 |
| sellerBankAccount | String | 销方银行账号 |
| sellerBankNameAccount | String | 销售方开户行及账号 |
| telexInvoiceNumber | String | 数电纸票发票号码 |
| paperInvoiceCode | String | 增值税发票代码 |
| paperInvoiceNum | String | 增值税发票号码 |
| items | [] | 详见销货清单 |
附加信息集合
| 参数名称 | 类型 | 说明 |
|---|---|---|
| additionalInformationName | String | 附加信息名称 |
| additionalInformationContent | String | 附加信息内容 |
旅客运输服务
| 参数名称 | 类型 | 说明 |
|---|---|---|
| departurePlace | String | 出发地 |
| departureDate | String | 出行日期 |
| departurePer | String | 出行人 |
| departureCardType | String | 出行人证件类型 参见身份证件类型代码 |
| destinationPlace | String | 到达地 |
| vehicleType | String | 交通工具类型 参见身份证件类型代码 |
| departurePerCardNum | String | 出行人身份证件号码 |
| serialNum | String | 序号 |
建筑服务
| 参数名称 | 类型 | 说明 |
|---|---|---|
| locationDetails | String | 发生地详细信息 |
| constructionName | String | 建筑项目名称 |
销货清单
| 参数名称 | 类型 | 说明 |
|---|---|---|
| unit | String | 单位 |
| specification | String | 规格型号 |
| unitPrice | String | 单价 |
| itemKind | String | 发票行性质，0：正常行 1：折扣行 2：被折扣行 |
| amount | String | 不含税金额 |
| tax | String | 税额 |
| taxRate | String | 税率 |
| itemName | String | 商品名称 |
| quantity | String | 商品数量 |
| commodityCode | String | 商品编码，税收分类编码 |
| no | String | 序号 |
| favorable | String | 是否享受优惠政策，0 不使用 1 使用 |
| specificTaxCode | String | 特定征税方式代码 参见特定征税方式代码 |
| taxIncentivePolicyTypeCode | String | 税收优惠政策类型代码 参见税收优惠政策类型代码 |