Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
|---|
Especificação | |||
Produto | Microsiga Protheus® | Módulo | TOTVS Smart Analytics |
Segmento Executor | Serviços | ||
Projeto | SERBA003 | IRM | SERBA003-33 |
Requisito | SERBA003-35 | Subtarefa | SERBA003-125 |
Este documento tem por objetivo especificar os novos elementos a serem inseridos no TOTVS Smart Analytics, tanto para modelagem como processo de ETL, correspondentes ao segmento de Hotelaria que, a partir desta versão, passa a ser segmento integrante do produto, abordando os assuntos de faturamento e gestão de reservas.
O assunto Faturamento será modelado através da fato Faturamento Hoteleiro que poderá ser analisada por empresa, estabelecimento, moeda, região geográfica, hotel, grupo de unidade habitacional, tipo de faturamento e período:
![Linha Microsiga Protheus > ER_SERBA003-35_Segmento_de_Hotelaria > TOTVS_BA_MER_Hotel_Faturamento_Hoteleiro[1].jpg](/download/attachments/248581190/TOTVS_BA_MER_Hotel_Faturamento_Hoteleiro%5B1%5D.jpg?version=1&modificationDate=1473358266000&api=v2)
Já para o assunto de Gestão de Reservas serão modeladas três tabelas fatos.
Para a gestão de reservas confirmadas, será modelada a tabela fato Reservas que poderá ser analisada por empresa, estabelecimento, moeda, região geográfica, hotel, grupo de unidade habitacional, status da reserva e período:
Para a gestão de reservas canceladas após a confirmação será modelada a tabela fato Reservas Canceladas que poderá ser analisada por empresa, estabelecimento, moeda, região geográfica, hotel, grupo de unidade habitacional, motivo cancelamento, status da reservas e período:
![Linha Microsiga Protheus > ER_SERBA003-35_Segmento_de_Hotelaria > TOTVS_BA_MER_Hotel_Reservas_Canceladas[1].jpg](/download/attachments/248581190/TOTVS_BA_MER_Hotel_Reservas_Canceladas%5B1%5D.jpg?version=1&modificationDate=1474319596000&api=v2)
Para a gestão das unidades habitacionais será modelada a tabela fato Ocupação Hoteleira que poderá ser analisadas por empresa, estabelecimento, moeda, região geográfica, hotel, grupo unidade habitacional, posto cliente, segmento de mercado, tipo de gratuidade, grupo empresarial e período:
A implementação do modelo descrito acima dá-se através das seguintes etapas:
1- Criação das tabelas fatos e dimensões através do GoodData CloudConect em TOTVS SMART ANALYTICS/MODEL da seguinte maneira:
| Dimensão | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| HOTEL HRD | Hotel | Connection Point | Texto | Hotel |
| Nome | Label | Texto | ||
| Código | Label | Texto | ||
| Livre0 | Attribute | Texto | ||
| Livre1 | Attribute | Texto | ||
| Livre2 | Attribute | Texto | ||
| Livre3 | Attribute | Texto | ||
| Livre4 | Attribute | Texto | ||
| Livre5 | Attribute | Texto | ||
| Livre6 | Attribute | Texto | ||
| Livre7 | Attribute | Texto | ||
| Livre8 | Attribute | Texto | ||
| Livre9 | Attribute | Texto |
| Dimensão | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| GRUPO DE UNIDADE HABITACIONAL HRE | Grupo Unidade Habitacional | Connection Point | Texto | Grupo Unidade Habitacional |
| Código | Label | Texto | ||
| Descrição | Label | Texto | ||
| Livre0 | Attribute | Texto | ||
| Livre1 | Attribute | Texto | ||
| Livre2 | Attribute | Texto | ||
| Livre3 | Attribute | Texto | ||
| Livre4 | Attribute | Texto | ||
| Livre5 | Attribute | Texto | ||
| Livre6 | Attribute | Texto | ||
| Livre7 | Attribute | Texto | ||
| Livre8 | Attribute | Texto | ||
| Livre9 | Attribute | Texto |
| Dimensão | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| MOTIVO CANCELAMENTO HRF | Motivo Cancelamento | Connection Point | Texto | Motivo Cancelamento |
| Código | Label | Texto | ||
| Descrição | Label | Texto | ||
| Livre0 | Attribute | Texto | ||
| Livre1 | Attribute | Texto | ||
| Livre2 | Attribute | Texto | ||
| Livre3 | Attribute | Texto | ||
| Livre4 | Attribute | Texto | ||
| Livre5 | Attribute | Texto | ||
| Livre6 | Attribute | Texto | ||
| Livre7 | Attribute | Texto | ||
| Livre8 | Attribute | Texto | ||
| Livre9 | Attribute | Texto |
| Dimensão | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| POSTO CLIENTE HRG | Posto Cliente | Connection Point | Texto | Posto Cliente |
| Código | Label | Texto | ||
| Nome | Label | Texto | ||
| Livre0 | Attribute | Texto | ||
| Livre1 | Attribute | Texto | ||
| Livre2 | Attribute | Texto | ||
| Livre3 | Attribute | Texto | ||
| Livre4 | Attribute | Texto | ||
| Livre5 | Attribute | Texto | ||
| Livre6 | Attribute | Texto | ||
| Livre7 | Attribute | Texto | ||
| Livre8 | Attribute | Texto | ||
| Livre9 | Attribute | Texto |
| Dimensão | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| SEGMENTO DE MERCADO HRH | Segmento de Mercado | Connection Point | Texto | Segmento de Mercado |
| Código | Label | Texto | ||
| Descrição | Label | Texto | ||
| Livre0 | Attribute | Texto | ||
| Livre1 | Attribute | Texto | ||
| Livre2 | Attribute | Texto | ||
| Livre3 | Attribute | Texto | ||
| Livre4 | Attribute | Texto | ||
| Livre5 | Attribute | Texto | ||
| Livre6 | Attribute | Texto | ||
| Livre7 | Attribute | Texto | ||
| Livre8 | Attribute | Texto | ||
| Livre9 | Attribute | Texto |
| Dimensão | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| TIPO DE GRATUIDADE HRI | Tipo de Gratuidade | Connection Point | Texto | Tipo de Gratuidade |
| Código | Label | Texto | ||
| Descrição | Label | Texto | ||
| Livre0 | Attribute | Texto | ||
| Livre1 | Attribute | Texto | ||
| Livre2 | Attribute | Texto | ||
| Livre3 | Attribute | Texto | ||
| Livre4 | Attribute | Texto | ||
| Livre5 | Attribute | Texto | ||
| Livre6 | Attribute | Texto | ||
| Livre7 | Attribute | Texto | ||
| Livre8 | Attribute | Texto | ||
| Livre9 | Attribute | Texto |
| Dimensão | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| STATUS DA RESERVA HRJ | Status da Reserva | Connection Point | Texto | Status da Reserva |
| Código | Label | Texto | ||
| Descrição | Label | Texto | ||
| Livre0 | Attribute | Texto | ||
| Livre1 | Attribute | Texto | ||
| Livre2 | Attribute | Texto | ||
| Livre3 | Attribute | Texto | ||
| Livre4 | Attribute | Texto | ||
| Livre5 | Attribute | Texto | ||
| Livre6 | Attribute | Texto | ||
| Livre7 | Attribute | Texto | ||
| Livre8 | Attribute | Texto | ||
| Livre9 | Attribute | Texto |
| Dimensão | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| GRUPO EMPRESARIAL HRK | Grupo Empresarial | Connection Point | Texto | Grupo Empresarial |
| Código | Label | Texto | ||
| Descrição | Label | Texto | ||
| Livre0 | Attribute | Texto | ||
| Livre1 | Attribute | Texto | ||
| Livre2 | Attribute | Texto | ||
| Livre3 | Attribute | Texto | ||
| Livre4 | Attribute | Texto | ||
| Livre5 | Attribute | Texto | ||
| Livre6 | Attribute | Texto | ||
| Livre7 | Attribute | Texto | ||
| Livre8 | Attribute | Texto | ||
| Livre9 | Attribute | Texto |
| Dimensão | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| TIPO DE FATURAMENTO HRL | Tipo de Faturamento | Connection Point | Texto | Tipo de Faturamento |
| Código | Label | Texto | ||
| Descrição | Label | Texto | ||
| Livre0 | Attribute | Texto | ||
| Livre1 | Attribute | Texto | ||
| Livre2 | Attribute | Texto | ||
| Livre3 | Attribute | Texto | ||
| Livre4 | Attribute | Texto | ||
| Livre5 | Attribute | Texto | ||
| Livre6 | Attribute | Texto | ||
| Livre7 | Attribute | Texto | ||
| Livre8 | Attribute | Texto | ||
| Livre9 | Attribute | Texto |
| Dimensão | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| FATURAMENTO HOTELEIRO HRM | Vl Faturamento | Fact | Decimal(15,5) | Faturamento Hoteleiro |
| _Livre0 | Fact | Decimal(15,5) | ||
| _Livre1 | Fact | Decimal(12,2) | ||
| _Livre2 | Fact | Decimal(12,2) | ||
| _Livre3 | Fact | Decimal(12,2) | ||
| _Livre4 | Fact | Decimal(12,2) | ||
| _Livre5 | Attribute | Texto | ||
| _Livre6 | Attribute | Texto | ||
| _Livre7 | Attribute | Texto | ||
| _Livre8 | Attribute | Texto | ||
| _Livre9 | Attribute | Texto |
Com associação as dimensões: Empresa, Estabelecimento, Hotel, Grupo de Unidade Hoteleira, Região Geográfica, Moeda, Tipo de Faturamento, Data e Areas.
| Fato | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| RESERVAS CANCELADAS HRN | Qtd Reservas Canceladas | Fact | Decimal(15,5) | Reservas Canceladas |
| Qtd Pernoites Cancelados | Fact | Decimal(15,5) | ||
| Vl Reservas Canceladas | Fact | Decimal(15,5) | ||
| Vl Diária Cancelada | Fact | Decimal(15,5) | ||
| Cancelado no Prazo? | Attribute | Texto | ||
| Com Multa? | Attribute | Texto | ||
| _Livre0 | Fact | Decimal(12,2) | ||
| _Livre1 | Fact | Decimal(12,2) | ||
| _Livre2 | Fact | Decimal(12,2) | ||
| _Livre3 | Fact | Decimal(12,2) | ||
| _Livre4 | Fact | Decimal(12,2) | ||
| _Livre5 | Attribute | Texto | ||
| _Livre6 | Attribute | Texto | ||
| _Livre7 | Attribute | Texto | ||
| _Livre8 | Attribute | Texto | ||
| _Livre9 | Attribute | Texto |
Com associação as dimensões: Empresa, Estabelecimento, Hotel, Grupo de Unidade Hoteleira, Região Geográfica, Motivo Cancelamento, Status da Reserva, Moeda, Data e Areas.
| Fato | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| RESERVAS HRO | Qtd Reservas | Fact | Decimal(15,5) | Reservas |
| Qtd Pernoites | Fact | Decimal(15,5) | ||
| Vl Reservas | Fact | Decimal(15,5) | ||
| _Livre0 | Fact | Decimal(12,2) | ||
| _Livre1 | Fact | Decimal(12,2) | ||
| _Livre2 | Fact | Decimal(12,2) | ||
| _Livre3 | Fact | Decimal(12,2) | ||
| _Livre4 | Fact | Decimal(12,2) | ||
| _Livre5 | Attribute | Texto | ||
| _Livre6 | Attribute | Texto | ||
| _Livre7 | Attribute | Texto | ||
| _Livre8 | Attribute | Texto | ||
| _Livre9 | Attribute | Texto |
Com associação as dimensões: Empresa, Estabelecimento, Hotel, Grupo de Unidade Hoteleira, Região Geográfica, Status da Reserva, Moeda, Data e Areas.
| Fato | Título | Tipo | DataType | Pasta |
|---|---|---|---|---|
| OCUPAÇÃO HOTELEIRA HRP | Qtd Reservas | Fact | Decimal(15,5) | Ocupação Hoteleira |
| Qtd UH Ocupadas | Fact | Decimal(15,5) | ||
| Qtd UH Total | Fact | Decimal(15,5) | ||
| Qtd UH Bloqueadas | Fact | Decimal(15,5) | ||
| Vl Receita Diária | Fact | Decimal(15,5) | ||
| _Livre0 | Fact | Decimal(12,2) | ||
| _Livre1 | Fact | Decimal(12,2) | ||
| _Livre2 | Fato | Decimal(12,2) | ||
| _Livre3 | Fact | Decimal(12,2) | ||
| _Livre4 | Fact | Decimal(12,2) | ||
| _Livre5 | Attribute | Texto | ||
| _Livre6 | Attribute | Texto | ||
| _Livre7 | Attribute | Texto | ||
| _Livre8 | Attribute | Texto | ||
| _Livre9 | Attribute | Texto |
Com associação as dimensões: Empresa, Estabelecimento, Hotel, Grupo de Unidade Hoteleira, Região Geográfica, Tipo de Gratuidade, Posto Cliente, Segmento de Mercado, Grupo Empresarial, Moeda, Data e Areas.
2- Criação dos graphs das dimensões no GoodData CloudConect em TOTVS SMART ANALYTICS/GRAPH/DIMENSIONS:
3- Criação dos graphs das fatos no GoodData CloudConect em TOTVS SMART ANALYTICS/GRAPH/FACT:
4- Inclusão dos graphs, tanto dimensão como fato, no graph MAIN_JOB em TOTVS SMART ANALYTICS/GRAPH.
5- Adicionar as dimensões no arquivo DIMENSION_PARAMETERS.TXT em /DATA/TRANSFORM/ da seguinte forma:
| Dataset | Tabela |
|---|---|
| hotelhrd | HRD |
grupodeunidadehabitacionalhre | HRE |
motivocancelamentohrf | HRF |
postoclientehrg | HRG |
segmentodemercadohrh | HRH |
tipodegratuidadehri | HRI |
| statusdareservahrj | HRJ |
| grupoempresarialhrk | HRK |
| tipodefaturamentohrl | HRL |
6- Adicionar a limpeza padrão das tabelas fato no arquivo PURGE_PARAMETERS.TXT em /DATA/TRANSFORM/ da seguinte forma:
| Dataset | Campo de Data | Período | Qtd de Tempo | Tabela | Nome da Fato | Área |
|---|---|---|---|---|---|---|
faturamentohoteleirohrm | data | year | 2 | HRM | Faturamento Hoteleiro | Hotelaria |
reservascanceladashrn | data | year | 2 | HRN | Reservas Canceladas | Hotelaria |
reservashro | data | year | 2 | HRO | Reservas | Hotelaria |
ocupacaohoteleirahrp | data | year | 2 | HRP | Ocupação Hoteleira | Hotelaria |
7- Adicionar as instruções SQL para criação dos arquivos CSV, tanto de dimensões como de fatos, no arquivo my.properties, no Agent:
8- Adicionar os campos de data das tabelas fato no arquivo DATE_FIELD.TXT no Agent:
9- Criação das métricas das tabelas fatos no Portal em MANAGE/METRICS:
| Pasta | Nome | Descrição | Agregação/Fórmula | Formato |
|---|---|---|---|---|
| Faturamento Hoteleiro | Vl Faturamento | Indica o valor faturado com os serviços prestados pelo hotel ao hóspede durante a sua estadia. Este valor pode ser proveniente de diárias, eventos, outros serviços, etc. | Soma | $ #.##0,00 |
| Reservas | Qtd Reservas | Indica a quantidade de reservas confirmadas e check ins realizados no dia. | Soma | #.##0 |
Qtd Pernoites | Indica a quantidade de pernoites programados para as reservas confirmadas e reservas que realizaram check ins no dia. | Soma | #.##0 | |
Vl Reservas | Indica o valor total das reservas confirmadas e check ins realizados no dia | Soma | $ #.##0,00 | |
| Reservas Canceladas | Qtd Reservas Canceladas | Indica a quantidade de reservas confirmadas que foram canceladas. | Soma | #.##0 |
Qtd Pernoites Cancelados | Indica a quantidade de pernoites que foram afetados com os cancelamentos das reservas confirmadas. | Soma | #.##0 | |
Vl Reserva Cancelada | Indica o valor total das reservas confirmadas que foram canceladas. | Soma | $ #.##0,00 | |
Vl Diária Cancelada | Indica o valor da primeira diária das reservas confirmadas que foram canceladas. Este valor de primeira diária seria o valor cobrado do hóspede em caso de multa por cancelamento fora do prazo ou no show. | Soma | $ #.##0,00 | |
Receita Perdida | Indica o valor referente a primeira diária que deveria ter sido cobrado dos hóspedes em caso de cancelamento das reservas fora do prazo mas que não foi cobrado, caracterizando assim um valor de receita que o hotel perdeu pela falta de cobrança. | Soma / Se (Cancelado no Prazo? = N e Com Multa? = N) Então Vl Diária Senão 0 | $ #.##0,00 | |
Taxa de Cancelamento | Indica a taxa de reservas confirmadas que foram canceladas em relação ao total de reservas confimadas (também considera como reserva confirmada as reservas que já foram efetivados os check ins). | Soma / Total(Qtd Reservas Canceladas) / (Total(Qtd Reservas Canceladas) + Total(Qtd Reservas)) | #.##0,00 % | |
| Ocupação Hoteleira | Qtd Reservas | Indica a quantidade de reservas que já efetivaram o check in no hotel, na data. | Soma | #.##0 |
Qtd UH Ocupados | Indica a quantidade de unidades habitacionais ocupadas pelas hospedes na data. A ocupação pode ser gerada por check in no dia ou anterior. | Soma | #.##0 | |
Qtd Total de UH | Indica a quantidade total de unidades habitacionais construídas que estariam disponíveis para a hospedagem. Não indica a quantidade de unidades habitacionais vagas. | Soma | #.##0 | |
Qtd UH Bloqueados | Indica a quantidade de unidades habitacionais bloqueadas, indisponíveis para hospedagem. Este bloqueio pode ser por motivos variados como em construção, em manutenção, etc. | Soma | #.##0 | |
Vl Receita Diária | Indica o valor da receita obtida na data com as unidade habitacionais ocupadas. | Soma | $ #.##0,00 | |
REVPAR | Indica o valor de receita média obtida considerando todas as unidades habitacionais construídas. | Soma / Vl Receita Diária/Qtd Total de UH | $ #.##0,00 | |
Estada Média | Indica a quantidade média de pernoites do período, considerando a quantidade de reservas do mesmo período. Indicado ideal para análise de período agregado. | Soma / Qtd UH Ocupados/Qtd Reservas | #.##0,00 | |
Diária Média | Indica o valor médio pago pela diárias das unidades habitacionais ocupadas. | Soma / Vl Receita Diária/Qtd UH Ocupados | $ #.##0,00 | |
Taxa de Ocupação | Indica o percentual de unidades habitacionais ocupadas na data. | Soma / (Qtd UH Ocupados/Qtd Total de Uh) * 100 | #.##0,00 % |
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
|---|