Cómo cancelar una reserva de actividad
Cancelar una reserva de actividad es un proceso de dos pasos. Primero, verifique la penalización por cancelación para determinar el monto del reembolso y los motivos de cancelación disponibles. Luego, envíe la solicitud de cancelación con el código de motivo apropiado.
Paso 1: Verificar penalización por cancelación
Antes de cancelar, recupere los detalles de la penalización y los motivos disponibles.
Punto final
GET {{api_host}}/api/ext/activity/{bookingId}/cancel-penalty
Encabezados
| Encabezado | Requerido | Descripción |
|---|
x-api-key | Sí | Su clave API de Xeni |
Parámetros de ruta
| Parámetro | Tipo | Requerido | Descripción |
|---|
bookingId | cadena | Sí | El ID de la reserva para comprobar las penalizaciones por cancelación. |
Solicitud de ejemplo
GET {{api_host}}/api/ext/activity/MY-BOOKING-001/cancel-penalty
Respuesta
| Campo | Tipo | Descripción |
|---|
data.reasons | matriz | Motivos de cancelación disponibles. |
data.reasons[].reason | cadena | Identificador de motivo legible por máquina. |
data.reasons[].description | cadena | Descripción legible por humanos del motivo. |
data.reasons[].code | cadena | Código corto por el motivo. |
data.refundAmt | número | Monto del reembolso después de la deducción de la multa. |
data.currency | cadena | Moneda del importe del reembolso. |
Ejemplo de respuesta
JSON
{
"data": {
"reasons": [
{
"reason": "CHANGEOFPLANS",
"description": "Change of plans",
"code": "COP"
},
{
"reason": "FOUNDBETTERPRICE",
"description": "Found a better price",
"code": "FBP"
},
{
"reason": "WEATHER_CONCERNS",
"description": "Weather concerns",
"code": "WC"
},
{
"reason": "HEALTH_ISSUES",
"description": "Health issues",
"code": "HI"
}
],
"refundAmt": 793.26,
"currency": "QAR"
}
}
Códigos de motivo de cancelación
| Razón | Código | Descripción |
|---|
CHANGEOFPLANS | COP | El cliente cambió sus planes. |
FOUNDBETTERPRICE | FBP | El cliente encontró un mejor precio en otro lugar. |
WEATHERCONCERNS | WC | Cancelación por cuestiones meteorológicas. |
HEALTHISSUES | Hola | Cancelación por problemas de salud. |
Paso 2: Cancelar la Reserva
Después de revisar la multa y el monto del reembolso, envíe la cancelación.
Punto final
POST {{api_host}}/api/ext/activity/cancel
Encabezados
| Encabezado | Requerido | Descripción |
|---|
x-api-key | Sí | Su clave API de Xeni |
Content-Type | Sí | application/json |
Cuerpo de solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|
bookingId | cadena | Sí | El ID de la reserva para cancelar. |
reason | cadena | Sí | El identificador del motivo de cancelación de la respuesta de penalización. |
Solicitud de ejemplo
JSON
{
"bookingId": "MY-BOOKING-001",
"reason": "CHANGEOFPLANS"
}
Notas de uso
- Siempre verifique la penalización por cancelación antes de enviar una cancelación. Esto le permite mostrar el monto del reembolso esperado al cliente antes de que lo confirme.
- El campo
reason en la solicitud de cancelación debe ser uno de los identificadores de motivo devueltos por el punto final de penalización de cancelación (por ejemplo, "CHANGEOFPLANS", no el código "COP"). - El
refundAmt en la respuesta de penalización representa el monto que se reembolsará después de cualquier deducción de penalización. Un refundAmt de 0 significa que la reserva no es reembolsable en este momento. - La moneda del reembolso puede diferir de la moneda de la reserva original según la configuración del proveedor.
- Las políticas de cancelación varían según la actividad y el proveedor. Algunas actividades ofrecen cancelación gratuita hasta 24 horas antes de la fecha del viaje, mientras que otras pueden tener políticas más estrictas.
- Una vez enviada y confirmada una cancelación, no se puede revertir. Sería necesario crear una nueva reserva.
