付款申請變數

文件樣板中加入本文的變數,即可從系統中的付款申請填入值。例如可加入付款申請的編號、描述或原始合約值。

本文內容:

進一步瞭解:


常見用例和範例

在深入研究完整的變數參考之前,請查看以下最常見情境的實際範例:

付款申請標頭

為您的付款申請文件建立專業標題:

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}{action}

{/approvalHistories}

傳回在核准工作流程步驟中執行的動作。 字串
{#approvalHistories.stepName}

例如:
{#approvalHistories}{stepName}

{/approvalHistories}

傳回核准歷程中的工作流程步驟名稱。 字串
{#approvalHistories.operator.name}

例如:
{#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}{number}

{/payment.columnView.items}

傳回付款申請的明細項編號。 字串
{#payment.columnView.items.name}

例如:
{#payment.columnView.items}{name}

{/payment.columnView.items}

傳回付款申請的明細項名稱。 字串
{#payment.columnView.items.originalQuantity}

例如:
{#payment.columnView.items}{originalQuantity}

{/payment.columnView.items}

傳回付款申請的明細項原始數量。 數字
{#payment.columnView.items.unit}

例如:
{#payment.columnView.items}{unit}

{/payment.columnView.items}

傳回付款申請的明細項單位。 字串
{#payment.columnView.items.originalUnitPrice}

例如:
{#payment.columnView.items}{originalUnitPrice}

{/payment.columnView.items}

傳回付款申請的明細項原始單價。 數字
{#payment.columnView.items.originalAmount}

例如:
{#payment.columnView.items}{originalAmount}

{/payment.columnView.items}

傳回付款申請值的明細項原始排程。 數字
{#payment.columnView.items.changeOrders}

例如:
{#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}{revisedValue}

{/payment.columnView.items}

傳回付款申請的修訂值明細項。 數字
{#payment.columnView.items.previousQuantity}

例如:
{#payment.columnView.items}{previousQuantity}

{/payment.columnView.items}

傳回前次付款申請的明細項數量。 數字
{#payment.columnView.items.previousAmount}

例如:
{#payment.columnView.items}{previousAmount}

{/payment.columnView.items}

傳回前次付款申請的工作完成值明細項。 數字
{#payment.columnView.items.quantity}

例如:
{#payment.columnView.items}{quantity}

{/payment.columnView.items}

傳回目前付款申請的明細項數量。 數字
{#payment.columnView.items.amount}

例如:
{#payment.columnView.items}{amount}

{/payment.columnView.items}

傳回目前付款申請的工作完成值明細項。 數字
{#payment.columnView.items.materialsOnStoreQuantity}

例如:
{#payment.columnView.items}{materialsOnStoreQuantity}

{/payment.columnView.items}

傳回付款申請的已儲存材料值明細項數量。 數字
{#payment.columnView.items.materialsOnStoreUnitPrice}

例如:
{#payment.columnView.items}{materialsOnStoreUnitPrice}

{/payment.columnView.items}

傳回付款申請的已儲存材料值明細項單價。 數字
{#payment.columnView.items.materialsStored}

例如:
{#payment.columnView.items}{materialsStored}

{/payment.columnView.items}

傳回付款申請的已儲存材料值明細項。 數字
{#payment.columnView.items.completed}

例如:
{#payment.columnView.items}{completed}

{/payment.columnView.items}

傳回付款申請的明細項總完成值,包括工作完成值和現場材料值。 數字
{#payment.columnView.items.percentCompleted}

例如:
{#payment.columnView.items}{percentCompleted}

{/payment.columnView.items}

傳回付款申請的明細項總完成百分比。 數字
{#payment.columnView.items.balanceToFinish}

例如:
{#payment.columnView.items}{balanceToFinish}

{/payment.columnView.items}

傳回付款申請的待完成結餘值明細項。 數字
{#payment.columnView.items.retainage}

例如:
{#payment.columnView.items}{retainage}

{/payment.columnView.items}

傳回付款申請的明細項保留值。 數字
{#payment.columnView.items.completedWorkRetentionPercent}

例如:
{#payment.columnView.items}{completedWorkRetentionPercent}

{/payment.columnView.items}

傳回付款申請中已完成工作的明細項保留百分比。 數字
{#payment.columnView.items.materialsOnStoreRetentionPercent}

例如:
{#payment.columnView.items}{materialsOnStoreRetentionPercent}

{/payment.columnView.items}

傳回付款申請中已儲存材料的明細項保留百分比。 數字
{#payment.columnView.items.completedWorkReleased}

例如:
{#payment.columnView.items}{completedWorkReleased}

{/payment.columnView.items}

傳回付款申請中已完成工作的已發佈保留值明細項。 數字
{#payment.columnView.items.materialsOnStoreReleased}

例如:
{#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} 傳回預算轉移的單價。 數字