Invoice

Gets an invoice preview for one specific folio.

To see if the invoice creation would be successful, check the warnings.<br>You must have this scope: 'invoices.read'.<br>For fine-grained clients, you must have this permission: 'core.invoices.read'.

get/finance/v1/invoices/preview

Request

Base URL
https://api.apaleo.com (the document declares no server; this is the origin it was published from)
URL
https://api.apaleo.com/finance/v1/invoices/preview
Auth
OAuth 2
Implicit: https://identity.apaleo.com/connect/authorize
Scopes: invoices.read, admin

Query parameters

folioIdstring required

The ID of the folio for which the invoice should be created.

expandstring[]

List of all embedded resources that should be expanded in the response. Possible values are: company. All other values will be silently ignored.

Response

Success.

createInvoiceAction'CannotCreateInvoice' | 'CreatesInvoice' | 'CreatesInvoiceAndClosesFolio' | 'CreatesArInvoiceAndClosesFolio' required

Describes what will happen, when you try to create an invoice with the folio in the state it is in now.

invoiceDatestring date required

Date the invoice has been created

folioIdstring required

The folio this invoice was requested for

paymentTermsstring nullable

Specification of the payment terms, as defined in the property

propertyIdstring required

The ID of the property

propertyCountryCodestring required

The country code of the property

languageCodestring required

Language which was used to create the invoice

Example response

{
  "to": {
    "name": "John D. Doe",
    "address": {
      "addressLine1": "Baker Street 7",
      "postalCode": "10005",
      "city": "London",
      "countryCode": "GB"
    },
    "companyName": "Investigators Inc.",
    "companyTaxId": "GB-3358791",
    "reference": "REF-11",
    "personalTaxId": "123-321"
  },
  "createInvoiceAction": "CreatesInvoice",
  "invoiceDate": "2026-10-23",
  "folioId": "SGZLTBJC-1",
  "from": {
    "name": "The Bay Hotel",
    "address": {
      "addressLine1": "Ocean Drive 44",
      "postalCode": "55511",
      "city": "Santa Cruz",
      "countryCode": "US"
    }
  },
  "commercialInformation": {
    "registerEntry": "200417510087, California",
    "taxId": "775-43-2106"
  },
  "bankAccount": {
    "iban": "DE44 5001 0517 5407 3249 31",
    "bic": "SSKMDEMMXXX",
    "bank": "Stadtsparkasse München"
  },
  "paymentTerms": "Pay within 7 days",
  "lineItems": {
    "lineItems": [
      {
        "date": "2026-10-23",
        "description": "Double Room",
        "price": {
          "amount": 130,
          "currency": "EUR"
        },
        "vatType": "Reduced",
        "vatPercent": 7,
        "isNoShowFee": false
      },
      {
        "date": "2026-10-23",
        "description": "Service Package",
        "price": {
          "amount": 20,
          "currency": "EUR"
        },
        "vatType": "Normal",
        "vatPercent": 19,
        "isNoShowFee": false
      },
      {
        "date": "2026-10-23",
        "description": "Business Lounge Access",
        "price": {
          "amount": 40,
          "currency": "EUR"
        },
        "vatType": "Normal",
        "vatPercent": 19,
        "isNoShowFee": false
      }
    ],
    "subTotal": {
      "amount": 190,
      "currency": "EUR"
    }
  },
  "payments": [
    {
      "id": "PAY-1",
      "method": "BankTransfer",
      "methodName": "Banküberweisung",
      "amount": {
        "amount": 130,
        "currency": "EUR"
      },
      "paymentDate": "2026-10-23T13:50:37.1321675+02:00",
      "businessDate": "0001-01-01"
    },
    {
      "id": "PAY-2",
      "method": "Cash",
      "methodName": "Bar",
      "amount": {
        "amount": 30,
        "currency": "EUR"
      },
      "paymentDate": "2026-10-23T13:50:37.1321675+02:00",
      "businessDate": "0001-01-01"
    }
  ],
  "taxDetails": [
    {
      "vatType": "Reduced",
      "vatPercent": 7,
      "net": {
        "amount": 120,
        "currency": "EUR"
      },
      "tax": {
        "amount": 10,
        "currency": "EUR"
      }
    },
    {
      "vatType": "Normal",
      "vatPercent": 19,
      "net": {
        "amount": 49,
        "currency": "EUR"
      },
      "tax": {
        "amount": 11,
        "currency": "EUR"
      }
    }
  ],
  "total": {
    "amount": -30,
    "currency": "EUR"
  },
  "stayInfo": {
    "guestName": "John Doe",
    "arrivalDate": "2026-10-22",
    "departureDate": "2026-10-25",
    "reservationId": "ASTUBXVZ-1"
  },
  "propertyId": "ID",
  "propertyCountryCode": "BY",
  "languageCode": "en"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.