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.

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