Guía rápida

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

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" }
  }'

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"