ParteYa

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.

OperationWhat it does
comunicacion (A, PV)Create guest reports (up to 100 per request, a configurable value)
consultaLoteCheck whether the batch was processed, and the communication codes or errors
anulacionLoteCancel every communication in a batch
catalogoLook 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

Checked: 2026-11-21. General information, not legal advice. Always check the official source.

Related guides