Includere le variabili di questo articolo in un template di documento per compilare i valori della richiesto di pagamento nel sistema. Ad esempio, è possibile aggiungere il numero, la descrizione o il valore del contratto originale della richiesta di pagamento.
In questo articolo:
Per ulteriori informazioni su come:
Prima di immergersi nel riferimento completo alle variabili, ecco alcuni esempi pratici per gli scenari più comuni:
Creare un'intestazione professionale per i documenti di richiesta di pagamento:
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"}
Tracciare chi ha approvato cosa e quando per i requisiti di verifica:
APPROVAL HISTORY:
{#approvalHistories}
• {stepName}: {action} by {operator.name}
{/approvalHistories}
Visualizzare i principali totali finanziari a colpo d'occhio:
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}
Generare voci dettagliate per il lavoro completato:
{#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}
Mostrare i progressi rispetto alla precedente richiesta di pagamento:
Previous Payment #{previousPayment.number}: {payment.previousPayment | currency}
Current Period Work: {payment.currentPayment | currency}
Total Earned to Date: {payment.totalEarned | currency}
Quando l'impostazione Materiali fatturati è abilitata, è possibile tenere traccia dei materiali consegnati al cantiere:
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}
Questo sostituisce la necessità di calcolare manualmente i totali utilizzando la variabile totalMaterialsStored disponibile in precedenza.
Separare gli ordini di modifica positivi e negativi in colonne distinte:
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}
Valori specifici del fornitore
È possibile anteporre a qualsiasi variabile della richiesta di pagamento contract.supplier. per restituire valori specifici relativi al fornitore.
Esempio: {contract.supplier.payment.currentPayment}
Compatibilità con i fogli di calcolo
I fogli di calcolo non supportano le variabili Rich Text. Rimuovere il simbolo "@" quando si utilizzano variabili nei fogli di calcolo."
Invece di: {@pco.scopeOfWork}
Utilizzare: {pco.scopeOfWork}
Modalità linea e modalità colonna
Se si utilizza la modalità linea (Mostra gli ordini di modifica come voci) nella richiesta di pagamento, sostituire columnView con lineView nelle variabili.
Modalità colonna: {payment.columnView.totalAmount}
Modalità linea: {payment.lineView.totalAmount}
Variabili di aggiunta/detrazione di ordini di modifica
Queste variabili non supportano la modalità in linea e richiedono ordini di modifica completamente approvati per garantire la precisione.
Utilizzare la ricerca nella parte superiore della tabella per restringere i risultati. Le variabili sono organizzate per categoria per facilitare la navigazione.
| Variabili | Descrizione | Tipo |
| INFORMAZIONI DI BASE | ||
| {payment.number} | Restituisce il numero della richiesta di pagamento. | Stringa |
| {payment.name} | Restituisce il nome della richiesta di pagamento | Stringa |
| {payment.description} | Restituisce la descrizione della richiesta di pagamento. | Stringa |
| {payment.supplier} | Restituisce l'azienda del fornitore. | Stringa |
| {payment.owner} | Restituisce l'azienda del proprietario. | Stringa |
| {payment.architect} | Restituisce l'azienda dell'architetto. | Stringa |
| {@payment.note} | Restituisce la nota relativa alla richiesta di pagamento. | RichText |
| FLUSSO DI LAVORO DI APPROVAZIONE | ||
| {#approvalHistories} e {/approvalHistories} | Restituisce i dettagli della cronologia di approvazione della richiesta di pagamento, compresa l'azione eseguita, il nome della fase del flusso di lavoro e il nome dell'operatore. Utilizzare {#approvalHistories} e {/approvalHistories} together. |
Serie |
| {#approvalHistories.action} Ad esempio: {/approvalHistories} |
Restituisce l'azione eseguita nella fase del flusso di lavoro di approvazione. | Stringa |
| {#approvalHistories.stepName} Ad esempio: {/approvalHistories} |
Restituisce il nome della fase del flusso di lavoro nella cronologia di approvazione. | Stringa |
| {#approvalHistories.operator.name} Ad esempio: {/approvalHistories} |
Restituisce il nome della persona che ha eseguito l'azione di approvazione. | Stringa |
| DATE E TEMPISTICA | ||
| {payment.startDate} | Restituisce la data di inizio del periodo di fatturazione della richiesta di pagamento. | Date |
| {payment.endDate} | Restituisce la data di fine del periodo di fatturazione della richiesta di pagamento. | Date |
| {payment.createdAt} | Restituisce la data di creazione della richiesta di pagamento. | Date |
| {payment.submittedAt} | Restituisce la data di presentazione della richiesta di pagamento. | Date |
| {payment.revisedAt} | Restituisce la data di riesame della domanda di pagamento. | Date |
| {payment.updatedAt} | Restituisce la data di aggiornamento della richiesta di pagamento. | Date |
| TOTALI FINANZIARI D BASE | ||
| {payment.contractAmount} | Restituisce il valore del contratto originale della richiesta di pagamento. | Numero |
| {payment.contractSumToDate} | Restituisce la somma contrattuale corrente. | Numero |
| {payment.totalCompletedAndStored} | Restituisce il lavoro totale completato e il materiale stoccato fino alla data corrente. | Numero |
| {payment.totalEarned} | Restituisce il totale guadagnato meno la ritenuta. | Numero |
| {payment.previousPayment} Ad esempio: {#payment.previousPayment == ""} {/} {#payment.previousPayment < 0} ({payment.previousPayment | multiply: -1}) {/} |
Restituisce il totale guadagnato meno la ritenuta dalla precedente richiesta di pagamento. | Numero |
| {payment.currentPayment} | Restituisce il pagamento corrente in scadenza. | Numero |
| {payment.balanceToFinish} | Restituisce il saldo per completare, inclusa la ritenuta. | Numero |
| RITENZIONE E RINNOVO | ||
| {payment.completedWorkRetentionPercent} | Restituisce la percentuale del lavoro totale completato e del materiale stoccato fino alla data corrente. | Numero |
| {payment.completedWorkRetention} | Restituisce la quantità di ritenzione del lavoro completato. | Numero |
| {payment.materialsOnStoreRetentionPercent} | Restituisce la percentuale di ritenzione dei materiali in loco. | Percentuale |
| {payment.materialsOnStoreRetention} | Restituisce il numero di materiali conservati in loco. | Numero |
| {payment.allTotalRetainage} | Restituisce l'importo totale della ritenzione. | Numero |
| {payment.previousCompletedWorkRetained} | Restituisce l'importo trattenuto dal lavoro completato da precedenti richieste di pagamento. | Numero |
| {payment.previousMaterialsRetained} | Restituisce l'importo trattenuto dai materiali stoccati da precedenti richieste di pagamento. | Numero |
| {payment.currentCompletedWorkRetention} | Restituisce l'importo di ritenzione del periodo corrente per il lavoro completato. | Numero |
| {payment.currentMaterialsRetention} | Restituisce l'importo di ritenzione del periodo corrente per i materiali stoccati. | Numero |
| {payment.thisPeriodRetainage} | Restituisce la ritenuta totale del pagamento corrente meno la ritenuta del pagamento precedente. | Numero |
| ORDINI DI MODIFICA E VARIAZIONI | ||
| {payment.approvedInPreviousPeriod} | Restituisce le variazioni totali approvate nel periodo precedente. | Numero |
| {payment.approvedThisPeriod} | Restituisce le variazioni totali di questo periodo. | Numero |
| {payment.totalApprovedChangeOrders} | Restituisce le modifiche nette per ordine di modifica. | Numero |
| {payment.approvedChangeOrderAdditionsInPreviousPeriod} | Restituisce il totale delle aggiunte approvate per l'ordine di modifica dai periodi precedenti. | Numero |
| {payment.approvedChangeOrderDeductionsInPreviousPeriod} | Restituisce il totale delle detrazioni approvate per l'ordine di modifica dai periodi precedenti. | Numero |
| {payment.approvedChangeOrderAdditionsThisPeriod} | Restituisce le aggiunte approvate per l'ordine di modifica per questo periodo. | Numero |
| {payment.approvedChangeOrderDeductionsThisPeriod} | Restituisce le detrazioni approvate per l'ordine di modifica per questo periodo. | Numero |
| {payment.totalApprovedChangeOrderAdditions} | Restituisce il totale delle aggiunte approvate per l'ordine di modifica approvate in tutti i periodi. | Numero |
| {payment.totalApprovedChangeOrderDeductions} | Restituisce il totale delle detrazioni approvate per l'ordine di modifica in tutti i periodi. | Numero |
| DETTAGLI VOCE | ||
| {#payment.columnView.items} e {/payment.columnView.items} | Restituisce i dettagli della voce della richiesta di pagamento quando gli OCO vengono visualizzati come colonna. Utilizzare {#payment.columnView.items} e {/payment.columnView.items} insieme. |
Serie |
| {#payment.columnView.items.number} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del numero della richiesta di pagamento. | Stringa |
| {#payment.columnView.items.name} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del nome della richiesta di pagamento. | Stringa |
| {#payment.columnView.items.originalQuantity} Ad esempio: {/payment.columnView.items} |
Restituisce la voce della quantità originale della richiesta di pagamento. | Numero |
| {#payment.columnView.items.unit} Ad esempio: {/payment.columnView.items} |
Restituisce la voce dell'unità della richiesta di pagamento. | Stringa |
| {#payment.columnView.items.originalUnitPrice} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del prezzo unitario originale della richiesta di pagamento. | Numero |
| {#payment.columnView.items.originalAmount} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del cronoprogramma originale del valore della richiesta di pagamento. | Numero |
| {#payment.columnView.items.changeOrders} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del valore dell'ordine di modifica della richiesta di pagamento. | Numero |
| {#payment.columnView.changeOrderQuantity} | Restituisce la quantità degli ordini di modifica. | Numero |
| {#payment.columnView.items.revisedQuantity} Ad esempio: {#payment.columnView.items}{revisedQuantity} {/payment.columnView.items} |
Restituisce la voce della quantità riesaminata della richiesta di pagamento. | Numero |
| {#payment.columnView.items.revisedValue} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del valore riesaminato della richiesta di pagamento. | Numero |
| {#payment.columnView.items.previousQuantity} Ad esempio: {/payment.columnView.items} |
Restituisce la voce della quantità della precedente richiesta di pagamento. | Numero |
| {#payment.columnView.items.previousAmount} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del valore del lavoro completato della precedente richiesta di pagamento. | Numero |
| {#payment.columnView.items.quantity} Ad esempio: {/payment.columnView.items} |
Restituisce la voce della quantità della richiesta di pagamento corrente. | Numero |
| {#payment.columnView.items.amount} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del valore del lavoro completato della richiesta di pagamento corrente. | Numero |
| {#payment.columnView.items.materialsOnStoreQuantity} Ad esempio: {/payment.columnView.items} |
Restituisce la quantità di materiali stoccata nella voce della richiesta di pagamento. | Numero |
| {#payment.columnView.items.materialsOnStoreUnitPrice} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del prezzo unitario del materiale stoccato della richiesta di pagamento. | Numero |
| {#payment.columnView.items.materialsStored} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del valore dei materiali stoccati della richiesta di pagamento. | Numero |
| {#payment.columnView.items.completed} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del valore totale completato della richiesta di pagamento, inclusi il valore del lavoro completato e il valore del materiale in loco. | Numero |
| {#payment.columnView.items.percentCompleted} Ad esempio: {/payment.columnView.items} |
Restituisce la voce della percentuale totale completata della richiesta di pagamento. | Numero |
| {#payment.columnView.items.balanceToFinish} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del valore del saldo per completare della richiesta di pagamento. | Numero |
| {#payment.columnView.items.retainage} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del valore di ritenzione della richiesta di pagamento. | Numero |
| {#payment.columnView.items.completedWorkRetentionPercent} Ad esempio: {/payment.columnView.items} |
Restituisce la voce della percentuale di ritenzione del lavoro completato della richiesta di pagamento. | Numero |
| {#payment.columnView.items.materialsOnStoreRetentionPercent} Ad esempio: {/payment.columnView.items} |
Restituisce la voce della percentuale di ritenzione dei materiali stoccati della richiesta di pagamento. | Numero |
| {#payment.columnView.items.completedWorkReleased} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del valore di ritenzione rilasciato del lavoro completato della richiesta di pagamento. | Numero |
| {#payment.columnView.items.materialsOnStoreReleased} Ad esempio: {/payment.columnView.items} |
Restituisce la voce del valore di ritenzione rilasciato dei materiali stoccati della richiesta di pagamento. | Numero |
| {payment.columnView.totalOriginalAmount} | Restituisce il cronoprogramma del valore originale totale della richiesta di pagamento, inclusi l'importo del contratto, i trasferimenti di budget e gli ordini di modifica. | Numero |
| {approvedBudgetTransfers} | Trasferimenti di budget approvati: numero totale dei trasferimenti di budget approvati. | Numero |
| {previousApprovedBudgetTransfers} | Precedenti trasferimenti di budget approvati: importo di tutti i trasferimenti di budget approvati nei periodi precedenti. | Numero |
| {approvedThisPeriodBudgetTransfers} | Trasferimenti di budget approvati per questo periodo: importo dei trasferimenti di budget approvati aggiunti in questo periodo. | Numero |
| {totalBudgetTransfers} | Totale trasferimenti di budget: numero totale dei trasferimenti di budget. | Numero |
| {budgetTransfers} | Trasferimenti di budget: numero dei trasferimenti di budget. | Numero |
| {budgetTransfersQuantity} | Quantità trasferimenti di budget: quantità dei trasferimenti di budget. | Numero |
| {budgetTransfersUnit} | Unità di trasferimento budget: unità di misura dei trasferimenti di budget. | Stringa |
| {budgetTransfersUnitPrice} | Prezzo unitario trasferimenti di budget: prezzo unitario dei trasferimenti di budget. | Numero |
| {payment.columnView.totalChangeOrders} | Restituisce il valore totale approvato degli ordini di modifica della richiesta di pagamento. | Numero |
| {payment.columnView.totalRevisedValue} | Restituisce il valore riesaminato della richiesta di pagamento. | Numero |
| {payment.columnView.totalPreviousAmount} | Restituisce il valore totale del lavoro completato della precedente richiesta di pagamento. | Numero |
| {payment.columnView.totalAmount} | Restituisce il valore totale del lavoro completato della richiesta di pagamento corrente. | Numero |
| {payment.columnView.totalMaterialsStored} | Restituisce il valore totale del materiale in loco della richiesta di pagamento. | Numero |
| {previousMaterialsOnStore} | Restituisce la quantità di materiali memorizzati da tutte le richieste precedenti. | Numero |
| {previousClaimedAmount} | Restituisce l'importo richiesto dalle richieste precedenti. | Numero |
| {claimedAmount} | Restituisce l'importo richiesto per questo periodo di lavoro completato. | Numero |
| {claimedWorkCompleted} | Restituisce l'importo richiesto per questo per il lavoro totale completato. | Numero |
| {payment.columnView.totalCompleted} | Restituisce il valore totale completato della richiesta di pagamento, incluso il valore dei materiali stoccati. | Numero |
| {payment.columnView.percentTotalCompleted} | Restituisce la percentuale totale completata della richiesta di pagamento, incluso il valore dei materiali stoccati. | Numero |
| {payment.columnView.totalBalanceToFinish} | Restituisce il valore totale del saldo per completare della richiesta di pagamento. | Numero |
| {payment.columnView.totalRetainage} | Restituisce il valore di ritenzione totale della richiesta di pagamento. | Numero |
| {payment.thisPeriodRetainage} | Restituisce la ritenuta totale del pagamento corrente meno la ritenuta del pagamento precedente. | Numero |
| {#committedSubItems}{value}{/committedSubItems} | Restituisce l'importo impegnato degli elementi secondari della voce di costo. | Numero |
| {#committedSubItems}{unitPrice}{/committedSubItems} | Restituisce il prezzo unitario impegnato degli elementi secondari della voce di costo. | Numero |
| {latestComment.content} | Restituisce l'ultimo commento di revisione per ogni riga. | Numero |
| {this.costItem.corNumber} | Restituisce le informazioni relative agli ordini di modifica collegate alle voci di costo. Anziché corNumber, è possibile scrivere anche ocoNumber, scoNumber, scoType, corType, ocoType, corName, ocoName o scoName per includere le informazioni desiderate. | Numero |
| {materialsBilled} Ad esempio: {payment.columnView.materialsBilled} |
Se l'impostazione Materiali fatturati è abilitata, la variabile restituisce l'importo fatturato dei materiali. Ulteriori informazioni sui materiali nelle richieste di pagamento. | Numero |
| {previousMaterialsBilled} Ad esempio: {payment.columnView.previousMaterialsBilled} |
Se l'impostazione Materiali fatturati è abilitata, la variabile restituisce l'importo fatturato dei materiali della richiesta precedente. Ulteriori informazioni sui materiali nelle richieste di pagamento. | Numero |
| {payment.lineView.materials} Ad esempio: {payment.lineView.materials} |
Se l'impostazione Materiali fatturati è abilitata, questa variabile restituisce il totale dei materiali fatturati per ogni voce, calcolata come previousMaterialsBilled + materialsBilled (questo periodo). Questo fornisce una singola variabile per ottenere l'importo cumulativo dei materiali fatturati. Ulteriori informazioni sui materiali nelle richieste di pagamento. | Numero |
| {previousAmount | add: previousMaterialsBilled} | Se l'impostazione Materiali fatturati è abilitata, la variabile restituisce la somma dei lavori precedenti completati e dei materiali fatturati. Ulteriori informazioni sui materiali nelle richieste di pagamento. | Numero |
| {payment.columnView.totalPreviousAmount | add:payment.columnView.previousMaterialsBilled} | Se l'impostazione Materiali fatturati è abilitata, la variabile fornisce il totale combinato dei lavori precedenti completati e dei materiali fatturati. Ulteriori informazioni sui materiali nelle richieste di pagamento. | Numero |
| {totalAdvanceAmount} | Importo totale dell'anticipo di tutti i periodi. | Numero |
| {totalAdvancePercent} | Percentuale di anticipo di tutti i periodi. | Numero |
| {totalRecoupmentAmount} | Importo totale del recupero di tutti i periodi. | Numero |
| {totalRecoupmentPercentOfAdvance} | Percentuale di recupero di questo periodo. | Numero |
| {advanceAmount} | Importo anticipato di questo periodo. | Numero |
| {advancePercent} | Percentuale di anticipo di questo periodo. | Numero |
| {recoupmentAmount} | Importo del recupero di questo periodo. | Numero |
| {recoupmentPercentOfCompletedWork} | Percentuale di recupero del lavoro completato. | Numero |
| {previousAdvanceAmount} | La percentuale di recupero per il lavoro completato in questo periodo. | Numero |
| {previousRecoupmentAmount} | Importo del precedente recupero. | Numero |
| {previousAdvanceAmountForeignCurrency} | Valore {previousAdvanceAmount} nella valuta estera. | Numero |
| {previousRecoupmentAmountForeignCurrency} | Valore {previousRecoupmentAmount} nella valuta estera. | Numero |
| {payment.columnView.totalOriginalAmount} | Restituisce il cronoprogramma del valore originale totale della richiesta di pagamento, inclusi l'importo del contratto, i trasferimenti di budget e gli ordini di modifica. | Numero |
| {approvedBudgetTransfers} | Restituisce il numero totale dei trasferimenti di budget approvati. | Numero |
| {previousApprovedBudgetTransfers} | Restituisce l'importo di tutti i trasferimenti di budget approvati nei periodi precedenti. | Numero |
| {approvedThisPeriodBudgetTransfers} | Restituisce l'importo dei trasferimenti di budget approvati aggiunti in questo periodo. | Numero |
| {totalBudgetTransfers} | Restituisce il numero totale dei trasferimenti di budget. | Numero |
| {budgetTransfers} | Restituisce il numero dei trasferimenti di budget. | Numero |
| {budgetTransfersQuantity} | Restituisce la quantità di trasferimenti di budget. | Numero |
| {budgetTransfersUnit} | Restituisce l'unità di misura dei trasferimenti di budget. | Stringa |
| {budgetTransfersUnitPrice} | Restituisce il prezzo unitario dei trasferimenti di budget. | Numero |