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




Pré-requisitos Obrigatórios

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

Nível de Complexidade e Tempo Estimado

Para um planejamento eficaz, considere:

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

       






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:

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.