Por que os valores resumidos não podem ser filtrados por detalhes de transação no Cloudbeds Insights

Gabriela Garcia

Atualizado 27 de outubro de 2026 08:43

Objetivo	Entender por que uma métrica resumida, como a Receita Total de Hospedagem, nem sempre pode ser filtrada por campos no nível da transação.
Indicado para	Qualquer pessoa que esteja criando ou solucionando problemas em um relatório personalizado no Cloudbeds Insights.
Use quando	Você aplicar um filtro como Status da Transação, Tipo de Transação ou Tipo de Imposto a um relatório que inclui uma métrica resumida, e o Cloudbeds Insights indicar que os campos não funcionam juntos.
Requisitos	Um relatório personalizado do Cloudbeds Insights que inclua uma métrica agregada ou resumida e um filtro no nível da transação.
Resultado esperado	Você poderá identificar quando um filtro no nível da transação é incompatível com uma métrica resumida e escolher um campo ou configuração de filtro que corresponda ao nível de detalhe necessário.
Limitações	Uma métrica resumida não pode ser detalhada até o nível da transação quando a própria métrica não é registrada nesse nível.

Introdução

Filtros fazem parte da definição de um relatório no Cloudbeds Insights. Mesmo quando um campo não aparece como coluna ou linha no relatório, usá-lo como filtro pode alterar o nível de detalhe que o relatório está solicitando.

Isso importa quando você combina uma figura resumida, como Receita Total de Hospedagem, Receita Total, Quartos Vendidos ou Total Geral, com um filtro no nível da transação, como Status da Transação, Tipo de Transação ou Tipo de Imposto.

Este artigo explica por que essas combinações podem gerar uma mensagem dentro do produto e o que usar em vez disso.

Por que um filtro no nível da transação não funciona com uma figura resumida

Figuras resumidas são calculadas em níveis mais amplos, como por reserva, quarto ou diária. Campos no nível da transação descrevem cobranças individuais.

Quando você filtra por um campo no nível da transação, o relatório restringe os dados às transações individuais. Uma figura agregada não pode seguir esse filtro até o nível da transação quando não há uma forma precisa de atribuir parte da figura resumida a cada cobrança individual.

Um filtro conta como parte do relatório. O campo no nível da transação não precisa aparecer na grade para afetar se uma figura resumida pode ser calculada nesse nível.

Esse comportamento pode passar despercebido porque o campo que causa o conflito pode aparecer apenas nas configurações do filtro. O relatório em si pode parecer inalterado.

Exemplo: filtrando Receita Total de Hospedagem por Status da Transação

Receita Total de Hospedagem é uma figura resumida. Status da Transação descreve transações individuais.

Se você filtrar a Receita Total de Hospedagem para mostrar apenas um Status da Transação específico, o filtro pede que a figura resumida siga o detalhe da transação individual. Como a Receita Total de Hospedagem não é registrada por transação, não há uma forma precisa de determinar qual parte dessa figura resumida pertence a cada status de transação.

Por isso, o Cloudbeds Insights alerta você sobre a combinação incompatível em vez de apresentar um valor que poderia ser enganoso.

O que fazer em vez disso

Escolha o campo ou a configuração do filtro com base na necessidade de detalhe no nível da transação ou da figura resumida mais ampla.

Use Débitos ou Valor da Transação quando precisar de um filtro no nível da transação. Essas figuras são registradas por transação, então podem ser filtradas por campos no nível da transação, como Status da Transação, Tipo de Transação ou Tipo de Imposto.
Remova o filtro no nível da transação quando precisar da figura resumida. Sem o filtro mais detalhado, a figura resumida pode permanecer no nível em que é calculada.

Agora que você entende como filtros no nível da transação afetam figuras resumidas, confira estes recursos para o conceito mais amplo de nível de detalhe e o cenário relacionado em que o detalhe da transação é exibido diretamente no relatório: