Histórico da Página

IMPORTANTE: Antes de realizar a instalação do iCMNet 25, leia esse manual até o final e siga todo o passo a passo, em caso de dúvidas entre em contato com a equipe de Suporte TotvsCMNet Reservas.

Guia passo a passo

1. Pré-Requisitos 
2. Overview
3. Parametrizações
4. Instalação 
5. Configuração

1 - Pré-Requisitos

Para utilização desta integração, os hóteis precisam ter:

• VHF 6.11.7.00 ou superior;
• Máquina com mínimo de 2GB de memória Ram livre para o ICMNet processar;
• Mínimo de 1GB de espaço livre em disco;
• Processador Dual Core;
• Base de dados Oracle – (Legado + Todos Serviços Higs);
  • Para clientes que atualizarem da versão 24 ou inferior para a versão 25 terão os scripts de banco executados de forma automática pelo instalador.  
  • Caso ocorra erros na conexão fazendo referencia aos serviços de RATEAMOUNT, RULE e ou INVENTORY, será necessário validar se o banco de dados está configurado de acordo com a pasta inserida no instalador -->  Serviços HIGS.
• Base de dados SQL – (Legado + Serviços Higs (SOMENTE GuestRelation e Profile));
• Para a aplicação VHF_API acessar o banco de dados:
  • Conexão local usando Oracle é necessário ter o client 32 bits instalado no estação cliente.
  • Conexão local usando SQLServer é necessário instalador o client que vai junto com o instalador.
  • Conexão remota é necessário as mesmas configurações acima com as variações de banco de dados.

2 - Overview

ICMNET: Serviço de integração atual do PMS VHF com o CMNet Reservas, no qual  incorpora as parcerias com os GDS.

Mas também, neste momento a ferramenta estará absorvendo os recursos de transmissão e recebimento de informações dos parceiros através das APIs dos serviços HIGS. Para maiores informações sobre esses novos serviços entre em contato com o nosso time de vendas/comercial.

3 - Parametrizações

O PASSO A PASSO ABAIXO DEVE SER FEITO OBRIGATORIAMENTE ANTES DA INSTALAÇÃO DO ICMNET 25

Como primeiro passo, a equipe do Hotel ou seu TI deverá possuir duas informações do hotel, o IDCMNet e o Código CMNet.

IDCMNet = Ex.: 12345 – Combinação numérica que identifica o hotel na CMNet (obs.: não é o mesmo idhotel do banco de dados do VHF)

Código CMNet = Ex.: FLHO – Código de até 4 letras que identifica o hotel – Essa informação já existe hoje gravada dentro do Configurador do iCMNet da versão atual usada pelo hotel na aba “Integração com Sistemas Visuais” no campo “Código do Hotel”

Para o clientes que ainda não possuírem essa informação, realizamos uma implementação no sistema para que os hotéis tenham acesso a suas informações de IDCMNet e Código CMNet sem ter que entrar em contato com o suporte TotvsCMNet Reservas.

Desta forma orientamos que acesse o Hotvweb conforme passo a passo abaixo e caso não localize o seu IDCMNet e/ou Código CMNet ou tenha dúvidas, entre em contato com o suporte TotvsCMNet Reservas.

Hotvweb > Dados do hotel > Informações > Distribuidores

Nessa tabela se atente para a linha do Distribuidor “CMNet” onde:

ID da Propriedade = IDCMNet

Chain Code = Código CMNet

De posse dessas informações, devem acessar o VHF e inserir esses dados conforme abaixo:

Entrar no VHF > Acessar a tela Cadastros > Hotel > Procurar e selecionar o hotel desejado > Editar > Guia “Parâmetros Adicionais” > Preencher os campos “Código Higs” e “Código CMNet” > Confirmar

• Colocar o IDCMNet no campo Código Higs na guia Parâmetros Adicionais no cadastro do hotel.
• Colocar o Código CMNet no campo Código CMNet na guia Parâmetros Adicionais no cadastro do hotel.

Obs.: Se tratando de hotéis de Rede na mesma base de dados, esse procedimento deve ser realizado em todos os hotéis.

Se essa configuração no VHF não for feita corretamente, a conexão do iCMNet 25 NÃO será realizada.

3 - Instalação

Como essa versão do iCMNet irá executar scripts no banco de dados, orientamos que a instalação seja feita com as estações do VHF fechadas ou com pouca/quase nenhuma utilização.

Antes de realizar a instalação do iCMNet25, se certifique que não há nenhuma versão anterior instalada e ativa. Caso exista, interrompa a conexão, se tiver o serviço ativo o interrompa também e em seguida desinstale o iCMNet através do ícone “unistall” localizado na pasta “WinCMNet”. 

Por segurança, além de fazer uma cópia de segurança do arquivo clientcmnetconfig, guarde em um bloco de notas as informações de conexão com o banco de dados e IDHotel que constam no ConfigCMNet.

Exclua a pasta de instalação da versão anterior e todos os seus arquivos.

O arquivo de instalação do iCMNet 25 estará disponível na Central de Downloads https://suporte.totvs.com/portal/p/10098/download#000045/6/Totvs%20CMNet%20Hotal/

Instale o arquivo “ICMNET25” no servidor ou na máquina desejada (lembrando que essa máquina com o iCMNet deve sempre permanecer ligada). que estará disponível na Central de Downloads Pressionar o botão “Avançar” 

Escolher a pasta que onde será instalado o sistema e pressionar o botão “Avançar”.

Como sabemos para o funcionamento correto do iCMNet 25, é necessário a execução de alguns scripts no banco de dados e agora isso é um passo feito de forma automática na instalação do iCMNet25. Basta preencher a tela abaixo com os dados do Banco de dados.

Caso o TI do Hotel não concorde em executar de forma automática esses scripts e queira realizar uma verificação de segurança nesses scripts, ele deve marcar a opção de “Não” atualizar automaticamente, copiar todos os scripts que irão aparecer na tela seguinte e executar de forma manual em seu banco de dados antes de seguir com a instalação. A não execução desses scripts no banco de dados impedirá o funcionamento do iCMNet25

Caso queira seguir com a instalação toda automática, basta deixar a opção de Atualizar o banco maracada como “Sim”, preencher os dados do banco e seguir com o passo a passo. Lembrando que o usuário do banco que for configurado no iCMNet ( que normalmente por padrão é o CM) deve ter direito de acesso a todas a operações no banco, acesso total.

Em relação aos scripts dos serviços de Rateamount, Rule e Inventory, se o hotel possuir parte dessa estrutura já configurada em seu banco de dados, o iCMNet não altera ou subscreve qualquer pré configuração, mesmo estando incompleta ou de alguma forma errada.

Pensando no tratamento destes casos, existe a flag na tela inicial do instalador do iCMNet com a descrição "Drop das tabelas dos serviços Rule, RateAmount e Inventory", que fará o reset de qualquer estrutura já existente, ocorrendo uma nova configuração no banco de dados dos serviços Rule, RateAmount e Inventory. Por padrão essa flag virá sempre marcada como a opção "Não" e aconselhamos que para usá-la, entre em contato primeiro com o suporte TOTVS.

Seguem abaixo os cenários possíveis, vamos considerar que a Flag "Atualizar banco automaticamente" estará marcada como sim.

1 - Hotel NÃO possui nada da estrutura (Rule, rateamount e Inventory) no banco de dados e flag "Drop" marcada como "Não".
>>> Neste caso o instalador do iCMNet irá CRIAR automaticamente toda essa estrutura.

2 - Hotel POSSUI total ou parte da estrutura (Rule, rateamount e Inventory) no banco de dados e flag "Drop" marcada como "Não".
>>> Neste caso o instalador do iCMNet não fará nada nessa estrutura de Rule, rateamount e Inventory já existente, apenas irá criar o que estiver faltando, mas não corrigi o que já está criado se estiver errado.

3 - Hotel NÃO possui nada da estrutura (Rule, rateamount e Inventory) no banco de dados e flag "Drop" marcada como "Sim".
>>> Neste caso o instalador do iCMNet irá identificar que essa estrutura não existe, ignorar a flag Drop como "Sim" e CRIAR automaticamente toda essa estrutura.

4 - Hotel POSSUI total ou parte da estrutura (Rule, rateamount e Inventory) no banco de dados e flag "Drop" marcada como "Sim".
>>> Neste caso o instalador do iCMNet irá identificar que essa estrutura existe, excluir toda ela e À RECRIARÁ automaticamente.

OBS.: O cenário citado no item 4 não deve ser realizado em Redes com mais de 10 hotéis na base de dados sem a supervisão do time do Suporte da TOTVS devido a sobrecarga na base.

OBS.: Na grande maioria dos clientes NÃO SERÁ necessário usar essa opção marcada como "Sim" por isso, na dúvida, aconselhamos a manterem o padrão já marcado como "Não".

OBS.: Para Redes de Hotéis, é completamente desaconselhável o uso dessa flag como "Sim" sem prévia análise e orientação do time de Suporte da TOTVS.

 Essa execução de scripts levará um certo tempo e ficará sendo mostrada como carregando com a tela abaixo:

Em seguida aparecerá a opção de seleção de Idioma e basta clicar em OK.

Em seguida surgirá a tela de instalação da VHF API

A VHF API é uma aplicação que seguirá rodando junto ao iCMNet 25 mas que só precisa estar ativa para clientes que usam os serviços de Guest ou Twoway do Higs, para a integração exclusiva do VHF com o CMNet Reservas, a VHF API não precisa estar ativa, mas orientamos que mesmo assim siga com a instalação e configuração dela, para caso de um dia o hotel vir a ativar algum dos serviços do HIGS citados, bastará ativar a mesma.

Confirme o diretório de instalação e clique em Avançar e depois Instalar:

Aguarde o carregamento da instalação:

Assim que a aparecer a tela de Configuração do Serviço VHFAPI, realize a configuração com as mesmas informações do Banco de Dados do cliente nos campos Alias do Servidor, Schema, Usuário e Senha, em seguida clique em Salvar Configurações.

Após clicar em Salvar Configurações, irá aparecer a mensagem de Configuração gravada com sucesso e basta clicar em OK.

Após clicar no OK dessa mensagem, repare que o botão de Start da tela de Configuração da VHFAPI será ativado (ficará esmaecido) ligando assim a aplicação e essa tela será fechada ficando em segundo plano.

Durante todo o processo de configuração da VHF API teremos as duas telas abaixo em aguardo e agora basta clicar em Concluir.

Aguardar a instalação terminar.

Ao terminar a instalação será exibida a tela de conclusão.

Ao pressionar o botão “Terminar”, será exibida a tela abaixo para configurações. 

5 - CONFIGURAÇÕES

Conexão com o Serviço:

As seguintes URL’s já estarão configuradas:

• URL da Conexão e Conexão Alternativa:

https://icmnet.cmnetcloud.com/CMNetServer/IntegracaoCMNet?wsdl 

Obs.: Se optarem por usar o arquivo ”Clientconfig” de uma versão anterior, pode ser necessário atualizar as URLs de conexão para as citadas acima. Para utilizar o arquivo”Clientconfig” de uma versão anterior basta copiar o mesmo, salvar e depois colar/substituir dentro da pasta raiz da instalação do icmnet. Esse arquivo guarda todas as informações de configuração que estava na versão anterior, sendo esse um procedimento muito usado em rede de hotéis que possuem vários hotéis configurados na mesma base para que não seja necessário digitar todas as informações de Cod. Hotel e Id Hotel novamente.

• URL Serviço Estratégia tarifária VHF: NÃO DEVE SER PREENCHIDA NUNCA, COM NENHUMA INFORMAÇÃO

Programação de Conexões:

O tempo de conexão da integração VHF x CMNet Reservas é agora gerenciado pela equipe de suporte TotvsCMNet Reservas, qualquer alteração após a instalação deverá ser solicitada diretamente a eles. Orientamos que o campo “Intervalo entre Conexões (segundos)” do configurador do iCMNet, seja preenchido com o tempo desejado pelo Hotel sendo que o intervalo de conexões possui uma limitação de intervalo mínimo de 1800 segundos. Todo novo hotel que iniciar conexão com o iCMNet25, terá seu tempo de conexão da integração VHF x CMNet Reservas setado como default para 1800 segundos (30 minutos), e caso queiram alterar esse tempo, será necessário entrar em contato com o suporte TotvsCMNet Reservas.

Conexão com o Banco de Dados:

Agora, não é mais necessário preencher a guia de Conexão com o Banco de Dados do Config do iCMNet visto que essas informações são preenchidas durante a instalação e migram para essa guia que por outro lado segue disponível e operando da mesma maneira caso alguma informação do banco de dados seja alterada.

Tipo de Integração:

Escolher o sistema a ser integrado: Visual Hotal FrontOffice.

Integração com Sistemas Visuais:

• Informar o ID Hotel: ID da unidade no banco do VHF
• Informar o Código do Hotel: Código ICMNET no VHF
• Usa CalReservas: Sempre N (NÃO)
• Importar Clientes: S (SIM) OU N (NÃO) – Dependendo da escolha do Hotel
• Desabilitar: Essa opção NÃO funciona mais visto que o controle de conexão do hotel está sob responsabilidade da TotvsCMNet  

OBS.: O campo Código do Hotel (trata-se do Código CMNET encontrado no VHF (guia Parametros adicionais no cadastro do hotel)

Ao completar as configurações, clique em “Confirmar”.

Executar o sistema “Integrador CMNet Reservas“ que foi criado um atalho na área de trabalho. Logo após clicar no atalho para executar o iCMNet, na barra de tarefas, próximo a data e hora da máquina, irá aparecer o ícone do iCMNet e basta clicar em cima dele com o botão direto do Mouse e escolher a opção “Mostrar Log”.

     >>>>>>>  

IMPORTANTE - Lembramos que assim como nas versões anteriores: 

• O iCMNet não pode estar instalado em mais de uma máquina, só pode haver uma conexão ativa para o mesmo hotel.
• O iCMNet não pode estar conectando como aplicação e serviço ao mesmo tempo, ou um ou outro.
• Uma conexão completa é composta por 3 etapas conforme print do log acima

Artigos relacionados