单据电子发票数量查询
接口说明
- url: /common/receiptType/config
- method: POST
- 数据格式: JSON
- 描述: 单据电子发票数量查询
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| bizId | String | Y | |
| timestamp | Long | Y | 13位毫秒时间戳 |
| document_num | String | ONE-OF |
单据号 |
| external_id | String | ONE-OF |
外部id |
ONE-OF表示任选其一
响应参数
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| bizId | String | 业务唯一识别码 |
| resCode | Integer | 响应码 (200000代表处理成功) |
| resMsg | String | 错误信息 (响应码不为200000时返回错误信息) |
| data | Object | |
| data.invoice_number | Integer | 发票数量 |
| data.e_invoice_number | Integer | 电子发票数量，见下方电子发票说明 |
| data.paper_invoice_number | Integer | 纸质单据数量 |
电子发票说明
电子发票指票据类型属于电子发票的发票，判定依据为获取票据类型配置接口（/common/invoice/findInvoiceType）返回中 einvoice_flag 为 Y 的票据类型，如增值税电子专用发票（08）、增值税普通发票（电子）（10）、电子发票(增值税专用发票)（20）、电子发票(普通发票)（21）等，完整票据类型示例见获取票据类型配置响应示例。
e_invoice_number 即票据类型属于电子发票的发票数量，paper_invoice_number 为其余发票数量（invoice_number - e_invoice_number）。
请求示例
{
"bizId": "adc40wde-2fb6-49a8-9a91-9fz69fd0z578",
"timestamp" : 1725518213844,
"document_num": "EXP0000000415"
}
响应示例
处理成功时响应
{
"resCode": 200000,
"resMsg": "success",
"bizId": "adc40wde-2fb6-49a8-9a91-9fz69fd0z578",
"data": {
"invoice_number": 3,
"e_invoice_number": 2,
"paper_invoice_number": 1
}
}
处理失败时响应
{
"resCode": 500060,
"resMsg": "该单据不存在消费记录"
}