Creación de políticas de cancelación
Entiende cómo se definen y se ofrecen las políticas de cancelación a través de las API de Rapid Lodging
Información general
La API de Rapid Shopping te da los detalles de la política de cancelación de cada tarifa en la respuesta de disponibilidad. La política de cancelación específica de cada tarifa se basa en los siguientes elementos clave:
- El indicador « tri-state » (
current_refundability) ofrece una representación precisa de si la tarifa es reembolsable en el momento de realizar la solicitud. - El objeto «
cancel_penalties» define las ventanas de las pólizas con fechas de inicio y fin, tipos de penalización y valores. - El «
nonrefundable_date_ranges» define las fechas de estancia que se mantendrán como « non-refundable » para la reserva (y que tienen prioridad sobre «cancel_penalties»).
Nota: El valor de desplazamiento «ISO-8601 » que aparece en cancel_penalties.starty cancel_penalties.endes el valor oficial que debes usar para mostrar y calcular. Esto suele coincidir con la hora local del alojamiento, pero puede reflejar datos de zona horari supplier-configured es y no deberías volver a calcularla a partir de la dirección o la ubicación geográfica del alojamiento.
Todos los ejemplos de esta página muestran la diferencia horaria de forma explícita (por ejemplo, GMT+7:00) para dejar claro que debes mantenerla y mostrarla tal y como aparece.
Pautas
Refundability (Posibilidad de reembolso)
Utiliza current_refundabilitycomo tu principal herramienta de control para la lógica y la experiencia de usuario de refundability-driven; es la representación más precisa de la configuración de políticas, sobre todo para los escenarios de partial-penalty.
| Valor | Significado |
|---|---|
refundable | Completamente reembolsable |
non_refundable | No se admiten devoluciones |
partially_refundable | La penalización es superior a 0 pero inferior al valor total de la reserva, y/o hay intervalos de fechas « non-refundable » dentro de la estancia |
El valor booleano « refundable » te permite saber si la póliza es reembolsable, pero es un dato limitado y no explica del todo cómo funcionan las penalizaciones parciales o complejas, ni si podrían aplicarse otras comisiones. Cualquier tarifa que no sea totalmente reembolsable en el momento de la reserva aparecerá como « refundable=false ».
Non-refundable intervalos de fechas
El uso del objeto nonrefundable_date_ranges para establecer fechas de estancia que no sean reembolsables en el momento de la reserva es opcional. Ten en cuenta que el « nonrefundable_date_range » incluye la tarifa por noche, más los impuestos y las tasas correspondientes.
Si una tarifa tiene fechas de « non-refundable » definidas en el objeto « nonrefundable_date_ranges », estas noches se cobrarán junto con cualquier otro cargo por penalización por cancelación establecido en el objeto « cancel_penalties ».
Tasas del alojamiento
A la hora de hablar de los gastos que hay que pagar en caso de cancelación, lo mejor es usar el término «gastos del alojamiento» en lugar de «gastos de cancelación», para reflejar con mayor precisión quién cobra esos gastos y por qué hay que pagarlos.
En la reserva
Los detalles de la política de cancelación variarán en la respuesta dependiendo de si la reserva se hizo dentro o fuera del plazo de penalización por cancelación. Echa un vistazo al alojamiento « refundable » en los ejemplos que te pongo a continuación.
Reserva realizada dentro del plazo en el que se aplican penalizaciones por cancelación:
{
"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": {
...
}
}
}
]
}Reserva realizada fuera del plazo de penalización por cancelación:
{
"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 de la política
La política de cancelación que debes presentar a los viajeros se basa en cuatro plazos principales ,, además de una norma de reembolso **per-stay **. Debes tener en cuenta estos cuatro intervalos de tiempo en tu lógica y, cuando sea el caso, en el texto de tu interfaz de usuario.
Excepción a la política de cancelación
Definido por: nonrefundable_date_ranges
Estas son fechas de estancia que son totalmente non-refundable desde el momento de la reserva. Si una noche reservada entra dentro de uno de estos periodos, esa noche siempre se cobra íntegramente, independientemente de cuándo la cancele el viajero.
El periodo de fechas es inclusivo; la tarifa por noche, más los impuestos y tasas correspondientes a la fecha de finalización, también se cobran cuando la noche es non-refundable.
Aunque solo una parte de la estancia coincida con un periodo de « non-refundable », las noches que no entren en ese periodo pueden seguir siendo reembolsables, siempre que se cumplan los demás plazos de penalización que se indican en cancel_penalties.
Traveler-facing mensajes: Estas fechas son « non-refundable » (no reembolsables) desde el momento de la reserva; si cambias o cancelas tu reserva, no recibirás ningún reembolso ni crédito para usar en una estancia futura correspondiente a esos días, y además tendrás que pagar los impuestos y tasas correspondientes.
Cancelación gratuita
Es el periodo que va desde la creación de la reserva hasta el inicio de la primera ventana de nivel de póliza con penalización que aparece en el objeto « cancel_penalties », sin contar las noches que estén en « nonrefundable_date_ranges ». Identifica la fecha más temprana cancel_penalties.startde entre todas las ventanas y usa esa marca de tiempo como fecha límite para tu plazo de cancelación gratuita.
Nota: Las políticas de cancelación pueden tener hasta tres franjas horarias.
Traveler-facing mensajes: . Si cancelas tu reserva antes de [fecha y hora de inicio del plazo mínimo para la penalización], te devolveremos el importe íntegro. No se reembolsarán las estancias reservadas dentro de un periodo de « non-refundable ».
Anulación de la sanción
Definido por: Cada elemento de cancel_penaltiescuando esté presente.
Tipos de sanciones admitidos
Dentro de cada periodo de penalización, las noches en nonrefundable_date_rangessiguen siendo non-refundable y se aplican las penalizaciones adicionales tal y como están configuradas en la ventana correspondiente de cancel_penalties. Ten en cuenta que puedes combinar una cantidad + noches o una cantidad + porcentaje en el mismo periodo, pero no puedes combinar noches y porcentaje en un mismo nivel.
Penalización económica
- Una tarifa fija en una moneda concreta (e.g. 200 USD)
Traveler-facing mensajes: . Si cancelas después de [fecha y hora de inicio del plazo de la póliza], se te cobrará [importe] en [moneda].
Penalización por noche
- Un importe correspondiente a un número determinado de noches, más impuestos y tasas (cuando se reservan varias noches, el importe se cobra a partir de la primera noche).
Traveler-facing mensajes: . Si cancelas después de [fecha y hora de inicio del periodo de la póliza], se te cobrarán [número de noches] noches, más impuestos y tasas.
Penalización porcentual
- Un porcentaje del total de los gastos y tasas de la estancia (e.g. 90 %).
Traveler-facing mensajes: . Si cancelas después de [fecha y hora de inicio del periodo de la póliza], se te cobrará el [porcentaje] del importe total de tu estancia.
Post-check-in cancelación y no-show
Es el periodo posterior a la última ventana de penalización configurada (cancel_penalties[end]). En otras palabras, el intervalo de tiempo justo antes de la hora de « check-in ».
Traveler-facing mensajes: Si no-show para esta reserva, o si la cancelas o la modificas después de check-in, se te cobrará [importe/divisa/número de noches/porcentaje según se defina en la última ventana de penalización configurada].
Reembolsos de las cantidades de « per-stay »
Per-stay Los valores que devuelve el objeto stay siguen una única regla:
- Si algún día de la estancia es un « non-refundable, per-stay », los importes son non-refundable
- Per-stay Los importes solo se devuelven cuando toda la estancia es totalmente reembolsable
Nota:. En el caso de los alojamientos de VRBO, hay algunos detalles adicionales sobre los cargos por comisiones de servicio y los reembolsos; pide más información a tu asesor de integración.
Actualizaciones en la visualización de las pólizas para los alojamientos de California
Para cumplir con los cambios en la normativa de California, el plazo de cancelación debe empezar exactamente 24 horas después de la hora de creación de la reserva, a menos que la reserva se haga en las 72 horas siguientes a check-in. Expedia Los sistemas ajustan automáticamente los plazos de cancelación para cualquier alojamiento situado en California.
Ejemplos de comportamiento esperado:
- En el caso de un alojamiento situado en California cuya tarifa sea totalmente reembolsable y no tenga penalización por cancelación, no se modificará la política de cancelación.
- En el caso de un alojamiento situado en California que tenga una tarifa « non-refundable » con penalización por cancelación desde el momento de la reserva, la política de cancelación se modificará para que entre en vigor exactamente 24 horas después de la fecha de creación de la reserva.
- Si un alojamiento está fuera de California, no habrá ningún cambio en la política de cancelación, aunque la reserva se haga desde California.
Pre-booking política de cancelación
El plazo actualizado para la penalización por cancelación se mostrará automáticamente en la llamada a la API mientras el viajero está reservando. Quizá te hayas dado cuenta de que el indicador « refundable » sigue en «false» para las reservas de « non-refundable » y, por lo tanto, tendrás que respetar esto según el plazo de cancelación. En el caso de los hoteles, ese plazo es de 24 horas a partir de la fecha y hora de la reserva. En el caso de los alojamientos de Vrbo, el plazo vence al final del día siguiente a la reserva.
Post-booking política de cancelación
Una vez realizada la reserva, sigue siendo válida la póliza de California adaptada.
- Utiliza
GET /itinerariesycancel_refund, en la sección «Gestionar reserva», como fuente fiable para saber si una reserva es reembolsable y cuánto se debe devolver. - Los correos de confirmación también muestran la política de cancelación modificada.
- El valor booleano «
refundable» de Shopping no se modifica con este cambio; sigue indicando si una tarifa está pensada para ser « non-refundable » a efectos de filtrado. - El parámetro «
refundable» de la respuesta de «Recuperar itinerario» indica si la reserva se encuentra actualmente dentro de los plazos de cancelación aplicables; utilízalo para decidir si una reserva es totalmente reembolsable a la hora de mostrar las opciones de « post-booking ».