Esse documento tem o objetivo de mostrar como configurar a integração entre TOTVS Hospitalidade PMS - Linha Hotal (VHF) e a RD Station Marketing.

Guia passo a passo

  1. Solicitar o Client ID,Client Secret e Refresh Code, junto ao time de atendimento da Tribuzana. (VHF & RD Station)
  2. Solicitar o Id do Hotel no Higs.
  3. Baixar e instalar o plugin RD Station x VHF.
  4. Configurar o hotel no PMS (VHF).
  5. Parametrizar o hotel para transmitir os dados.
  6. Configurar o serviços de integração.
  7. Quais os dados transmitidos na integração?
  8. Visualizar os dados transmitidos.

1. Contato com a Tribuzana.

Entrar em contato junto a agência Tribuzana, pelo contato (47) 99122-7580, solicitando: Client ID, Client Secret e Refresh Code, pois esses códigos serão a ponte entre a API VHF e o RDStation para coletar as informações.

Para auxiliar na geração do Refresh Code, siga os passos abaixo:

Gerar CODE para obter o "refreshToken"


Para integrar o PMS do Hotel com a conta RD Station do mesmo, é preciso executar os seguintes passos:


- Acessar a URL substituindo os parâmetros pelos dados do seu aplicativo:

https://api.rd.services/auth/dialog?client_id=client_id&redirect_uri=redirect_uri


Ao acessar a URL, abrirá uma tela de confirmação, clicar em “Continuar”:

E após clique em “Conectar”:



É gerado o “CODE”, selecione o valor após o sinal de "=".


2. Solicitar ID Higs do Hotel.

Entrar em contato com o Staff do projeto, solicitando o Id Higs. 

3. Baixar e instalar o plugin RD Station x VHF.

Para baixar um plugin, siga as instruções clicando aqui.

Você deverá instalar os plugins abaixo:


Autorizar os acessos:

4. Configurando o hotel no PMS (VHF).

Acesse a tela de cadastro de hotéis para inserir o código do hotel para a integração com a RD Station.

VHF →  Cadastro →  Hotel 

Selecione o hotel desejado, e inclua o código do hotel do HIGS na aba “Parâmetros Adicionais”, no campo “Código HIGS”.

       






O código de integração com a RD Station é o mesmo utilizado para integrar com o HIGS, verifique com o time de vendas da TOTVS, qual o processo para conseguir esse código.


5. Parametrizar o hotel para transmitir os dados.

Acesse o menu de parâmetros.

Plugin → RD Station x VHF → Parâmetro.

                     



Os dados (Client ID, Client Secret, Code) são adquiridos no cadastro da RD Station, siga o passo a passo informado no passo 1, para que consiga essas informações.

O campo "CODE" tem a durabilidade de uma hora, ele deve ser gerado sempre que for cadastrar um novo hotel na integração.

Caso queira retirar o hotel do processo de integração com a RD Station, basta acessar a tela de parametrização, editar e desmarcar o flag "Ativo", não é preciso reiniciar o serviço.


6. Configurar o serviço de integração.

Acesse o módulo "Plug-in Robô", e inclua uma nova tarefa com os parâmetros mostrados abaixo, caso não saiba acessar o módulo "Plug-in Robô" e incluir uma tarefa, siga as instruções clicando aqui.


       





O intervalo de tempo para a execução da tarefa de envio dos dados, pode ser definido conforme o cliente desejar, mais recomendamos que seja a cada 60 min no mínimo.




7. Quais os dados transmitidos na integração?

Para esse processo de integração, que ocorre a cada 60 minutos no mínimo, é monitorado qualquer alteração feita na reserva ou na ficha de hóspede, para enviar os seguintes dados:

  • Número da reserva
  • Nome do hospede
  • E-mail do hóspede
  • Tipo de hóspede
  • Data prevista de check-in
  • Data prevista de check-out
  • Seguimento da reserva
  • Tipo de UH
  • Rate plan
  • Data chegada real
  • Data partida real
  • Data do cancelamento
  • Motivo do cancelamento
  • Valor da reserva
  • Valor da orçamento reserva
  • Quantidade de adultos na reserva
  • Quantidade de crianças na reserva (crianças1 + crianças2) 
  • Motivo da viagem
  • Status da reserva

8. Visualizar os dados da transmissão.

Acesse o menu Log de transmissão, para visualizar os registros integrados.

Plugin → RD Station x VHF → Log de transmissão

     




Para exibir apenas os erros, selecione o filtro no final da tela, ou filtre por qualquer coluna.