Histórico da Página

Informações Gerais

 Objetivo

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 contando com os , abordando os assuntos de faturamento e gestão de reservas. 

Definição da Regra de Negócio

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:

 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 analisadas analisada por empresa, estabelecimento, moeda, região geográfica, hotel, grupo de unidade habitacional, motivo cancelamento, status da reservas e período:

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 Hotel - HRD:

•  Dimensão Grupo de Unidade Habitacional - HRE:

•  Dimensão Motivo Cancelamento - HRF:

•  Dimensão Posto Cliente - HRG:

•  Dimensão Segmento de Mercado - HRH:

•  Dimensão Tipo de Gratuidade- HRI:

•  Dimensão Status da Reserva - HRJ:

•  Dimensão Grupo Empresarial - HRK:

•  Dimensão Tipo de Faturamento - HRL:

Exemplo de Aplicação:

• Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
• Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades  como a referência mínima para calcular o débito total do aluno.
• Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
• O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.

Tabelas Utilizadas

• SE2 – Cadastro de Contas a Pagar
• FI9 – Controle de Emissão de DARF>.

Opcional

Protótipo de Tela

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

Protótipo 01

 Image Removed

Opcional

Fluxo do Processo

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

Opcional

Dicionário de Dados

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB

•  Fato Faturamento Hoteleiro - HRM:

 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 Reservas Canceladas- HRN:

  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 Reservas - HRO:

   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 Ocupação Hoteleira - HRP:

  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:

• LOAD_DIMENSION_TABLE_HRD
• LOAD_DIMENSION_TABLE_HRE
• LOAD_DIMENSION_TABLE_HRF
• LOAD_DIMENSION_TABLE_HRG
• LOAD_DIMENSION_TABLE_HRH
• LOAD_DIMENSION_TABLE_HRI
• LOAD_DIMENSION_TABLE_HRJ
• LOAD_DIMENSION_TABLE_HRK
• LOAD_DIMENSION_TABLE_HRL

 3- Criação dos graphs das fatos no GoodData CloudConect em TOTVS SMART ANALYTICS/GRAPH/FACT:

• LOAD_FACT_TABLE_HRM
• LOAD_FACT_TABLE_HRN
• LOAD_FACT_TABLE_HRO
• LOAD_FACT_TABLE_HRP

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:

6- Adicionar a limpeza padrão das tabelas fato no arquivo PURGE_PARAMETERS.TXT em /DATA/TRANSFORM/ da seguinte forma:

 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:

• data.HRD.sql=SELECT HRD_ISTCIA,HRD_LINPRO,HRD_GRPEMP,HRD_CDUNEG,HRD_CDEMPR,HRD_FILIAL,HRD_HOTEL,HRD_CODIGO,HRD_NOME,HRD_LIVRE0,
  HRD_LIVRE1,HRD_LIVRE2,HRD_LIVRE3,HRD_LIVRE4,HRD_LIVRE5,HRD_LIVRE6,HRD_LIVRE7,HRD_LIVRE8,HRD_LIVRE9 FROM HRD

• data.HRE.sql=SELECT HRE_ISTCIA,HRE_LINPRO,HRE_GRPEMP,HRE_CDUNEG,HRE_CDEMPR,HRE_FILIAL,HRE_GRUPUH,HRE_CODIGO,HRE_DESC,HRE_LIVRE0,
  HRE_LIVRE1,HRE_LIVRE2,HRE_LIVRE3,HRE_LIVRE4,HRE_LIVRE5,HRE_LIVRE6,HRE_LIVRE7,HRE_LIVRE8,HRE_LIVRE9 FROM HRE

• data.HRF.sql=SELECT HRF_ISTCIA,HRF_LINPRO,HRF_GRPEMP,HRF_CDUNEG,HRF_CDEMPR,HRF_FILIAL,HRF_MOTCAN,HRF_CODIGO,HRF_DESC,HRF_LIVRE0,
  HRF_LIVRE1,HRF_LIVRE2,HRF_LIVRE3,HRF_LIVRE4,HRF_LIVRE5,HRF_LIVRE6,HRF_LIVRE7,HRF_LIVRE8,HRF_LIVRE9 FROM HRF

• data.HRG.sql=SELECT HRG_ISTCIA,HRG_LINPRO,HRG_GRPEMP,HRG_CDUNEG,HRG_CDEMPR,HRG_FILIAL,HRG_POSCLI,HRG_CODIGO,HRG_NOME,HRG_LIVRE0,
  HRG_LIVRE1,HRG_LIVRE2,HRG_LIVRE3,HRG_LIVRE4,HRG_LIVRE5,HRG_LIVRE6,HRG_LIVRE7,HRG_LIVRE8,HRG_LIVRE9 FROM HRG

• data.HRH.sql=SELECT HRH_ISTCIA,HRH_LINPRO,HRH_GRPEMP,HRH_CDUNEG,HRH_CDEMPR,HRH_FILIAL,HRH_SEGMER,HRH_CODIGO,HRH_DESC,HRH_LIVRE0,
  HRH_LIVRE1,HRH_LIVRE2,HRH_LIVRE3,HRH_LIVRE4,HRH_LIVRE5,HRH_LIVRE6,HRH_LIVRE7,HRH_LIVRE8,HRH_LIVRE9 FROM HRH

• data.HRI.sql=SELECT HRI_ISTCIA,HRI_LINPRO,HRI_GRPEMP,HRI_CDUNEG,HRI_CDEMPR,HRI_FILIAL,HRI_TPGRAT,HRI_CODIGO,HRI_DESC,HRI_LIVRE0,HRI_LIVRE1,
  HRI_LIVRE2,HRI_LIVRE3,HRI_LIVRE4,HRI_LIVRE5,HRI_LIVRE6,HRI_LIVRE7,HRI_LIVRE8,HRI_LIVRE9 FROM HRI

• data.HRJ.sql=SELECT HRJ_ISTCIA,HRJ_LINPRO,HRJ_GRPEMP,HRJ_CDUNEG,HRJ_CDEMPR,HRJ_FILIAL,HRJ_STTRES,HRJ_CODIGO,HRJ_DESC,HRJ_LIVRE0,
  HRJ_LIVRE1,HRJ_LIVRE2,HRJ_LIVRE3,HRJ_LIVRE4,HRJ_LIVRE5,HRJ_LIVRE6,HRJ_LIVRE7,HRJ_LIVRE8,HRJ_LIVRE9 FROM HRJ

• data.HRK.sql=SELECT HRK_ISTCIA,HRK_LINPRO,HRK_GRPEMP,HRK_CDUNEG,HRK_CDEMPR,HRK_FILIAL,HRK_GRUEMP,HRK_CODIGO,HRK_NOME,HRK_LIVRE0,
  HRK_LIVRE1,HRK_LIVRE2,HRK_LIVRE3,HRK_LIVRE4,HRK_LIVRE5,HRK_LIVRE6,HRK_LIVRE7,HRK_LIVRE8,HRK_LIVRE9 FROM HRK

• data.HRL.sql=SELECT HRL_ISTCIA,HRL_LINPRO,HRL_GRPEMP,HRL_CDUNEG,HRL_CDEMPR,HRL_FILIAL,HRL_TPFATU,HRL_CODIGO,HRL_DESC,HRL_LIVRE0,
  HRL_LIVRE1,HRL_LIVRE2,HRL_LIVRE3,HRL_LIVRE4,HRL_LIVRE5,HRL_LIVRE6,HRL_LIVRE7,HRL_LIVRE8,HRL_LIVRE9 FROM HRL

• data.HRM.sql=SELECT HRM_LINPRO,HRM_ISTCIA,HRM_FILIAL,HRM_EMPRES,HRM_ESTABL,HRM_HOTEL,HRM_GRUPUH,HRM_REGIAO,HRM_MOEDA,HRM_TPFATU,
  HRM_DATA,HRM_VLFATU,HRM_LIVRE0,HRM_LIVRE1,HRM_LIVRE2,HRM_LIVRE3,HRM_LIVRE4,HRM_LIVRE5,HRM_LIVRE6,HRM_LIVRE7,HRM_LIVRE8,HRM_LIVRE9
  FROM HRM

• data.HRN.sql=SELECT HRN_LINPRO,HRN_ISTCIA,HRN_FILIAL,HRN_EMPRES,HRN_ESTABL,HRN_HOTEL,HRN_GRUPUH,HRN_REGIAO,HRN_MOTCAN,HRN_STTRES,
  HRN_MOEDA,HRN_DATA,HRN_CANPRZ,HRN_COMMUL,HRN_QTDRES,HRN_QTDPER,HRN_VLRRES,HRN_VLRDIA,HRN_LIVRE0,HRN_LIVRE1,HRN_LIVRE2,HRN_LIVRE3,
  HRN_LIVRE4,HRN_LIVRE5,HRN_LIVRE6,HRN_LIVRE7,HRN_LIVRE8,HRN_LIVRE9 FROM HRN

• data.HRO.sql=SELECT HRO_LINPRO,HRO_ISTCIA,HRO_FILIAL,HRO_EMPRES,HRO_ESTABL,HRO_HOTEL,HRO_GRUPUH,HRO_REGIAO,HRO_STTRES,HRO_MOEDA,
  HRO_DATA,HRO_QTDRES,HRO_QTDPER,HRO_VLRRES,HRO_LIVRE0,HRO_LIVRE1,HRO_LIVRE2,HRO_LIVRE3,HRO_LIVRE4,HRO_LIVRE5,HRO_LIVRE6,HRO_LIVRE7,
  HRO_LIVRE8,HRO_LIVRE9 FROM HRO

• data.HRP.sql=SELECT HRP_LINPRO,HRP_ISTCIA,HRP_FILIAL,HRP_EMPRES,HRP_ESTABL,HRP_HOTEL,HRP_GRUPUH,HRP_REGIAO,HRP_TPGRAT,HRP_POSCLI,
  HRP_SEGMER,HRP_GRUEMP,HRP_MOEDA,HRP_DATA,HRP_QTDRES,HRP_QTDOCU,HRP_QTDTOT,HRP_QTDBLO,HRP_VLRDIA,HRP_LIVRE0,HRP_LIVRE1,
  HRP_LIVRE2,HRP_LIVRE3,HRP_LIVRE4,HRP_LIVRE5,HRP_LIVRE6,HRP_LIVRE7,HRP_LIVRE8,HRP_LIVRE9 FROM HRP

 8- Adicionar os campos de data das tabelas fato no arquivo DATE_FIELD.TXT no Agent:

• HRM_DATA
• HRN_DATA
• HRO_DATA
• HRP_DATA

9- Criação das métricas das tabelas fatos no Portal em MANAGE/METRICS:

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

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

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 %

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 %

(Opcional)

Estrutura de Menu

<Informações utilizadas na linha Datasul>.

Procedimentos

Programas

Cadastro de Papéis

<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.

<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.