Registro de viajeros para alquiler vacacional

SES Hospedajes, resuelto en una llamada a tu API.

Enviarlo es obligatorio; integrarte con el Ministerio no debería serlo. Kinapi lo reduce a dos pasos: creas el check-in y el huésped se registra solo.

Empezar Ver la documentación

¿Prefieres que lo montemos contigo? Cuéntanos tu caso.

crear-checkin.sh

curl -X POST https://api.kinapi.es/api/v1/checkins \
  -H "x-api-key: $API_KEY" \
  -d '{
    "reservationId": "R-2026-0412",
    "listingId": "38291",
    "checkInDate": "2026-08-14",
    "checkOutDate": "2026-08-18",
    "numGuests": 4
  }'

# → 201 Created
{
  "url": "https://…/c/aGb3xK…",
  "status": "pending"
}

# la noche de la llegada, sin que llames a nada:
# → parte comunicado a SES Hospedajes
# → código de comunicación confirmado

El problema

Cumplir con el registro de viajeros es obligatorio. Sufrirlo, no.

Conectar directamente con SES Hospedajes es lidiar con tecnología de otra época: formatos rígidos, respuestas que tardan y errores que no explican nada. Trabajo que no aporta a tu producto — y que hay que mantener para siempre.

Protocolos antiguos (SOAP y XML) con reglas estrictas
Cada envío, codificado exactamente como exige el sistema
Dos entornos, dos credenciales que mantener
La confirmación tarda: hay que volver a preguntar
Catálogos oficiales que cambian sin avisar

Con Kinapi

Una API moderna: tu clave, una llamada, y listo

JSON de entrada y salida — del formato del Ministerio nos ocupamos nosotros

Pruebas y producción sin cambiar tu código

Esperamos la respuesta del Ministerio; tú la consultas cuando quieras

Documentos y catálogos oficiales siempre al día

Integración

Cuatro llamadas, cero XML.

El huésped hace el trabajo de registrarse; tu integración solo crea el check-in y consulta el resultado.

1
POST/checkins
Creas el check-in
Una llamada por reserva. Recibes la URL para el huésped.
2
huésped
El huésped se registra solo
Abre la URL, rellena sus datos y firma. Cero llamadas tuyas.
3
GET/checkins/{id}
Consultas el estado
De "pendiente" a "confirmado", cuando quieras.
4
GET/checkins/{id}/ses
Recibes la confirmación
El justificante oficial — o el motivo exacto si algo falla.

Por dentro

Lo que la API gestiona sin que lo pidas.

No solo enviamos datos al Ministerio: cada check-in recoge, valida y firma todo lo que la ley exige antes de presentarse.

SES Hospedajes

Comprobamos los documentos de cada huésped, enviamos el parte cada noche dentro del plazo que marca la norma y reintentamos automáticamente si el Ministerio lo rechaza. La obligación sigue siendo tuya: por eso ves el estado de cada parte y te avisamos de lo que falle.

Firma y evidencia

El huésped firma desde su móvil, en su idioma. Tú recibes el contrato en PDF; su huella SHA-256 queda sellada en el tiempo por una autoridad externa (RFC 3161), y PDF y sello se guardan en almacenamiento inmutable durante tres años. Sin construir nada.

Integraciones

Una sola API para conectar tu PMS o tu propio software, más webhooks para el resto de tu stack.

Portal del huésped

La llegada, resuelta antes de que el huésped llegue.

El mismo enlace con el que el huésped se registra le cuenta cómo llegar, cómo entrar y cómo funciona la casa, en su idioma y con tu marca. Los códigos de acceso, solo cuando el registro está hecho.

Llegar y entrar sin mensajes: dirección con mapa, dónde aparcar, instrucciones de acceso y códigos a su hora. Nadie llama a las siete de la tarde preguntando por la caja de llaves.
La casa y la zona en siete idiomas: el manual por temas, las normas, tus recomendaciones con mapa y los teléfonos útiles. Lo común se escribe una vez para todas las propiedades.
Los códigos, solo con el registro hecho: se abren con el registro completo y dentro de la ventana que fijas, y cada vez que se muestran queda registrado. Un enlace reenviado no abre nada.

Incluido en el precio. Viene apagado: lo enciendes cuando el contenido esté a tu gusto.

Ver el portal del huésped

Estancia: fechas, registro y huéspedes
La casa: llegar, entrar y cómo funciona
La zona: tus recomendaciones con mapa

API v1 · REST · JSON

Documentación pensada para integrar sin abrir un ticket.

Una API key por cliente, JSON en toda respuesta. Crea, consulta, actualiza y cancela check-ins; descarga contratos firmados; comprueba el estado del parte.

Autenticación: una clave en la cabecera, sin tokens que renovar.
Sin duplicados: reintenta con libertad — la misma reserva nunca se registra dos veces.
Docs interactivas: cada endpoint con su ejemplo curl y su respuesta real.

Leer la documentación

# Estado del parte en SES Hospedajes

curl https://api.kinapi.es/api/v1/checkins/R-2026-0412/ses \
  -H "x-api-key: $API_KEY"

# → 200 OK
{
  "status": "confirmed",
  "results": [{
    "lote": "20260815-000123",
    "status": "polled_ok",
    "comunicaciones": [{
      "guestName": "María García López",
      "codigoComunicacion": "SES-2026-…",
      "errores": []
    }]
  }]
}

kinapi-mcp-server · npm

También puede usarla un agente, no solo tu código.

Publicamos la misma API como servidor MCP: Claude u otro agente compatible crea check-ins y consulta su estado hablando con Kinapi, sin que tú escribas un cliente HTTP.

Cero cliente HTTP: instalas el paquete y el agente ya sabe llamar a cada operación.
Errores que se entienden, no JSON que parsear: el agente sabe qué falló y qué hacer, no solo un código de estado.
Lo usa cualquiera del equipo: soporte puede resolver una duda de huésped hablando con Claude, sin tocar código ni entrar al panel.

Ver el servidor MCP

mcp.json

{
  "mcpServers": {
    "kinapi": {
      "command": "npx",
      "args": ["-y", "kinapi-mcp-server"],
      "env": {
        "KINAPI_API_KEY": "kinapi_…"
      }
    }
  }
}

Empieza ahora

Crea tu cuenta y prueba la API en minutos.

Sin instalar nada ni hablar con nadie. Si prefieres que montemos la integración contigo caso por caso, también podemos hacerlo.

Empezar Cuéntanos tu caso