Criação de políticas de cancelamento

Descubra como as políticas de cancelamento funcionam na Rapid API

Introdução

Todos os tipos de tarifa que não são totalmente reembolsáveis no momento da reserva exibem refundable=false na resposta da API.

A política de cancelamento específica para cada tarifa é determinada por uma combinação dos objetos cancel_penalties e nonrefundable_date_ranges na API Rapid Shop Availability.

  • O objeto nonrefundable_date_ranges define todas as datas de estadia que não são totalmente reembolsáveis no momento da reserva. Como tal, esse objeto tem precedência sobre quaisquer políticas de cancelamento adicionais definidas no objeto cancel_penalties. O uso do objeto nonrefundable_date_ranges para definir datas de estadia não reembolsáveis no momento da reserva é opcional. Vale lembrar que nonrefundable_date_range é inclusivo, ou seja, a diária mais os impostos e as taxas para a data de término também serão cobrados.
  • O objeto cancel_penalties define detalhes de multa de cancelamento adicionais, e há uma variedade de opções para construir essas políticas. Os detalhes incluem as datas inicial e final da multa especificada, bem como o período, o tipo e o valor da multa. Os tipos de multa incluem um valor fixo, número de diárias e porcentagem do custo total.

É importante observar que, quando uma tarifa tiver datas não reembolsáveis definidas no objeto nonrefundable_date_ranges, essas noites serão cobradas além de quaisquer outras multas de cancelamento definidas no objeto cancel_penalties.

O valor do reembolso de uma reserva pode ser encontrado no objeto cancel_refund no serviço Recuperar reserva como parte da API de gerenciamento de reservas. Veja abaixo mais informações sobre o status dos reembolsos de valores por estadia.

As diretrizes para a criação do texto da política de cancelamento abaixo são apresentadas para ajudar as propriedades a interpretar e comunicar a política de cancelamento com precisão aos viajantes finais ou mostrar uma mensagem com a informação de não reembolsável aos clientes quando a API retorna a política em um formato não indicado.

Modelo de política

A política de cancelamento é composta por quatro períodos principais que são representados com o modelo a seguir. Inclua os quatro períodos para representar de maneira adequada a política de cancelamento.

1. Período de exceção da política de cancelamento.

As datas para as quais não vai haver reembolso no cancelamento, a partir do momento da reserva, podem ser definidas no objeto nonrefundable_date_ranges. As datas de estadia fora desse período estão sujeitas à política fornecida no objeto cancel_penalties e, portanto, é possível receber um reembolso parcial se apenas parte da estadia reservada estiver dentro do prazo de exceção.

2. Período de cancelamento grátis.

Cancelamento grátis até [data e hora iniciais do primeiro período de multa]. Observação: as datas de estadia reservadas que estiverem dentro de um intervalo de datas não reembolsável (conforme definido no objeto nonrefundable_date_ranges) não vão ser reembolsadas, mas as datas de estadia fora desse período vão ser reembolsadas de modo integral se o cancelamento for feito antes do horário de início do período de multa mais antigo fornecido no objeto cancel_penalties.

3. Períodos de multa por cancelamento (são possíveis vários períodos de multa): se cancel_penalties estiver na resposta da API.

Observação: as datas de estadia reservadas que estiverem dentro de um intervalo de datas não reembolsável (conforme definido no objeto nonrefundable_date_ranges) ainda vão ser cobradas de modo integral, mas quaisquer datas de estadia fora desse período vão ser reembolsadas de acordo com as políticas fornecidas no objeto cancel_penalties.

Multa de valor

Cancelamentos feitos após [data e hora iniciais do período de multa] vão resultar em uma taxa de [valor] [moeda].

OU

Multa de diária

Cancelamentos feitos após [data e hora iniciais do período de multa] estão sujeitos a uma multa de [número de diárias] diárias mais impostos e taxas.

OU

Multa de percentual

Cancelamentos feitos após [data e hora iniciais do período de multa] estão sujeitos a uma multa de [porcentagem] por cento do preço total. É possível aplicar multas de valor e de diária ou de valor e de porcentagem, mas não uma multa de diária e de porcentagem no mesmo período.

4. Período de no show e check-in tardio.

Se você não fizer o check-in da reserva e se cancelar ou alterar a reserva após o check-in, poderá incorrer em multas, a critério da propriedade, de até 100% do valor da reserva. A data final do período de multa mais recente é a data e hora de cancelamento mais recentes.

5. Reembolsos de valores por estadia.

Os valores por estadia, retornados no objeto da estadia, são considerados não reembolsáveis se um ou mais dias da reserva também forem não reembolsáveis. Os valores por estadia só serão reembolsados se a estadia inteira for totalmente reembolsável.

Exemplos

|

Exemplo 1: multa de valor

Resposta da API:

"refundable": true,
"cancel_penalties": [
    {
        "start": "2022-08-26T23:59:00.000+07:00",
        "end": "2022-09-29T23:59:00.000+07:00",
        "amount": "200",
        "currency": "USD"
    }
],

Detalhes da reserva:

  • Cliente faz reserva em 5 de julho de 2022
  • A data de check-in é 29 de setembro de 2022
  • A data de check-out é 6 de outubro de 2022

Política de cancelamento explicada:

  • Cancelamento grátis até 26 de agosto de 2022 às 23h59 (GMT +7:00).
  • Cancelamentos feitos após 26 de agosto de 2022 às 23h59 (GMT +7:00) vão resultar em uma taxa de US$ 200.
  • O fim do período de cancelamento sujeito a multa é 29 de setembro de 2022 às 23h59 (GMT +7:00), momento em que a reserva vai se tornar não reembolsável na sua totalidade.
  • Se você não fizer o check-in da reserva e se cancelar ou alterar a reserva após o check-in, poderá incorrer em multas, a critério da propriedade, de até 100% do valor da reserva.

Exemplo 2 - Multa de valor + Datas não reembolsáveis

Resposta da API:

"refundable": false,
"cancel_penalties": [
    {
        "start": "2022-08-26T23:59:00.000+07:00",
        "end": "2022-09-29T23:59:00.000+07:00",
        "amount": "200",
        "currency": "USD"
    }
], 
"nonrefundable_date_ranges": [ 
    {  
        "start": "2022-09-30",
        "end": "2022-10-01"
    }
    {   "start": "2022-10-05",         
        "end": "2022-10-06"     
    }
],

Detalhes da reserva:

  • Cliente faz reserva em 5 de julho de 2022
  • A data de check-in é 29 de setembro de 2022
  • A data de check-out é 7 de outubro de 2022

Política de cancelamento explicada:

  • Cancelamento até 26 de agosto de 2022 às 23h59 (GMT +7:00):
  • Todas as noites reservadas durante intervalos de datas não reembolsáveis (30 de setembro de 2022 a 1º de outubro de 2022 e 5 de outubro de 2022 a 6 de outubro de 2022) são totalmente não reembolsáveis a partir do momento da reserva.
  • O cancelamento é gratuito para todas as noites fora dos intervalos de datas não reembolsáveis.
  • Cancelamentos entre 26 de agosto de 2022 às 23h59 (GMT +7:00) e 29 de setembro de 2022 às 23h59 (GMT +7:00):
  • Todas as noites reservadas durante intervalos de datas não reembolsáveis (30 de setembro de 2022 a 1º de outubro de 2022 e 5 de outubro de 2022 a 6 de outubro de 2022) são totalmente não reembolsáveis a partir do momento da reserva.
  • Noites fora dos intervalos de datas não reembolsáveis incorrerão em uma multa adicional de US$ 200.
  • O fim do período de cancelamento sujeito a multa é 29 de setembro de 2022 às 23h59 (GMT +7:00), momento em que a reserva vai se tornar não reembolsável na sua totalidade.
  • Se você não fizer o check-in da reserva e se cancelar ou alterar a reserva após o check-in, poderá incorrer em multas, a critério da propriedade, de até 100% do valor da reserva.

Observação: o objeto nonrefundable_date_ranges pode ser combinado dessa forma com qualquer um dos períodos de tempo do objeto cancel_penalties.

Exemplo 3: multa de diária

Resposta da API:

"refundable": true,
"cancel_penalties": [
    {
        "start": "2022-08-26T23:59:00.000+07:00",
        "end": "2022-09-29T23:59:00.000+07:00",
        "nights": "1",
        "currency": "USD"
    }
],

Detalhes da reserva:

  • Cliente faz reserva em 5 de julho de 2022
  • A data de check-in é 29 de setembro de 2022
  • A data de check-out é 6 de outubro de 2022

Política de cancelamento explicada:

  • Cancelamento grátis até 26 de agosto de 2022 às 23h59 (GMT +7:00).
  • Cancelamentos feitos após 26 de agosto de 2022 às 23h59 (GMT +7:00) vão resultar em uma cobrança de multa de diária.
  • O fim do período de cancelamento sujeito a multa é 29 de setembro de 2022 às 23h59 (GMT +7:00), momento em que a reserva vai se tornar não reembolsável na sua totalidade.
  • Se você não fizer o check-in da reserva e se cancelar ou alterar a reserva após o check-in, poderá incorrer em multas, a critério da propriedade, de até 100% do valor da reserva.

Observação: quando várias diárias são reservadas, a multa cobrada é para a primeira diária da reserva.

Exemplo 4: multa de percentual

Resposta da API:

"refundable": true,
"cancel_penalties": [
    {         
        "start": "2022-08-26T23:59:00.000+07:00",        
        "end": "2022-09-29T23:59:00.000+07:00",         
        "percent": "90%",        
        "currency": "USD"     }
],

Detalhes da reserva:

  • Cliente faz reserva em 5 de julho de 2022
  • A data de check-in é 29 de setembro de 2022
  • A data de check-out é 6 de outubro de 2022

Política de cancelamento explicada:

  • Cancelamento grátis até 26 de agosto de 2022 às 23h59 (GMT +7:00).
  • Cancelamentos feitos após 26 de agosto de 2022 às 23h59 (GMT +7:00) vão resultar em uma multa de 90% das cobranças e taxas da estadia.
  • O fim do período de cancelamento sujeito a multa é 29 de setembro de 2022 às 23h59 (GMT +7:00), momento em que a reserva vai se tornar não reembolsável na sua totalidade.
  • Se você não fizer o check-in da reserva e se cancelar ou alterar a reserva após o check-in, poderá incorrer em multas, a critério da propriedade, de até 100% do valor da reserva.

Exemplo 5: cancelamento grátis, sem multas por cancelamento

Resposta da API:

"refundable": true,
"cancel_penalties": [
    {
    "start": "2022-08-26T23:59:00.000+07:00",
    "end": "2022-09-29T23:59:00.000+07:00",
    "nights": "0",
    "currency": "USD"
    }
],

Detalhes da reserva:

  • Cliente faz reserva em 5 de julho de 2022
  • A data de check-in é 29 de setembro de 2022
  • A data de check-out é 6 de outubro de 2022

Política de cancelamento explicada:

  • Cancelamento grátis até 26 de agosto de 2022 às 23h59 (GMT +7:00).
  • O cancelamento entre 26 de agosto às 23h59 (GMT +7h) e o dia do check-in, 29 de setembro de 2022, é gratuito. Nenhuma cobrança de penalidade vai ser feita.
  • Se você não fizer o check-in da reserva e se cancelar ou alterar a reserva após o check-in, poderá incorrer em multas, a critério da propriedade, de até 100% do valor da reserva.

Exemplo 6: não reembolsável

Se uma reserva não for totalmente reembolsável, a data ou hora inicial da janela cancel_penalties será anterior à data ou hora da reserva.

Resposta da API:

"cancel_penalties": [
        {
                "start": "2022-11-29T10:47:19.727+00:00",
                "end": "2023-01-05T23:59:00.000+00:00",
                "percent": "100%",
                "currency": "USD"
        }
    ],

Detalhes da reserva:

  • Cliente faz reserva em 30 de novembro de 2022
  • A data de check-in é 5 de janeiro de 2023
  • A data de check-out é 7 de janeiro de 2023

Texto da política de cancelamento:

  • Se você cancelar a sua reserva, não vai receber reembolso nem crédito para usar em uma estadia futura.

Exemplo 7: cancelamento em níveis

As políticas de cancelamento em níveis permitem que as propriedades cobrem dos clientes uma penalidade de cancelamento que varia de acordo com o valor do aviso de cancelamento. Em geral, quanto mais próximo o cliente cancelar da data da estadia, maior será a multa por cancelamento.

Resposta da API:

"refundable": true,
"cancel_penalties": [
    { 
        "start": "2022-08-31T23:59:00.000+07:00",
        "end": "2022-12-09T23:59:00.000+07:00",
        "percent": "70%", 
        "currency": "USD" 
    },
    { 
        "start": "2022-12-09T23:59:00.000+07:00",
        "end": "2022-12-12T23:59:00.000+07:00",
        "percent": "90%", 
        "currency": "USD" 
    }
 ],

Detalhes da reserva:

  • Cliente faz reserva em 5 de julho de 2022
  • A data de check-in é 12 de dezembro de 2022
  • A data de check-out é 22 de dezembro de 2022

Política de cancelamento explicada:

  • Cancelamentos feitos antes de 31 de agosto de 2022 às 23h59 (GMT +7:00) são gratuitos.
  • Cancelamentos feitos entre 31 de agosto de 2022 às 23h59 (GMT +7:00) e 9 de dezembro de 2022 às 23h59 (GMT +7:00) vão resultar em uma multa de 70% das cobranças e taxas da estadia.
  • Cancelamentos feitos entre 9 de dezembro de 2022 às 23h59 (GMT +7:00) e 12 de dezembro de 2022 às 23h59 (GMT +7:00) vão resultar em uma multa de 90% das cobranças e taxas da estadia.
  • O fim do período de cancelamento sujeito a multa é 12 de dezembro de 2022 às 23h59 (GMT +7:00), momento no qual a reserva vai se tornar não reembolsável na sua totalidade.
  • Se você não fizer o check-in da reserva e se cancelar ou alterar a reserva após o check-in, poderá incorrer em multas, a critério da propriedade, de até 100% do valor da reserva.

Exemplo 8: parcialmente reembolsável

Resposta da API:

"refundable": false
"cancel_penalties": [
     {
     "start": "2022-11-27T22:21:15.996+01:00",
     "end": "2023-01-10T18:00:00.000+01:00",
     "percent": "90%",
     "currency": "USD"
     }
  ],

Detalhes da reserva:

  • Cliente faz reserva em 28 de novembro de 2022
  • A data de check-in é 10 de janeiro de 2023
  • A data de check-out é 14 de janeiro de 2023

Política de cancelamento explicada:

  • Todos os cancelamentos a partir do momento da reserva incorrerão em uma multa de cancelamento de 90%.
  • O fim do período de cancelamento sujeito a multa é 10 de dezembro de 2022 às 23h59 (GMT +7:00), momento no qual a reserva vai se tornar não reembolsável na sua totalidade.
  • Se você não fizer o check-in da reserva e se cancelar ou alterar a reserva após o check-in, poderá incorrer em multas, a critério da propriedade, de até 100% do valor da reserva.

Exemplo 9: valores por estadia não reembolsáveis

Resposta da API:

"refundable" : true,
      "cancel_refund" : {
        "amount" : "-784.57",
        "currency" : "EUR"
      },
      "cancel_penalties" : [ {
        "currency" : "EUR",
        "nights" : "1",
        "start" : "2022-11-16T18:00:00.000+04:00",
        "end" : "2022-11-19T18:00:00.000+04:00"

Política de cancelamento explicada:

  • Os valores por estadia só são reembolsáveis se a reserva inteira for reembolsável.
  • Como o cancelamento desta reserva incorre em uma multa por cancelamento de uma diária, a reserva inteira é não reembolsável e, por isso, os valores por estadia não serão reembolsados.
Esta página foi útil?
Como podemos melhorar esse conteúdo?
Agradecemos por nos ajudar a melhorar o Developer Hub.