1. 发票库存信息
1.1. 接口说明
获取指定类型发票库存信息。
1.2. 调用方式
请求方式：GET
https://invoice.youepiao.com/openApi/v4/fp/receive
1.3. 请求参数
1.3.1. 参数说明
| 参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
|---|---|---|---|---|---|
| lsh | 流水号 | String | 50 | 是 | 申请流水号 |
| kpzdbs | 开票终端标识 | String | 30 | 是 | |
| xhdwsbh | 纳税人识别号 | String | 20 | 是 | |
| fplxdm | 发票类型代码 | String | 3 | 是 | 004-纸质专票 007-纸质普票 025-卷票 026-电子普票 028-电子专票 |
| type | 接口类型 | String | 2 | 是 | 3-税控服务器 6-托管UKey |
1.4. 返回结果
1.4.1. 返回示例
{
"status": true,
"code": 0,
"msg": "提示信息",
"timestamp": "2021-06-23T03:42:23.517+00:00",
"data": {
"lsh": "12132123",
"kpzdbs": "917020050202",
"currentInvoiceCode": "021022100113",
"currentInvoiceNum": "01292835",
"totalInvoiceCount": 4,
"list": [
{
"fplxdm": "028",
"invoiceCode": "021022100113",
"startInvoiceNum": "01292831",
"endInvoiceNum": "01292838",
"invoiceQuantity": 8,
"remainingQuantity": 4,
"invoiceClaimDate": "2022-05-13",
"operator": "WSLP"
}
]
}
}
1.4.2. 返回说明
| 参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
|---|---|---|---|---|---|
| lsh | 流水号 | String | 50 | 是 | 申请流水号 |
| kpzdbs | 开票终端标识 | String | 30 | 是 | |
| currentInvoiceCode | 待开发票代码 | String | 10/12 | 否 | 发票用完则为空 |
| currentInvoiceNum | 待开发票号码 | String | 8 | 否 | 发票用完则为空 |
| totalInvoiceCount | 剩余发票份数 | Int | 是 | ||
| list | 发票段列表 | 否 | 发票用完则为空 |
发票段列表说明
| 报文 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
|---|---|---|---|---|---|
| fplxdm | 发票类型 | String | 3 | 是 | 004-纸质专票 007-纸质普票 025-卷票 026-电子普票 028-电子专票 |
| invoiceCode | 发票代码 | String | 10/12 | 是 | |
| startInvoiceNum | 发票起始号码 | String | 8 | 是 | |
| endInvoiceNum | 发票终止号码 | String | 8 | 是 | |
| invoiceQuantity | 发票份数 | Int | 是 | ||
| remainingQuantity | 剩余份数 | Int | 是 | ||
| invoiceClaimDate | 领购日期 | String | 10 | 是 | 时间格式（yyyy-MM-dd） |
| operator | 领购人员 | String | 20 | 是 |