Especificações do Protocolo PMS 3CX

Introdução

Este capítulo detalha o protocolo 3CX PMS, que se integra ao software PMS do hotel. O protocolo 3CX PMS é muito parecido com o protocolo Mitel PMS ou Oracle Micros-Fidelio e, portanto, é possível especificar o protocolo Mitel PMS (SX2000) ou FIAS no sistema PMS. O protocolo Mitel está mais detalhado neste capítulo, enquanto o protocolo Micros-Fidelio é padronizado pela Oracle Micros.

Formulário de Especificação de Registro de Fornecedor Micros FIAS

A 3CX possui uma certificação da Micros-Fidelio após a conclusão do programa de interoperabilidade.

Informações do Protocolo Geral da Mitel

O link bidirecional PMS/Sistema (por meio de half-duplex) usa o protocolo ENQ/ACK/STX-text-ETX/ACK. A sequência de transmissão do PMS para o sistema é:

A transmissão da mensagem está concluída.

Há restrições de tempo impostas às sequências de transmissão:

O tempo máximo de espera pelo ACK após uma transmissão STX + msg + ETX é de 3 segundos.

Transmissão do PMS para o sistema

Depois de receber um caractere ENQ do PMS, o sistema responde em três segundos com um ACK ou um NAK. O ACK indica que a transmissão foi bem-sucedida. O NAK indica que houve um erro de transmissão ou que o sistema está ocupado. O sistema gera um registro de hotel indicando a ocorrência desse erro. Depois de enviar o ACK, o sistema fica imediatamente pronto para receber o STX, o texto da mensagem e o ETX. Dentro de três segundos após o recebimento do ETX, ele responde com:

• ACK indica que a transmissão foi bem-sucedida e que todos os campos da mensagem são válidos.
• NAK indica que houve um erro na própria transmissão, em um dos campos da mensagem ou na sintaxe da mensagem (especificamente STX, ETX, código de função e código de status. Por exemplo, CHK3 é enviado em vez de CHK1). O sistema gera um registro de hotel indicando a ocorrência desse erro. O PMS pode tentar enviar novamente apenas a mensagem txn (STX, texto da mensagem e ETX) mais três vezes sem precedê-la de uma mensagem ENQ.

O exemplo a seguir ilustra uma nova tentativa de transação do PMS:

Em seguida, o PMS descarta a transação.

Especificação do Formato PMS

As mensagens têm o seguinte formato geral:

Mensagens Check In/Out

A mensagem tem o seguinte formato:

X: O código de status do Check In/Out é

• Caractere ASCII 1 para Check In
• Caractere ASCII 0 para Check Out

SP: É o caractere em branco ASCII. n é um dígito do número da extensão.

Nota: Os números de ramal com menos de cinco dígitos são preenchidos com caracteres de espaço (ASCII 32, HEX 20), não com zeros (ASCII 48, HEX 30).

Se a mensagem recebida do PMS for inválida, o sistema retornará um NAK (um caractere ASCII para Negative Acknowledge).

Examplo:

Check In: (check in para o ramal 100)

STXCHK1 100ETX (onde STX = 2, ETX = 3) resultando na seguinte mensagem 2CHK1 1003

Mensagem de Nome

Essa mensagem é enviada pelo PMS e é usada para exibir o nome do Guest (visitante) no telefone. A mensagem de nome tem o seguinte formato de entrada:

NAM: É o código de função do nome.

NAME: É um caractere do nome (máximo de 21 caracteres).

n: É um dígito de número da extensão.

O comprimento do nome (até 21 caracteres) é ajustado à esquerda, com espaços em branco usados para preenchimento. Os caracteres podem ser maiúsculos ou minúsculos e também podem incluir caracteres numéricos. O nome e o sobrenome podem ser fornecidos (separados por uma vírgula colocada em qualquer lugar que não seja o 1º e o 21º local), mas se apenas um nome aparecer, ele será registrado como o sobrenome por padrão. O primeiro nome na cadeia deve ser o sobrenome ou apelido, seguido pelo primeiro nome. Se apenas um nome for fornecido, o 21º caractere será um espaço em branco (o tamanho máximo de um nome é 20).

O uso do código de operação de cadeia permite a adição e a exclusão de um nome específico em um ramal.

O sistema permite que mais de um nome seja adicionado a um ramal. A maioria das situações geralmente tem apenas um nome associado a um número de ramal.

O código String Operation é o primeiro byte do código de status e pode ser uma destas opções:

1. (adição) - O nome é ADICIONADO à lista atual de nomes dessa extensão. Se não houver nenhum nome para esse número, será criado um novo registro na lista telefônica.
2. (substituição) - O nome é usado para SUBSTITUIR o primeiro nome alfabético desse número. Todos os outros nomes desse número não são alterados

Se uma mensagem inválida for recebida do PMS, o sistema retornará um NAK.

Mensagens de Despertar

O sistema PMS pode informar ao sistema quando definir uma chamada de despertar para uma determinada extensão de um convidado. A mensagem de despertar tem o seguinte formato de saída:

t: É o horário de despertar.

n: É um dígito de número da extensão.

O horário de despertar é especificado em 24 horas. Todos os quatro caracteres, preenchidos com espaços em branco ASCII, representam uma exclusão da hora de despertar (formato de hora: HHmm).

Exemplo de chamada de despertar às 23 horas e 30 minutos para a extensão 100:

2MW 2330 1003

Mensagem DND

O sistema PMS pode informar ao PBX quando definir o status DND (Não perturbe) para um determinado ramal de convidado enviando a seguinte mensagem.

A mensagem DND tem o seguinte formato:

CÓDIGO DE STATUS:

• 1 – DND ON
• 0 – DND OFF
• SP é o caractere em branco ASCII.
• Examplo: definir DND ON para a extensão 302
• 2DND1   3023  STXDND1SPSPSP302ETX
• StxValue = 2
• EtxValue = 3
• ENQ = 5;
• ACK = 6;
• NACK = 21

Mensagem de Registro de Mensagem

Sempre que uma extensão do hotel faz uma chamada de tronco, o sistema envia uma mensagem ao PMS para atualizar a contagem total de chamadas externas feitas para o quarto do hóspede. Não é feita distinção entre chamadas locais e de longa distância. O registro de mensagens funciona contando o número de pulsos do medidor durante a duração da chamada.

A mensagem Message Registration tem o seguinte formato de saída:

SP: É o caractere em branco ASCII.

n: é um dígito de número de extensão.

O código de status, nesse caso, é uma taxa. Essa é a única exceção ao comprimento do código de status, que é de 4 bytes em vez de 2.

Mensagem de Restrição de Estação

Uma mensagem de Restrição de Estação pode ser usada para estabelecer restrições de chamadas. Quando essa mensagem é enviada do PMS para o sistema, ela coloca em vigor as restrições de chamadas programadas anteriormente.

Observação: os serviços de emergência (911/999) e as chamadas internas nunca serão restritos.

A mensagem “Station Restriction” tem o seguinte formato:

RST: É o código da função Station Restriction.

X: É um dígito de número de ramal ou suíte.

S: É um dos seguintes códigos de status:

• 0 - Interno
• 1 - Local
• 2 - Longa Distância

StxValue = 2

EtxValue = 3

ENQ = 5;

ACK = 6;

NACK = 21

Mensagem de Status da Camareira

A mensagem de status da camareira é usada para permitir que os profissionais da limpeza definam o status do quarto pelo telefone. A mensagem de status da camareira é acionada por uma chamada do quarto em questão e pela digitação do código de recurso especial, seguido do código apropriado para especificar o status do quarto.

Por exemplo, discar "*682" do quarto acionará uma mensagem de status da camareira para o PMS, que definirá o status do quarto como limpo.

A mensagem de status da camareira tem o seguinte formato:

X: É o código de status da camareira.

SP: É o caractere em branco ASCII.

n: É o dígito do número da estação (até 5 dígitos).

Quando um código de recurso é discado, o sistema envia um código de função e de status para o PMS, e o PMS interpreta os códigos da seguinte maneira:

Condição de Ocupação da Mensagem

• STS1 - Camareira presente
• STS2 - Limpo
• STS3 - Não limpo
• STS4 - Fora de serviço
• STS5 - A ser inspecionado
• STS6 - Ocupado/limpo
• STS7 - Ocupado/não limpo
• STS8 - Vago/Limpo
• STS9 - Vago/não limpo