---
title: "Get fiscal document preview of the type invoice"
method: POST
path: "/fiscal-document/v1/fiscal-documents/invoice/preview"
tags: ["Fiscal Documents"]
---

# Get fiscal document preview of the type invoice

`POST /fiscal-document/v1/fiscal-documents/invoice/preview`

Get fiscal document preview of the type invoice.

## Headers

- `X-Property-ID` integer, required

## Request body

- GetInvoicePreviewRequest
  - `transactionIdToAmount` object, nullable — Map of transaction ID to amount (in major currency units, e.g., 10.50 for $10.50) for partial transaction inclusion
  - `transactionIds` integer[], required — Include transactions with the specified IDs (deprecated, use `includeTransactionIds` instead)
  - `sourceId` integer, required
  - `sequenceId` integer, nullable
  - `sourceKind` 'GROUP_PROFILE' | 'RESERVATION' | 'HOUSE_ACCOUNT' | 'ACCOUNTS_RECEIVABLE_LEDGER', required — Kind of the source entity
  - `userId` integer, nullable
  - `recipient` RecipientRequest
    - `type` 'GUEST' | 'CONTACT' | 'GROUP' | 'COMPANY' | 'GROUP_PROFILE' | 'GROUP_PROFILE_CONTACT', required — Type of the recipient.
    - `id` integer, required — ID of the recipient, references guestId, contactId, groupId, etc. depending on type.
    - `taxDocumentSource` 'GUEST_TAX_ID' | 'GUEST_DOCUMENT_NUMBER' — Source of the tax document number.
  - `manualRecipient` ManualRecipientRequest
    - `type` 'PERSON' | 'COMPANY', required — Type of recipient (person or company)
    - `name` string, nullable, required — Name of the recipient
    - `gender` 'M' | 'F' | 'N/A' — Gender of the guest
    - `email` string, email, nullable — Email address of the recipient
    - `birthday` string, date, nullable — Birthday of the recipient
    - `phone` string, nullable — Phone number
    - `cellPhone` string, nullable — Cell phone number
    - `taxId` string, nullable, required — Tax ID / VAT number
    - `address` object, nullable
      - `country` string, nullable — Country code
      - `state` string, nullable — State or province
      - `city` string, nullable — City
      - `address1` string, nullable — Primary street address
      - `address2` string, nullable — Secondary street address
      - `zip` string, nullable — Zip/postal code
    - `document` object, nullable
      - `type` 'na' | 'driver_licence' | 'student_id' | 'passport' | 'dni' | 'nie' — Type of guest identification document
      - `number` string, nullable — Document number
      - `issueDate` string, date, nullable — Document issue date
      - `issuingCountry` string, nullable — Country that issued the document
      - `expirationDate` string, date, nullable — Document expiration date
  - `folioIds` integer[] — Include all transactions from the specified folio IDs
  - `excludeTransactionIds` integer[] — Exclude transactions with the specified IDs
  - `includeTransactionIds` integer[] — Include transactions with the specified IDs
  - `simplified` boolean
  - `dueDatePropertyTimezone` string, date

## Response `200`

Successful file download

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)