Variabler för betalningsansökan

Inkludera variabler från den här artikeln i en dokumentmall för att fylla i värden från betalningsansökan i systemet. Du kan till exempel lägga till betalningsansökans nummer, beskrivning eller det ursprungliga avtalsvärdet.

I den här artikeln:

För att lära dig mer om:


Vanliga användningsfall och exempel

Innan vi går in på den fullständiga variabelreferensen följer här praktiska exempel på de vanligaste scenarierna:

Rubrik för betalningsansökan

Skapa en professionell rubrik för dina betalningsansökningsdokument:

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

Sammanfattning av godkännandehistorik

Spåra vem som godkände vad och när för granskningskrav:

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

Finansiell sammanfattning

Visa viktiga finansiella summor på ett ögonblick:

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}

Tabell för radobjekt

Generera detaljerade radobjekt för slutfört arbete:

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

Jämförelse mellan föregående och nuvarande

Visa förlopp från föregående betalningsansökan:

Previous Payment #{previousPayment.number}: {payment.previousPayment | currency}
Current Period Work: {payment.currentPayment | currency}
Total Earned to Date: {payment.totalEarned | currency}

Spårning av fakturerat material

När inställningen Fakturerat material är aktiverad kan du spåra material som levererats till byggplatsen:

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}

Detta ersätter behovet av att manuellt räkna ut totala summor med den tidigare tillgängliga variabeln totalMaterialsStored.

Ändringsbeställningens sammanfattning med tillägg och avdrag

Separera positiva och negativa ändringsbeställningar i distinkta kolumner:

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}

Tips för att använda variabler

Leverantörsspecifika värden

Tips:

Du kan föregå alla variabler för betalningsansökan med contract.supplier. för att returnera värden som är specifika för leverantören.

Exempel: {contract.supplier.payment.currentPayment}

Kompatibilitet med kalkylblad

Viktigt:

Kalkylbladet stöder inte RTF-variabler. Ta bort @-symbolen när du använder variabler i kalkylblad.

I stället för: {@pco.scopeOfWork}
Använd: {pco.scopeOfWork}

Linjeläge jämfört med kolumnläge

Obs!

Om du använder radläge (Visa ändringsbeställningar som radobjekt) i betalningsansökan, ersätter du columnView med lineView i variablerna.

Kolumnläge: {payment.columnView.totalAmount}
Linjeläge: {payment.lineView.totalAmount}

Variabler för tillägg/avdrag för ändringsbeställning

Viktigt:

Dessa variabler stöder inte direktläge och kräver fullständigt godkända ändringsbeställningar för noggrannhet.


Fullständig variabelreferens

Använd sökningen överst i tabellen för att avgränsa resultaten. Variablerna är ordnade efter kategori för enklare navigering.

Variabler Beskrivning Typ
GRUNDLÄGGANDE INFORMATION
{payment.number} Returnerar betalningsansökans nummer. Sträng
{payment.name} Returnerar betalningsansökans namn. Sträng
{payment.description} Returnerar beskrivning av betalningsansökan. Sträng
{payment.supplier} Returnerar leverantörens företag. Sträng
{payment.owner} Returnerar byggherrens företag. Sträng
{payment.architect} Returnerar arkitektens företag. Sträng
{@payment.note} Returnerar anteckning om betalningsansökan. RichText
ARBETSFLÖDE FÖR GODKÄNNANDE
{#approvalHistories} och {/approvalHistories} Returnerar information om godkännandehistoriken för betalningsansökan, inklusive vidtagen åtgärd, arbetsflödesstegets namn och operatörens namn.

Använd {#approvalHistories} och {/approvalHistories} tillsammans.

Uppställning
{#approvalHistories.action}

Till exempel:
{#approvalHistories}{action}

{/approvalHistories}

Returnerar den åtgärd som vidtogs i arbetsflödessteget för godkännande. Sträng
{#approvalHistories.stepName}

Till exempel:
{#approvalHistories}{stepName}

{/approvalHistories}

Returnerar arbetsflödesstegets namn i godkännandehistoriken. Sträng
{#approvalHistories.operator.name}

Till exempel:
{#approvalHistories}{operator.name}

{/approvalHistories}

Returnerar namnet på den person som utförde godkännandeåtgärden. Sträng
DATUM & TIDSLINJE
{payment.startDate} Returnerar faktureringsperiodens startdatum för betalningsansökan. Datum
{payment.endDate} Returnerar faktureringsperiodens slutdatum för betalningsansökan. Datum
{payment.createdAt} Returnerar datumet då betalningsansökan skapades. Datum
{payment.submittedAt} Returnerar datumet då betalningsansökan skickades. Datum
{payment.revisedAt} Returnerar datumet då betalningsansökan ändrades. Datum
{payment.updatedAt} Returnerar datumet då betalningsansökan uppdaterades. Datum
FINANSIELLA KÄRNSUMMOR
{payment.contractAmount} Returnerar det ursprungliga avtalsvärdet för betalningsansökan. Nummer
{payment.contractSumToDate} Returnerar avtalssumman hittills. Nummer
{payment.totalCompletedAndStored} Returnerar det totala arbete som har slutförts och lagrat material hittills. Nummer
{payment.totalEarned} Returnerar total intjänad summa minus kvarhållning. Nummer
{payment.previousPayment}
Till exempel:

{#payment.previousPayment == ""} {/} {#payment.previousPayment < 0} ({payment.previousPayment | multiply: -1}) {/}

Returnerar total intjänad summa minus kvarhållning från tidigare betalningsansökan. Nummer
{payment.currentPayment} Returnerar aktuell betalning som ska betalas. Nummer
{payment.balanceToFinish} Returnerar saldo för att avsluta inklusive kvarhållning. Nummer
LAGRING OCH KVARHÅLLNING
{payment.completedWorkRetentionPercent} Returnerar procentandelen av det totala arbete som har slutförts och lagrat material hittills. Nummer
{payment.completedWorkRetention} Returnerar innehållet belopp för slutfört arbete. Nummer
{payment.materialsOnStoreRetentionPercent} Returnerar kvarhållningsprocent av material på plats. Procent
{payment.materialsOnStoreRetention} Returnerar mängden material som finns kvar på platsen. Nummer
{payment.allTotalRetainage} Returnerar det totala innehållna beloppet. Nummer
{payment.previousCompletedWorkRetained} Returnerar det innehållna beloppet från slutfört arbete från tidigare betalningsansökningar. Nummer
{payment.previousMaterialsRetained} Returnerar det innehållna beloppet från lagrat material från tidigare betalningsansökningar. Nummer
{payment.currentCompletedWorkRetention} Returnerar den aktuella periodens innehållna belopp för slutfört arbete. Nummer
{payment.currentMaterialsRetention} Returnerar den aktuella periodens innehållna belopp för lagrat material. Nummer
{payment.thisPeriodRetainage} Returnerar den aktuella betalningens totala kvarhållning minus den föregående betalningens kvarhållning. Nummer
ÄNDRINGSBESTÄLLNINGAR OCH VARIATIONER
{payment.approvedInPreviousPeriod} Returnerar de totala variationer som godkänts under föregående period. Nummer
{payment.approvedThisPeriod} Returnerar totala variationer denna period. Nummer
{payment.totalApprovedChangeOrders} Returnerar nettoförändringar efter ändringsbeställning. Nummer
{payment.approvedChangeOrderAdditionsInPreviousPeriod} Returnerar totalt antal godkända ändringsbeställningstillägg från föregående perioder. Nummer
{payment.approvedChangeOrderDeductionsInPreviousPeriod} Returnerar totalt antal godkända ändringsbeställningsavdrag från föregående perioder. Nummer
{payment.approvedChangeOrderAdditionsThisPeriod} Returnerar godkända ändringsbeställningstillägg för den här perioden. Nummer
{payment.approvedChangeOrderDeductionsThisPeriod} Returnerar godkända ändringsbeställningsavdrag för den här perioden. Nummer
{payment.totalApprovedChangeOrderAdditions} Returnerar totalt antal godkända ändringsbeställningstillägg från alla perioder. Nummer
{payment.totalApprovedChangeOrderDeductions} Returnerar totalt antal godkända ändringsbeställningsavdrag från alla perioder. Nummer
INFORMATION OM RADOBJEKT
{#payment.columnView.items} och {/payment.columnView.items} Returnerar objektsdetaljerna för betalningsansökan när Byggherre Ändringar (OCO) visas som en kolumn.

Använd {#payment.columnView.items} och {/payment.columnView.items} tillsammans.

Uppställning
{#payment.columnView.items.number}

Till exempel:
{#payment.columnView.items}{number}

{/payment.columnView.items}

Returnerar radartikelnumret för betalningsansökan. Sträng
{#payment.columnView.items.name}

Till exempel:
{#payment.columnView.items}{name}

{/payment.columnView.items}

Returnerar radartikelnamnet för betalningsansökan. Sträng
{#payment.columnView.items.originalQuantity}

Till exempel:
{#payment.columnView.items}{originalQuantity}

{/payment.columnView.items}

Returnerar radartikelns ursprungliga kvantitet för betalningsansökan. Nummer
{#payment.columnView.items.unit}

Till exempel:
{#payment.columnView.items}{unit}

{/payment.columnView.items}

Returnerar radartikelenheten för betalningsansökan. Sträng
{#payment.columnView.items.originalUnitPrice}

Till exempel:
{#payment.columnView.items}{originalUnitPrice}

{/payment.columnView.items}

Returnerar radartikelns ursprungliga artikelpris för betalningsansökan. Nummer
{#payment.columnView.items.originalAmount}

Till exempel:
{#payment.columnView.items}{originalAmount}

{/payment.columnView.items}

Returnerar radartikelns ursprungliga tidsplan för värdet för betalningsansökan. Nummer
{#payment.columnView.items.changeOrders}

Till exempel:
{#payment.columnView.items}{changeOrders}

{/payment.columnView.items}

Returnerar radartikeln för ändringsbeställningarnas värde för betalningsansökan. Nummer
{#payment.columnView.changeOrderQuantity} Returnerar ändringsbeställningarnas kvantitet. Nummer
{#payment.columnView.items.revisedQuantity}
Till exempel:
{#payment.columnView.items}{revisedQuantity}
{/payment.columnView.items}
Returnerar radartikelns reviderade kvantitet för betalningsansökan. Nummer
{#payment.columnView.items.revisedValue}

Till exempel:
{#payment.columnView.items}{revisedValue}

{/payment.columnView.items}

Returnerar radartikeln för reviderat värde för betalningsansökan. Nummer
{#payment.columnView.items.previousQuantity}

Till exempel:
{#payment.columnView.items}{previousQuantity}

{/payment.columnView.items}

Returnerar radartikeln för antal i den tidigare betalningsansökan. Nummer
{#payment.columnView.items.previousAmount}

Till exempel:
{#payment.columnView.items}{previousAmount}

{/payment.columnView.items}

Returnerar radartikeln för värdet av slutfört arbete i den tidigare betalningsansökan. Nummer
{#payment.columnView.items.quantity}

Till exempel:
{#payment.columnView.items}{quantity}

{/payment.columnView.items}

Returnerar radartikeln för antal i den befintliga betalningsansökan. Nummer
{#payment.columnView.items.amount}

Till exempel:
{#payment.columnView.items}{amount}

{/payment.columnView.items}

Returnerar värdet för slutfört arbete för radartikeln för den befintliga betalningsansökan. Nummer
{#payment.columnView.items.materialsOnStoreQuantity}

Till exempel:
{#payment.columnView.items}{materialsOnStoreQuantity}

{/payment.columnView.items}

Returnerar radartikelns antal för värdet för lagrat material för betalningsansökan. Nummer
{#payment.columnView.items.materialsOnStoreUnitPrice}

Till exempel:
{#payment.columnView.items}{materialsOnStoreUnitPrice}

{/payment.columnView.items}

Returnerar radartikelns enhetspris för värdet för lagrat material för betalningsansökan. Nummer
{#payment.columnView.items.materialsStored}

Till exempel:
{#payment.columnView.items}{materialsStored}

{/payment.columnView.items}

Returnerar radartikelns värde för lagrat material för betalningsansökan. Nummer
{#payment.columnView.items.completed}

Till exempel:
{#payment.columnView.items}{completed}

{/payment.columnView.items}

Returnerar radartikelns totala slutförda värde för betalningsansökan inklusive värdet för slutfört arbete och värdet för material på plats. Nummer
{#payment.columnView.items.percentCompleted}

Till exempel:
{#payment.columnView.items}{percentCompleted}

{/payment.columnView.items}

Returnerar radartikelns totala slutförda procentandel för betalningsansökan. Nummer
{#payment.columnView.items.balanceToFinish}

Till exempel:
{#payment.columnView.items}{balanceToFinish}

{/payment.columnView.items}

Returnerar värdet för radartikelns saldo till färdigställandevärdet för betalningsansökan. Nummer
{#payment.columnView.items.retainage}

Till exempel:
{#payment.columnView.items}{retainage}

{/payment.columnView.items}

Returnerar radartikelns kvarhållna värde för betalningsansökan. Nummer
{#payment.columnView.items.completedWorkRetentionPercent}

Till exempel:
{#payment.columnView.items}{completedWorkRetentionPercent}

{/payment.columnView.items}

Returnerar procentandel för radartikelns kvarhållning av slutfört arbete för betalningsansökan. Nummer
{#payment.columnView.items.materialsOnStoreRetentionPercent}

Till exempel:
{#payment.columnView.items}{materialsOnStoreRetentionPercent}

{/payment.columnView.items}

Returnerar procentandel för radartikelns kvarhållning av lagrat material för betalningsansökan. Nummer
{#payment.columnView.items.completedWorkReleased}

Till exempel:
{#payment.columnView.items}{completedWorkReleased}

{/payment.columnView.items}

Returnerar radartikeln för det frisläppta kvarhållningsvärdet för slutfört arbete för betalningsansökan. Nummer
{#payment.columnView.items.materialsOnStoreReleased}

Till exempel:
{#payment.columnView.items}{materialsOnStoreReleased}

{/payment.columnView.items}

Returnerar radartikeln för det frisläppta kvarhållningsvärdet för lagrat material för betalningsansökan. Nummer
{payment.columnView.totalOriginalAmount} Returnerar den totala ursprungliga värdetabellen för betalningsansökningen, inklusive avtalsbelopp, budgetöverföringar och ändringsbeställningar. Nummer
{approvedBudgetTransfers} Godkända budgetöverföringar: Det totala beloppet för godkända budgetöverföringar. Nummer
{previousApprovedBudgetTransfers} Tidigare godkända budgetöverföringar: Beloppet för alla godkända budgetöverföringar under de föregående perioderna. Nummer
{approvedThisPeriodBudgetTransfers} Godkända budgetöverföringar för den här perioden: Beloppet för godkända budgetöverföringar som lagts till under den här perioden. Nummer
{totalBudgetTransfers} Totalt antal budgetöverföringar: Det totala beloppet för budgetöverföringar. Nummer
{budgetTransfers} Budgetöverföringar: Summan av budgetöverföringar. Nummer
{budgetTransfersQuantity} Antal budgetöverföringar: Antalet budgetöverföringar. Nummer
{budgetTransfersUnit} Budgetöverföringsenhet: Måttenheten för budgetöverföringarna. Sträng
{budgetTransfersUnitPrice} Enhetspris för budgetöverföring: Enhetspriset för budgetöverföringar. Nummer
{payment.columnView.totalChangeOrders} Returnerar värdet för totalt antal godkända ändringsbeställningar för betalningsansökan. Nummer
{payment.columnView.totalRevisedValue} Returnerar det totala reviderade värdet för betalningsansökan. Nummer
{payment.columnView.totalPreviousAmount} Returnerar det totala värdet för slutfört arbete för den tidigare betalningsansökan. Nummer
{payment.columnView.totalAmount} Returnerar det totala värdet för slutfört arbete för den befintliga betalningsansökan. Nummer
{payment.columnView.totalMaterialsStored} Returnerar det totala värdet för material på plats för betalningsansökan. Nummer
{previousMaterialsOnStore} Returnerar beloppet för lagrat material från alla tidigare ansökningar. Nummer
{previousClaimedAmount} Returnerar det begärda beloppet från tidigare ansökningar. Nummer
{claimedAmount} Returnerar begärt belopp för slutfört arbete för denna period. Nummer
{claimedWorkCompleted} Returnerar totalt begärt belopp för slutfört arbete. Nummer
{payment.columnView.totalCompleted} Returnerar det totala slutförda värdet för betalningsansökan inklusive värdet för lagrat material. Nummer
{payment.columnView.percentTotalCompleted} Returnerar den totala slutförda procentandelen för betalningsansökan inklusive värdet för lagrat material. Nummer
{payment.columnView.totalBalanceToFinish} Returnerar det totala saldot till färdigställandevärdet för betalningsansökan. Nummer
{payment.columnView.totalRetainage} Returnerar det totala kvarhållningsvärdet för betalningsansökan. Nummer
{payment.thisPeriodRetainage} Returnerar den aktuella betalningens totala kvarhållning minus den föregående betalningens kvarhållning. Nummer
{#committedSubItems}{value}{/committedSubItems} Returnerar det utfästa beloppet för kostnadsobjektets underobjekt. Nummer
{#committedSubItems}{unitPrice}{/committedSubItems} Returnerar det utfästa enhetspriset för kostnadsobjektets underartiklar. Nummer
{latestComment.content} Returnerar den senaste granskningskommentaren för varje rad. Nummer
{this.costItem.corNumber} Returnerar ändringsbeställningsinformation som är länkad till kostnadsobjekt. Istället för corNumber kan du även skriva ocoNumber, scoNumber, scoType, corType, ocoType, corName, ocoName eller scoName för att inkludera den information som krävs. Nummer
{materialsBilled}
Till exempel:
{payment.columnView.materialsBilled}
Om inställningen Fakturerat material är aktiverad returnerar variabeln beloppet för fakturerat material. Läs mer om material i betalningsansökningar. Nummer
{previousMaterialsBilled}
Till exempel:
{payment.columnView.previousMaterialsBilled}
Om inställningen Fakturerat material är aktiverad returnerar variabeln det fakturerade beloppet för material från den senaste ansökningen. Läs mer om material i betalningsansökningar. Nummer
{payment.lineView.materials}
Till exempel:
{payment.lineView.materials}
Om inställningen Fakturerat material är aktiverad returnerar den här variabeln det totala material som fakturerats för varje radobjekt, beräknat som previousMaterialsBilled + materialsBilled (denna period). Detta ger en enda variabel för att hämta det ackumulerade beloppet för fakturerat material. Läs mer om material i betalningsansökningar. Nummer
{previousAmount | add: previousMaterialsBilled} Om inställningen Fakturerat material är aktiverad returnerar variabeln summan av tidigare slutfört arbete och fakturerat material. Läs mer om material i betalningsansökningar. Nummer
{payment.columnView.totalPreviousAmount | add:payment.columnView.previousMaterialsBilled} Om inställningen Fakturerat material är aktiverad ger variabeln den kombinerade totala summan av tidigare slutfört arbete och fakturerat material. Läs mer om material i betalningsansökningar. Nummer
{totalAdvanceAmount} Det totala förskottsbeloppet för alla perioder. Nummer
{totalAdvancePercent} Förskottsprocentsatsen för alla perioder. Nummer
{totalRecoupmentAmount} Det totala ersättningsbeloppet för alla perioder. Nummer
{totalRecoupmentPercentOfAdvance} Ersättningsprocentsatsen för denna period. Nummer
{advanceAmount} Förskottsbeloppet för denna period. Nummer
{advancePercent} Förskottsprocentsatsen för denna period. Nummer
{recoupmentAmount} Ersättningsbeloppet för denna period. Nummer
{recoupmentPercentOfCompletedWork} Ersättningsprocentsatsen för slutfört arbete. Nummer
{previousAdvanceAmount} Ersättningsprocentsatsen för arbete som slutförts under denna period. Nummer
{previousRecoupmentAmount} Beloppet för föregående ersättning. Nummer
{previousAdvanceAmountForeignCurrency} {previousAdvanceAmount} värde i utländsk valuta. Nummer
{previousRecoupmentAmountForeignCurrency} {previousRecoupmentAmount} värde i utländsk valuta. Nummer
{payment.columnView.totalOriginalAmount} Returnerar den totala ursprungliga värdetabellen för betalningsansökningen, inklusive avtalsbelopp, budgetöverföringar och ändringsbeställningar. Nummer
{approvedBudgetTransfers} Returnerar det totala beloppet för godkända budgetöverföringar. Nummer
{previousApprovedBudgetTransfers} Returnerar beloppet för alla godkända budgetöverföringar under föregående perioder. Nummer
{approvedThisPeriodBudgetTransfers} Returnerar beloppet för godkända budgetöverföringar som lagts till under den här perioden. Nummer
{totalBudgetTransfers} Returnerar det totala antalet budgetöverföringar. Nummer
{budgetTransfers} Returnerar antalet budgetöverföringar. Nummer
{budgetTransfersQuantity} Returnerar antalet budgetöverföringar. Nummer
{budgetTransfersUnit} Returnerar måttenheten för budgetöverföringarna. Sträng
{budgetTransfersUnitPrice} Returnerar enhetspriset för budgetöverföringar. Nummer