Esta especificação é o ponto de partida para entender o fluxo de integração de reservas com o sistema Sismotel.

API de Integração de Reservas do Sismotel fornece todo o conhecimento necessário para a integração de sistemas terceiros. O foco desta API é suprir a necessidade de reservas online dos moteleiros.

Esta API trata as solicitações de reservas para as próximas 24 horas como reservas do dia (last minute) e maiores que 24 horas como reservas futuras (programadas). Ou seja, para efetivação de uma nova reserva, o sistema considera como regra principal o status atual das suítes e como regra secundária as RESERVAS JÁ CONFIRMADAS QUE ESTÃO PREVISTAS (mapa de reserva). Enquanto a reserva programada considera apenas as RESERVAS CONFIRMADAS PREVISTAS (mapa de reservas).

• Reservas para as próximas 24 horas, considera os status atual das suítes.
• Reservas após as próximas 24 horas, considera as reservas já confirmadas que estão previstas (mapa de reservas).
• Para a utilização e consumo dos endpoints da API é permitido 1 request por segundo.

1 - Solicitação de Pré-Reserva (API RECEBE)
2 - Pré-Reserva Cancelada
3 - Pré-Reserva Confirmada
4 - Informações de Pagamento (API RECEBE)
5 - Pagamento não Registrado
6 - Pagamento Registrado (Confirmada)
7 - Solicitação de Cancelamento, antes de check-in (API RECEBE)
8 - Confirmação de Cancelamento
9 - Cancelamento pelo Sistema
10 - Check-in
11 - Troca de Suíte
12 - Checkout
13 - No Show
14 - Cancelamento pelo Sistema após check-in
15 - Solicitado alteração nos dados da Reserva
98 - Timeout
99 - Motel Offline

1 - PERIODO
2 - PERNOITE
3 - PERDIA
4 - DIARIA

1 - Buscar as Categorias;
2 - Solicitar pré-reserva, de acordo com os dados da categoria obtidas anteriormente;
3 - Buscar informação da reserva a cada x tempo, recomendamos 10 segundos. Caso a pré-reserva fique 60 segundos sem alterar a situação, será automaticamente cancelada, com a situação 98 - Timeout.
4 - Se a situação da reserva for 3, a pré-reserva foi confirmada; O sistema informa a suíte que foi reservada e irá aguardar pela informação de pagamento. Envie a informação de pagamento da reserva. (Só pode ser feita, quando a situação da pré-reserva for igual a 3)
5 - O sistema reconhece o pagamento e confirma a reserva da suíte.

1 - A reserva pode ser cancelada pela api, se ainda não foi feito o check-in. Ou seja, quando as situações ainda forem (1, 2, 3, 4, 5, 6);
2 - O pagamento da reserva não for confirmado em 3 minutos, ou seja, não enviar a confirmação de pagamento (situação 4).

1 - Somente reservas confirmadas podem ser editadas. Ou seja, a edição só é permitida quando o situação for igual a 6 (confirmada).
2 - Ao solicitar a edição de uma reserva, a situação será alterado para 15, indicando que a reserva está em processo de edição, até que o sistema conclua a operação.
3 - Após a conclusão da edição, o sistema retornará a situação 6 novamente, indicando que a reserva foi confirmada, juntamente com uma mensagem informando se a alteração foi realizada com sucesso ou não.
4 - Não é possivel editar dados como: CPF e Valores. Se for necessário alterar esses dados, o fluxo recomendado é cancelar a reserva e fazer uma nova.

Para utilizar o módulo Fidelidade, é necessário que o cliente tenha o serviço Fidelidade Web contratado, juntamente com os parâmetros FIDELIDADE-RTOKEN e FIDELIDADE-EMPRESA-ID.

Categorias = Tipo de Suíte.
TOKEN = Token do motel, fornecido pela Microtecs com autorização do Motel.
SOFTHOUSE = Token da Softhouse, fornecido pela Microtecs. Envie um e-mail para atendimento@microtecs.com.br com os dados: nome, email e telefone da softhouse para solicitar o cadastro e o token.
FIDELIDADE-RTOKEN = Token da rede.
FIDELIDADE-EMPRESA-ID = CNPJ da empresa.

Operações relacionadas as reservas do motel.