Why nightly totals can't be split by transaction detail in Cloudbeds Insights

PurposeUnderstand why a summary figure such as Total Room Revenue can show dashes when it is broken down by transaction-level detail.
Best forAnyone building or troubleshooting a custom report in Cloudbeds Insights.
Use this whenA summary figure shows a dash after you add Transaction Status, Transaction Type, Tax Type, or another transaction-level field to the report.
RequirementsA custom Cloudbeds Insights report that combines a summary figure with transaction-level detail.
Expected resultYou can identify why the summary figure cannot be split at the transaction level and choose a field or report structure that matches the detail you need.
LimitationsA summary figure cannot be divided across individual transactions when there is no accurate way to assign part of that figure to each transaction. The report total remains correct.

Introduction

Summary revenue and occupancy figures in Cloudbeds Insights are recorded at specific levels, such as per reservation, per room, or per night. Transaction-level fields describe individual charges associated with those reservations and nights.

One night can have one summary revenue figure but several charges with different transaction statuses, types, taxes, or other transaction details. Because there is no accurate way to divide the single summary figure among those individual charges, Cloudbeds Insights does not display the summary value on those detailed rows.

This article explains what you will see in the report, why the total remains correct, and which alternatives to use depending on the information you need.

Table of contents

Why a summary figure cannot be split by transaction detail

Fields such as Total Room Revenue represent summary values recorded at a broader level. Transaction-level fields such as Transaction Status, Transaction Type, Tax Type, and general ledger codes describe individual charges.

A single night can have several charges associated with it. For example, some charges may be Posted while others are Pending. The night's Total Room Revenue is still one figure, so there is no correct way to determine how much of that total belongs to each transaction status.

When you place transaction-level detail next to a summary figure, the summary figure shows a dash on the detailed rows and remains available where it can be calculated accurately, such as the total line.

 The summary figure is not being double counted or inflated. A dash means there is no meaningful value to display for that particular transaction-level row. The overall summary total remains correct.

Example: Total Room Revenue and Transaction Status

In this example, a room has 370 in Total Room Revenue across three nights. Charges associated with the stay have a mix of Posted and Pending transaction statuses.

Transaction StatusDebitsTotal Room Revenue
Posted219–
Pending188–
Total407370

Debits can be split by Transaction Status because Debits is recorded for each transaction. Total Room Revenue cannot be divided between Posted and Pending charges because it is a summary figure for the room nights.

The 370 Total Room Revenue shown on the total line is correct. The dashes simply prevent that figure from being assigned to transaction-level rows where there is no accurate split.

What to do instead

Choose the report structure based on whether you need transaction detail or the summary figure.

  • Use Debits or Transaction Amount when you need transaction-level detail. These figures are recorded per transaction, so they can be broken down by fields such as Transaction Status, Transaction Type, or Tax Type.
  • Remove the transaction-level field when you need the summary figure. Without the finer transaction breakdown, the summary value can display at the level where it is recorded.

Why Stay Date is not affected

Stay Date does not create the same issue. Breaking a summary figure down by Stay Date works, including for whole-stay figures such as Room Rate Total.

In those cases, the figure can be divided across the nights of the stay. The limitation described in this article applies to transaction-level detail, not to Stay Date itself.


Now that you understand why summary figures cannot always be split by transaction detail, review this foundational guide for more information about how levels of detail affect field combinations throughout Cloudbeds Insights:

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.