Certificação API do Cangooroo – Hotel, Tour, RentACar, Flight, Transfer e Insurance

Veja o que é necessário para certificar as APIs de Hotel, Tour, RentACar, Flight, Transfer e Insurance. Responda as perguntas gerais e, em seguida, as perguntas e cenários apenas dos produtos que você vai integrar.

Como enviar

É necessário preencher o formulário e responder as perguntas abaixo, salvar esse documento em um PDF e enviá-lo para suporte@cangooroo.net junto com os arquivos XML ou JSON do fluxo completo de cada cenário de teste dos produtos selecionados, em arquivos separados para cada request e response.

Recomenda-se nomear os arquivos indicando produto, cenário e método (ex.: Transfer_Cenario2_DoBooking_Request.json).

• Nome do Integrador
• E-mail(s) de contato
• Telefone(s) de contato

Produtos que serão certificados

• Hotel
• Tour
• RentACar
• Flight
• Transfer
• Insurance

Métodos obrigatórios

Todos os produtos seguem o mesmo fluxo de reserva. Os serviços abaixo devem ser sempre utilizados no fluxo completo:

1. Search
2. GetBookingConditions
3. DoBooking
4. CancelBooking (obrigatória a implementação do serviço de cancelamento)

O método CheckBookingStatus deve ser usado sempre que a resposta do DoBooking não for conclusiva.

Particularidade de Hotel: o cancelamento pode ser feito por CancelByService ou CancelAllHotelServices (obrigatória a implementação de ao menos um dos dois).

Particularidade de Flight: quando a emissão do bilhete for uma etapa separada da reserva, ela também faz parte do fluxo obrigatório e deve ser enviada nos arquivos de cada cenário.

Perguntas gerais (responder para todos os produtos)

1. Você poderia detalhar o fluxo de reserva que está seguindo? Gostaríamos de uma breve explicação sobre como funciona o fluxo de reservas do seu sistema e em que etapa você nos envia cada um dos nossos serviços. Se o fluxo for diferente entre os produtos, detalhe cada um.

2. Você está ciente de que é importante manter a mesma nacionalidade e a mesma composição de passageiros (quantidade e idades) em todas as etapas do fluxo? A tarifa é calculada com base nesses dados. Enviar valores diferentes no DoBooking em relação ao Search pode alterar o preço ou invalidar a tarifa selecionada.

3. Você exibe ao usuário as condições retornadas no GetBookingConditions antes de confirmar a reserva? Preço final, política de cancelamento e informações obrigatórias do serviço devem ser apresentados e aceitos pelo usuário antes do DoBooking. Se o preço ou as condições forem diferentes do Search, o usuário deve ser avisado.

4. Você está tratando da forma adequada todos os possíveis status de reserva retornados no campo “Status” da resposta do método “DoBooking”? Você deve assumir que a reserva foi confirmada apenas se for recebido "Status": "Confirmed". Você NÃO deve considerar que a reserva não foi confirmada no fornecedor caso receba algum erro na resposta do DoBooking, falta de resposta ou status informando problema técnico.

5. Tem conhecimento da possibilidade de enviar a sua referência de reserva através do campo “ClientReference”? Recomenda-se enviar esta informação junto com o pedido de confirmação de reserva. Se houver algum problema no processo de confirmação (e, portanto, você ainda não tiver nosso localizador), sua referência nos ajuda a identificar se a reserva foi criada e o que aconteceu com ela.

6. Você confirma que sabe do fluxo de checagem do status da reserva sempre que houver retorno de erro HTTP (4XX ou 5XX) no método “DoBooking”? Quando o response do DoBooking não for conclusivo, valide o status pelo método “CheckBookingStatus”. Assim você confirma se a reserva foi criada ou se será necessária uma nova solicitação, evitando reservas duplicadas.

7. Você entende que só pode considerar uma reserva como “cancelada” após receber a confirmação do cancelamento? Caso o response da chamada de cancelamento não retorne o status cancelado, faça uma nova chamada para garantir que a reserva será realmente cancelada no fornecedor. Caso contrário, ela pode permanecer ativa e gerar prejuízos.

Perguntas específicas por produto

Responda apenas os blocos dos produtos que serão certificados.

Hotel

H1. Você tem conhecimento de que é necessário sempre verificar o campo “MustCheckHotelInfo” retornado no método “GetBookingConditions”? Recomenda-se que sempre que for retornado "MustCheckHotelInfo": true no GetBookingConditions sejam revisados os dados de hotel do fornecedor (campos "SupplierHotelName" e "SupplierHotelAddress") e seja gerado um alerta no sistema do integrador, pedindo ao usuário que confirme se os dados são do hotel que deseja reservar antes de avançar. Caso o campo seja “true” e os dados retornados sejam de outro hotel, diferente do retornado na disponibilidade, o integrador se responsabiliza ao avançar com a reserva.

Tour

T1. Você está enviando a data, o horário (sessão) e a modalidade exatamente como retornados no Search/GetBookingConditions? Muitos passeios têm mais de uma sessão por dia ou modalidades diferentes (compartilhado, privativo, com ou sem traslado). O usuário deve ver e confirmar essas informações antes da reserva.

T2. Você exibe ponto de encontro, documentos exigidos e restrições do passeio, e envia no DoBooking os dados adicionais solicitados? Exemplos: hotel para pickup, documento ou data de nascimento do passageiro.

RentACar

R1. Você mantém o mesmo país de residência e a mesma idade do condutor principal em todas as etapas? A tarifa depende desses dados. Valores diferentes podem incluir taxas (ex.: condutor jovem) ou invalidar a tarifa.

R2. Você exibe o que está e o que não está incluído na tarifa? Proteções incluídas, franquia, política de combustível, quilometragem, taxas pagas no balcão (ex.: one-way, aeroporto) e caução no cartão de crédito. Valores pagos no destino não fazem parte do valor cobrado na reserva.

R3. Você envia lojas, datas e horários de retirada e devolução exatamente como retornados no Search, e o número do voo em retiradas em aeroporto? O horário deve respeitar o funcionamento da loja. O número do voo permite à locadora acompanhar atrasos.

Flight

F1. Você trata alterações de preço e disponibilidade retornadas no GetBookingConditions? Tarifas aéreas mudam com frequência. Se o valor for diferente do Search, o usuário deve confirmar o novo valor antes de seguir.

F2. Você envia os dados dos passageiros exatamente como no documento de viagem? Nome e sobrenome idênticos ao documento, sem abreviações, com data de nascimento e gênero. Em voos internacionais, envie também número, validade e país emissor do passaporte quando exigido. Erros de nome podem impedir o embarque.

F3. Você respeita o prazo de emissão (time limit) e exibe as regras tarifárias e de bagagem? Reservas não emitidas no prazo são canceladas pela companhia. Regras de alteração, cancelamento, reembolso e bagagem devem ser apresentadas antes da confirmação. Para bilhetes emitidos, o cancelamento segue a regra da tarifa (void, reembolso ou multa).

Transfer

TR1. Você envia os dados de voo (companhia, número e horário) nos traslados que envolvem aeroporto? O fornecedor usa esses dados para programar a busca e acompanhar atrasos. Sem eles, há risco de no-show.

TR2. Você confere se origem e destino retornados no GetBookingConditions correspondem ao trajeto pesquisado e exibe as condições do serviço? Tipo de serviço (privativo ou compartilhado), ponto de encontro, tempo de espera, limite de bagagem e telefone de emergência, quando retornados. Para hotéis, envie nome e endereço exatos.

Insurance

I1. Você mantém o mesmo destino, as mesmas datas de vigência e as mesmas idades dos segurados em todas as etapas? O preço é calculado por faixa etária, destino e período. A data de nascimento no DoBooking deve corresponder à idade usada no Search.

I2. Você exibe coberturas, limites, exclusões e condições gerais do plano antes da contratação? Para destinos com exigência legal (ex.: Espaço Schengen), confirme que o plano atende ao valor mínimo de cobertura exigido.

I3. Você envia nome completo, data de nascimento e documento (CPF ou passaporte) de cada segurado, e sabe que o cancelamento normalmente só é aceito antes do início da vigência? Esses dados constam no voucher e são usados pela assistência. Após o início da vigência, o cancelamento pode não ser permitido ou não gerar reembolso.

Cenários de teste

Execute os 4 cenários de cada produto que será certificado. Em todos eles é necessário confirmar e cancelar a reserva.

Hotel

• Cenário 1: 1 quarto com 1 adulto.
• Cenário 2: 2 quartos, com 2 adultos no primeiro quarto e 1 adulto e 1 criança no segundo.
• Cenário 3: 3 quartos com 2 adultos cada.
• Cenário 4: 3 quartos, sendo 1 adulto no primeiro, 1 adulto e 1 criança no segundo e 2 adultos e 2 crianças no terceiro.

Tour

• Cenário 1: 1 passeio com 1 adulto.
• Cenário 2: 1 passeio com 2 adultos e 1 criança (informando a idade).
• Cenário 3: 2 passeios diferentes na mesma reserva, com 2 adultos cada.
• Cenário 4: 3 passeios, sendo 1 adulto no primeiro, 1 adulto e 1 criança no segundo e 2 adultos e 2 crianças no terceiro, com ao menos um passeio com seleção de sessão/horário.

RentACar

• Cenário 1: Retirada e devolução na mesma loja, 1 condutor, sem opcionais.
• Cenário 2: Retirada em aeroporto (com número do voo) e devolução na mesma loja, 1 condutor e 1 opcional (ex.: cadeirinha infantil).
• Cenário 3: Retirada e devolução em lojas diferentes (one-way), 1 condutor e proteção adicional.
• Cenário 4: Condutor principal e condutor adicional, mais de um opcional (ex.: GPS e cadeirinha infantil), categoria diferente da econômica.

Flight

• Cenário 1: Só ida, 1 adulto.
• Cenário 2: Ida e volta, 2 adultos e 1 criança.
• Cenário 3: Ida e volta internacional, 2 adultos, 1 criança e 1 bebê, com dados de passaporte.
• Cenário 4: Voo com conexão (ou multitrecho, se disponível), 4 adultos e 3 crianças de idades diferentes.

Transfer

• Cenário 1: Só ida (aeroporto → hotel), 1 adulto, com dados do voo de chegada.
• Cenário 2: Ida e volta (aeroporto ↔ hotel), 2 adultos e 1 criança, com voos de chegada e partida.
• Cenário 3: 3 transfers na mesma reserva (ex.: chegada, hotel → porto e saída), com 2 adultos cada.
• Cenário 4: 3 transfers, sendo 1 adulto no primeiro, 1 adulto e 1 criança no segundo e 2 adultos e 2 crianças no terceiro, com ao menos um privativo e um compartilhado.

Insurance

• Cenário 1: 1 segurado adulto, viagem internacional.
• Cenário 2: 2 adultos e 1 criança.
• Cenário 3: 3 adultos em faixas etárias diferentes, incluindo 1 segurado acima de 65 anos.
• Cenário 4: 4 adultos e 3 crianças, destino Europa (Espaço Schengen), vigência acima de 15 dias.