Home - 共享仓 - 发票信息 登录  
最后修改者: huangyingliang  2025-11-24 17:32:10 

查询未开票 或者 已开票 列表

编号  :  001

GET - https://fl.tp6.hyj111.cn/admin/gxcInvoice/index
headers下token必传 然后 Accept = application/json
请求参数
参数名 参数类型 必传 缺省值 描述
page int Y 页码
pageSize int Y 每页显示数
vid int N 商户id 手机端不用传
start_month string Y 开始月份 例如 2025-10
end_month string Y 结束月份 例如 2025-10
status int Y 开票状态 0 未开票 1 已开票
gxc_id int Y 仓库id
返回值
未开票接口示例:
https://fl.tp6.hyj111.cn/admin/gxcInvoice/index?gxc_id=11&vid=18&start_month=2025-10&end_month=2025-10&status=0&page=1&pageSize=10

{
    "status": 200,
    "msg": "success",
    "data": {
        "list": [
            {
                "serial_number": 1, // 序号
                "year_month": "2025-10", // 账单月份
                "start_date": "2025-10-01", //账单开始日期
                "end_date": "2025-10-31",// 账单结束日期
                "price": "2430.46", // 账单金额 格式 字符串类型
                "price_float": 2430.46, // 账单金额 格式 浮点型
                "gxc_id": 11, // 仓库id
                "gxc_name": "南通智化慧仓科技有限公司(南通仓)", // 仓库名称
                "vid": 18, // 商户id
                "store_name": "清远市清城区广佛鑫照明工厂(个体工商户)", // 商户名称
                "short_name": "广佛鑫照明", // 商户简称
                "tax_number": "92441802MAE5TGX68M", // 商户税号
                "invoice_status": 0 // 发票状态 0  未开票 1 已开票
            }
        ],
        "total_price": "2430.46",
        "summary": {
            "total_price": "2430.46"
        },
        "filters": {
            "gxc_id": 11,
            "vid": 18,
            "start_month": "2025-10",
            "end_month": "2025-10"
        },
        "page": 1,
        "limit": 10,
        "count": 1
    }
}

查询已开票列表 
接口示例:
https://fl.tp6.hyj111.cn/admin/gxcInvoice/index?gxc_id=11&vid=18&start_month=2025-07&end_month=2025-10&status=1&page=1&pageSize=10

接口返回:
{
    "status": 200,
    "msg": "success",
    "data": {
        "total": 1,
        "per_page": 10,
        "current_page": 1,
        "last_page": 1,
        "data": [
            {
                "id": 1, // id
                "gxc_id": 11, // 仓库Id
                "vid": 18,  // 商户Id
                "start_date": "2025-07-01",
                "end_date": "2025-08-31",
                "price": 3458.99,
                "voucher": "https://img.hyj111.cn/path/to/invoice.pdf",
                "created_at": "2025-11-24 17:24:01",
                "updated_at": "2025-11-24 17:24:01",
                "vendor": {
                    "vid": 18,
                    "store_name": "清远市清城区广佛鑫照明工厂(个体工商户)",
                    "short_name": "广佛鑫照明",
                    "tax_number": "92441802MAE5TGX68M"
                },
                "gxc": {
                    "id": 11,
                    "name": "南通智化慧仓科技有限公司(南通仓)"
                }
            }
        ],
        "list": [
            {
                "id": 1, //id 
                "gxc_id": 11,  // 仓库id
                "vid": 18, // 商户id
                "start_date": "2025-07-01", // 资金账单开始日期
                "end_date": "2025-08-31", // 资金账单结束日期
                "price": "3458.99", // 开票金额(元)
                "voucher": "https://img.hyj111.cn/path/to/invoice.pdf", // 凭证(pdf)
                "created_at": "2025-11-24 17:24:01", // 创建时间
                "updated_at": "2025-11-24 17:24:01",
                "serial_number": 1,
                "parent_serial": 1,
                "children": [ // 对应月份账单信息
                    {
                        "id": 101,
                        "year_month": "2025-07",
                        "start_date": "2025-07-01",
                        "end_date": "2025-07-31",
                        "price": "1568.14",
                        "price_float": 1568.14
                    },
                    {
                        "id": 102,
                        "year_month": "2025-08",
                        "start_date": "2025-08-01",
                        "end_date": "2025-08-31",
                        "price": "1890.85",
                        "price_float": 1890.85
                    }
                ],
                "year_month": "2025-07-01 ~ 2025-08-31",
                "detail_total": "3458.99",
                "gxc_name": "南通智化慧仓科技有限公司(南通仓)",
                "store_name": "清远市清城区广佛鑫照明工厂(个体工商户)",
                "short_name": "广佛鑫照明",
                "tax_number": "92441802MAE5TGX68M",
                "invoice_status": 1
            }
        ],
        "summary": {
            "total_price": "3458.99"
        },
        "filters": {
            "start_month": "2025-07",
            "end_month": "2025-10"
        }
    }
}
最后修改者: huangyingliang  2025-11-25 09:41:43 

开票提交

编号  :  002

POST - https://fl.tp6.hyj111.cn/admin/gxcInvoice/submit
headers下token必传 然后 Accept = application/json
请求参数
参数名 参数类型 必传 缺省值 描述
vid int Y 商户id
gxc_id int Y 仓库id
items array Y 勾选的未开票数组
voucher string Y 开票凭据图片
返回值
请求参数示例:
{
    "vid": 18,
    "gxc_id": 11,
    "items": [
        {
            "year_month": "2025-07"
        },
        {
            "year_month": "2025-08"
        }
    ],
    "voucher": "/path/to/invoice.pdf"
}

请求成功返回:
{
    "status": 200,
    "msg": "开票成功",
    "data": {
        "id": 1,
        "gxc_id": 11,
        "vid": 18,
        "price": 3458.99,
        "start_date": "2025-07-01",
        "end_date": "2025-08-31"
    }
}
最后修改者: huangyingliang  2025-11-25 09:58:38 

删除已开票

编号  :  003

POST - https://fl.tp6.hyj111.cn/admin/gxcInvoice/delete
headers下token必传 然后 Accept = application/json
请求参数
参数名 参数类型 必传 缺省值 描述
ids array Y 要删除的集合 例如 [1,2,3] 如果只删除一个 则是 [1]
返回值
{
    "status": 200,
    "msg": "删除成功"
}