> For the complete documentation index, see [llms.txt](https://dev.realpadsoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.realpadsoftware.com/placeholders/document-templating/invoices.md).

# Invoices

This document lists all available placeholders for Invoice Documents.

## Overview

This printer provides Invoice-specific placeholders in addition to the base Deal Document placeholders from [Deal documents](broken://pages/39fbfb63fbb82de321e37879ffe2276e388e28eb). Invoice documents are generated for individual Prescribed Payments and include both Deal-level information and specific details about the payment being invoiced.

***

## Invoice-Specific Placeholders

These placeholders are specific to Invoice documents.

### How to Use

Example invoice template using invoice-specific placeholders:

{% code title="invoice.vm" %}

```velocity
Invoice for Deal: $dealId
Date: $today
Variable Symbol: $variable_symbol

Customer: $customerName
Email: $customerMail
Phone: $customerPhone

Property: $flatId
Building: $buildingName
Project: $projectName

Payment Details:
Type: $paymentType
Method: $paymentMethod
Amount: $paymentAmountVat ($paymentAmountVat_cz in words)
#if($paymentAmountNoVat)
Amount excl. VAT: $paymentAmountNoVat
#end
Due Date: $paymentCalculatedDeadline

#if($pendingAmountVat.isPositive())
Amount Due: $pendingAmountVat
#end

#if($paymentNote)
Note: $paymentNote
#end
```

{% endcode %}

***

### Date and Deal Identification

#### $today

Current date when the invoice is generated.\
Type: DateWrapper

#### $dealId

Unique identifier of the Deal (numeric ID as string).\
Type: String

#### $variable\_symbol

Variable symbol for the Deal (payment pairing symbol).\
Type: String

***

### Main Unit Information

These placeholders provide information about the main Unit on the Deal. All values are empty strings if there is no main Unit.

#### $flatId

Internal ID of the main Flat/Unit on the Deal.\
Type: String | UI: "Number in project" (`flat_param_internalid`)

#### $buildingName

Name of the Building containing the main Unit.\
Type: String | UI: "Name" (`building_param_name`)

#### $projectName

Name of the Project containing the main Unit.\
Type: String | UI: "Name" (`project_param_name`)

***

## Prescribed Payment Details

These placeholders describe the specific Prescribed Payment being invoiced.

### Payment Classification

#### $paymentType

Type of the Prescribed Payment (localized text).\
Type: String | UI: "Type" (`type`)\
Possible values: "Reservation fee", "Additional payment", "Additional product payment", "FPC payment", "1st FPC payment"

#### $paymentMethod

Payment method for this payment (localized text).\
Type: String | UI: "Account type" (`incoming_payment_param_accounttype`)\
Possible values: "Direct transfer", "Notary escrow", "Bank escrow", "Mortgage", "Settlement", "Cash", "Bank cheque", "Compensation", "Land compensation"

### Payment Amounts

#### $paymentAmountVat / $paymentAmountVat\_sk / $paymentAmountVat\_cz

Payment amount including VAT. Includes Slovak and Czech word variants.\
Type: NumberWrapper / String (words) | UI: "Amount including VAT" (`business_case_payment_amount`)

#### $paymentAmountNoVat / $paymentAmountNoVat\_sk / $paymentAmountNoVat\_cz

Payment amount excluding VAT. Includes Slovak and Czech word variants.\
Type: NumberWrapper / String (words)

#### $pendingAmountVat / $pendingAmountVat\_sk / $pendingAmountVat\_cz

Amount still pending/outstanding with VAT (amount not yet paid).\
Type: NumberWrapper / String (words) | UI: "Pending w/ VAT" (`business_case_payment_pending_amount`)

### Payment Timing and Notes

#### $paymentCalculatedDeadline

Due date for this Payment (calculated deadline).\
Type: DateWrapper | UI: "Due date" (`business_case_payment_deadline`)

#### $paymentNote

Notes or comments about the Payment.\
Type: String

***

## Customer Contact Information

These placeholders provide contact information for the invoice recipient (primary Customer).

#### $customerName

Full name of the Customer (formatted according to person type).\
Type: String | UI: "Name" (`customer_param_full_name`)

#### $customerMail

Email address of the Customer.\
Type: String | UI: "E-mail" (`contact_param_email`)

#### $customerPhone

Phone number of the Customer.\
Type: String | UI: "Phone" (`contact_param_phone`)