Incluya variables de este artículo en una plantilla de documento para rellenar los valores de la solicitud de pago en el sistema. Por ejemplo, puede añadir el número, la descripción o el valor original del contrato de la solicitud de pago.
En este artículo:
Para obtener más información sobre cómo:
Antes de profundizar en la referencia completa de la variable, aquí se muestran ejemplos prácticos de los escenarios más comunes:
Cree un encabezado profesional para los documentos de solicitud de pago:
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"}
Realice un seguimiento de quién aprobó qué y cuándo para los requisitos de auditoría:
APPROVAL HISTORY:
{#approvalHistories}
• {stepName}: {action} by {operator.name}
{/approvalHistories}
Muestre los totales financieros clave de un vistazo:
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}
Genere elementos de línea detallados para el trabajo completado:
{#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}
Muestre el progreso desde la solicitud de pago anterior:
Previous Payment #{previousPayment.number}: {payment.previousPayment | currency}
Current Period Work: {payment.currentPayment | currency}
Total Earned to Date: {payment.totalEarned | currency}
Cuando la opción Materiales facturados esté activada, realice un seguimiento de los materiales entregados en el lugar del trabajo:
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}
Esto reemplaza la necesidad de calcular manualmente los totales con la variable totalMaterialsStored disponible anteriormente.
Separe las órdenes de cambio positivas y negativas en columnas distintas:
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}
Valores específicos del proveedor
Es posible anteponer contract.supplier. a cualquiera de las variables de la solicitud de pago para devolver valores específicos del proveedor.
Ejemplo: {contract.supplier.payment.currentPayment}
Compatibilidad con hojas de cálculo
Las hojas de cálculo no admiten variables de texto enriquecido. Elimine el símbolo "@" al utilizar variables en las hojas de cálculo.
En lugar de: {@pco.scopeOfWork}
Utilice: {pco.scopeOfWork}
Modo de línea frente a modo de columna
Si utiliza el modo de línea (Mostrar órdenes de cambio como artículos de línea) en la solicitud de pago, sustituya columnView por lineView en las variables anteriores.
Modo de columna: {payment.columnView.totalAmount}
Modo de línea: {payment.lineView.totalAmount}
Variables de adición/deducción de órdenes de cambio
Estas variables no admiten el modo en línea y requieren órdenes de cambio totalmente aprobadas para precisión.
Utilice el buscador de la parte superior de la tabla para restringir los resultados. Las variables se organizan por categorías para facilitar la navegación.
| Variables | Descripción | Tipo |
| INFORMACIÓN BÁSICA | ||
| {payment.number} | Devuelve el número de la aplicación de pago. | Cadena |
| {payment.name} | Devuelve el nombre de la aplicación de pago. | Cadena |
| {payment.description} | Devuelve la descripción de la aplicación de pago. | Cadena |
| {payment.supplier} | Devuelve la empresa del proveedor. | Cadena |
| {payment.owner} | Devuelve la empresa del propietario. | Cadena |
| {payment.architect} | Devuelve la empresa del arquitecto. | Cadena |
| {@payment.note} | Devuelve la nota de la aplicación de pago. | RichText |
| FLUJO DE TRABAJO DE APROBACIÓN | ||
| {#approvalHistories} y {/approvalHistories} | Devuelve los detalles del historial de aprobación de la aplicación de pago, incluida la acción realizada, el nombre del paso del flujo de trabajo y el nombre del operador. Utilice {#approvalHistories} y {/approvalHistories} juntos. |
Matriz |
| {#approvalHistories.action} Por ejemplo: {/approvalHistories} |
Devuelve la acción realizada en el paso del flujo de trabajo de aprobación. | Cadena |
| {#approvalHistories.stepName} Por ejemplo: {/approvalHistories} |
Devuelve el nombre del paso de flujo de trabajo en el historial de aprobación. | Cadena |
| {#approvalHistories.operator.name} Por ejemplo: {/approvalHistories} |
Devuelve el nombre de la persona que realizó la acción de aprobación. | Cadena |
| FECHAS Y SECUENCIA TEMPORAL | ||
| {payment.startDate} | Devuelve la fecha de inicio del período de facturación de la aplicación de pago. | Fecha |
| {payment.endDate} | Devuelve la fecha de finalización del período de facturación de la aplicación de pago. | Fecha |
| {payment.createdAt} | Devuelve la fecha en la que se creó la solicitud de pago. | Fecha |
| {payment.submittedAt} | Devuelve la fecha en la que se envió la solicitud de pago. | Fecha |
| {payment.revisedAt} | Devuelve la fecha en la que se revisó la solicitud de pago. | Fecha |
| {payment.updatedAt} | Devuelve la fecha en la que se actualizó la solicitud de pago. | Fecha |
| TOTALES FINANCIEROS BÁSICOS | ||
| {payment.contractAmount} | Devuelve el valor del contrato original de la aplicación de pago. | Número |
| {payment.contractSumToDate} | Devuelve la suma de contrato a la fecha. | Número |
| {payment.totalCompletedAndStored} | Devuelve el trabajo total completado y el material almacenado hasta la fecha. | Número |
| {payment.totalEarned} | Devuelve el total ganado menos retenciones. | Número |
| {payment.previousPayment} Por ejemplo: {#payment.previousPayment == ""} {/} {#payment.previousPayment < 0} ({payment.previousPayment | multiply: -1}) {/} |
Devuelve el total ganado menos retenciones de la aplicación de pago anterior. | Número |
| {payment.currentPayment} | Devuelve el vencimiento de pago actual. | Número |
| {payment.balanceToFinish} | Devuelve el saldo para finalizar, incluida la retención. | Número |
| RETENCIÓN | ||
| {payment.completedWorkRetentionPercent} | Devuelve el porcentaje del trabajo total completado y el material almacenado hasta la fecha. | Número |
| {payment.completedWorkRetention} | Devuelve el importe de retención del trabajo completado. | Número |
| {payment.materialsOnStoreRetentionPercent} | Devuelve el porcentaje de retención de los materiales en el sitio. | Porcentaje |
| {payment.materialsOnStoreRetention} | Devuelve la cantidad de materiales que se conservan en el sitio. | Número |
| {payment.allTotalRetainage} | Devuelve el importe de retención total. | Número |
| {payment.previousCompletedWorkRetained} | Devuelve el importe retenido del trabajo finalizado de aplicaciones de pago anteriores. | Número |
| {payment.previousMaterialsRetained} | Devuelve el importe retenido de los materiales almacenados de aplicaciones de pago anteriores. | Número |
| {payment.currentCompletedWorkRetention} | Devuelve el importe de retención del período actual para el trabajo finalizado. | Número |
| {payment.currentMaterialsRetention} | Devuelve el importe de retención del período actual para los materiales almacenados. | Número |
| {payment.thisPeriodRetainage} | Devuelve la retención total del pago actual menos la retención del pago anterior. | Número |
| ÓRDENES DE CAMBIO Y VARIACIONES | ||
| {payment.approvedInPreviousPeriod} | Devuelve las variaciones totales aprobadas en el periodo anterior. | Número |
| {payment.approvedThisPeriod} | Devuelve las variaciones totales en este periodo. | Número |
| {payment.totalApprovedChangeOrders} | Devuelve los cambios netos por orden de cambio. | Número |
| {payment.approvedChangeOrderAdditionsInPreviousPeriod} | Devuelve el total de adiciones de órdenes de cambio aprobadas de períodos anteriores. | Número |
| {payment.approvedChangeOrderDeductionsInPreviousPeriod} | Devuelve el total de deducciones de órdenes de cambio aprobadas de períodos anteriores. | Número |
| {payment.approvedChangeOrderAdditionsThisPeriod} | Devuelve las adiciones de órdenes de cambio aprobadas para este período. | Número |
| {payment.approvedChangeOrderDeductionsThisPeriod} | Devuelve las deducciones de órdenes de cambio aprobadas para este período. | Número |
| {payment.totalApprovedChangeOrderAdditions} | Devuelve el total de adiciones de órdenes de cambio aprobadas en todos los períodos. | Número |
| {payment.totalApprovedChangeOrderDeductions} | Devuelve el total de deducciones de órdenes de cambio aprobadas en todos los períodos. | Número |
| DETALLES DEL ARTÍCULO DE LÍNEA | ||
| {#payment.columnView.items} y {/payment.columnView.items} | Devuelve los detalles del artículo de la solicitud de pago cuando se muestran las OCO como una columna. Utilice {#payment.columnView.items} and {/payment.columnView.items} juntos. |
Matriz |
| {#payment.columnView.items.number} Por ejemplo: {/payment.columnView.items} |
Devuelve el número de elemento de línea de la aplicación de pago. | Cadena |
| {#payment.columnView.items.name} Por ejemplo: {/payment.columnView.items} |
Devuelve el nombre de elemento de línea de la aplicación de pago. | Cadena |
| {#payment.columnView.items.originalQuantity} Por ejemplo: {/payment.columnView.items} |
Devuelve la cantidad original del elemento de línea de la aplicación de pago. | Número |
| {#payment.columnView.items.unit} Por ejemplo: {/payment.columnView.items} |
Devuelve la unidad de elemento de línea de la aplicación de pago. | Cadena |
| {#payment.columnView.items.originalUnitPrice} Por ejemplo: {/payment.columnView.items} |
Devuelve el precio unitario original del elemento de línea de la aplicación de pago. | Número |
| {#payment.columnView.items.originalAmount} Por ejemplo: {/payment.columnView.items} |
Devuelve el programa original del elemento de línea de valor de la aplicación de pago. | Número |
| {#payment.columnView.items.changeOrders} Por ejemplo: {/payment.columnView.items} |
Devuelve el elemento de línea del valor de las órdenes de cambio de la aplicación de pago. | Número |
| {#payment.columnView.changeOrderQuantity} | Devuelve la cantidad de órdenes de cambio. | Número |
| {#payment.columnView.items.revisedQuantity} Por ejemplo: {#payment.columnView.items}{revisedQuantity} {/payment.columnView.items} |
Devuelve la cantidad revisada del elemento de línea de la aplicación de pago. | Número |
| {#payment.columnView.items.revisedValue} Por ejemplo: {/payment.columnView.items} |
Devuelve el elemento de línea del valor revisado de la aplicación de pago. | Número |
| {#payment.columnView.items.previousQuantity} Por ejemplo: {/payment.columnView.items} |
Devuelve el elemento de línea de la cantidad de la aplicación de pago anterior. | Número |
| {#payment.columnView.items.previousAmount} Por ejemplo: {/payment.columnView.items} |
Devuelve el elemento de línea del valor completado del trabajo de la aplicación de pago anterior. | Número |
| {#payment.columnView.items.quantity} Por ejemplo: {/payment.columnView.items} |
Devuelve el elemento de línea de cantidad de la aplicación de pago actual. | Número |
| {#payment.columnView.items.amount} Por ejemplo: {/payment.columnView.items} |
Devuelve el elemento de línea del valor completado del trabajo de la aplicación de pago actual. | Número |
| {#payment.columnView.items.materialsOnStoreQuantity} Por ejemplo: {/payment.columnView.items} |
Devuelve el valor de cantidad de materiales de elementos de línea en el sitio de la aplicación de pago. | Número |
| {#payment.columnView.items.materialsOnStoreUnitPrice} Por ejemplo: {/payment.columnView.items} |
Devuelve el valor de precio unitario de elementos de línea de los materiales almacenados de la aplicación de pago. | Número |
| {#payment.columnView.items.materialsStored} Por ejemplo: {/payment.columnView.items} |
Devuelve el valor de materiales almacenados de elementos de línea de la aplicación de pago. | Número |
| {#payment.columnView.items.completed} Por ejemplo: {/payment.columnView.items} |
Devuelve el valor completado total del elemento de línea de la aplicación de pago, incluidos el valor completado del trabajo y el valor de los materiales en el sitio. | Número |
| {#payment.columnView.items.percentCompleted} Por ejemplo: {/payment.columnView.items} |
Devuelve el porcentaje completado total de elemento de línea de la aplicación de pago. | Número |
| {#payment.columnView.items.balanceToFinish} Por ejemplo: {/payment.columnView.items} |
Devuelve el valor de saldo de elemento de línea para finalizar el valor de la aplicación de pago. | Número |
| {#payment.columnView.items.retainage} Por ejemplo: {/payment.columnView.items} |
Devuelve el valor de retención de elemento de línea de la aplicación de pago. | Número |
| {#payment.columnView.items.completedWorkRetentionPercent} Por ejemplo: {/payment.columnView.items} |
Devuelve el porcentaje de retención de elemento de línea del trabajo completado de la aplicación de pago. | Número |
| {#payment.columnView.items.materialsOnStoreRetentionPercent} Por ejemplo: {/payment.columnView.items} |
Devuelve el porcentaje de retención de elementos de línea de los materiales almacenados de la aplicación de pago. | Número |
| {#payment.columnView.items.completedWorkReleased} Por ejemplo: {/payment.columnView.items} |
Devuelve el elemento de línea del valor de retención lanzado del trabajo completado correspondiente a la aplicación de pago. | Número |
| {#payment.columnView.items.materialsOnStoreReleased} Por ejemplo: {/payment.columnView.items} |
Devuelve el elemento de línea del valor de retención lanzado de los materiales almacenados de la aplicación de pago. | Número |
| {payment.columnView.totalOriginalAmount} | Devuelve la planificación original total de valor de la solicitud de pago, incluidos el importe del contrato, las transferencias de presupuesto y las órdenes de cambio. | Número |
| {approvedBudgetTransfers} | Transferencias de presupuesto aprobadas: la cantidad total de las transferencias de presupuesto aprobadas. | Número |
| {previousApprovedBudgetTransfers} | Transferencias de presupuesto aprobadas anteriores: el importe de todas las transferencias de presupuesto aprobadas en los períodos anteriores. | Número |
| {approvedThisPeriodBudgetTransfers} | Transferencias de presupuesto aprobadas en este periodo: el importe de las transferencias de presupuesto aprobadas que se añaden en este periodo. | Número |
| {totalBudgetTransfers} | Transferencias de presupuesto totales: la cantidad total de transferencias de presupuesto. | Número |
| {budgetTransfers} | Transferencias de presupuesto: la cantidad de transferencias de presupuesto. | Número |
| {budgetTransfersQuantity} | Cantidad de transferencia de presupuesto: la cantidad de transferencias de presupuesto. | Número |
| {budgetTransfersUnit} | Unidad de transferencia de presupuesto: unidad de medida de las transferencias de presupuesto. | Cadena |
| {budgetTransfersUnitPrice} | Precio unitario de transferencia de presupuesto: el precio unitario de las transferencias de presupuesto. | Número |
| {payment.columnView.totalChangeOrders} | Devuelve el valor total de las órdenes de cambio aprobadas de la aplicación de pago. | Número |
| {payment.columnView.totalRevisedValue} | Devuelve el valor revisado total de la aplicación de pago. | Número |
| {payment.columnView.totalPreviousAmount} | Devuelve el valor total de trabajo completado de la aplicación de pago anterior. | Número |
| {payment.columnView.totalAmount} | Devuelve el valor total de trabajo completado de la aplicación de pago actual. | Número |
| {payment.columnView.totalMaterialsStored} | Devuelve el valor total del material en el sitio de la aplicación de pago. | Número |
| {previousMaterialsOnStore} | Devuelve la cantidad de materiales almacenados de todas las solicitudes anteriores. | Número |
| {previousClaimedAmount} | Devuelve el importe reclamado de aplicaciones anteriores. | Número |
| {claimedAmount} | Devuelve este importe reclamado de trabajo realizado en el período. | Número |
| {claimedWorkCompleted} | Devuelve el trabajo total completado del importe reclamado. | Número |
| {payment.columnView.totalCompleted} | Devuelve el valor total completado de la aplicación de pago, incluido el valor de los materiales almacenados. | Número |
| {payment.columnView.percentTotalCompleted} | Devuelve el porcentaje total completado de la aplicación de pago, incluido el valor de los materiales almacenados. | Número |
| {payment.columnView.totalBalanceToFinish} | Devuelve el saldo total de elemento para finalizar el valor de la aplicación de pago. | Número |
| {payment.columnView.totalRetainage} | Devuelve el valor de retención total de la aplicación de pago. | Número |
| {payment.thisPeriodRetainage} | Devuelve la retención total del pago actual menos la retención del pago anterior. | Número |
| {#committedSubItems}{value}{/committedSubItems} | Devuelve el importe validado de los subelementos del elemento de coste. | Número |
| {#committedSubItems}{unitPrice}{/committedSubItems} | Devuelve el precio unitario validado de los subelementos del elemento de coste. | Número |
| {latestComment.content} | Devuelve el último comentario de revisión para cada línea. | Número |
| {this.costItem.corNumber} | Devuelve información de la orden de cambio vinculada a los elementos de coste En lugar de corNumber, también puede escribir ocoNumber, scoNumber, scoType, corType, ocoType, corName, ocoName o scoName para incluir la información necesaria. | Número |
| {materialsBilled} Por ejemplo: {payment.columnView.materialsBilled} |
Devuelve el importe facturado de materiales si está activado el parámetro Materiales facturados. Obtenga más información sobre Materiales en solicitudes de pago. | Número |
| {previousMaterialsBilled} Por ejemplo: {payment.columnView.previousMaterialsBilled} |
Devuelve el importe facturado de materiales de la solicitud anterior si está activado el parámetro Materiales facturados. Obtenga más información sobre Materiales en solicitudes de pago. | Número |
| {payment.lineView.materials} Por ejemplo: {payment.lineView.materials} |
Si el parámetro Materiales facturados está activado, esta variable devuelve el total de materiales facturados para cada partida, calculado como MaterialesFacturadosAnteriores + MaterialesFacturados (en este período). Esto proporciona una única variable para obtener el importe facturado de materiales acumulado. Obtenga más información sobre Materiales en solicitudes de pago. | Número |
| {previousAmount | add: previousMaterialsBilled} | Devuelve la suma del trabajo realizado anteriormente y los materiales facturados si el parámetro Materiales facturados está activado. Obtenga más información sobre Materiales en solicitudes de pago. | Número |
| {payment.columnView.totalPreviousAmount | add:payment.columnView.previousMaterialsBilled} | Proporciona el total combinado del trabajo realizado anteriormente y los materiales facturados si el parámetro Materiales facturados está activado. Obtenga más información sobre Materiales en solicitudes de pago. | Número |
| {totalAdvanceAmount} | El importe total anticipado de todos los periodos. | Número |
| {totalAdvancePercent} | El porcentaje anticipado de todos los periodos. | Número |
| {totalRecoupmentAmount} | El importe total de recoge de todos los periodos. | Número |
| {totalRecoupmentPercentOfAdvance} | Porcentaje de recoge de este periodo. | Número |
| {advanceAmount} | El importe anticipado de este periodo. | Número |
| {advancePercent} | Porcentaje anticipado de este periodo. | Número |
| {recoupmentAmount} | El importe de recoge de este periodo. | Número |
| {recoupmentPercentOfCompletedWork} | Porcentaje de recoge del trabajo completado. | Número |
| {previousAdvanceAmount} | Porcentaje de recoge del trabajo realizado en este periodo. | Número |
| {previousRecoupmentAmount} | El importe del recoge anterior. | Número |
| {previousAdvanceAmountForeignCurrency} | Valor {previousAdvanceAmount} en la divisa extranjera. | Número |
| {previousRecoupmentAmountForeignCurrency} | Valor {previousRecoupmentAmount} en la divisa extranjera. | Número |
| {payment.columnView.totalOriginalAmount} | Devuelve la planificación original total de valor de la solicitud de pago, incluidos el importe del contrato, las transferencias de presupuesto y las órdenes de cambio. | Número |
| {approvedBudgetTransfers} | Devuelve la cantidad total de las transferencias de presupuesto aprobadas. | Número |
| {previousApprovedBudgetTransfers} | Devuelve el importe de todas las transferencias de presupuesto aprobadas en los períodos anteriores. | Número |
| {approvedThisPeriodBudgetTransfers} | Devuelve el importe de las transferencias de presupuesto aprobadas que se han añadido en este periodo. | Número |
| {totalBudgetTransfers} | Devuelve la cantidad total de las transferencias de presupuesto. | Número |
| {budgetTransfers} | Devuelve la cantidad de las transferencias de presupuesto. | Número |
| {budgetTransfersQuantity} | Devuelve la cantidad de transferencias de presupuesto. | Número |
| {budgetTransfersUnit} | Devuelve la unidad de medida de las transferencias de presupuesto. | Cadena |
| {budgetTransfersUnitPrice} | Devuelve el precio por unidad de las transferencias de presupuesto. | Número |