Variabili delle richieste di pagamento

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:


Casi di utilizzo ed esempi comuni

Prima di immergersi nel riferimento completo alle variabili, ecco alcuni esempi pratici per gli scenari più comuni:

Intestazione richiesta di pagamento

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"}

Riepilogo della cronologia delle approvazioni

Tracciare chi ha approvato cosa e quando per i requisiti di verifica:

APPROVAL HISTORY:
{#approvalHistories}
• {stepName}: {action} by {operator.name}
{/approvalHistories}

Riepilogo finanziario

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}

Tabella delle voci

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}

Confronto tra precedente e attuale

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}

Monitoraggio dei materiali fatturati

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.

Riepilogo ordini di modifica con aggiunte e detrazioni

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}

Suggerimenti per l'uso delle variabili

Valori specifici del fornitore

Suggerimento:

È 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

Importante:

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

Nota:

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

Importante:

Queste variabili non supportano la modalità in linea e richiedono ordini di modifica completamente approvati per garantire la precisione.


Variabile completa: riferimento

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

{/approvalHistories}

Restituisce l'azione eseguita nella fase del flusso di lavoro di approvazione. Stringa
{#approvalHistories.stepName}

Ad esempio:
{#approvalHistories}{stepName}

{/approvalHistories}

Restituisce il nome della fase del flusso di lavoro nella cronologia di approvazione. Stringa
{#approvalHistories.operator.name}

Ad esempio:
{#approvalHistories}{operator.name}

{/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}{number}

{/payment.columnView.items}

Restituisce la voce del numero della richiesta di pagamento. Stringa
{#payment.columnView.items.name}

Ad esempio:
{#payment.columnView.items}{name}

{/payment.columnView.items}

Restituisce la voce del nome della richiesta di pagamento. Stringa
{#payment.columnView.items.originalQuantity}

Ad esempio:
{#payment.columnView.items}{originalQuantity}

{/payment.columnView.items}

Restituisce la voce della quantità originale della richiesta di pagamento. Numero
{#payment.columnView.items.unit}

Ad esempio:
{#payment.columnView.items}{unit}

{/payment.columnView.items}

Restituisce la voce dell'unità della richiesta di pagamento. Stringa
{#payment.columnView.items.originalUnitPrice}

Ad esempio:
{#payment.columnView.items}{originalUnitPrice}

{/payment.columnView.items}

Restituisce la voce del prezzo unitario originale della richiesta di pagamento. Numero
{#payment.columnView.items.originalAmount}

Ad esempio:
{#payment.columnView.items}{originalAmount}

{/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}{changeOrders}

{/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}{revisedValue}

{/payment.columnView.items}

Restituisce la voce del valore riesaminato della richiesta di pagamento. Numero
{#payment.columnView.items.previousQuantity}

Ad esempio:
{#payment.columnView.items}{previousQuantity}

{/payment.columnView.items}

Restituisce la voce della quantità della precedente richiesta di pagamento. Numero
{#payment.columnView.items.previousAmount}

Ad esempio:
{#payment.columnView.items}{previousAmount}

{/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}{quantity}

{/payment.columnView.items}

Restituisce la voce della quantità della richiesta di pagamento corrente. Numero
{#payment.columnView.items.amount}

Ad esempio:
{#payment.columnView.items}{amount}

{/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}{materialsOnStoreQuantity}

{/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}{materialsOnStoreUnitPrice}

{/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}{materialsStored}

{/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}{completed}

{/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}{percentCompleted}

{/payment.columnView.items}

Restituisce la voce della percentuale totale completata della richiesta di pagamento. Numero
{#payment.columnView.items.balanceToFinish}

Ad esempio:
{#payment.columnView.items}{balanceToFinish}

{/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}{retainage}

{/payment.columnView.items}

Restituisce la voce del valore di ritenzione della richiesta di pagamento. Numero
{#payment.columnView.items.completedWorkRetentionPercent}

Ad esempio:
{#payment.columnView.items}{completedWorkRetentionPercent}

{/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}{materialsOnStoreRetentionPercent}

{/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}{completedWorkReleased}

{/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}{materialsOnStoreReleased}

{/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