FAQ - Integrações API Cangooroo

1. Busca e Conteúdo Estático

P: O ID do quarto (roomId) é único e permanente?R: O roomId é único dentro de uma resposta de busca, mas é dinâmico. Ele pode mudar a cada nova requisição. Não utilize esse ID para mapeamento estático em seu banco de dados.

P: Qual a diferença entre "Quantity" e "QuantityAvailable" no nó de quartos?R: IsAvailable indica disponibilidade geral. Quantity e QuantityAvailable referem-se ao inventário total e ao inventário ainda disponível para venda naquele momento, respectivamente.

P: Por que os campos de taxas (Taxes, TotalTax) aparecem vazios em alguns hotéis?R: Esses campos só são preenchidos se o hotel ou provedor configurar taxas específicas (como taxas governamentais ou de propriedade) separadas da tarifa base. Se estiverem vazios, o preço total já contempla os valores necessários ou não há taxas adicionais informadas pelo provedor.

2. Regras de Cancelamento e Refeições

P: Pode haver conflito entre o campo "IsNonRefundable" e as "CancellationPolicies"?R: Não há conflito. O campo IsNonRefundable é um booleano derivado das políticas. Se ele for true, a reserva é não reembolsável desde o momento da criação. Se houver uma política com data futura, prevalecem as regras descritas no nó de políticas.

P: Além do BoardCode, devo usar parâmetros como "Halfboard" ou "AllInclusive"?R: O BoardCode é o identificador principal do regime de alimentação. Os demais parâmetros são descritivos e servem para detalhar o que o código representa (ex: Meia Pensão, Tudo Incluso).

3. Processo de Reserva (DoBooking)

P: Como identificar minha reserva em caso de erro de rede se eu não receber o ID da Cangooroo?R: Você deve enviar o seu ID interno no campo ExternalReference (ou ClientReference, conforme o esquema). Em caso de erro ou timeout, utilize o método CheckBookingStatus filtrando pela sua referência externa para verificar se a reserva foi gerada com sucesso.

P: Como estruturar uma reserva de múltiplos quartos do mesmo tipo?R: No nó Rooms, você pode enviar múltiplos elementos. Se os quartos forem idênticos (mesma categoria e ocupação), o RoomId será o mesmo para todos os identicos da lista.

P: É necessário enviar informações de pagamento (cartão de crédito)?R: Se o seu perfil for do tipo Faturado (Invoiced), você não precisa preencher os campos de cartão de crédito no DoBooking.

4. Gestão Pós-Reserva e Status

P: Qual a diferença entre "Status" e "SystemStatus" no retorno da reserva?R: * Status: É a descrição textual do estado da reserva (ex: "Confirmed", "Cancelled").

• SystemStatus: É o código interno relacionado a essa descrição, útil para automações no seu sistema.

P: Qual GetBookingDetail devo usar: CangoorooBackOffice ou ClientBackOffice?R: Utilize sempre o ClientBackOffice.svc. O serviço CangoorooBackOffice é exclusivo para uso interno do operador.

5. Fase de Certificação

P: Concluí o desenvolvimento. Qual o próximo passo?R: Você deve seguir o documento de Certificação da API. Ele contém os casos de teste obrigatórios (reserva, cancelamento, verificação de status, etc.) que devem ser validados antes do "Go-Live"