SES Hospedajes

Seguimiento del parte de viajeros comunicado al Ministerio del Interior (RD 933/2021).

Cómo se envía el parte

No hay nada que llamar: la noche de la llegada (23:30 hora peninsular), Kinapi comunica automáticamente a SES Hospedajes los huéspedes registrados de cada check-in con entrada ese día. Si a esa hora falta parte del grupo, se envía un parte parcial con los que haya, y los rezagados se comunican como delta en noches siguientes — cada huésped es una comunicación independiente en SES, así que ampliar el grupo nunca duplica.

SES procesa los lotes de forma asíncrona: tras el envío, consultamos el resultado y guardamos el código de comunicación de cada huésped (o los errores devueltos por el Ministerio).

Consultar el estado del parte

GET/checkins/{reservationId}/ses

curl

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

200 OK

{
  "status": "confirmed",
  "results": [
    {
      "lote": "20260815-000123",
      "env": "prod",
      "status": "polled_ok",
      "codigoEstablecimiento": "0000012345",
      "sentAt": "2026-08-14T21:30:05.000Z",
      "polledAt": "2026-08-14T22:30:10.000Z",
      "comunicaciones": [
        {
          "guestId": "5f0c33f1-…",
          "guestName": "María García López",
          "codigoComunicacion": "SES-2026-…",
          "errores": []
        }
      ]
    }
  ]
}

Estados de un envío (results[].status)

Campo	Tipo	Descripción
`sent`	estado	Lote enviado, pendiente de que SES lo procese.
`polled_ok`	estado	SES confirmó todas las comunicaciones del lote.
`polled_error`	estado	SES rechazó alguna comunicación — ver errores por huésped.
`http_error`	estado	El envío no llegó a SES (problema de red/credenciales). Se reintenta.

Un check-in puede tener varios envíos (parciales + deltas). El estado agregado que importa es el status del propio check-in: confirmed significa que todos los huéspedes tienen código de comunicación.

Errores del Ministerio

Cuando SES rechaza una comunicación (documento inválido, municipio incorrecto…), el error exacto queda en comunicaciones[].errores y el check-in pasa a error con el detalle en errorReason. Tras corregir los datos, el siguiente envío nocturno lo reintenta automáticamente.