编辑已完成付款申请单

编号  :  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": 7, // 付款申请单ID
        "request_no": "PR202607181404398036", // 付款申请单号
        "status": "pending_review", // 状态
        "status_name": "待审核" // 状态名称
    }
}

备注

只允许编辑待审核的付款申请单。可编辑内容限定为商户收款信息、商户收款银行卡号、付款金额；服务端根据付款申请单原商户ID校验商户收款银行卡属于该商户且state=1，并同步更新vendor_account_number_id、vendor_payee_company_name、vendor_collection_account、vendor_collection_bank_name。付款金额修改后会按原冲抵明细重新计算strike_amount，其他字段不允许修改。

财务确认付款申请单打款

编号  :  004

请求参数

返回值

{
    "status": 200,
    "msg": "付款申请单打款完成",
    "data": {
        "id": 1, // 付款申请单ID
        "payment_order_id": 1001, // 生成的付款单ID
        "status": "completed", // 完成状态
        "status_name": "已完成" // 完成状态名称
    }
}

备注

仅status=pending_payment的付款申请单可以确认打款。确认后状态改为completed，并生成付款单、付款单图片、冲抵明细；付款单生成成功后调用付款单日记账同步逻辑，符合期初建账和2026-06-23同步条件的银行卡会生成支出流水。

老板审核付款申请单

编号  :  003

请求参数

返回值

{
    "status": 200,
    "msg": "付款申请单审核成功",
    "data": {
        "next_review_payment_request_id": 6 // 下一个待审核付款申请单ID；没有则为0
    }
}

备注

支持单个或批量审核，id和ids二选一。仅status=pending_review的付款申请单可以审核，批量审核时任意一条不满足条件则整体失败回滚。action=approve时状态改为pending_payment；action=reject时状态改为rejected并记录驳回原因、审核人、审核时间。单个审核通过或驳回时返回下一个待审核付款申请单ID；按付款申请单列表id倒序取当前单据之后的下一条；下一个待审核付款申请单ID会按当前申请单platform_type继续过滤，平台单只返回平台待审核单，第三方单只返回第三方待审核单；没有下一条则返回0。批量审核返回0。

添加付款申请单

编号  :  002

请求参数

返回值

{
    "status": 200,
    "msg": "添加付款申请单成功",
    "data": {
        "id": 1, // 付款申请单ID
        "request_no": "PR202607141200001234", // 付款申请单号
        "status": "pending_review", // 初始状态
        "status_name": "待审核" // 初始状态名称
    }
}

备注

新增后只生成付款申请单，状态为pending_review，不生成付款单。老板审核通过后进入pending_payment，财务确认打款时才生成bbc_payment_order、bbc_payment_strike_detail、bbc_payment_order_image，并按付款单逻辑同步日记账银行卡流水。

付款申请单列表

编号  :  001

请求参数

返回值

{
    "status": 200,
    "msg": "获取付款申请单列表成功",
    "data": {
        "total": 1, // 总条数
        "per_page": 10, // 每页条数
        "current_page": 1, // 当前页
        "last_page": 1, // 最后一页
        "data": [
            {
                "id": 1, // 付款申请单ID
                "request_no": "PR202607141200001234", // 付款申请单号
                "status": "pending_review", // 状态字符串
                "status_name": "待审核", // 状态名称
                "platform_type": "platform", // 平台类型
                "company_info_id": 1, // 付款主体ID
                "company_name": "南通智化慧仓科技有限公司", // 付款主体名称
                "company_info_bank_id": 1, // 付款账号ID
                "payment_account_name": "南通飞驴网络科技有限公司", // 付款账号名称
                "payment_account": "8888 8883 7102 6715", // 付款账号
                "payment_bank_name": "浙江网商银行", // 付款开户行
                "vid": 18, // 商户ID
                "store_name": "测试商户", // 商户名称
                "vendor_account_number_id": 2, // 商户收款账号ID
                "vendor_payee_company_name": "王华仔", // 商户收款方公司
                "vendor_collection_account": "622439380002049532", // 商户收款账号
                "vendor_collection_bank_name": "广州农商银行", // 商户收款开户行
                "total_remaining_payable": "120000.00", // 剩余总应付
                "payment_price": "15000.00", // 付款金额
                "payment_date": "2026-07-14", // 付款日期
                "type": 0, // 冲账类型
                "deduct_company_id": 1, // 应付款冲抵主体
                "strike_details": [], // 冲抵明细
                "remark": "", // 摘要
                "voucher_image": [], // 财务付款凭证
                "payment_order_id": 0, // 生成的付款单ID
                "can_edit_completed_payment": false, // 是否可编辑已完成申请单凭证和摘要
                "created_at": "2026-07-14 12:00:00" // 创建时间
            }
        ],
        "status_options": {
            "pending_review": "待审核",
            "pending_payment": "待打款",
            "completed": "已完成",
            "rejected": "驳回"
        }
    }
}

备注

返回付款申请单分页列表。status为字符串枚举：pending_review=待审核，pending_payment=待打款，completed=已完成，rejected=驳回。data.status_options会返回状态枚举文本。列表每行返回total_remaining_payable=剩余总应付：口径同 vendorPayableSummary/totalRemaining 返回的 total_remaining_payable；平台为2026年前期初剩余应付 + 大于等于2026年月度账单剩余总应付，月度账单剩余总应付=已对账应付+未对账金额-本年剩余预付款；第三方无期初，对应 douyinMonthlyBill 的 all_carry_over_price。每条数据的can_edit_completed_payment表示当前账号是否可以编辑该已完成申请单的付款凭证和摘要。