Guia de integração Adviser Hotel. Protocolo padrão de comunicação

Objetivo deste Post

Para facilitar o trabalho de integração com novos PMS (Sistemas Hoteleiros) publicamos aqui dados técnicos de integração, como bilhetes padrão, cenários, topologia, etc.,

E também possibilitar ao leitor conhecer todas as facilidades que nosso produto oferece ao Hotel. Devido à demanda crescente por novos Hotéis no mundo e com foco principalmente no Brasil e na América Latina, elaboramos esse documento para facilitar a integração de novos PMS a um dos maiores Middlewares de integração PABX x PMS do mercado, o Adviser Hotel.

Introdução

Adviser Hotel é uma solução que integra o sistema de gestão hoteleira com a
infraestrutura de telefonia do hotel, automatizando processos de check-­‐in e
check-­‐out além de oferecer serviços diferenciados para hóspedes e staff
administrativo.

Adviser Hotel aproveita a infra-­‐estrutura de telefonia e rede existentes. Os
meios de comunicação podem ser via cabo serial ou TCP/IP e as formas de
comunicação (protocolos) dependem de cada fabricante de telefonia.

blocos adviser

Blocos Funcionais

Funcionalidades do Adviser Hotel

  • Despertador,
  • Correio de Voz,
  • Correio de Fax
  • Check-­‐in / Check-­‐out
  • Room-­‐Status
  • Frigobar

São dezenas de PMS homologados com o Adviser Hotel, dentre eles :

  • Ópera,
  • Fidelio;
  • Amadeus;
  • Totvs (CM Soluções);
  • Volux (OCL);
  • Desbravador;
  • Innsist;

Mas qualquer sistema PMS pode se conectar ao Adviser Hotel, temos um protocolo de comunicação muito simples, inclusive há uma diversidade de sistemas diferentes que tem Hotéis em funcionamento onde apenas se conectaram ao nosso protocolo padrão de comunicação e nem pediram um suporte se quer. E este post é destinado a estes PMS , aqui mostramos bem as conexões e o protocolo em si.

B ILHETES DE
INTEGRAÇÃO PADRÃO
Os bilhetes de integração entre o Adviser Hotel e o PMS devem utilizar
comunicação ACK-­‐NAK e STX-­‐ETX.
Todos os exemplos apresentados nesse manual levam em consideração que as
duas configurações citadas acima estejam ativadas.

Sentido das comunicações

Na comunicação entre o PMS e o software Adviser Hotel, pode
ser configurado para qualquer uma das duas funções. As funções definem o
sentido da comunicação em que os bilhetes serão emitidos.

Cada tipo de bilhete de é gerado em um sentido de comunicação segundo o
ponto de partida, porém, às vezes a mesma funcionalidade gera bilhetes em
mais de um sentido devido à necessidade de respostas por parte do sistema
para configurações ou características da funcionalidade.

EXEMPLO : Wake up, os bilhetes de agendamento de wake up seguem em
sentido Adviser > PMS,

sentidoadviser.jpg

porém os de resposta de sucesso do agendamento, ou  de ação de despertar seguem sem sentido contrário.

sentido2

Sentido das Comunicações segundo as facilidades

Bilhete de agendamento de Despertar, contém:

wakeup

  • Flag de Agendamento,
  • Quarto,
  • Data do Agendamento,
  • Horário programado do despertar,
  • Flag de confirmação

Execução do Despertar, comtém :

  • acaodespertarflag da Chamada,
  • quarto,
  • Horário do despertar,
  • Status da chamada

roomstatus.jpg

Atualização do Room Status contém:

  • quarto,
  • camareira,
  • produto(s),
  • quantidade(s)

Atualização do Estado de limpeza:

roomstatus.jpg

  • quarto,
  • camareira,
  • Status de limpeza,

Descrição técnica dos Bilhetes:

Direção: Front Office -> Server

1.0 CHECKIN Utilizado para enviar a adviser as informações do hospede para registro na central telefônica.

  • bilhete: [IN RRRRRR LL PPPPPP NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN]
      • [“IN “] Indicação de operação. (05 Caracteres)
      • [RRRRRR] Número do quarto. (06 Dígitos)
      • [LL] Número do idioma do hóspede. (06 Dígitos)
      • [PPPPPP] Senha da Caixa Postal do hóspede. (06 Dígitos)
      • [NNN…] Nome do hóspede. (40 Caracteres)
    • Observação: * Se PPPPPP=000000. A caixa postal será criada sem senha.?

2.0 CHECKOUT Utilizado para enviar a adviser as infomações de bloqueio na central telefônica e no sistema hoteleiro.

  • bilhete: [OUT RRRRRR]
      • [“OUT “] Indicação de operação. (05 Caracteres)
    • [RRRRRR] Número do quarto. (06 Dígitos)

3.0 ROOMTRANSFER Utilizado para enviar a adviser as informações de transferência do hospede para registro na central telefônica.

  • bilhete: [TRF OOOOOO RRRRRR NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN]
      • [“TRF “] Indicação de operação. (05 Caracteres)
      • [OOOOOO] Número do quarto antigo. (06 Dígitos)
      • [RRRRRR] Número do quarto novo. (06 Dígitos)
    • [NNN…] Nome do hóspede. (40 Caracteres)

4.0 WAKEUP Utilizado programar ou apagar programações de despertador no sistema hoteleiro.

  • bilhete: [WUP RRRRRR DD/MM/YYYY HH:MM:SS E]
      • [“WUP “] Indicação de operação. (05 Caracteres)
      • [RRRRRR] Número do quarto. (06 Dígitos)
      • [DD/MM/YYYY HH:MM:SS] Horário do Despertador (19 Caracteres)
    • [E] Flag indicando se marca ou apaga. (01 Dígitos)

Observações:

    • * A data e o horário deve ser no formato 24h.
    • * [E]=1 agenda Wakeup.
    • * [E]=0 apaga todos os registros de wakeup.
  • * [E]=2 apaga registro de Wakeup conforme o horário.

5.0 CHANGE NAME Utilizado para trocar o nome dos hóspede na central telefônica.

  • bilhete: [CHNAM RRRRRR NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN]
      • [“CHNAM”] Indicação de operação. (05 Caracteres)
      • [RRRRRR] Número do quarto. (06 Dígitos)
    • [NNN…] Nome do hóspede. (40 Caracteres)

6.0 CHANGE LANGUAGE Utilizado para trocar o idioma do hóspede no Voice Mail e no Sistema Hoteleiro.

  • bilhete: [CHLAN RRRRRR LL]
      • [“CHLAN”] Indicação de operação. (05 Caracteres)
      • [RRRRRR] Número do quarto. (06 Dígitos)
    • [LL] Idioma do hóspede. (02 Dígitos)

7.0 CHANGE PASSWORD Utilizado para trocar a senha da caixa postal do hóspede.

  • bilhete: [CHPAS RRRRRR PPPPPP]
      • [“CHPAS”] Indicação de operação. (05 Caracteres)
      • [RRRRRR] Número do quarto. (06 Dígitos)
    • [PPPPPP] Senha da Caixa Postal. (02 Dígitos)

Direção: Server -> Front Office

    • 1.0 WAKEUP Utilizado para a sinalização da aplicação de despertador automático através do correio de voz. Tem como função passar o status de despertador de todas as operações e quartos para o PMS com a finalidade de gerar logs, documentar e provar o processamento de cada operação.
    • bilhete: [PROG RRRRRR DD/MM/YYYY HH:MM:SS HHMM CONFIRMOU ]
    • bilhete: [PROG RRRRRR DD/MM/YYYY HH:MM:SS HHMM NAO_CONFIRMOU ]
    • bilhete: [PROG RRRRRR DD/MM/YYYY HH:MM:SS HHMM CANCELOU ]
    • bilhete: [CHAM RRRRRR DD/MM/YYYY HH:MM:SS HHMM NAO_CANCELOU ]
    • bilhete: [CHAM RRRRRR DD/MM/YYYY HH:MM:SS HHMM NAO_ATENDEU ]
    • bilhete: [CHAM RRRRRR DD/MM/YYYY HH:MM:SS HHMM EMERGEN-ATENDEU ]
  • bilhete: [CHAM RRRRRR DD/MM/YYYY HH:MM:SS HHMM EMERGEN-NAO_ATENDEU ]
      • [“PROG “] Indicação de bilhete de programação. (05 Caracteres)
      • [“CHAM “] Indicação de bilhete de chamada. (05 Caracteres)
      • [RRRRRR] Número do quarto. (06 Dígitos)
      • [DD/MM/YYYY HH:MM:SS] Data e Hora do bilhete. (19 Caracteres)
      • [HHMM] Hora da programação ou chamada de wakeup. (04 Dígitos)
      • [“CONFIRMOU “] Aplicação confirmada. (20 Caracteres)
      • [“NAO_CONFIRMOU “] Aplicação não confirmada. (20 Caracteres)
      • [“CANCELOU “] Aplicação cancelada. (20 Caracteres)
      • [“NAO_CANCELOU “] Aplicação não cancelada. (20 Caracteres)
      • [“NAO_ATENDEU “] Chamada não atendida. (20 Caracteres)
      • [“EMERGEN-ATENDEU “] Hospede atendeu as tentativas mas não cancelou. (20 Caracteres)
    • [“EMERGEN-NAO_ATENDEU “] Hospede não atendeu as tentativas. (20 Caracteres)

Observações:

    • Se HHMM=”9999″, cancela todas as operações de wakeup para o quarto.
  • HHMM Precisa ser um horário válido no formato 24 horas sem os dois pontos.

2.0 ROOMSTATUS Utilizado para passar informações de estado de cada quarto para registro no PMS. Como por exemplo se o quarto está limpo, sujo, ocupado ou vazio.

  • bilhete: [RST RRRRRR CCC SS]
      • [“RST “] Indicação de bilhete de RoomStatus. (05 Caracteres)
      • [RRRRRR] Número do quarto. (04 Dígitos)
      • [CCC] Identificação da camareira. (03 Dígitos)
    • [SS] Código de status do quarto. (02 Dígitos)

3.0 FRIGOBAR Utilizado para passar informações de consumo de frigobar para registro no PMS.

  • bilhete: [FRI RRRRRR CCC PPP Q]
      • [“FRI “] Indicação de bilhete de frigobar. (05 Caracteres)
      • [RRRRRR] Número do Quarto. (04 Dígitos)
      • [CCC] Identificação da Camareira. (03 Dígitos)
      • [PPP] Código do Produto. (03 Dígitos)
    • [Q} Quantidade. (01 Dígito)

4.0 MESSAGE UPDATEUtilizado para informar ao PMS se o quarto possui ou não novas mensagens no Voice Mail.

    • bilhete: [MSG RRRRRR] 
  • bilhete: [NMS RRRRRR]
      • [“MSG “] Indicação dizendo que possui mensagens novas. (05 Caracteres)
      • [“NMS “] Indicação dizendo que não possui mensagens. (05 Caracteres)
    • [RRRRRR] Número do Quarto. (06 Dígitos)

Deixe um comentário

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair /  Alterar )

Foto do Google

Você está comentando utilizando sua conta Google. Sair /  Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair /  Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair /  Alterar )

Conectando a %s