Histórico da Página
...
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”.
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
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.
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
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.
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 .
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.
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.
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.
- URL da Conexão e Conexão Alternativa: https://icmnet.cmnetcloud.com/CMNetServer/IntegracaoCMNet?wsdl
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
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
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)
2.2 – Agora é possível ordenar a lista de hotéis no caso de redes que possuem mais de uma unidade no mesmo configurador
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.
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”.
>>>>>>>
do computador e clicar na opção mostrar log, o log abrirá automaticamente após cerca de 5 a 10 segundos.
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
...