Registro de viajeros: los datos del documento del huésped, leídos de una foto

Qué dice el Real Decreto 933/2021

El registro de viajeros está regulado por el Real Decreto 933/2021, de 26 de octubre (BOE-A-2021-17461), que establece las obligaciones de registro documental e información de quienes ejercen actividades de hospedaje y de alquiler de vehículos a motor. Esta página trata solo del hospedaje. Lo que dice el texto, en resumen:

• Se aplica a quien ejerce actividades de hospedaje, de modo profesional o no: hoteles, hostales, pensiones, casas de huéspedes, establecimientos de turismo rural, campings, apartamentos, bungalows y otros alojamientos turísticos, además de los operadores turísticos y las plataformas digitales que intermedian en ellos (artículo 2).
• Toda persona mayor de catorce años firma un parte de entrada; los datos de los menores de catorce los facilita el adulto que los acompaña (artículo 4.2).
• El establecimiento responde de que los datos del parte coincidan con los documentos que acreditan la identidad de los viajeros, que estos deben exhibir o facilitar (artículo 4.3).
• Los datos se llevan en un registro informático y se conservan durante tres años desde que termina el servicio contratado (artículo 5). Quien hospeda de manera no profesional queda exceptuado del registro y la conservación, pero no de la comunicación.
• Los datos se comunican a las autoridades competentes por procedimientos telemáticos, de manera inmediata y en todo caso en no más de 24 horas desde la reserva o la formalización del contrato (o su anulación) y desde el inicio del servicio (artículo 6). Quien hospeda de manera no profesional puede hacerlo por medios no telemáticos.
• Entre los datos de cada viajero que enumera el anexo I están el nombre, los apellidos, el sexo, el número y el tipo de documento (DNI, pasaporte, TIE), el número de soporte del documento, la nacionalidad y la fecha de nacimiento, junto con la residencia, el contacto y los datos de la estancia y del pago.

Qué datos salen del documento

De un pasaporte, o de un documento de identidad con zona de lectura mecánica (MRZ) según la norma ICAO 9303, la API devuelve estos campos, entre otros. Un valor que no se pudo leer llega como null, nunca como una clave ausente:

• Apellidos y nombre
• Fecha de nacimiento y sexo
• Número de documento
• Nacionalidad y Estado emisor
• Fechas de expedición y de caducidad
• El veredicto de la MRZ: si sus dígitos de control cuadran

El resto del parte no está en el documento: dirección, teléfono, correo electrónico, fechas de entrada y salida, datos del pago y firma los recoges tú, como hasta ahora. Qué campo de la respuesta va a qué casilla del registro lo decides tú en tu propio sistema.

Cómo encaja la API

• Una llamada HTTP síncrona: envías la imagen y la respuesta trae los datos en JSON, sin cola que consultar ni SDK que instalar.
• Lee la zona de lectura mecánica y los campos de la zona visual, y verifica los dígitos de control ICAO 9303 de la MRZ, así que una lectura que no cuadra se nota en la respuesta.
• 1¢ por documento reconocido. Un escaneo fallido (foto borrosa, ningún documento en el encuadre, tipo desconocido) no cuesta nada.
• La imagen se mantiene en memoria mientras dura la solicitud y nunca se escribe en disco. Cuánto tiempo se guarda el resultado lo eliges por clave o por solicitud, hasta cero: con cero no se guarda nada.
• Un sandbox público sin cuenta: 10 documentos reconocidos gratis por dirección, con un máximo de 10 solicitudes por hora.

Lo que la API no hace

• No comunica nada a las autoridades ni se conecta a ningún sistema de la Administración: la comunicación que exige el artículo 6 la haces tú, por el procedimiento que corresponda.
• No lleva tu registro ni lo conserva: los tres años de conservación del artículo 5 se cumplen en tu propio sistema.
• No rellena los datos que el documento no lleva impresos, ni comprueba que el documento sea auténtico.

Esta página resume el texto del real decreto y no es asesoramiento jurídico: cada establecimiento sigue siendo responsable de cumplir sus propias obligaciones.

Haz la llamada

Ejecuta esto contra el sandbox público, sin registro y con reconocimiento real. Guarda una foto del documento como document.jpg en la carpeta desde la que lo ejecutas.

curl -X POST https://api.doc.cheap/v1/scans \
  -H "Authorization: Bearer sk_sandbox_public" \
  -H "Content-Type: application/json" \
  -d "{\"image\": \"$(base64 < document.jpg | tr -d '\n')\"}"