Home - 平台 - 发票信息
最后修改者: huangyingliang 2025-11-12 17:50:09
查询未开票 或者 已开票 列表
编号 : 001
GET - https://fl.tp6.hyj111.cn/admin/vendorInvoice/index
headers下token必传 然后 Accept = application/json
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| page | int | Y | 页码 | |
| pageSize | int | Y | 每页显示数 | |
| vid | int | N | 商户id 手机端不用传 | |
| platform_owner_type | int | Y | 平台归属 0 南通飞驴网络科技有限公司 1 南通霍元甲网络科技有限公司 | |
| status | int | Y | 发票状态 0 未开票 1 已开票 | |
| start_month | string | Y | 账单开始日期 如 2025-07 默认上一个月 | |
| end_month | string | Y | 账单结束日期 如 2025-10 默认上一个月 |
返回值
未开票接口示例:
https://fl.tp6.hyj111.cn/admin/vendorInvoice/index?status=0&vid=17&platform_owner_type=0&start_month=2025-07&end_month=2025-10&page=1&pageSize=10
{
"status": 200,
"msg": "success",
"data": {
"list": [
{
"serial_number": 1, // 序号
"year_month": "2025-07", // 账单月份
"start_date": "2025-07-01", //账单开始日期
"end_date": "2025-07-31", // 账单结束日期
"platform_owner_type": 0, // 平台归属 0 南通飞驴网络科技有限公司 1 南通霍元甲网络科技有限公司
"price": "6.09", // 账单金额 格式 字符串类型
"price_float": 6.09, // 账单金额 格式 浮点型
"vid": 17, // 商户id
"store_name": "江苏集结号机车科技有限公司", // 商户名称
"short_name": "", // 商户简称
"tax_number": "", // 商户税号
"invoice_status": 0 // 发票状态 0 未开票 1 已开票
},
{
"serial_number": 2,
"year_month": "2025-08",
"start_date": "2025-08-01",
"end_date": "2025-08-31",
"platform_owner_type": 0,
"price": "5.88",
"price_float": 5.88,
"vid": 17,
"store_name": "江苏集结号机车科技有限公司",
"short_name": "",
"tax_number": "",
"invoice_status": 0
},
{
"serial_number": 3,
"year_month": "2025-09",
"start_date": "2025-09-01",
"end_date": "2025-09-30",
"platform_owner_type": 0,
"price": "0.63",
"price_float": 0.63,
"vid": 17,
"store_name": "江苏集结号机车科技有限公司",
"short_name": "",
"tax_number": "",
"invoice_status": 0
},
{
"serial_number": 4,
"year_month": "2025-10",
"start_date": "2025-10-01",
"end_date": "2025-10-31",
"platform_owner_type": 0,
"price": "0.25",
"price_float": 0.25,
"vid": 17,
"store_name": "江苏集结号机车科技有限公司",
"short_name": "",
"tax_number": "",
"invoice_status": 0
}
],
"total_price": "12.85", // 总计金额
"filters": { // 筛选条件
"start_month": "2025-07",
"end_month": "2025-10",
"platform_owner_type": 0
},
"page": 1, // 页码
"limit": 10, // 每页显示数
"count": 4 // 总条数
}
}
查询已开票的列表接口:
https://fl.tp6.hyj111.cn/admin/vendorInvoice/index?status=1&vid=17&platform_owner_type=0&start_month=2025-07&end_month=2025-10&page=1&pageSize=15
接口返回示例:
{
"status": 200,
"msg": "success",
"data": {
"total": 1,
"per_page": 15,
"current_page": 1,
"last_page": 1,
"data": [
{
"id": 2, // id
"platform_owner_type": 0, // 平台归属 0 南通飞驴网络科技有限公司 1 南通霍元甲网络科技有限公司
"vid": 17,
"start_date": "2025-07-01", // 资金账单开始日期
"end_date": "2025-08-31", // 资金账单结束日期
"price": 11.97, // 开票金额(元)
"voucher": "https://img.hyj111.cn/tmp/0148882ccc5aa0d186e6d5f996aea431.pdf", // 凭证(pdf)
"created_at": "2025-11-12 17:11:13", // 创建时间
"updated_at": "2025-11-12 17:11:13",
"vendor": {
"vid": 17,
"store_name": "江苏集结号机车科技有限公司",
"short_name": null,
"tax_number": null
}
}
],
"list": [
{
"id": 2, // id
"platform_owner_type": 0, // 平台归属 0 南通飞驴网络科技有限公司 1 南通霍元甲网络科技有限公司
"vid": 17,
"start_date": "2025-07-01", // 资金账单开始日期
"end_date": "2025-08-31", // 资金账单结束日期
"price": "11.97", // 开票金额(元)
"voucher": "https://img.hyj111.cn/tmp/0148882ccc5aa0d186e6d5f996aea431.pdf", // 凭证(pdf)
"created_at": "2025-11-12 17:11:13", // 创建时间
"updated_at": "2025-11-12 17:11:13",
"serial_number": 1,
"children": [ // 对应月份账单信息
{
"year_month": "2025-07",
"start_date": "2025-07-01",
"end_date": "2025-07-31",
"price": "6.09",
"price_float": 6.09
},
{
"year_month": "2025-08",
"start_date": "2025-08-01",
"end_date": "2025-08-31",
"price": "5.88",
"price_float": 5.88
}
],
"detail_total": "11.97",
"store_name": "江苏集结号机车科技有限公司",
"short_name": "",
"tax_number": "",
"invoice_status": 1
}
],
"summary": {
"total_price": "11.97"
},
"filters": {
"start_month": "2025-07",
"end_month": "2025-10",
"platform_owner_type": 0
}
}
}
最后修改者: huangyingliang 2025-11-12 09:19:36
开票提交
编号 : 002
POST - https://fl.tp6.hyj111.cn/admin/vendorInvoice/submit
headers下token必传 然后 Accept = application/json
请求参数
| 参数名 | 参数类型 | 必传 | 缺省值 | 描述 |
|---|---|---|---|---|
| vid | int | Y | 商户id | |
| items | array | Y | 勾选的未开票数组 | |
| voucher | string | Y | 发票凭据 |
返回值
请求参数示例:
{
"vid": 17,
"items": [
{
"year_month": "2025-07",
"platform_owner_type": 0
},
{
"year_month": "2025-08",
"platform_owner_type": 0
}
],
"voucher": "/path/to/invoice.pdf"
}
请求成功返回:
{
"status": 200,
"msg": "开票成功",
"data": {
"id": 1,
"vid": 17,
"platform_owner_type": 0,
"price": 11.97,
"start_date": "2025-07-01",
"end_date": "2025-08-31"
}
}