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
TOTALT BETALT HITTILLS PER AVTAL
{payment.contract.totalPaidAmount} Returnerar summan av alla referensbelopp för betalningar som är relaterade till avtalet. Detta omfattar både kostnadsbetalningsansökningar och betalda utgifter. Nummer
{payment.contract.totalPayAppPaidAmount} Returnerar summan av alla betalda belopp för kostnadsbetalningsansökningar som är relaterade till avtalet. Nummer
{payment.contract.totalExpensePaidAmount} Returnerar summan av alla betalda belopp för utgifter som är relaterade till avtalet. 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. I stä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