API y Webhooks

GUÍA: API de reservas, crea reservas desde tu software

Por: Diego Betancor, CTO · Ingeniero informático y economista de empresa|Actualizado: 2026-11-04

Con la API de reservas creas una reserva en una de tus propiedades y obtienes al instante el enlace de check-in del huésped. Si quieres saber cuándo completan el registro, configura los webhooks.

1. Genera tu API key

Entra en Integraciones → API y crea tu clave. Envíala en cada petición en la cabecera Authorization como Bearer.

2. Crea la reserva

curl -X POST https://app.registroparteviajeros.com/reservas \
  -H "Authorization: Bearer $RPV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "property_id": "prop_xxxxxxxx",
    "reference": "HMABC123",
    "reservation_date": "2026-10-01",
    "check_in": "2026-11-10",
    "check_out": "2026-11-12"
  }'
Campo Obligatorio Descripción
property_id Sí Identificador de la propiedad (prop_…), visible en el panel.
reference No Referencia de tu sistema. Única por propiedad.
reservation_date Sí Fecha de la reserva (YYYY-MM-DD).
check_in Sí Fecha de entrada (YYYY-MM-DD).
check_out Sí Fecha de salida, al menos una noche después.
guest No Datos del huésped: name, surname, email, phone, number_of_guests.
send_to_guest No Con true, enviamos el enlace de check-in al correo del huésped (requiere guest.email).
payment_method No Por defecto PLATF (reserva de plataforma). Con otros medios de pago, los datos del huésped son obligatorios.

3. Recibe el enlace de check-in

{
  "id": "0192f3a4-…",
  "status": "created",
  "property_id": "prop_xxxxxxxx",
  "reference": "HMABC123",
  "checkin_code": "AbCd1234",
  "checkin_url": "https://app.registroparteviajeros.com/checkin/AbCd1234",
  "send_to_guest": false
}

checkin_url funciona desde ese momento: envíalo al huésped por el canal que prefieras o activa send_to_guest.

Errores habituales

Código Significado
400 Datos no válidos. La respuesta indica qué campo corregir.
401 Falta la API key o no es válida.
403 La propiedad no existe o no pertenece a tu cuenta.
409 Ya existe una reserva con esa reference en la propiedad.
429 Demasiadas peticiones seguidas: espera unos segundos y reintenta.

Siguiente paso

Configura los webhooks para que tu sistema reciba el aviso cuando el huésped termine el registro.

Automatiza tus partes de viajeros

Prueba Registro Parte Viajeros durante 7 días totalmente gratis.

Probar Gratis