Sign in

v1

latestOpenAPI 3.0.12026-07-245277551.2 MB
Custom Transaction Codes

List custom transaction codes

Retrieve all custom transaction code mappings for a property. Custom transaction codes let you assign your own codes to each Cloudbeds internal transaction type (e.g., room rate, tax, payment method). You must call the initialize endpoint before codes can be retrieved for the first time.

get/accounting/v1.0/custom-transaction-codes

Headers

X-Property-IDinteger required

Property id

Response

OK

idstring
versioninteger
namestring required
codestring required

The custom code assigned by the user.

transactionItemCodestring

The system code that cannot be modified.

skustring
itemGroup'items_services' | 'reservations' | 'taxes_fees' | 'payments' | 'accrual_accounting' | 'custom_item' | 'spaces' | 'accounts_receivable_transfers' | 'deposit_transfers' | 'channel_commission' | 'gratuity'

Category grouping for transaction item codes. Used to classify custom transaction codes and general ledger codes.

  • items_services — Products and services sold to guests (minibar, restaurant, spa, etc.).
  • reservations — Room rate charges and room revenue adjustments.
  • taxes_fees — Tax and fee line items applied to charges.
  • payments — Payment transactions (cash, card, bank transfer, etc.).
  • accrual_accounting — Accrual accounting entries for revenue recognition.
  • custom_item — Custom POS or manually created charge items.
  • spaces — Charges related to bookable spaces (meeting rooms, event venues, etc.).
  • accounts_receivable_transfers — Transfers to or from accounts receivable ledgers.
  • deposit_transfers — Transfers to or from the deposit ledger.
customGeneralLedgerCodeIdstring
itemIdstring

Item ID for items_services group

posItemIdstring

POS Item ID for items_services group

taxIdstring

Tax ID for taxes_fees group (taxes)

feeIdstring

Fee ID for taxes_fees group (fees)

paymentIdstring

Payment ID for payments group

spaceIdstring

Space ID for spaces group

channelIdstring

Channel ID for channel commission group