Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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

  • Para iCMNet v25.04.10 ou inferior - obrigatório VHF atualizado até no máximo a versão 12.01.2402.03 
  • Para iCMNet v25.04.11 ou superior - obrigatório VHF 12.01.2402.05 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 CoreVHF 6.11.7.00 ou superior;
  • 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 reinstalar o iCMNet marcando como “Sim” a flag “Refaz estrutura dos serviços de Tarifas-Regras e Inventário”. (Disponível apenas para Banco Oracle)
  • Base de dados SQL – (Legado + Serviços Higs (SOMENTE GuestRelation e Profile));
  • Para a aplicaçao 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.

...

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”.


Image AddedImage Removed


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.

...

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


Existe ainda uma configuração necessária no VHF que, se não realizada, impede a conexão de ser finalizada com todos os dados e a visualização correta no VHF de reservas migradas na tela de Consulta Geral.

Caminho da tela: VHF > Sistema > Configuração > Parâmetros do Sistema > editar > Integração CMNet


Image Added


Image Added


Nessa aba Integração CMNet, deve estar marcada a flag "Integrado com CMNet" e no campo Usuário CMNet deve estar selecionado o usuário de sistema que estará vinculado ao usuário de banco configurado dentro do integrador iCMNet. O usuário de sistema selecionado pode ser qualquer um de escolha do hotel e precisa estar obrigatoriamente dentro de algum Grupo de usuários de acesso, não pode estar "solto", aconselhamos ser o grupo ADM. Esse usuário selecionado é o que ficará gravado nas tabelas de log como sendo o que realizou tudo referente a integração de informações pelo iCMNet, normalmente esse usuário é criado no momento da implantação com o nome de CM ou CMNET.


Image Added



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.

...

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

A partir da versão v25.04.11, a atualização de banco deixou de ser opcional como nas versões anteriores da v25, onde era permitido ao hotel seguir com a instalação pulando a atualização de Banco caso quisesse fazer isso de forma manual após copiar os scripts, nessa versão é obrigatória a atualização automática do banco de dados para a sequência da instalação.

Caso a equipe do hotel queira ter acesso aos scripts, eles estarão disponíveis no caminho padrão de instalação: C:\cm\WinCMNet\.install4j\user\script-database\liquibase\clob-files

Image Added


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 Tarifas/Regras e Inventário, 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 "Refaz estrutura dos serviços de Tarifas/Regras e Inventário”, 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.


Image Added


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 "Refaz estrutura" 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 "Refaz estrutura" 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 "Refaz estrutura" 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 .

Image Removed

 Image Removed

 

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.


Como os serviços de RATEAMOUNT, RULE e ou INVENTORY não estão disponíveis para banco SQL essa flag citada acima fica esmaecida e indisponível pra uso quando selecionado a opção de banco MSSql.

Image Added


Após clicar em "Avançar", a  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

...

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 

A partir da versão 25.04.10, o configurador do iCMNet foi reformulado. Agora o novo configurador do iCMNet possui apenas 2 abas, Configurações e Hotéis. Retiramos as abas de configurações não mais existentes, serão exibidas apenas as informações que o cliente pode precisar ver e/ou alterar.


Image Added


Para clientes que já possuem o iCMNet de versões anteriores, existe a possibilidade de fazer um cópia do arquivo de configuração “clientcmnetconfig.xml” que guarda todas as informações de configuração como os dados do banco e a lista de hotéis e substituir esse arquivo na pasta raiz de instalação da versão atual do iCMNet, esse é 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:

...

. Mas recomendamos que essa operação seja feita apenas por TIs ou sob supervisão do time Totvs. Se for realizado essa substituição de arquivos de configuração, orientamos que abra o “Configurador_ICMNET” e sem alterar nada apenas clique em “Salvar”, apenas para ajustes da estrutura do XML para a versão atual.


1 – Aba Configurações

1.1 – Serviço_URLs – Nessa opção temos as URLs de conexão do iCMNet que só devem ser alteradas se houver alguma orientação do time Totvs. As URLS já virão preenchidas com o nosso endereço padrão e caso o cliente deixe algumas delas vazias, ao clicar em Salvar, automaticamente o campo será preenchido novamente com o nosso endereço correto. 


Obs.: Se optarem por usar o arquivo “clientcmnetconfig.xml” de uma versão igual ou inferior a v21, será necessário atualizar as URLs de conexão para as citadas acima.


1.2 – Serviços _Intervalo Reservas/Disponibilidade – Campo novo e disponibilizado a partir da versão v25.04.10, conexão mais rápida dos serviços de Disponibilidade e Reservas. Neste campo deve ser inserido o tempo mínimo desejado pelo hotel para realizar a transmissão de reservas e disponibilidade do serviço CMNet Reservas em separado. O tempo mínimo para esse campo é de 5 minutos. Todo o restante do serviço que abrange a parte cadastral (Contratos, tarifas, UHs etc) permanecerá no tempo mínimo de 30 minutos que é estabelecido e configurado na base Totvs.

1.3 – Proxy – Este campo permanece inalterado em relação as versões anteriores, caso o cliente possua essa opção de segurança, basta inserir os dados solicitados para que o iCMNet não seja bloqueado por ela.

1.4 – Banco de Dados – Todas as informações do banco como IP, caminho do banco e porta que são inseridos no instalador, são transferidos automaticamente para o campo String de conexão, não sendo necessário mais ao hotel digitar essas informações e clicar na opção “Gerar URL de Conexão” opção essa que agora foi descontinuada, caso em algum momento o hotel altere alguma de suas informações de banco, basta preencher no configurador todos os campos solicitados e clique em Salvar. Em caso de necessidade de alterar algum item da String de conexão, somente será gravada a alteração após clicar em salvar se forem preenchidos os dois campos de IP e caminho do banco. Qualquer operação do usuário fora do ideal, o configurador irá disparar uma mensagem de alerta.

 

2 – Aba Hotéis


Image Added


2.1 – Nesta opção a operação segue a mesma porém agora somente com os Campo Id Hotel (VHF), Cod. Hotel (CMNet Reservas), Importar Clientes (S ou N) e Chave pública (ainda não utilizada), sendo o preenchimento obrigatório dos 3 primeiros campos descritos.

OBS.: O campo Código

Image Removed

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.

Image Removed

Tipo de Integração:

Escolher o sistema a ser integrado: Visual Hotal FrontOffice.

Image Removed

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)


2.2  – Agora é possível ordenar a lista de hotéis no caso de redes que possuem mais de uma unidade no mesmo configurador

Image Added


2.3 – Caso a equipe esqueça de inserir algum hotel no configurador após a instalação ou deixar a linha de algum hotel sem um dos itens obrigatórios como ID Hotel, Código Hotel e/ou Importar Clientes, será exibida uma mensagem perguntando se deseja seguir editando e inserir a informação que falta ou salvar sem nenhum Hotel ou apagando da lista aquele que não está com as informações completas.


2.3 – Após preencher o configurador, basta clicar em Salvar, confirmar a mensagem de “Configurações salvas com sucesso” e depois Sair.

Image AddedImage Removed


Ao completar as configurações, clique em Confirmar“Salvar” e depois em "Sair".

Executar o sistema “Integrador CMNet Reservas“ que foi criado um atalho na área de trabalho. Logo após  

Após clicar no atalho para executar o ícone do iCMNet, na barra de tarefas, não é mais necessário selecionar o mesmo após aparecer 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”.

  Image Removed   >>>>>>>   Image Removed

do computador e clicar na opção mostrar log, o log abrirá automaticamente após cerca de 5 a 10 segundos.

Image AddedImage Removed


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



Informações

Artigos relacionados

...