Manage Charges

This page explains how booking folios work for Group objects, and how you can use routings to direct charges to the right folio.

Booking folios are created for each Group object. These are empty folios you can use when some or all charges aren’t paid by the guests themselves, but by a single booker or company. The typical example is when a company might cover accommodation and breakfast for its employees, but the employees pay for everything else.

Routings allow you to direct charges from one or multiple reservations to a specific folio within the same Group booking. This can be a reservation folio or a Group booking folio. By setting up routings, you decide which future, unposted charges go to the designated folio. Charges that have already been posted are never moved retroactively.

POST /finance/v1/routings

{
  "propertyId": "MUC",
  "bookingId": "EQBOXNNQ",
  "destinationFolioId": "EQBOXNNQ-MUC-1",
  "filter": {
    "serviceTypes": ["Accommodation", "FoodAndBeverages"]
  }
}

While bookingId identifies the group booking and destinationFolioId identifies the target folio for consolidation, the specific charges that get routed there are determined by the filters below.

Filter What it controls When to use
serviceTypes Category of charges To match an entire charge category (e.g., Accommodation, Food & Beverage)
subAccountIds Charges tied to a specific sub-account Useful for charges that don’t map to a standard service type (e.g., a custom fee).
serviceIds A specific service To match one or more bookable service (e.g., Breakfast, Minibar)
folioIds (source) Which folio(s) charges are pulled from Leave empty to source from the entire booking (any current or future folio becomes a source automatically). Specify an array of folio IDs to source from specific folios only.
From / To (routing period) Time window the routing applies to To narrow charges routings only within that date range. e.g., company covers night one only

Constraints

  • Only main folios (folio IDs ending in -1) can be used as routing sources.
  • Routings only work within a single group booking.
  • Charges cannot be routed from one property to another.
  • Creating a routing whose filter would overlap with an existing routing’s filter returns a validation error.

Please note

  • If you delete a routing, all charges will return to their original sources, provided they have not been posted yet.