KinapiKinapi
Documentación

Para developers · API REST

SES Hospedajes, resuelto en una llamada a la API.

Enviar el parte de viajeros al Ministerio es obligatorio, pero integrarse con su sistema es un proyecto entero. Kinapi lo reduce a dos pasos: creas el check-in y le envías un enlace al huésped. Los datos, la firma y la confirmación del Ministerio llegan solos.

Cuéntanos tu caso Ver la documentación

Estamos en beta: montamos la integración contigo, caso por 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 tu software directamente con SES Hospedajes es pelearse con tecnología de otra época: formatos estrictos, respuestas que no llegan al momento y errores que no explican qué hiciste mal. Es trabajo que no aporta nada a tu producto — y que hay que mantener para siempre.

  • Protocolos antiguos (SOAP y XML) con reglas estrictas del Ministerio
  • Cada envío, comprimido y codificado exactamente como exige el sistema
  • Dos entornos, dos credenciales, dos configuraciones que mantener
  • La confirmación no es inmediata: hay que volver a preguntar hasta tenerla
  • Listas oficiales (tipos de documento, parentescos…) que cambian sin avisar

Con Kinapi

Una API moderna: tu clave, una llamada, y listo
Envías y recibes JSON — del formato del Ministerio nos ocupamos nosotros
Pruebas y producción sin cambiar tu código
Nosotros esperamos la respuesta del Ministerio; tú la consultas cuando quieras
Documentos validados y listas 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. 1POST/checkins

    Creas el check-in

    Una llamada por reserva. Recibes la URL que envías al huésped.

  2. 2huésped

    El huésped se registra solo

    Abre la URL, rellena sus datos (validados al momento) y firma. Cero llamadas tuyas.

  3. 3GET/checkins/{id}

    Consultas el estado

    Un estado claro en cada momento, desde "pendiente" hasta "confirmado". Cuando quieras.

  4. 4GET/checkins/{id}/ses

    Recibes la confirmación

    El justificante oficial de cada huésped — 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 legal y reintentamos automáticamente si el Ministerio lo rechaza.

Firma y evidencia

El huésped firma desde su móvil. Tú recibes el contrato en PDF con sello de tiempo certificado y una copia que nadie puede alterar. 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, respuestas JSON consistentes y llamadas que puedes repetir sin miedo a duplicar nada. Cubre todo el ciclo: crear, consultar, actualizar y cancelar check-ins; ver los huéspedes registrados; descargar el contrato firmado; y comprobar 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": []
    }]
  }]
}

Programa beta

Cuéntanos tu caso y lo montamos contigo.

No abrimos autoservicio todavía: estamos entrando poco a poco con un grupo pequeño de integraciones piloto, caso por caso, antes de abrir la API a cualquiera.

Cuéntanos tu caso Ver la documentación