Web service
Does SES.Hospedajes have an API or web service to send reports automatically?
Updated 2026-11-21 · Checked: 2026-11-21
Yes. The Ministry of the Interior offers a “Servicio de Comunicación” (a SOAP web service with HTTP Basic authentication) to send guest reports and bookings from software. You need your landlord code and web-service credentials, which you get when you register on the platform. Sending works in batches: you first get a batch number, then you check the result.
| Operation | What it does |
|---|---|
| comunicacion (A, PV) | Create guest reports (up to 100 per request, a configurable value) |
| consultaLote | Check whether the batch was processed, and the communication codes or errors |
| anulacionLote | Cancel every communication in a batch |
| catalogo | Look up code tables (sex, documents, payment, relationship…) |
How sending works
According to the technical document (v3.1.3), each request has a header with the landlord code, the application name, the operation type and the communication type (PV for guest reports), and a request body with the XML ZIP-compressed and Base64-encoded. If the request is valid, the service answers with a batch number; a later process records the valid communications.
Communications with errors are not recorded, and the service emails the entity the errors it found.
Credentials and requirements
The service uses HTTP basic security (username and password). The document says those credentials are obtained when the entity registers. The platform has a “Usuario servicio web” screen to change the password and download the documentation (sections 9 and 14 of the visual guide).
If your account doesn’t have the web service enabled, the service answers error 10120: “The landlord does not have the option to operate through the web service enabled”.
How ParteYa uses it
In ParteYa web-service sending is optional and in beta. You save your landlord code and credentials (encrypted), press “Send” and we show you the batch number. We then check the batch and only mark the report as done when the Ministry returns the communication code. If you’d rather not give us your credentials, use the bulk-upload file.
Quick answers
Is there a test environment?
Yes, the technical document publishes a test endpoint as well as the production one.
Can a private host use the web service?
The technical document describes the landlord code as identifying accommodation companies and also individual property holders. You need the web service enabled and your account’s credentials.
What to do next
Turn on web-service sending in ParteYa’s settings once you have your credentials, or keep using the bulk-upload file.
Official sources
- 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
Checked: 2026-11-21. General information, not legal advice. Always check the official source.