CLcloudbeds
Fiscal Documents

Create a fiscal document of the type pro forma invoice

Create a fiscal document of the type pro forma invoice.

Pro Forma Invoice Characteristics:

  • Contains pending transactions that are subject to change
  • Includes payment information
  • Transactions are NOT locked (unlike regular invoices)
  • Can be converted to regular invoices later when transactions are posted
  • Has its own sequence numbering and settings
post/fiscal-document/v1/fiscal-documents/pro-forma-invoice/preview

Request

  • Base URL
    https://api.cloudbeds.com
  • URL
    https://api.cloudbeds.com/fiscal-document/v1/fiscal-documents/pro-forma-invoice/preview
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://api.cloudbeds.com/auth/oauth/authorize
      Token URL: https://api.cloudbeds.com/auth/oauth/token scopes: read:reservation

Headers

X-Property-IDinteger required

Property id

Request body

transactionIdsinteger[] required

List of pending transaction IDs to include in the pro forma invoice (deprecated, use includeTransactionIds instead)

transactionIdToAmountobject nullable

Map of transaction ID to amount (in major currency units, e.g., 10.50 for $10.50) for partial transaction inclusion

paymentIdsinteger[]

List of payment IDs associated with the pending transactions

sourceIdinteger required
sequenceIdinteger nullable
sourceKind'GROUP_PROFILE' | 'RESERVATION' | 'HOUSE_ACCOUNT' | 'ACCOUNTS_RECEIVABLE_LEDGER' required

Kind of the source entity

userIdinteger nullable

Ignored. The document is attributed to the authenticated user.

invoiceDatestring date

Date for the pro forma invoice (defaults to current date if not provided)

folioIdsinteger[]

Include all transactions from the specified folio IDs

excludeTransactionIdsinteger[]

Exclude transactions with the specified IDs

includeTransactionIdsinteger[]

Include transactions with the specified IDs

packageBreakdownboolean nullable

Per-document override for package breakdown. Null means use property default.

Response

Successful file download

Changes

No recorded changes to this operation across all 1 revision of this API.