Compreendendo os níveis de detalhe nos relatórios do Cloudbeds Insights

Gabriela Garcia

Atualizado 27 de outubro de 2026 08:42

Objetivo	Entender por que alguns campos em um relatório do Cloudbeds Insights podem ser combinados ou detalhados juntos enquanto outros não podem.
Indicado para	Qualquer pessoa que esteja criando ou solucionando problemas em um relatório personalizado no Cloudbeds Insights.
Use este recurso quando	Um relatório mostrar traços em algumas células, um valor não puder ser dividido por outro campo, ou você precisar entender quais campos podem ser usados juntos.
Requisitos	Um relatório personalizado no Cloudbeds Insights com campos que você deseja combinar, filtrar ou detalhar.
Resultado esperado	Você poderá reconhecer quando campos estão sendo combinados em níveis incompatíveis de detalhe e escolher uma estrutura de relatório ou campo que combine melhor com a análise que precisa.
Limitações	Um valor resumido não pode ser dividido de forma significativa por um detalhe que existe em um nível mais específico do que o próprio valor. Quando isso acontece, as células afetadas podem mostrar um traço, enquanto os totais do relatório permanecem corretos.

Introdução

O Cloudbeds Insights permite que você crie relatórios personalizados combinando campos de diferentes partes dos dados do seu estabelecimento. No entanto, esses campos não são todos registrados no mesmo nível de detalhe.

Uma reserva é um nível. Os quartos incluídos nessa reserva são mais detalhados. Cada noite de cada quarto é ainda mais detalhada, enquanto cobranças individuais, pagamentos, repasses e faturas são registrados em níveis ainda mais específicos.

Essas diferenças determinam como um campo pode ser agrupado, filtrado ou exibido junto com outros campos. Quando um relatório solicita ao Cloudbeds Insights que divida um valor resumido em detalhes que esse valor não contém, as células afetadas podem mostrar um traço em vez de um número.

Este artigo explica como funcionam os níveis de detalhe, por que eles afetam algumas combinações de campos, o que os traços significam e como ajustar seu relatório quando isso acontecer.

Neste artigo

Entenda os níveis de detalhe em um relatório
Por que os níveis de detalhe afetam os resultados do relatório
O que um traço significa no seu relatório
O que fazer quando os campos não combinam

Entenda os níveis de detalhe em um relatório

Cada campo no Cloudbeds Insights pertence à parte dos dados do seu estabelecimento onde essa informação é registrada. Entender esse nível ajuda a explicar por que um campo funciona em algumas combinações de relatório, mas não em outras.

Nível	Exemplos de campos registrados neste nível
Reserva	Total Geral, Receita de Hospedagem Total, Data de Check-in, Data de Check-out
Quarto em uma reserva	Total da Tarifa do Quarto, Preço Total do Quarto, Tipo de Acomodação, Plano de Refeição
Uma noite desse quarto	Receita Total do Quarto, Quartos Vendidos, Data da Estadia
Uma cobrança nessa noite	Débitos, Valor da Transação, Status da Transação, Data do Serviço
Um pagamento, repasse ou fatura	Valor Líquido do Pagamento, Valor do Repasse, Valor do Documento, Data do Repasse

Um nível mais amplo contém menos detalhes. Uma reserva, por exemplo, representa a reserva como um todo. Um campo no nível de transação descreve uma cobrança individual associada a essa reserva.

Por que os níveis de detalhe afetam os resultados do relatório

Um valor pode ser exibido no seu próprio nível ou resumido em uma visão mais ampla. Por exemplo, Receita Total do Quarto é registrada por noite, então pode ser resumida por mês, tipo de acomodação ou reserva. Essas visões agrupam os mesmos valores noturnos em um total mais amplo.

O inverso nem sempre funciona. A receita de uma noite é um valor único, mas a mesma noite pode ter várias cobranças individuais lançadas em momentos diferentes. Não existe uma forma correta de decidir quanto desse valor único por noite pertence a cada cobrança individual.

Quando o relatório solicita esse tipo de divisão, o Cloudbeds Insights não atribui um valor arbitrário às linhas detalhadas. Em vez disso, o valor resumido não é exibido quando esse detalhamento seria enganoso.

O que um traço significa no seu relatório

Quando um valor resumido é combinado com detalhes que não podem ser divididos, as células afetadas mostram um traço em vez de um número. Uma mensagem curta dentro do produto também pode explicar por que os campos não funcionam no mesmo nível.

Seus totais ainda estão corretos. Os traços alteram quais células individuais podem exibir um número significativo. Eles não alteram os totais subjacentes, que são calculados a partir dos dados do relatório e não pela soma das linhas visíveis na tela.

Esse comportamento impede que um valor resumido apareça ao lado de linhas detalhadas quando não há uma forma precisa de dividir esse valor.

O que fazer quando os campos não se combinam

O melhor ajuste depende se você precisa do detalhamento ou do valor resumido.

Use o valor detalhado. Se você precisa da receita dividida por cobranças individuais, use Débitos ou Valor da Transação. Esses valores são registrados por transação, então podem ser divididos por campos no nível da transação.
Remova o campo mais detalhado. Se o valor resumido é o que você precisa, remova o campo que está solicitando ao relatório dividir o valor em um nível mais detalhado. O valor resumido poderá então ser exibido no nível em que foi registrado.
Crie dois relatórios. Um relatório focado na receita por noite e outro no nível de transação podem mostrar as informações corretas em seus níveis naturais. O problema ocorre quando níveis incompatíveis são combinados na mesma grade.

Adicionar mais detalhes a um relatório é suportado

Esse comportamento não impede que você crie relatórios detalhados. Por exemplo, um relatório com uma linha por hóspede por noite é uma saída normal suportada, e alguns fluxos de trabalho legais exigem esse nível de detalhe.

A restrição se aplica apenas quando um valor resumido é colocado ao lado de detalhes que o próprio valor não pode ser dividido.

Agora que você entende como os níveis de detalhe afetam os relatórios do Cloudbeds Insights, revise estes artigos específicos para cenários que oferecem mais orientações sobre detalhes de transações, combinações de datas, totais de reservas e noites, e métricas dinâmicas: