Servicio web
¿Tiene SES.Hospedajes una API o servicio web para enviar partes automáticamente?
Actualizado 2026-11-21 · Comprobado: 2026-11-21
Sí. El Ministerio del Interior ofrece un «Servicio de Comunicación» (servicio web SOAP con autenticación HTTP básica) para enviar partes de viajeros y reservas desde un programa. Hace falta tu código de arrendador y unas credenciales de servicio web, que se obtienen al registrarte en la plataforma. El envío se procesa por lotes: primero recibes un número de lote y después consultas el resultado.
| Operación | Para qué sirve |
|---|---|
| comunicacion (A, PV) | Alta de partes de viajeros (hasta 100 por petición, valor configurable) |
| consultaLote | Ver si el lote se procesó y los códigos de comunicación creados o los errores |
| anulacionLote | Anular todas las comunicaciones de un lote |
| catalogo | Consultar tablas de códigos (sexo, documentos, pagos, parentesco…) |
Cómo funciona el envío
Según el documento técnico (v3.1.3), cada petición lleva una cabecera con el código de arrendador, el nombre de la aplicación, el tipo de operación y el tipo de comunicación (PV para partes de viajeros), y una solicitud con el XML comprimido en ZIP y codificado en Base64. Si la petición es correcta, el servicio responde con un número de lote; un proceso posterior da de alta las comunicaciones válidas.
Las comunicaciones con errores no se graban, y el servicio informa por correo a la entidad de los errores encontrados.
Credenciales y requisitos
El servicio usa seguridad básica HTTP (usuario y contraseña). El documento dice que esas credenciales se obtienen en el registro de la entidad. La plataforma tiene una pantalla «Usuario servicio web» para cambiar la contraseña y descargar la documentación (apartados 9 y 14 de la guía visual).
Si tu cuenta no tiene habilitado el servicio web, el servicio responde con el error 10120: «El arrendador no tiene habilitada la opción de realizar operaciones a través del servicio web».
Cómo lo usa ParteYa
En ParteYa el envío por servicio web es opcional y está en beta. Guardas tu código de arrendador y tus credenciales (cifradas), pulsas «Enviar» y te mostramos el número de lote. Después consultamos el lote y solo marcamos el parte como comunicado cuando el Ministerio devuelve el código de comunicación. Si no quieres darnos tus credenciales, usa el fichero de alta masiva.
Respuestas rápidas
¿Existe un entorno de pruebas?
Sí, el documento técnico publica un endpoint de pruebas además del de producción.
¿Un particular puede usar el servicio web?
El documento técnico describe el código de arrendador como el identificador de empresas de hospedaje y también de titulares de inmuebles. Necesitas tener el servicio web habilitado y las credenciales de tu cuenta.
Qué hacer ahora
Activa el envío por servicio web en los ajustes de ParteYa cuando tengas tus credenciales, o sigue con el fichero de alta masiva.
Fuentes oficiales
- Ministerio del Interior: Servicio de Comunicación Hospedajes, interfaz servicios externos v3.1.3 (se descarga desde la plataforma, apartado «Usuario servicio web»)
- Guía visual de la plataforma Hospedajes (v. 29.08.2025)
- Sede electrónica del Ministerio del Interior: Hospedajes y alquiler de vehículos
Comprobado: 2026-11-21. Información general, no asesoramiento jurídico. Comprueba siempre la fuente oficial.