Desarrollador PHP en Valladolid

Cómo usar los servicios web libres del Catastro desde una aplicación PHP: consulta por referencia o dirección, coordenadas, errores, caché y datos protegidos. Para empresas de Valladolid.

Desarrollador PHP

Mi lugar en la comunidad WordPress

  • Tengo cuenta en wordpress.org desde 2006.
  • He contribuido al núcleo de WordPress en las versiones 7.0 y 7.1.
  • Mantengo 30 plugins en wordpress.org.
  • Organizo WordCamps y hablo en ellos como ponente.
  • He asistido a todas las WordCamp Europe de 2017 a 2026.
  • Meetup local de WordPress: Valladolid WordPress Meetup

Mi perfil en WordPress.org

#Datos del Catastro desde una aplicación PHP: de qué hablamos

Soy Mariusz Szatkowski, desarrollador independiente de WPPoland, en Gdynia (Polonia), y trabajo con WordPress desde 2006. Para empresas de Valladolid hago desarrollo PHP, y esta página trata un encargo concreto: consultar los servicios web públicos del Catastro desde tu aplicación Laravel, Symfony o PHP puro. Todo el trabajo es remoto y se hace por escrito.

El caso típico es pequeño. Un formulario pide una dirección o una referencia catastral y la aplicación completa la superficie, el uso y la dirección normalizada, o convierte un punto del mapa en una referencia. Lo que complica el encargo no es la llamada HTTP. Es que la documentación y los endpoints reales no coinciden del todo, que los errores llegan con código 200 y que una referencia guardada junto a un cliente ya es un dato tuyo.

#Qué ofrecen los servicios web libres de la Sede Electrónica

La Dirección General del Catastro publica en su sede un documento llamado Servicios web libres (versión 2.6, del 1 de diciembre de 2025). Describe dos servicios: callejero con datos catastrales no protegidos, y conversor de coordenadas. Según ese documento, los datos no protegidos son todos los de un inmueble excepto titularidad y valor, y cualquier ciudadano puede invocarlos.

NecesitasOperación (JSON)Entrada principal
Lista de provinciasObtenerProvinciasninguna
Municipios de una provinciaObtenerMunicipiosprovincia, municipio (opcional)
Vías de un municipioObtenerCallejeroprovincia, municipio, tipo de vía, nombre
Números de una víaObtenerNumereroademás, número
Inmueble por direcciónConsulta_DNPLOCprovincia, municipio, sigla, calle, número
Inmueble por referenciaConsulta_DNPRCRefCat de 14, 18 o 20 posiciones
Inmueble por polígono y parcelaConsulta_DNPPPpolígono, parcela
Referencia por coordenadasConsulta_RCCOORSRS, CoorX, CoorY
Referencias cercanas a un puntoConsulta_RCCOOR_DistanciaSRS, CoorX, CoorY
Coordenadas por referenciaConsulta_CPMRCSRS, RefCat

Cada operación de callejero tiene una variante con sufijo Codigos, que trabaja con códigos en lugar de nombres. La Sede indica además que cubre el territorio nacional salvo el País Vasco y Navarra, así que Valladolid y el resto de Castilla y León entran. Para la geometría de las parcelas, la Sede remite a sus servicios INSPIRE de cartografía catastral, que son otro servicio con otro formato.

Río Pisuerga y Puente Mayor en Valladolid

Foto: Kizar, CC BY-SA 4.0, Wikimedia Commons.

#Cómo aparece Valladolid en los códigos

La operación ObtenerMunicipios con provincia y municipio VALLADOLID devuelve dos pares de códigos que conviene no mezclar. El INE lo identifica con provincia 47 y municipio 186, es decir, 47186. La delegación de Hacienda usa 47 y 900. Si tu base de datos ya guarda códigos INE (por ejemplo, de un callejero o de un formulario de envío), usa las operaciones Codigos con el segundo par solo cuando el servicio lo pida.

#Primera llamada en PHP

Sin dependencias, con file_get_contents, un User-Agent propio y un tiempo máximo. La referencia de ejemplo es la que el propio documento de la Sede usa en su anexo, una vivienda de la provincia de Valencia.

<?php
declare(strict_types=1);

function catastro(string $op, array $params): array
{
    $url = 'https://ovc.catastro.meh.es/OVCServWeb/OVCWcfCallejero/COVCCallejero.svc/json/'
        . $op . '?' . http_build_query($params);
    $ctx = stream_context_create(['http' => [
        'header' => "User-Agent: mi-app/1.0\r\n",
        'timeout' => 10,
        'ignore_errors' => true,
    ]]);
    $raw = file_get_contents($url, false, $ctx);
    if ($raw === false || !str_contains($http_response_header[0], ' 200 ')) {
        throw new RuntimeException('Catastro no disponible: ' . ($http_response_header[0] ?? 'sin respuesta'));
    }
    $body = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
    $result = reset($body);
    if (isset($result['lerr'])) {
        throw new DomainException($result['lerr'][0]['cod'] . ': ' . $result['lerr'][0]['des']);
    }
    return $result;
}

$r = catastro('Consulta_DNPRC', ['RefCat' => '2749704YJ0624N0001DI']);
echo $r['bico']['bi']['ldt'];

La salida es CL GUAYANA-MOJONERA 3 46388 GODELLETA (VALENCIA). Dos detalles. Primero, ignore_errors hace que PHP devuelva el cuerpo también en un 4xx o 5xx, y el código de estado se lee en $http_response_header. Segundo, el User-Agent no es un adorno: a 15 de noviembre de 2026, una petición hecha con curl y su User-Agent por defecto recibió un 400 con una página HTML, y la misma petición con otro User-Agent devolvió el JSON. Pruébalo desde el servidor donde va a vivir la aplicación, no solo desde tu portátil.

Si ya usas Symfony, el componente HttpClient admite la opción query y una cabecera User-Agent por defecto. Su método toArray() lanza una excepción en cualquier respuesta 3xx, 4xx o 5xx, según la documentación de Symfony, y eso encaja bien con el 400 en HTML de arriba.

#Dónde el PDF y los endpoints no coinciden

El PDF describe las operaciones con unos nombres y los endpoints JSON reales usan otros. A 15 de noviembre de 2026 comprobé esto contra el servicio:

El PDF diceEl endpoint JSON espera
ConsultaMunicipio, ConsultaVia, ConsultaNumeroObtenerMunicipios, ObtenerCallejero, ObtenerNumerero
TipoVia y NomVia en Consulta_DNPLOCSigla y Calle
Coordenada_X y Coordenada_YCoorX y CoorY

ConsultaMunicipio en JSON devuelve una página HTML de ayuda, no un error. Consulta_DNPLOC con TipoVia y NomVia devuelve el error 6, ERROR AL CONSULTAR LA REFERENCIA, que no te dice que el nombre del parámetro está mal. Consulta_RCCOOR con Coordenada_X devuelve el error 76, LA COORDENADA X OBLIGATORIA. La fuente fiable de nombres es la página /json/help de cada servicio, que el propio documento enlaza en su apartado 2.3. Un tutorial anterior al 27 de octubre de 2022 describe además otra tecnología: según el control de cambios del documento, los servicios pasaron en esa fecha de ASMX a WCF.

#Respuestas que cambian de forma

Con las mismas operaciones, el JSON no tiene siempre la misma estructura.

  • Un inmueble o varios. Si la consulta identifica un único inmueble, los datos cuelgan de bico.bi, y las construcciones están en lcons. Si hay varios (una dirección con número y sin planta ni puerta, por ejemplo), llega una lista en lrcdnp.rcdnp con la referencia y la localización de cada uno. El documento describe las dos salidas, y un cliente PHP debe aceptar ambas.
  • El error llega con código 200. Una referencia mal formada devuelve un HTTP 200 con control.cuerr y una lista lerr con cod y des. Por ejemplo, el código 3 dice que la referencia debe tener 14, 18 o 20 posiciones.
  • La clave raíz cambia con la operación. consulta_dnprcResult, consulta_dnplocResult, Consulta_RCCOORResult: por eso el código de arriba toma el primer elemento en lugar de fijar el nombre.
  • Las direcciones van en mayúsculas, con abreviaturas de tipo de vía (CL, PZ, AV, PS, todas en el anexo II del documento), y algunos literales llegan sin tilde, como Almacen-Estacionamiento. Si guardas la dirección que devuelve el Catastro, guarda también la que escribió el usuario.

Para el primer punto basta una función de apoyo:

function inmuebles(array $r): array
{
    return isset($r['bico']) ? [$r['bico']['bi']] : ($r['lrcdnp']['rcdnp'] ?? []);
}

Con una referencia de 14 posiciones, que identifica la finca, el documento indica que el servicio devuelve todos los inmuebles cuyos 14 primeros caracteres coinciden. Una referencia de 20 posiciones identifica un inmueble concreto.

#De un punto a una referencia catastral

El servicio de coordenadas convierte en las dos direcciones. Con Consulta_RCCOOR pasas un sistema de referencia (SRS) y las coordenadas, y recibes la referencia de la parcela de ese punto y su dirección. En coordenadas geográficas, X es la longitud y Y la latitud, en grados. Los sistemas admitidos incluyen EPSG:4326, EPSG:4258 y las proyecciones UTM en WGS 84 (husos 27 a 31), ETRS89 y ED50 (husos 29 a 31), por ejemplo EPSG:25830.

Un punto de prueba en el centro de Valladolid, con SRS=EPSG:4326, longitud -4,7245 y latitud 41,6523, devuelve la referencia de una parcela cuyo literal es CL CATEDRAL 5 VALLADOLID (VALLADOLID). Consulta_RCCOOR_Distancia devuelve una lista de parcelas próximas con la distancia a ese punto, donde la primera aparece a distancia 0 y la siguiente a 2,78.

Hay una trampa para quien dibuja un mapa. El Catastro devuelve el centroide de la parcela, no su contorno. Un marcador en el centroide sirve para una ficha; si necesitas el polígono, el origen es el servicio INSPIRE, no este.

#Datos protegidos y RGPD

El texto refundido de la Ley del Catastro Inmobiliario (Real Decreto Legislativo 1/2004, en el BOE) define en su artículo 51 los datos protegidos: nombre, apellidos, razón social, código de identificación y domicilio de quienes figuran como titulares, y el valor catastral. El artículo 52 permite a todos acceder a los datos no protegidos, y el artículo 53 limita el acceso a los protegidos al consentimiento expreso, específico y por escrito del afectado o a los supuestos que la ley enumera. Por eso los servicios libres no devuelven propietario ni valor, y por eso una aplicación que necesite el titular no se resuelve con otra llamada: es otro régimen de acceso.

Una consecuencia práctica para tu base de datos. Una dirección y una referencia catastral de un inmueble no son datos protegidos del Catastro. Pero en cuanto las guardas junto a un cliente, el registro identifica a una persona, y el Reglamento (UE) 2016/679 define dato personal como toda información sobre una persona física identificable (artículo 4). Esa tabla pasa a seguir las mismas reglas que el resto de datos del cliente: finalidad, plazo de conservación y peticiones de acceso o supresión. Yo dejo anotado qué campos del Catastro se guardan, con qué finalidad y durante cuánto tiempo.

El artículo 52.2 añade que la Dirección General del Catastro puede autorizar la transformación y posterior distribución de la información catastral. Si lo que planeas es publicar o revender esos datos, no solo mostrarlos a tu cliente, esa frase es el punto de partida y conviene leerla antes de diseñar nada.

#Cómo diseño la integración

Estas son decisiones mías, no requisitos del Catastro, y las dejo escritas en el alcance.

  1. Un único cliente PHP para todo el Catastro. Una clase que construye la URL, fija el User-Agent y el tiempo máximo, interpreta lerr y normaliza una o varias respuestas. El resto de la aplicación nunca ve JSON crudo.
  2. Caché por referencia catastral. La referencia es la clave natural, pero los datos que cuelgan de ella pueden cambiar. Guardo la fecha de la consulta junto al dato y muestro esa fecha, en lugar de presentarlo como información en vivo.
  3. Tiempo máximo corto y un reintento como mucho. La documentación de la Sede no publica límites de peticiones ni disponibilidad comprometida. Si el servicio tarda, el formulario sigue funcionando con entrada manual.
  4. Cola para volúmenes grandes. Si importas cientos de referencias de un fichero, las peticiones van por una cola con ritmo controlado, no en un bucle. La Sede ofrece además una consulta masiva a partir de un fichero XML que se procesa fuera de línea, y para una carga puntual grande es una alternativa a valorar.
  5. Una prueba con respuestas grabadas. Guardo una respuesta de cada forma (un inmueble, varios, error 3, error 5, sin cartografía) y las uso en PHPUnit. Así un cambio de estructura del servicio rompe una prueba y no una factura.

#Lista de comprobación antes de publicar

PuntoPregunta
Nombres de operación¿Salen de la página /json/help y no del PDF?
Código de estado¿Se trata el 200 con lerr como error?
Forma de la respuesta¿Se aceptan un inmueble y una lista?
User-Agent¿Se probó desde el servidor de producción?
Territorio¿Hay inmuebles en el País Vasco o Navarra?
Titularidad¿Alguna pantalla promete el propietario o el valor?
Datos personales¿La referencia guardada junto al cliente tiene finalidad y plazo de conservación definidos?
Caché¿Se muestra la fecha de la consulta?
Plan B¿Qué ve el usuario si el servicio no responde?

#Cómo trabajo contigo

Trabajo por escrito y en remoto, sin reuniones ni llamadas. Empiezo con un alcance con supuestos: qué dato se obtiene, desde qué pantalla o proceso, qué ocurre cuando falla. Trabajo en tu repositorio con ramas y pull requests, entrego primero en un entorno de pruebas y tú aceptas por escrito antes de pasar a producción. Después puedes contratar mantenimiento, con las horas de cada mes dentro de ese mes.

Qué preparas tú: un ejemplo de las entradas reales que vas a procesar (direcciones tal y como las escribe el usuario, referencias de tu archivo), el acceso al repositorio y al entorno de pruebas, y quién decide qué se hace con un resultado dudoso. El diseño gráfico, las maquetas y los wireframes los aportas tú y yo los implemento; para marcar qué elemento va en cada vista te envío una hoja de cálculo.

#Preguntas frecuentes

#¿Necesito registrarme o pedir una clave para usar los servicios web libres del Catastro?

No para los servicios de datos no protegidos: la Sede los describe como servicios que puede invocar cualquier ciudadano. Para los datos protegidos hay otros servicios, reservados a usuarios registrados en la Sede Electrónica del Catastro y sujetos a los supuestos de los artículos 52 y 53 del texto refundido de la Ley del Catastro Inmobiliario.

#¿Puedo obtener el propietario de un inmueble con estos servicios?

No. Los servicios libres devuelven todos los datos de un inmueble salvo la titularidad y el valor catastral. Nombre, razón social, identificación y domicilio del titular, y el valor catastral, son datos protegidos según el artículo 51 del texto refundido de la Ley del Catastro Inmobiliario, y el artículo 53 limita quién puede acceder a ellos.

#¿Sirven los servicios para una vivienda en Bizkaia, Gipuzkoa, Álava o Navarra?

No. Según la Sede, el Catastro pone a disposición los datos de todo el territorio bajo su competencia, que es el nacional salvo el País Vasco y Navarra. Una integración que deba cubrir esos territorios necesita otras fuentes.

#¿Qué formato uso, SOAP o JSON?

JSON por GET, salvo que tu sistema ya hable SOAP. El documento de la Sede describe SOAP 1.1 y REST con GET y POST, y desde la versión 2.1 (28 de diciembre de 2022) también salida en JSON. Para una aplicación PHP nueva, una petición GET y json_decode son la ruta más corta.

#¿Qué hago si el servicio no responde o responde despacio?

Lo trato como un servicio externo sin garantías: tiempo máximo corto, un reintento como mucho, caché de las referencias ya consultadas y un mensaje claro al usuario para que pueda seguir rellenando el formulario a mano. La documentación de la Sede no publica límites de peticiones ni disponibilidad comprometida.

#¿Qué tengo que prepararte para empezar?

Qué dato necesitas obtener (superficie, uso, dirección normalizada, coordenadas), desde qué entrada lo vas a pedir (formulario, importación, otro sistema) y qué se hace con él después. Con eso te contesto por escrito con las preguntas que falten y un alcance con supuestos.

#Escríbeme

Cuéntame por escrito la dirección web de tu aplicación, qué dato del Catastro necesitas, la fecha que te importa y el stack que usas hoy (Laravel, Symfony, PHP puro). Te contesto con preguntas concretas y una primera estimación por escrito, sin coste. El formulario está en la página de contacto.

¿Buscas el servicio: Desarrollador PHP en Valladolid?

Describe tu proyecto por e-mail. Respondo en 48 horas.

Describe tu proyecto

Explora otros servicios WordPress y base de conocimiento