Cómo recuperar o cancelar una reserva de alquiler de coches
Después de crear una reserva, puedes recuperar sus detalles en cualquier momento o cancelarla si los planes del cliente cambian. Este artículo cubre los puntos finales de Recuperar reserva y Cancelar reserva.
Recuperar una reserva
Punto final
GET /cars/api/v2/bookings/{booking_id}
Parámetros de ruta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
booking_id | cadena | Sí | El ID de reserva devuelto por el punto final Crear reserva (por ejemplo, XNCTPN3cuzY). |
Solicitud de ejemplo
HTTP
GET /cars/api/v2/bookings/XNCTPN3cuzY
x-api-key: YOURAPIKEY
x-correlation-id: 550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer YOUR_SIGNATURE
Ejemplo de respuesta
JSON
{
"data": {
"core": {
"reference_number": "XNCTPN3cuzY",
"reservation_status": "CONFIRMED",
"customer": {
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"phone": "+1-555-123-4567"
},
"vehsegmentcore": {
"vehrentalcore": {
"pickupdatetime": "2026-06-15T10:00:00",
"returndatetime": "2026-06-20T10:00:00",
"pickup_location": {
"name": "Hertz - Manhattan Midtown"
},
"return_location": {
"name": "Hertz - Manhattan Midtown"
}
},
"vehicle": {
"name": "Toyota Camry or similar",
"sipp_code": "CCAR",
"vehicle_type": "Sedan",
"vehicle_size": "Standard",
"transmission_type": "Automatic",
"air_conditioning": true,
"passenger_quantity": 5,
"baggage_quantity": 2
},
"rental_rate": {
"vehicle_charges": [
{
"currency_code": "USD",
"base_price": 245,
"total_price": 289.75,
"tax_inclusive": true,
"purpose": "rental"
}
]
}
},
"fees": []
}
}
}Campos de respuesta
| Campo | Descripción |
|---|---|
referencenumber | La referencia de la reserva, igual que el ID de la reserva. |
reservationstatus | Estado actual de la reserva (por ejemplo, "CONFIRMED"). |
customer | Datos de contacto del cliente. |
vehsegmentcore | Contiene fechas de alquiler, ubicaciones, información del vehículo y detalles de tarifas. |
fees | Cualquier tarifa asociada con la reserva. |
Valores del estado de la reserva
| Estado | Descripción |
|---|---|
CONFIRMED | La reserva está activa y confirmada. |
CANCELLED | La reserva ha sido cancelada. |
COMPLETED | El periodo de alquiler ha finalizado. |
NO_SHOW | El cliente no recogió el vehículo. |
Cancelar una reserva
Punto final
PATCH /cars/api/v2/bookings/{bookingid}?token={bookingtoken}
Parámetros
| Parámetro | Tipo | Requerido | Ubicación | Descripción |
|---|---|---|---|---|
booking_id | cadena | Sí | Camino | El ID de la reserva. |
token | cadena | Sí | Consulta | El token de reserva devuelto por el punto final Crear reserva. |
Solicitud de ejemplo
HTTP
PATCH /cars/api/v2/bookings/XNCTPN3cuzY?token=eyJhbGciOiJIUzI1NiIsInR5cCI6...
x-api-key: YOURAPIKEY
x-correlation-id: 550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer YOUR_SIGNATURE
Ejemplo de respuesta
JSON
{
"data": {
"core": {
"cancel_status": "Cancelled",
"cancel_rules": [
{
"amount": 0
}
]
},
"info": {
"veh_reservation": {
"reservation_status": "Cancelled by customer",
"fees": []
}
}
}
}Campos de respuesta
| Campo | Descripción |
|---|---|
cancelstatus | Resultado de la cancelación. "Cancelled" indica éxito. |
cancelrules | Conjunto de reglas de tarifas de cancelación. Un amount de 0 significa que no hay cargo. |
reservation_status | Cadena de estado actualizada (por ejemplo, "Cancelled by customer"). |
fees | Cualquier tarifa cobrada como resultado de la cancelación. |
Tarifas de cancelación
Los cargos por cancelación dependen de la política de cancelación del proveedor y de qué tan cerca de la fecha de recogida se produce la cancelación. La matriz cancel_rules en la respuesta muestra la tarifa real cobrada.
Las políticas de cancelación típicas incluyen:
| Tipo de póliza | Descripción |
|---|---|
| Cancelación gratuita | amount: 0 — No se cobra ninguna tarifa. Común cuando se cancela con mucha antelación. |
| Tarifa parcial | Se cobra un porcentaje o cantidad fija según la proximidad a la fecha de recogida. |
| Carga completa | Se cobra el importe total del alquiler. Aplica para reservas no reembolsables o cancelaciones muy tardías. |
Para verificar la política de cancelación antes de cancelar, revise el campo
raterules.cancellationpolicy desde el punto final de detalles del alquiler.
Mejores prácticas- Guarda siempre tanto la reserva id como token en el momento de realizar la reserva. Necesitas ambos para cancelar una reserva.
- Consulte primero la política de cancelación. Muestre la política al cliente y obtenga su confirmación antes de enviar la solicitud de cancelación.
- Maneja las reservas ya canceladas con elegancia. Si intentas cancelar una reserva que ya está cancelada, la API devolverá un error apropiado.
- Utilice el punto final de recuperación para confirmar la cancelación. Después de una cancelación exitosa, puede llamar al punto final de recuperación para verificar que
reservation_statushaya cambiado. - Mostrar la tarifa de cancelación. Mostrar siempre el importe
cancel_rulesal cliente en la pantalla de confirmación de cancelación.