在文件樣板中加入本文的變數,即可從系統中的付款申請填入值。例如可加入付款申請的編號、描述或原始合約值。
本文內容:
進一步瞭解:
在深入研究完整的變數參考之前,請查看以下最常見情境的實際範例:
為您的付款申請文件建立專業標題:
PAYMENT APPLICATION #{payment.number}
Contractor: {payment.supplier}
Project: {payment.name}
Billing Period: {payment.startDate | date: "%B %d, %Y"} to {payment.endDate | date: "%B %d, %Y"}
最終何人於何時核准何事,以符合檢核需求:
APPROVAL HISTORY:
{#approvalHistories}
• {stepName}: {action} by {operator.name}
{/approvalHistories}
一目了然地顯示關鍵財務總計:
Original Contract Amount: {payment.contractAmount | currency}
Total Change Orders: {payment.totalApprovedChangeOrders | currency}
Contract Sum to Date: {payment.contractSumToDate | currency}
Current Payment Due: {payment.currentPayment | currency}
Balance to Finish: {payment.balanceToFinish | currency}
為已完成的工作產生詳細的行項:
{#payment.columnView.items}
{number} | {name} | {originalAmount | currency} | {amount | currency} | {percentCompleted}%
{/payment.columnView.items}
TOTALS:
Work Completed: {payment.columnView.totalAmount | currency}
Materials Stored: {payment.columnView.totalMaterialsStored | currency}
Total Retention: {payment.columnView.totalRetainage | currency}
顯示上一個付款申請以來的進度:
Previous Payment #{previousPayment.number}: {payment.previousPayment | currency}
Current Period Work: {payment.currentPayment | currency}
Total Earned to Date: {payment.totalEarned | currency}
啟用「已計費的材料」設定後,追蹤交付到施工現場的材料:
Materials Delivered This Period: ${payment.lineView.materialsBilled | currency}
Materials Delivered Previously: ${payment.lineView.previousMaterialsBilled | currency}
Total Materials Delivered: ${payment.lineView.materials | currency}
Calculation: {payment.lineView.materials} = {payment.lineView.previousMaterialsBilled} + {payment.lineView.materialsBilled}
這樣就無需使用先前可用的 totalMaterialsStored 變數手動計算總計。
將正向變更命令與負向變更命令分隔到不同的欄:
CHANGE ORDER SUMMARY
Additions Deductions
Previous Periods: {payment.approvedChangeOrderAdditionsInPreviousPeriod | currency} {payment.approvedChangeOrderDeductionsInPreviousPeriod | currency}
This Period: {payment.approvedChangeOrderAdditionsThisPeriod | currency} {payment.approvedChangeOrderDeductionsThisPeriod | currency}
TOTALS: {payment.totalApprovedChangeOrderAdditions | currency} {payment.totalApprovedChangeOrderDeductions | currency}
Net Change Orders: {payment.totalApprovedChangeOrders | currency}
供應商特定值
您可以在任何付款申請變數之前輸入 contract.supplier.,以傳回特定於供應商的值。
範例:{contract.supplier.payment.currentPayment}
工作表相容性
工作表無法支援 Rich Text 變數。在工作表中使用變數時,請移除「@」符號。
請勿使用:{@pco.scopeOfWork}
而應使用: {pco.scopeOfWork}
行模式與欄模式
如果您在付款申請中使用行模式 (將變更命令展示為行項),請將變數中的 lineView 取代為 columnView。
欄模式:{payment.columnView.totalAmount}
行模式:{payment.lineView.totalAmount}
變更命令增加/扣除變數
這些變數不支援內嵌模式,需要經過完全核准的變更命令以確保準確性。
使用表格頂部的搜尋來縮小結果範圍。變數依品類組織,以便於導覽。
| 變數 | 描述 | 類型 |
| 基本資訊 | ||
| {payment.number} | 傳回付款申請編號。 | 字串 |
| {payment.name} | 傳回付款申請名稱。 | 字串 |
| {payment.description} | 傳回付款申請描述。 | 字串 |
| {payment.supplier} | 傳回供應商的公司。 | 字串 |
| {payment.owner} | 傳回擁有者的公司。 | 字串 |
| {payment.architect} | 傳回建築師的公司。 | 字串 |
| {@payment.note} | 傳回付款申請備註。 | RichText |
| 核准工作流程 | ||
| {#approvalHistories} 和 {/approvalHistories} | 傳回付款申請的核准歷程詳細資料,包括已執行的動作、工作流程步驟名稱和操作員姓名。 同時使用 {#approvalHistories} 和 {/approvalHistories}。 |
陣列 |
| {#approvalHistories.action} 例如: {/approvalHistories} |
傳回在核准工作流程步驟中執行的動作。 | 字串 |
| {#approvalHistories.stepName} 例如: {/approvalHistories} |
傳回核准歷程中的工作流程步驟名稱。 | 字串 |
| {#approvalHistories.operator.name} 例如: {/approvalHistories} |
傳回執行核准動作的操作員姓名。 | 字串 |
| 日期與時間表 | ||
| {payment.startDate} | 傳回付款申請計費期間的開始日期。 | 日期 |
| {payment.endDate} | 傳回付款申請計費期間的結束日期。 | 日期 |
| {payment.createdAt} | 傳回付款申請的建立日期。 | 日期 |
| {payment.submittedAt} | 傳回付款申請的提交日期。 | 日期 |
| {payment.revisedAt} | 傳回付款申請的修訂日期。 | 日期 |
| {payment.updatedAt} | 傳回付款申請的更新日期。 | 日期 |
| 核心財務總額 | ||
| {payment.contractAmount} | 傳回付款申請的原始合約值。 | 數字 |
| {payment.contractSumToDate} | 傳回迄今合約總額。 | 數字 |
| {payment.totalCompletedAndStored} | 傳回目前已完成和儲存材料的所有工作。 | 數字 |
| {payment.totalEarned} | 傳回總收入減去保留額的值。 | 數字 |
| {payment.previousPayment} 例如: {#payment.previousPayment == ""} {/} {#payment.previousPayment < 0} ({payment.previousPayment | multiply: -1}) {/} |
傳回前次付款申請的總收入減去保留額的值。 | 數字 |
| {payment.currentPayment} | 傳回目前的付款到期日。 | 數字 |
| {payment.balanceToFinish} | 傳回要完成的餘額,包括保留額。 | 數字 |
| 保留額 | ||
| {payment.completedWorkRetentionPercent} | 傳回目前已完成和儲存材料的所有工作百分比。 | 數字 |
| {payment.completedWorkRetention} | 傳回已完成工作的保留量。 | 數字 |
| {payment.materialsOnStoreRetentionPercent} | 傳回現場材料的保留百分比。 | 百分比 |
| {payment.materialsOnStoreRetention} | 傳回現場保留的材料數量。 | 數字 |
| {payment.allTotalRetainage} | 傳回總保留量。 | 數字 |
| {payment.previousCompletedWorkRetained} | 傳回先前付款申請中已完成工作的保留金額。 | 數字 |
| {payment.previousMaterialsRetained} | 傳回先前付款申請中已儲存材料的保留金額。 | 數字 |
| {payment.currentCompletedWorkRetention} | 傳回已完成工作的目前期間保留金額。 | 數字 |
| {payment.currentMaterialsRetention} | 傳回已儲存材料的目前期間保留金額。 | 數字 |
| {payment.thisPeriodRetainage} | 傳回目前付款的總保留額減去前次付款的保留額。 | 數字 |
| 變更命令 | ||
| {payment.approvedInPreviousPeriod} | 傳回前段時間內核准的變更總數。 | 數字 |
| {payment.approvedThisPeriod} | 傳回此期間的變更總數。 | 數字 |
| {payment.totalApprovedChangeOrders} | 傳回變更命令的淨變更。 | 數字 |
| {payment.approvedChangeOrderAdditionsInPreviousPeriod} | 傳回先前期間核准的變更命令增加總額。 | 數字 |
| {payment.approvedChangeOrderDeductionsInPreviousPeriod} | 傳回先前期間核准的變更命令扣除總額。 | 數字 |
| {payment.approvedChangeOrderAdditionsThisPeriod} | 傳回此期間核准的變更命令增加額。 | 數字 |
| {payment.approvedChangeOrderDeductionsThisPeriod} | 傳回此期間核准的變更命令扣除額。 | 數字 |
| {payment.totalApprovedChangeOrderAdditions} | 傳回所有期間內核准的變更命令增加總額。 | 數字 |
| {payment.totalApprovedChangeOrderDeductions} | 傳回所有期間內核准的變更命令扣除總額。 | 數字 |
| 行項詳細資料 | ||
| {#payment.columnView.items}和{/payment.columnView.items} | 當 OCO 顯示為欄時,傳回付款申請的項目詳細資訊。 將{#payment.columnView.items}和{/payment.columnView.items}一起使用。 |
陣列 |
| {#payment.columnView.items.number} 例如: {/payment.columnView.items} |
傳回付款申請的明細項編號。 | 字串 |
| {#payment.columnView.items.name} 例如: {/payment.columnView.items} |
傳回付款申請的明細項名稱。 | 字串 |
| {#payment.columnView.items.originalQuantity} 例如: {/payment.columnView.items} |
傳回付款申請的明細項原始數量。 | 數字 |
| {#payment.columnView.items.unit} 例如: {/payment.columnView.items} |
傳回付款申請的明細項單位。 | 字串 |
| {#payment.columnView.items.originalUnitPrice} 例如: {/payment.columnView.items} |
傳回付款申請的明細項原始單價。 | 數字 |
| {#payment.columnView.items.originalAmount} 例如: {/payment.columnView.items} |
傳回付款申請值的明細項原始排程。 | 數字 |
| {#payment.columnView.items.changeOrders} 例如: {/payment.columnView.items} |
傳回付款申請的變更命令值明細項。 | 數字 |
| {#payment.columnView.changeOrderQuantity} | 傳回變更命令的數量。 | 數字 |
| {#payment.columnView.items.revisedQuantity} 例如: {#payment.columnView.items}{revisedQuantity} {/payment.columnView.items} |
傳回付款申請的明細項修訂數量。 | 數字 |
| {#payment.columnView.items.revisedValue} 例如: {/payment.columnView.items} |
傳回付款申請的修訂值明細項。 | 數字 |
| {#payment.columnView.items.previousQuantity} 例如: {/payment.columnView.items} |
傳回前次付款申請的明細項數量。 | 數字 |
| {#payment.columnView.items.previousAmount} 例如: {/payment.columnView.items} |
傳回前次付款申請的工作完成值明細項。 | 數字 |
| {#payment.columnView.items.quantity} 例如: {/payment.columnView.items} |
傳回目前付款申請的明細項數量。 | 數字 |
| {#payment.columnView.items.amount} 例如: {/payment.columnView.items} |
傳回目前付款申請的工作完成值明細項。 | 數字 |
| {#payment.columnView.items.materialsOnStoreQuantity} 例如: {/payment.columnView.items} |
傳回付款申請的已儲存材料值明細項數量。 | 數字 |
| {#payment.columnView.items.materialsOnStoreUnitPrice} 例如: {/payment.columnView.items} |
傳回付款申請的已儲存材料值明細項單價。 | 數字 |
| {#payment.columnView.items.materialsStored} 例如: {/payment.columnView.items} |
傳回付款申請的已儲存材料值明細項。 | 數字 |
| {#payment.columnView.items.completed} 例如: {/payment.columnView.items} |
傳回付款申請的明細項總完成值,包括工作完成值和現場材料值。 | 數字 |
| {#payment.columnView.items.percentCompleted} 例如: {/payment.columnView.items} |
傳回付款申請的明細項總完成百分比。 | 數字 |
| {#payment.columnView.items.balanceToFinish} 例如: {/payment.columnView.items} |
傳回付款申請的待完成結餘值明細項。 | 數字 |
| {#payment.columnView.items.retainage} 例如: {/payment.columnView.items} |
傳回付款申請的明細項保留值。 | 數字 |
| {#payment.columnView.items.completedWorkRetentionPercent} 例如: {/payment.columnView.items} |
傳回付款申請中已完成工作的明細項保留百分比。 | 數字 |
| {#payment.columnView.items.materialsOnStoreRetentionPercent} 例如: {/payment.columnView.items} |
傳回付款申請中已儲存材料的明細項保留百分比。 | 數字 |
| {#payment.columnView.items.completedWorkReleased} 例如: {/payment.columnView.items} |
傳回付款申請中已完成工作的已發佈保留值明細項。 | 數字 |
| {#payment.columnView.items.materialsOnStoreReleased} 例如: {/payment.columnView.items} |
傳回付款申請中已儲存材料的已發佈保留值明細項。 | 數字 |
| {payment.columnView.totalOriginalAmount} | 傳回付款申請的原始進價進度表總值,包括合約金額、預算轉移和變更命令。 | 數字 |
| {approvedBudgetTransfers} | 已核准的預算轉移:已核准的預算轉移總數。 | 數字 |
| {previousApprovedBudgetTransfers} | 先前核准的預算轉移:先前期間中所有已核准預算轉移的金額。 | 數字 |
| {approvedThisPeriodBudgetTransfers} | 此期間核准的預算轉移:此期間加入的已核准預算轉移的金額。 | 數字 |
| {totalBudgetTransfers} | 預算轉移總數:預算轉移總數。 | 數字 |
| {budgetTransfers} | 預算轉移:預算轉移數量。 | 數字 |
| {budgetTransfersQuantity} | 預算轉移數量:預算轉移的數量。 | 數字 |
| {budgetTransfersUnit} | 預算轉移單位:預算轉移的度量單位。 | 字串 |
| {budgetTransfersUnitPrice} | 預算轉移單價:預算轉移的單價。 | 數字 |
| {payment.columnView.totalChangeOrders} | 傳回付款申請的總計已核准變更命令值。 | 數字 |
| {payment.columnView.totalRevisedValue} | 傳回付款申請的總計修訂值。 | 數字 |
| {payment.columnView.totalPreviousAmount} | 傳回前次付款申請的總計工作完成值。 | 數字 |
| {payment.columnView.totalAmount} | 傳回目前付款申請的總計工作完成值。 | 數字 |
| {payment.columnView.totalMaterialsStored} | 傳回付款申請的總計現場材料值。 | 數字 |
| {previousMaterialsOnStore} | 傳回所有先前申請的已儲存材料金額。 | 數字 |
| {previousClaimedAmount} | 傳回先前申請的索賠金額。 | 數字 |
| {claimedAmount} | 傳回此期間所完成工作的索賠金額。 | 數字 |
| {claimedWorkCompleted} | 傳回已完成所有工作的索賠金額。 | 數字 |
| {payment.columnView.totalCompleted} | 傳回付款申請的總完成值,包括已儲存材料值。 | 數字 |
| {payment.columnView.percentTotalCompleted} | 傳回付款申請的總完成百分比,包括已儲存材料值。 | 數字 |
| {payment.columnView.totalBalanceToFinish} | 傳回付款申請的總計待完成結餘值。 | 數字 |
| {payment.columnView.totalRetainage} | 傳回付款申請的總計保留值。 | 數字 |
| {payment.thisPeriodRetainage} | 傳回目前付款的總保留額減去前次付款的保留額。 | 數字 |
| {#committedSubItems}{value}{/committedSubItems} | 傳回成本項目子項目的已確定金額。 | 數字 |
| {#committedSubItems}{unitPrice}{/committedSubItems} | 傳回成本項目子項目的已確定單價。 | 數字 |
| {latestComment.content} | 傳回每行的最新審閱註解。 | 數字 |
| {this.costItem.corNumber} | 傳回連結至成本項目的變更命令資訊。除了 corNumber 以外,您也可以寫入 ocoNumber、scoNumber、scoType、coType、ocoType、coType、corName、ocoName 或 scoName,以包含所需資訊。 | 數字 |
| {materialsBilled} 例如: {payment.columnView.materialsBilled} |
如果啟用了「已計費的材料」設定,則傳回已計費的材料金額。進一步瞭解付款申請中的材料。 | 數字 |
| {previousMaterialsBilled} 例如: {payment.columnView.previousMaterialsBilled} |
如果啟用了「已計費的材料」設定,則傳回上次申請中的已計費材料金額。進一步瞭解付款申請中的材料。 | 數字 |
| {payment.lineView.materials} 例如: {payment.lineView.materials} |
如果啟用了「已計費的材料」設定,此變數會傳回每個行項的已計費材料總額,其計算方式為:previousMaterialsBilled + materialsBilled (當期)。這提供了一個變數來獲取累計已計費材料金額。進一步瞭解付款申請中的材料。 | 數字 |
| {previousAmount | add: previousMaterialsBilled} | 如果啟用了「已計費的材料」設定,則傳回上一個已完成工作和已計費材料的總和。進一步瞭解付款申請中的材料。 | 數字 |
| {payment.columnView.totalPreviousAmount | add:payment.columnView.previousMaterialsBilled} | 如果啟用了「已計費的材料」設定,則該變數提供先前已完成工作和已計費材料的總數。進一步瞭解付款申請中的材料。 | 數字 |
| {totalAdvanceAmount} | 所有期間的預付款總額。 | 數字 |
| {totalAdvancePercent} | 所有期間的預付款百分比。 | 數字 |
| {totalRecoupmentAmount} | 所有期間的扣除總額。 | 數字 |
| {totalRecoupmentPercentOfAdvance} | 此期間的扣除百分比。 | 數字 |
| {advanceAmount} | 此期間的預付款金額。 | 數字 |
| {advancePercent} | 此期間的預付款百分比。 | 數字 |
| {recoupmentAmount} | 此期間的扣除金額。 | 數字 |
| {recoupmentPercentOfCompletedWork} | 已完成工作的扣除百分比。 | 數字 |
| {previousAdvanceAmount} | 此期間內已完成工作的扣除百分比。 | 數字 |
| {previousRecoupmentAmount} | 上次扣除金額。 | 數字 |
| {previousAdvanceAmountForeignCurrency} | {previousAdvanceAmount}的外幣值。 | 數字 |
| {previousRecoupmentAmountForeignCurrency} | {previousRecoupmentAmount}的外幣值。 | 數字 |
| {payment.columnView.totalOriginalAmount} | 傳回付款申請的原始進價進度表總值,包括合約金額、預算轉移和變更命令。 | 數字 |
| {approvedBudgetTransfers} | 傳回已核准的預算轉移總數。 | 數字 |
| {previousApprovedBudgetTransfers} | 傳回先前期間中所有已核准預算轉移的金額。 | 數字 |
| {approvedThisPeriodBudgetTransfers} | 傳回此期間加入的已核准預算轉移的金額。 | 數字 |
| {totalBudgetTransfers} | 傳回預算轉移的總數。 | 數字 |
| {budgetTransfers} | 返回預算轉移的次數。 | 數字 |
| {budgetTransfersQuantity} | 傳回預算轉移數量。 | 數字 |
| {budgetTransfersUnit} | 傳回預算轉移的度量單位。 | 字串 |
| {budgetTransfersUnitPrice} | 傳回預算轉移的單價。 | 數字 |