Criação de políticas de cancelamento

Entenda como as políticas de cancelamento são modeladas e expostas por meio das APIs do Rapid Lodging.

Visão geral

A API Rapid Shopping retorna detalhes da política de cancelamento para cada tarifa na resposta de disponibilidade. A política de cancelamento específica para cada tarifa é construída a partir dos seguintes objetos principais:

• A flag tri-state current_refundabilityfornece uma representação precisa da reembolsabilidade da tarifa no momento da solicitação.
• O objeto cancel_penaltiesdefine janelas de política com datas de início/término, tipos de penalidade e valores.
• O nonrefundable_date_rangesdefine as datas de estadia que permanecerão non-refundable para a reserva (tendo precedência sobre cancel_penalties).

Nota: O deslocamento ISO-8601 retornado em cancel_penalties.starte cancel_penalties.endé o valor autorizado para exibição e cálculo. Normalmente, isso corresponde ao horário local propriedade, mas pode refletir dados do fuso horário supplier-configured e não deve ser recalculado a partir do endereço/geografia propriedade.

Todos os exemplos nesta página mostram o deslocamento explicitamente (por exemplo, GMT+7:00) para reforçar que você deve preservá-lo e exibi-lo como fornecido.

>> Consulte as regras específicas de exibição de políticas para propriedades na Califórnia

fotografia

Possibilidade de reembolso

Use current_refundabilitycomo seu controle principal para a lógica e experiência do usuário do refundability-driven; é a representação mais precisa da configuração da política, especialmente para cenários do partial-penalty.

O booleano refundablefornece visibilidade sobre a possibilidade de reembolso da apólice, mas é limitado e não descreve completamente como funcionam as penalidades parciais ou complexas, nem se outras taxas podem ser aplicadas. Qualquer tarifa que não seja totalmente reembolsável no momento da reserva será exibida refundable=false.

Non-refundable intervalos de datas

O uso do objeto nonrefundable_date_ranges para definir datas de estadia não reembolsáveis no momento da reserva é opcional. Observe que o nonrefundable_date_rangeinclui a tarifa noturna mais quaisquer impostos e taxas.

Quando uma tarifa tiver datas non-refundable definidas no objeto nonrefundable_date_ranges, essas noites serão cobradas juntamente com quaisquer outras taxas de penalidade de cancelamento estabelecidas no objeto cancel_penalties.

Taxas da propriedade

Ao mencionar taxas a pagar em caso de cancelamento, a melhor prática é usar a terminologia "propriedade taxa" em vez de "taxa de cancelamento" para refletir com mais precisão quem cobra a taxa e por que ela é devida.

No momento da reserva

Os detalhes da política de cancelamento serão alterados na resposta, dependendo se a reserva foi feita dentro ou fora do período de penalidade por cancelamento. Veja o refundablepropriedade nos exemplos abaixo.

Reserva efetuada dentro do período de cancelamento com penalidade:

{
  "itinerary_id": "9999999999999",
  ...
  "rooms": [
    {
      "links": {
        ...
      },
      "id": "1111",
      ...
      "status": "booked",
      "checkin": "2026-08-03",
      "checkout": "2026-08-07",
      ...
      "rate": {
        "id": "2222",
        ...
        "refundable": false,
        "cancel_refund": {
          "amount": "0.00",
          "currency": "USD"
        },
        "cancel_penalties": [
          {
            "currency": "USD",
            "percent": "100%",
            "start": "2026-07-16T06:56:59.311-07:00",
            "end": "2026-08-03T23:59:00.000-07:00"
          }
        ],
        ...
        "pricing": {
          ...
        }
      }
    }
  ]
}

Reservas feitas fora do período de cancelamento com penalidade:

{
  "itinerary_id": "9999999999999",
  ...
  "rooms": [
    {
      "links": {
        ...
      },
      "id": "1111",
      ...
      "status": "booked",
      "checkin": "2026-09-27",
      "checkout": "2026-10-02",
      ...
      "rate": {
        "id": "2222",
        ...
        "refundable": true,
        "cancel_refund": {
          "amount": "-1131.85",
          "currency": "EUR"
        },
        "cancel_penalties": [
          {
            "currency": "EUR",
            "percent": "100%",
            "start": "2026-07-18T01:21:30.000-07:00",
            "end": "2026-09-27T23:59:00.000-07:00"
          }
        ],
        ...
        "pricing": {
          ...
        }
      }
    }
  ]
}

Componentes da política

A política de cancelamento que você deve apresentar aos viajantes é derivada de quatro principais prazos, além de uma regra de reembolso **per-stay **. Os quatro períodos de tempo devem ser considerados na sua lógica e, quando aplicável, no texto da sua interface de usuário.

Exceção à política de cancelamento

Definido por: nonrefundable_date_ranges

Essas são datas de estadia que estão completamente non-refundable a partir do momento da reserva. Se uma diária reservada se enquadrar em um desses intervalos, essa diária será sempre cobrada integralmente, independentemente de quando o viajante cancelar a reserva.

O período é inclusivo; a tarifa noturna mais quaisquer impostos e taxas para a data final também são cobrados quando a noite é non-refundable.

Se apenas parte da estadia se sobrepuser a um intervalo non-refundable, as noites fora desse intervalo ainda podem ser reembolsáveis, sujeitas às outras janelas de penalidade em cancel_penalties.

Traveler-facing mensagens: Estas datas são non-refundable da reserva; se você alterar ou cancelar sua reserva, não receberá reembolso ou crédito para usar em uma estadia futura para esses dias e também precisará pagar todos os impostos e taxas.

Cancelamento grátis

Este é o período entre a criação da reserva e o início da janela do nível de política mais antigo com penalidade no objeto cancel_penalties, excluindo quaisquer noites que estejam em nonrefundable_date_ranges. Identifique o cancel_penalties.startmais antigo em todas as janelas e use esse carimbo de data/hora como o fim da sua janela de cancelamento gratuito.

Nota: As políticas de cancelamento podem ter até 3 níveis de janelas.

Traveler-facing mensagem: Cancele sua reserva antes de [data e hora de início do primeiro período de penalidade] e você receberá um reembolso total. Quaisquer reservas feitas dentro do período especificado por non-refundable não serão reembolsadas.

Cancelamento de penalidade

Definido por: Cada elemento de cancel_penaltiesquando presente.

Tipos de penalidades suportados

Dentro de cada período de penalidade, as noites em nonrefundable_date_rangespermanecem non-refundable e quaisquer penalidades adicionais se aplicam conforme configurado na janela cancel_penaltiesaplicável. Observe que é possível combinar quantidade + noites ou quantidade + porcentagem no mesmo período, mas não noites e porcentagem juntas em uma única janela de nível.

Multa de valor

• Uma taxa fixa em uma moeda específica (e.g. 200 USD)

Traveler-facing mensagens: Se você cancelar após [data e hora de início do período da apólice], será cobrado [valor] [moeda].

Multa de diária

• Uma taxa referente a um número específico de noites, acrescida de impostos e taxas (quando várias noites são reservadas, a cobrança é feita a partir da primeira noite).

Traveler-facing mensagens: _ Se cancelar após [data e hora de início do período da apólice], será cobrado o valor correspondente a [número de noites] noites, mais impostos e taxas._

Multa de percentual

• Uma porcentagem do valor total da estadia, incluindo taxas e encargos (e.g. 90%).

Traveler-facing mensagens: _ Se você cancelar após [data e hora de início do período da política], será cobrada uma taxa de [percentual] do valor total da sua estadia._

Cancelamento de Post-check-in e no-show

Este é o período após a última janela de penalidade configurada (cancel_penalties[end]). Em outras palavras, a janela de nível imediatamente anterior ao horário check-in.

Traveler-facing mensagens: _ Se você cancelar ou alterar esta reserva após o horário de cancelamento, será cobrado o valor [valor/moeda/número de noites/percentual conforme definido na última janela de penalidade configurada]._

Reembolsos para valores per-stay

Per-stay valores, devolvidos nostay objeto, siga uma única regra:

• Se algum dia da estadia for non-refundable, per-stay, os valores são non-refundable
• Os valores Per-stay só são reembolsados ​​quando o** estadia completa** é totalmente reembolsável

Observação: Para imóveis VRBO, existem nuances adicionais em relação às taxas de serviço e reembolsos – consulte seu Consultor de Integração para obter mais informações.

Atualizações sobre a exibição de políticas para propriedades na Califórnia

Para cumprir as mudanças de política na Califórnia, o período de cancelamento deve começar exatamente 24 horas após o registro de criação da reserva, a menos que a reserva seja feita dentro de 72 horas de check-in. Os sistemas da Expedia ajustam automaticamente os prazos de cancelamento para qualquer propriedade localizado na Califórnia.

Exemplos de comportamento esperado:

• Para um imóvel propriedade localizado na Califórnia, cuja tarifa é totalmente reembolsável e sem penalidade de cancelamento, a política de cancelamento permanecerá inalterada.
• Para um imóvel propriedade localizado na Califórnia que tenha uma tarifa non-refundable com uma penalidade de cancelamento em vigor a partir do momento da reserva, a política de cancelamento será alterada para começar exatamente 24 horas após a data de criação da reserva.
• Se um endereço propriedade estiver localizado fora da Califórnia, nenhuma alteração será feita na política de cancelamento, mesmo que a reserva seja feita na Califórnia.

Pre-booking política de cancelamento

O período atualizado para a penalidade de cancelamento será exibido automaticamente na chamada da API enquanto o viajante estiver fazendo compras. Você pode notar que orefundable A sinalização permanece falsa para reservas non-refundable e, portanto, você precisará respeitá-la de acordo com o prazo de cancelamento. Para hotéis, esse prazo é de 24 horas a partir do horário da reserva. Para propriedades da Vrbo, o prazo é até o final do dia seguinte à reserva.

Post-booking política de cancelamento

Após a reserva, a política ajustada da Califórnia continua a ser aplicada.

• UsarGET /itineraries ecancel_refund Consulte a seção "Gerenciar Reservas" como sua fonte confiável para saber se uma reserva é reembolsável e qual o valor a ser devolvido.
• Os e-mails de confirmação também mostram a política de cancelamento ajustada.
• O valor booleano refundable no Shopping não foi modificado para esta alteração; ele continua a refletir se uma taxa deve ser non-refundable para fins de filtragem.
• O parâmetro refundable na resposta Retrieve Itinerary reflete se a reserva está atualmente dentro dos períodos de cancelamento aplicáveis; use-o para decidir se uma reserva é totalmente reembolsável ao exibir as opções post-booking.

Exemplos

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

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

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

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

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

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

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

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

"refundable" : false,
"cancel_penalties" : [
    {
        "start" : "2027-11-16T18:00:00.000+04:00",
        "end" : "2027-11-19T18:00:00.000+04:00",
        "nights" : "1",
        "currency" : "EUR"
    }
],