编辑已完成预付款付款申请单

编号  :  007

请求参数

返回值

{
    "status": 200,
    "msg": "编辑已完成预付款付款申请单成功",
    "data": {
        "id": 1,
        "status": "completed",
        "status_name": "已完成"
    }
}

备注

仅admin_name=13817813691且申请单状态为completed时允许操作；申请单状态保持completed，更新申请单凭证和摘要；关联预付款单存在时，同步更新预付款单摘要、预付款凭证图片和对应日记账流水。

作废预付款付款申请单

编号  :  006

请求参数

返回值

{
    "status": 200,
    "msg": "作废预付款付款申请单成功"
}

备注

只允许作废status=pending_review或pending_payment的预付款付款申请单。作废不需要填写驳回理由，数据库状态仍写为rejected，驳回理由字段写为空字符串，并记录操作人和操作时间。id和ids二选一，支持单个或批量作废，批量作废时任意一条不满足条件则整体失败回滚。

财务确认预付款付款申请单打款

编号  :  005

请求参数

返回值

{
    "status": 200,
    "msg": "预付款付款申请单打款完成",
    "data": {
        "id": 1,
        "payment_advance_id": 1001,
        "status": "completed",
        "status_name": "已完成"
    }
}

备注

仅status=pending_payment的预付款付款申请单可以确认打款。确认后状态改为completed，并复用预付款单新增逻辑生成bbc_payment_advance、bbc_payment_advance_image；符合期初建账和2026-06-23同步条件的银行卡会按预付款单逻辑生成日记账银行卡流水。

老板审核预付款付款申请单

编号  :  004

请求参数

返回值

{
    "status": 200,
    "msg": "预付款付款申请单审核成功",
    "data": {
        "next_review_payment_advance_request_id": 6,
        "payment_advance_ids": []
    }
}

备注

仅status=pending_review的预付款付款申请单可以审核。action=approve时状态改为pending_payment，不需要传付款凭证和摘要；action=reject时状态写为rejected并记录驳回原因、审核人、审核时间。单个审核通过或驳回时返回下一个待审核预付款付款申请单ID。下一个待审核预付款付款申请单ID会按当前申请单platform_type继续过滤，平台单只返回平台待审核单，第三方单只返回第三方待审核单。

编辑预付款付款申请单

编号  :  003

请求参数

返回值

{
    "status": 200,
    "msg": "编辑预付款付款申请单成功",
    "data": {
        "id": 1,
        "request_no": "PAR202607201200001234",
        "status": "pending_review",
        "status_name": "待审核"
    }
}

备注

只允许编辑待审核的预付款付款申请单；可编辑商户收款银行卡和预付金额，保存时刷新商户收款信息快照。

添加预付款付款申请单

编号  :  002

请求参数

返回值

{
    "status": 200,
    "msg": "添加预付款付款申请单成功",
    "data": {
        "id": 1,
        "request_no": "PAR202607201200001234",
        "status": "pending_review",
        "status_name": "待审核"
    }
}

备注

新增后只生成预付款付款申请单，状态为pending_review。预付款付款申请单保存商户收款信息快照。无需选择或勾选剩余应付年月。老板审核通过后进入pending_payment，财务确认打款后复用预付款单新增逻辑生成预付款单。

预付款付款申请单列表

编号  :  001

请求参数

返回值

{
    "status": 200,
    "msg": "获取预付款付款申请单列表成功",
    "data": {
        "total": 1,
        "per_page": 10,
        "current_page": 1,
        "last_page": 1,
        "data": [
            {
                "id": 1,
                "request_no": "PAR202607201200001234",
                "status": "pending_review",
                "status_name": "待审核",
                "platform_type": "platform",
                "company_info_id": 1,
                "company_name": "南通飞驴网络科技有限公司",
                "company_short_name": "飞驴",
                "company_info_bank_id": 1,
                "payment_account_name": "南通飞驴网络科技有限公司",
                "payment_account": "8888 8883 7102 6715",
                "payment_bank_name": "浙江网商银行",
                "vid": 18,
                "store_name": "测试商户",
                "vendor_account_number_id": 2,
                "vendor_payee_company_name": "测试商户收款公司",
                "vendor_collection_account": "6222 0000 0000 0000",
                "vendor_collection_bank_name": "测试银行",
                "payment_price": "10000.00",
                "payment_date": "2026-07-20",
                "remark": "",
                "voucher_image": [],
                "reject_reason": "",
                "payment_advance_id": 0,
                "can_edit_completed_payment": false,
                "created_at": "2026-07-20 12:00:00"
            }
        ],
        "status_options": {
            "pending_review": "待审核",
            "pending_payment": "待打款",
            "completed": "已完成",
            "rejected": "驳回"
        }
    }
}

备注

返回预付款付款申请单分页列表。status为字符串枚举：pending_review=待审核，pending_payment=待打款，completed=已完成，rejected=驳回。老板审核通过后进入pending_payment，财务确认打款后才生成预付款单并写为completed。每条数据的can_edit_completed_payment表示当前账号是否可以编辑该已完成申请单的付款凭证和摘要。