Histórico da Página

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:

Pré-requisitos Obrigatórios

Antes de iniciar a configuração da integração, certifique-se de que os seguintes requisitos estão atendidos:

• • Versão atual do PMS (VHF) compatível com o plugin RD Station x VHF.

  • Acesso administrativo ao sistema para instalação de plugins.

  • Conexão estável com a internet para comunicação com a RD Station(Ambiente Local).

  • Abertura de Issue para instalação do Robot (Ambiente Cloud), siga conforme Modelo

Nível de Complexidade e Tempo Estimado

Para um planejamento eficaz, considere:

• • Nível de Complexidade: Médio.

  • Tempo Estimado para Execução: Aproximadamente 4 horas, considerando a obtenção das credenciais e a configuração completa
    
    

Caso o hotel possua conta ativa na RDStation: 

Se o hotel já contratou o RD Station e possui acesso ao portal, siga este passo a passo com imagens para gerar as credenciais de integração diretamente, sem depender da Tribuzana:

01. Acesse: https://appstore.rdstation.com/pt-BR/publisher
02. Faça login e selecione a conta do hotel
03. Clique em Criar aplicativo, selecione Privado
04. Preencha os dados conforme orientado (nome, site, callback)
05. Copie client_id e client_secret
06. Gere o code com a URL de autorização e envie para o integrador

Caso o hotel não possua conta ativa na RDStation:

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:

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

5. Parametrizar o hotel para transmitir os dados.

Acesse o menu de parâmetros.

Plugin → RD Station x VHF → Parâmetro.

Informações 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. Aviso 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.

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