> 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`)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.realpadsoftware.com/placeholders/document-templating/invoices.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.