A migração de reservas entre o VHF e o PMS utiliza o HIGS como intermediário para passagem das reservas de um sistema para o outro. A migração é constituída por 3 passos:
- Configuração do Hotel no PMS
- Configurações no VHF Web
- Passagem das Reservas para o PMS
Abaixo são descritos os 3 passos que envolvem a migração.
1 - Configuração do Hotel no PMS
1.1 - Hotel e Associação a Parceiro (Obrigatório)
Criação do hotel no SuperAdmin e associação de Parceiro Higs com o HotelCode que é referente ao hotel no HIGS.
Exemplo:
1.2 - Criação do Channel (Obrigatório)
Criação de um channel com o código padrão
Exemplo:
1.3 - Criação dos tipos de UH (Obrigatório)
A criação dos tipos de uh não têm que conter a mesma sigla utilizada no VHF no entanto é necessário fazer a associação do tipo de UH criado com o código do tipo de UH existente no VHF. Essa associação é feita através do menu de Correlacionamentos -> Tipo de UH
Exemplo:
1.4 - Criação de UH (Facultativo)
Criação das UH's com a mesma numeração que está no VHF, dessa forma é possivel fazer a paridade entre as UH do PMS e do VHF
1.5 - Moedas (Obrigatório)
Verificar/Criar as moedas que estão associadas às reservas no VHF. É necessário garantir que o código da moeda que vem na reserva do VHF é o mesmo que o código das moedas no PMS. Tabela Currency, Coluna AlphabeticCode
1.6 - Tipos de Hóspede (Obrigatório)
Criar os tipos de hóspede com as mesma Siglas que vêm do VHF, essa sigla deve ser aplicada no campo código do PMS.
Exemplo:
1.7 - Tarifa Base: (Obrigatório)
Criar uma tarifa Padrão que abranja todos os tipos de quarto a serem importados bem como as datas das reservas a serem migradas.
No caso da existência de reservas em outras moedas, é necessário criar tarifas padrão para essa moeda.(Facultativo)
1.8 - BusinessSource: (Facultativo)
Criar as Origens no PMS com os mesmos códigos do VHF, o código do VHF deve ser colocado no campo código do PMS, para ser possível fazer a paridade entre o VHF e PMS.
Exemplo:
1.9 - MarketSegment (Facultativo)
Criar os Segmentos no PMS de acordo com a estrutura existente no VHF. os códigos do VHF devem ser colocados no campo código do PMS.
Exemplo: Segmento 0305 do VHF. No PMS tem que ser criado um segmento Principal com o código 03, após isso deve ser criar um Segmento Secundário associando o que foi criado anteriormente a este secundário, com o código 05. Dessa forma terá o segmento 03.05 criado no PMS e com isso será feito o vinculo entre o segmento do VHF e do PMS.
Exemplo:
1.10 - Migração dos clientes/empresas (Facultativo)
É necessário importar previamente os clientes que estão criados no VHF, pelo menos os que estão associados a reservas que vão ser migradas.
Este passo deve ser feito através da funcionalidade migração de clientes via Excel (feito pelo time de desenvolvimento do PMS SaaS).
É muito importante que nessa migração, seja preenchido no campo Código Integração do excel, o IdPessoa do cliente no VHF. É dessa forma que será feito o vinculo do cliente cadastrado no VHF com o Thex na hora de associar o cliente à reserva migrada.
Legenda:
Obrigatório - Passo obrigatório, a não execução deste passo implica que as reservas não serão migradas
Facultativo - Passo facultativo, a não execução deste passo não impede a migração de reservas, no entanto algumas informações podem não ser migradas.
## 2 - Configurações no VHF Web
2.1 - Configurar VHF Web
Fazer as configurações no aplicativo VHF Web para ligar o aplicativo ao banco de dados do VHF onde vão ser migradas as reservas
2.2 - Preparar Reservas que vão ser migradas
Escolher o periodo das reservas a serem migradas bem como o status da reservas (Actualmente só estão a ser migradas reservas confirmadas e a confirmar)
Este procedimento vai alimentar a tabela mensagemhigs com as reservas a serem migradas
2.3 - Enviar as reservas para o Higs
Executar o serviço do VHF WEB. Este passo vai enviar as reservas previamente escolhidas no passo anterior para o HIGS.
Podem ser consultadas as reservas que foram enviadas para o Higs através do Endpoint abaixo:
https://higs.thex.cloud/pms/api/v1/SendBooking?HotelCode=526910&Status=0,1,2,4
É necessário adicionar no Header do request o token-client e token-application. Para não deixar exposta esta informação nesta Wiki, quando for feita a migração é necessário solicitar estes dados a algum responsável do desenvolvimento do HIGS.
É necessário substituir o HotelCode pelo que está a ser utilizado na migração
## 3 - Passagem das Reservas para o PMS
3.1 - Pegar um token do PMS
É necessário fazer login no hotel onde devem integrar as reservas e através das ferramentas do programador (F12) na aba Rede, pegar um token de alguma das requisições
Exemplo:
3.2 - Procedimento de importação das reservas
É necessário utilizar o seguinte endpoint passando o token que foi resgatado no passo anterior:
Método: POST
https://group01.totvshospitalidade.com/higsintegration/api/reservationVhf
3.3 - Acompanhamento das reservas migradas
Acompanhar a migração das reservas através da consulta geral (verificar se todas as reservas foram migradas) e do painel de integração (caso haja algum erro na integração)
3.4 - Finalizar a migração
Após verificar que todas as reservas foram migradas é necessário limpar a lista de reservas do HIGS
Para tal é necessário utilizar o seguinte endpoint passando o token que foi resgatado no passo 3.1
Método: PUT
https://group01.totvshospitalidade.com/higsintegration/api/reservationVhf