用途:面向建筑工程的付款申请(Pay Application)处理流程,覆盖从创建、提交、审核到批准与付款记录的完整链路,并可生成 AIA G702/G703 表单数据。
主要能力:维护工程量清单(Schedule of Values,SOV)及行项;按行项录入本期完成额与已存材料,或按完成百分比反算本期完成额;自动计算完成百分比、待完成余额、保留金以及本期应付净额;登记已批准变更单并作为新 SOV 行项纳入合同额;跨多期付款申请结转上期完成额与上期已签发证书金额;管理草稿、已提交、审核中、已批准、已驳回、已付、部分付款等状态;记录批准金额与实际付款;生成 G702 数据对象与 G703 续表文本表格。
使用方式:以 Python 数据类实现。核心类 PaymentApplicationProcessor,需传入项目名、承包商、原始合同额;用 add_sov_item 或 import_sov 建立工程量清单;用 add_change_order 登记变更;用 create_pay_app(period_from, period_to) 创建某期申请;用 update_line_item 或 update_by_percentage 更新进度;用 set_retainage_rates 设置施工与已存材料保留金比例(默认均为 10%);再依次调用 submit_pay_app、approve_pay_app、record_payment 推进状态;最后用 generate_g702 与 generate_g703 输出表单数据。
适用场景:施工总承包或分包方的进度款申请编制与复核、保留金与累计开票金额核对、按 AIA 格式整理付款证书与续表。
限制:资料仅给出上述 Python 实现与字段定义,未提供安装方式、运行环境要求、依赖库、导出 PDF/Excel 能力、税费与其他扣款处理、多合同或多家承包商并行,以及数据持久化说明;具体要求暂未提供。所有金额计算逻辑以资料中的公式为准。