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"
    }
}