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
- Solicitar o Client ID,Client Secret e Refresh Code, junto ao time de atendimento da Tribuzana. (VHF & RD Station)
- Solicitar o Id do Hotel no Higs.
- Baixar e instalar o plugin RD Station x VHF.
- Configurar o hotel no PMS (VHF).
- Parametrizar o hotel para transmitir os dados.
- Configurar o serviços de integração.
- Quais os dados transmitidos na integração?
- 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. |
---|