Este tutorial descreve tecnicamente como a integração entre o PMS Desbravador, o Channel Manager e o RMS (Revenue Management System) como Climber, Bebook ou VOA Hotéis funciona.

1. O Fluxo de Comunicação e Sincronização

A integração flui em três camadas principais, ilustradas no fluxograma abaixo:

1. PMS (Fonte da Operação - PostgreeSQL / Front): Centraliza as ocupações reais (UHs reservadas, ocupadas, bloqueadas), gerenciamento do hóspede e lançamentos financeiros, enviando esses dados ao RMS de forma sincronizada.
2. RMS (Inteligência e Preço): Lê os insumos providos pelo PMS (restrições, taxas de ocupação, inventário histórico) para calcular valores dinâmicos. Envia esse Grid Tarifário otimizado para o Channel Manager (que assume a distribuição) ou repassa diretamente para as OTAs.
3. Channel Manager (Distribuidor): Atua apenas como motor distribuidor. Recebe do RMS a grade de tarifas já precificada e a distribui para os diversos canais de venda (OTAs).

2. Escopo de Carga e Histórico de Dados

Nas integrações do gênero de RMS mais sofisticados, não somente é exportado as diárias e UHs habitacionais hoje, mas dados complementares de Eventos e de Receita Alimentos & Bebidas das contas ativas em um período retrospectivo e prospectivo. Geralmente extrai-se a nível de banco:

• Passado: Até 3 anos de logs retroativos de hóspedes.
• Ocupação Futura: 365 Dias futuros já transacionados nos grids de bloqueios / reservas na agenda.

3. Configurando a Integração RMS e Channel Manager

Com base no modelo de configuração de integração padrão, detalhamos as etapas e restrições para ativação de um parceiro RMS:

Pré-requisitos

• Possuir a licença de integração com o RMS e tarifas mapeadas com canais conectados no Channel Manager.
• Atenção à Versão: A integração de tarifas vindas do bloco de inteligência (RMS) de volta para o PMS é homologada somente para os produtos 4.5 Front Office e família WEB.

Passo a Passo da Parametrização

Vá até: Desbravador Channel Manager > Configurações > Integrações Channel

1. Em Tipos, defina a interface homologada do parceiro de revenue.
2. Em Usuário, digite o nome descritivo do parceiro RMS.
3. Defina a Senha, que pode exigir composição baseada na nomenclatura juntamente com o código do cliente (Exemplo: se o código for 5109 do hotel Tryp, usar o padrão requisitado como trypribeirao5109).

Mapeamento a Enviar para o RMS

Para que os motores alinhem o banco de dados remoto com o Desbravador, o hoteleiro/suporte deve repassar aos técnicos do parceiro RMS:

• Credenciais Base: O Usuário, Senha de Conexão configurados e a Id Empresa;
• Tabela de Classificação de Pax: (Ex: Siglas como CHD, INF, ADT limitadas pelas idades correspondentes e acompanhadas pelo seu ID Integração).
• Tabela de Tarifas: (Preços mapeados com sua categoria e data inicial/final e seu ID Integração).
• Código dos Quartos (Tipo de UL): Listagem do nome da UL (SUI, LUX, STD) com limite de PAX por ambiente.

Encerramento e Auditoria

Após a etapa de setup técnico entre APIS e capacitação, o hoteleiro deverá observar o comportamento no Monitor Channel, validando as variações diárias de tarifa descendo para as pontas prontas para venda.

• Para clientes com Light Web / 3.0 Web: Basta enviar os códigos de cliente/Série (disponíveis na Página de Serviços) aos técnicos solicitando a ativação primária.
• Para as demais topologias (Front Office): Para habilitar a integração bi-direcional de dados, solicite ao Douglas Fabiano Spech (douglas@desbravador.com.br), do time de Projetos, que fará as configurações do endpoint da integração.

4. Diagnóstico e Resolução de Problemas (Troubleshooting)

Abaixo listados os principais cenários de erros já analisados na relação Channel X RMS.

Bloqueio no Envio/Retorno - Limite NGINX (Rate Limit)

• A infraestrutura de segurança possui limitação típica para 100 mensagens/minuto e até 3 consultas/segundo. Exceder o valor corta toda a integração RMS momentaneamente limitando a sincronicidade dos preços. Validar o log do Motor web para confirmar bloqueios 429 Too Many Requests.

Divergência nos Dados / Quebras de Linha no CSV Exportado

• O Desbravador repassa a informação aos agentes como estão descritas no banco. Quebras de linhas em campos strings \n fazem o CSV estourar e colocar o dado em colunas subsequentes, bagunçando as métricas do RMS e omitindo essas contas de cancelamentos e diárias calculadas.

Divergência na Diária Média (Especial Multipropriedades)

• Sistemas complexos onde as UH servem a clientes fixos ou donos fracionários costumam gerar conflitos na leitura do sistema RM na leitura totalística da receita diária. A auditoria deve gerar o Relatório Diário de Situação (RDS/PosicaoDetalhada.xlsx) no Desbravador e confrontar com o Json de leitura retornado para validar filtros ativados erroneamente.

Rejeição de Modificação / Tarifa Vencida