Suporte
Fale com nossa equipe de desenvolvimento sobre qualquer coisa que esteja travando sua integração. Sugerimos consultar primeiro a página Códigos de erro do produto; a maioria das dúvidas é respondida lá.
Dúvidas técnicas, relatos de bugs, solicitações de chave de parceiro e de hotel de teste. Respondemos em até um dia útil.
Telefone
Dias úteis, 09:00–18:00 (GMT+3). Para indisponibilidades que afetam o ambiente de produção.
Chave de parceiro
O acesso requer uma conta de parceiro emitida pela HMS. Envie por e-mail os dados da sua empresa e os hotéis que você vai integrar; você receberá uma apiKey, um apiSecret e um ID de hotel para o ambiente de teste.
Ao relatar um problema, inclua
- Produto e endpoint (ex.: Online Booking ·
POST /external/online/roomType) - O corpo completo da requisição e a resposta, com
apiSecret, token e dados de cartão mascarados - Quando a requisição foi enviada (com fuso horário) e o
hotelID - O resultado esperado e se o problema pode ser reproduzido
Perguntas frequentes
Do que eu preciso para usar a API?
Uma conta de parceiro emitida pela HMS (apiKey / apiSecret) e autorização para o hotel que você vai integrar. O módulo correspondente (por exemplo, o canal de reservas online) precisa estar ativo no hotel.
Existe um ambiente de teste?
Sim. Os exemplos desta documentação usam o ambiente de teste (test.hms.gen.tr); para o desenvolvimento, fornecemos um cadastro de hotel e uma chave de parceiro nesse ambiente. O endereço e as chaves de produção são enviados quando a integração é aprovada.
Estou recebendo 401.
O token está ausente, expirou, não tem o prefixo Bearer ou pertence a outro hotel. Faça login de novo e repita a requisição. Se o login retornar success: false, verifique message: par de chaves incorreto ou falta de autorização para o hotel.
A lista de quartos vem vazia ou roomCount é 0.
O canal online do hotel está fechado (errorCode 10003), nenhum tipo de quarto está aberto para venda (10004) ou há restrições de data/ocupação. Para quartos com roomCount 0, roomRestrictionMessage informa o motivo (estadia mínima, fechado para check-in, tarifa não definida).
Enviei uma reserva, mas ela não aparece no painel.
Verifique se há Error em BookingPushRS. Hotel registration not found on HMS. significa que o hotel não está vinculado ao canal online; Could not register. geralmente indica roomTypeID / ratePlanID inválido ou datas inconsistentes.
Quando as APIs dos outros módulos serão publicadas?
A documentação de PDV de Restaurante, Spa, IA, TV e PABX está sendo adicionada aos poucos. As datas de lançamento são anunciadas nas notas de versão; escreva para nós se quiser acesso antecipado a um módulo específico.