Guía rápida

Del alta de la propiedad al parte confirmado en SES, paso a paso.

¿Estás integrando? Haz estos pasos primero en el entorno de pruebas, con una clave kinapi_test_: el mismo recorrido, hasta el parte confirmado o rechazado, sin comunicar nada al Ministerio ni pagar nada.

1. Da de alta tu propiedad

Cada alojamiento necesita una ficha con su listingId (el id con el que tu PMS identifica el listing), su código de establecimiento SES y los datos del propietario que aparecerán en el contrato.

curl

curl -X POST https://api.kinapi.es/api/v1/properties \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "nickname": "Apartamento Sol 3B",
    "listingId": "38291",
    "address": { "street": "Calle del Sol 3", "city": "Tarifa", "province": "Cádiz", "postalCode": "11380" },
    "touristLicense": "VFT/CA/12345",
    "ses": { "codigoEstablecimiento": "0000012345" },
    "owner": { "legalName": "Gestora Costa SL", "nif": "B12345678" }
  }'

También puedes darlas de alta desde el panel, en Propiedades — útil para probar el producto antes de conectar tu PMS. El código de establecimiento te lo asigna el portal de SES Hospedajes, uno por alojamiento.

2. Crea el check-in cuando entre una reserva

En cuanto tu sistema reciba una reserva confirmada, crea su check-in. La llamada es idempotente: si se repite (reintento, webhook duplicado) devuelve el mismo check-in y la misma URL, sin duplicar nada.

curl

curl -X POST https://api.kinapi.es/api/v1/checkins \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "reservationId": "R-2026-0412",
    "listingId": "38291",
    "confirmationCode": "HMXK4L",
    "checkInDate": "2026-08-14",
    "checkOutDate": "2026-08-18",
    "numGuests": 4,
    "leadGuest": { "name": "María García", "email": "maria@example.com" }
  }'

201 Created

{
  "reservationId": "R-2026-0412",
  "listingId": "38291",
  "status": "pending",
  "url": "https://checkinsas…/c/aGb3xKf9…",
  "created": true
}

3. Envía la URL al huésped

La url de la respuesta es el enlace de check-in de esa reserva. Envíasela al huésped por el canal que ya uses (email de confirmación, WhatsApp, el mensaje automático de tu PMS…). Todos los huéspedes del grupo comparten el mismo enlace; cada uno añade su propio registro y firma.

No tienes que crear huéspedes por API: se registran ellos mismos desde el enlace, con validación en vivo de DNI/NIE/pasaporte y las reglas de SES (municipio INE, parentesco de menores, nº de soporte…).

4. Sigue el estado

El check-in avanza solo. Consulta su estado cuando quieras:

curl

curl https://api.kinapi.es/api/v1/checkins/R-2026-0412 \
  -H "ocp-apim-subscription-key: TU_API_KEY"

Estados: pending → in_progress → completed → signed → submitted → confirmed (más error y cancelled).

5. Recupera el contrato y el parte SES

curl

# Contrato firmado (PDF con firmas + página de evidencias)
curl -OJ https://api.kinapi.es/api/v1/checkins/R-2026-0412/contract \
  -H "ocp-apim-subscription-key: TU_API_KEY"

# Estado del parte de viajeros en SES Hospedajes
curl https://api.kinapi.es/api/v1/checkins/R-2026-0412/ses \
  -H "ocp-apim-subscription-key: TU_API_KEY"