Use Campos de Dados da Cloudbeds em múltiplos níveis em relatórios do Cloudbeds Insights

Gabriela Garcia

Atualizado 5 de novembro de 2026 13:39

Objetivo	Entender, habilitar e usar Campos de Dados da Cloudbeds em múltiplos níveis quando um relatório precisar de informações abaixo do registro de nível superior.
Ideal para	Gerentes de estabelecimento, gerentes gerais, administradores e proprietários que criam ou editam relatórios personalizados no Cloudbeds Insights.
Use quando	Você precisar de informações mais detalhadas dentro de um registro, visualizar a opção Campos de Dados da Cloudbeds Multinível no seletor de campos ou notar linhas adicionais após adicionar um campo.
Requisitos	Cloudbeds Insights e um relatório que você possa criar ou editar.
Resultado esperado	O relatório inclui o detalhe adicional que você precisa, e você entende como os campos multinível afetam suas linhas e totais.
Limitações	Campos multinível podem criar linhas adicionais e repetir valores que existem apenas em um nível superior do relatório. Revise as linhas e totais resultantes antes de usar o relatório para análise.

Introdução

Um relatório do Cloudbeds Insights pode conter informações em mais de um nível. Por exemplo, uma reserva pode conter várias acomodações. Um Campo de Dados da Cloudbeds (CDF) multinível permite incluir informações desses registros subjacentes mais detalhados.

Os CDFs multinível são úteis quando o registro de nível superior não fornece detalhes suficientes para a pergunta que você está tentando responder. Como adicionar esses campos pode alterar o número de linhas no relatório, é importante entender o nível de relatório resultante antes de confiar em totais ou outros cálculos.

Este guia explica como identificar e habilitar os CDFs multinível, adicioná-los a um relatório e revisar o efeito que eles têm nos resultados do relatório.

Neste artigo

Entender os Cloudbeds Data Fields multinível
Habilitar os CDFs multinível
Adicionar CDFs multinível a um relatório
Revisar linhas e totais após adicionar CDFs multinível

Entender os Cloudbeds Data Fields multinível

Os CDFs multinível representam informações de um nível mais detalhado do que o registro de nível superior no relatório. Você pode identificar os dados multinível disponíveis pelo ícone multinível exibido ao lado das categorias e campos aplicáveis no seletor de campos.

Um exemplo comum são os dados de Reservas. Uma reserva pode conter mais de uma acomodação. No nível da reserva, ainda é uma única reserva, mas informações no nível do quarto, como Número do Quarto, Tipo de Acomodação ou outros valores no nível da acomodação podem ocorrer mais de uma vez dentro dela.

Os campos multinível permitem que o relatório represente esses registros subjacentes separadamente, em vez de mostrar apenas as informações da reserva de nível superior. Isso oferece um relatório mais detalhado, mas também pode alterar a estrutura das linhas do relatório.

Para definições dos Cloudbeds Data Fields individuais e das categorias de dados onde estão disponíveis, consulte Cloudbeds Data Fields (CDFs): definições e cálculos.

Habilitar os CDFs multinível

Os CDFs multinível não são habilitados por padrão. Quando estiverem disponíveis para o relatório, o seletor de campos mostrará CDF multinível com um botão Habilitar.

Crie um novo relatório ou abra um relatório que você possa editar no Cloudbeds Insights.
No Painel da Estrutura da Tabela, clique em + Adicionar em Colunas, Agrupar Linhas ou Agrupar Colunas.
Localize CDF multinível e clique em Habilitar.

O exemplo abaixo mostra a opção CDF multinível antes de ser habilitada.

Uma janela de confirmação é aberta com um aviso de que CDFs multinível podem causar registros repetidos. Você pode abrir este artigo pelo Saiba mais na base de conhecimento e, em seguida, retornar ao relatório e clicar em Eu entendo para habilitar os campos.

Após clicar em Eu entendo, retorne a + Adicionar. Os campos multinível agora estão selecionáveis e Habilitar é substituído por Leia mais.

A animação abaixo mostra o estado habilitado e a opção Leia mais.

Leia mais reabre a mesma janela de informações e fornece novamente o link do artigo.

Adicionar CDFs multinível a um relatório

Após habilitar os CDFs multinível, escolha apenas os campos detalhados que suportam a pergunta que você quer que o relatório responda. Categorias e campos multinível disponíveis são identificados com o ícone multinível no seletor de campos.

Para adicionar um campo multinível:

No Estrutura da tabela, clique em + Adicionar em Colunas, Agrupar linhas ou Agrupar colunas.
Localize a categoria multinível que contém o campo que você precisa.
Selecione a caixa de seleção ao lado do campo aplicável.
Repita a seleção se precisar de campos multinível adicionais.
Feche o seletor de campos ou retorne aos resultados do relatório e revise as linhas atualizadas.

No exemplo abaixo, Diária e Tipo de acomodação estão selecionados como campos multinível. Eles são adicionados à Estrutura da tabela com o ícone multinível, e o relatório é atualizado para representar os registros mais detalhados.

Adicione apenas o nível de detalhe que você precisa. Cada campo multinível pode introduzir registros mais detalhados no relatório. Revise o relatório após adicionar os campos, em vez de presumir que a estrutura original das linhas permanecerá inalterada.

Para o fluxo de trabalho geral de adicionar campos, agrupar dados, aplicar filtros e configurar a Estrutura da tabela, veja Criar e configurar um relatório personalizado no Cloudbeds Insights.

Revisar linhas e totais após adicionar CDFs multinível

Adicionar um campo multinível altera o nível de detalhe representado no relatório. Um registro de nível superior pode, portanto, aparecer em mais de uma linha quando existem vários itens subjacentes.

Por exemplo, se uma reserva contém duas acomodações, adicionar campos no nível da acomodação pode criar linhas separadas para que ambas as acomodações sejam representadas sob o mesmo número de reserva.

Revise os valores de nível superior antes de confiar nos totais. Algumas informações existem apenas no nível da reserva. Quando um campo multinível cria linhas adicionais, esses valores de nível superior podem se repetir nas linhas detalhadas e fazer com que alguns totais pareçam duplicados ou exagerados.

Isso é especialmente importante ao combinar campos multinível com valores que existem apenas em um nível superior do relatório, como algumas informações financeiras.

Campos multinível também podem afetar filtros. Se você usar um CDF multinível em um filtro, revise as linhas resultantes para confirmar que os registros restantes ainda representam o nível de relatório que você pretende analisar.

Antes de salvar ou usar o relatório:

Verifique se o número de linhas aumentou após adicionar o campo multinível.
Confirme se números de reserva repetidos representam itens subjacentes separados dentro da mesma reserva.
Revise totais e outros cálculos para valores de nível superior que podem se repetir nas linhas detalhadas.
Confirme que quaisquer filtros que usem campos multinível retornam os registros detalhados esperados.

Se você não tiver certeza se o nível do campo ou a agregação correspondem à pergunta que deseja que o relatório responda, veja Escolher campos e agregações para um relatório do Cloudbeds Insights.

Próximo passo

Após confirmar que os campos multinível produzem as linhas e totais esperados, continue configurando e salve o relatório. Veja Criar e configurar um relatório personalizado no Cloudbeds Insights para o fluxo completo de criação de relatórios.