Los esquemas XML que definen los mensajes de respuesta de los servicios web definidos en este documento contienen siempre campos para informar de posibles errores en el procesamiento de las solicitudes. Los esquemas de cada uno de los mensajes relacionados con las diferentes funciones se pueden descargar en el portal de la Dirección General de Catastro. A continuación se explican los aspectos más importantes de cada uno de los mensajes de solicitud y respuesta, así como la validación de los mensajes entrantes.
El encabezado del mensaje de solicitud 3 también incluye la lista de identificadores de diálogo de propiedades o propiedades sobre las cuales se realiza la solicitud (
Devuelve una lista de identificadores de diálogo (
Incluye en el encabezado (
ConsultaExpediente
Los elementos orientados a situaciones finales tienen la misma estructura que los definidos para la entrada END. Que el archivo no esté cerrado (en este caso se devuelve el valor EXPTE en el elemento (
Autenticidad e integridad
Autenticación personal
Autenticación delegada
3 Procedimiento para acceder a los servicios
Acceso al entorno de integración
Nombre, apellidos y NIF del usuario que quiere darse de alta en el entorno de integración. Dado que en este entorno no se proporcionan datos protegidos reales, este usuario podría ser alguien del equipo de desarrollo de aplicaciones, por ejemplo. Sólo el acceso en modo de autenticación delegada requiere el registro de la organización en este modo.
En este caso se deberá adjuntar la clave pública del certificado que se utilizará para firmar las solicitudes. No es necesario que sea el sello del organismo solicitante, pero sí un certificado emitido por una AC reconocida por la D.G. Luego de recibir la solicitud, el usuario quedará registrado y en caso de autenticación delegada, el certificado digital y el remitente responderá informándole que puede iniciar las pruebas de integración.
Las incidencias detectadas y dudas surgidas en el proceso de integración se comunicarán a través del formulario “Contáctanos”, seleccionando el tipo de incidencia.
Acceso al entorno de producción
El nombre, apellidos y NIF del usuario ya registrado en la SEC y el tipo de servicio que desea asignar. Deberá ser el sello del organismo solicitante, que será expedido por una AC reconocida por la D.G. Al recibir la solicitud, se actualizará el perfil de los usuarios, se registrará el certificado digital y los remitentes responderán para informarles que ya pueden lanzar las solicitudes en el entorno de producción.
Si se selecciona la autenticación personal, no será necesario enviar la clave pública del certificado de la organización.
Tipos de vía
Validaciones previas a la integración con los servicios web que proporcionan datos protegidos
Este apéndice es una guía de las validaciones que se deben realizar antes de llamar a los servicios. Se centra en los servicios de acceso a datos protegidos, ya que son los que presentan más problemas a la hora de integrarse. Estos servicios sólo se pueden llamar a través de mensajes SOAP. También requieren un xml como parámetro de entrada, el cual debe ser válido en un horario y por la naturaleza de estos servicios, el usuario debe firmar el mensaje que envía con su certificado.
Por un lado, debe validar el parámetro de entrada con un esquema y, por otro lado, validar la firma del mensaje. Tomaremos como ejemplo el servicio web de ficheros de consulta catastral. https://ovc2.catastro.meh.es/ovcservweb/OVCSWExpedientes/OVCExpediente.asmx). En este caso el nombre del parámetro es "ConsultaCatastro_In" y el valor que toma el parámetro es
El xml enviado como parámetro debe ser un xml "bien formado" y debe cumplir con el esquema publicado en la web del catastro (http://www.catastro.minhap.es/ws/esquemas/esquemas.htm). Para verificar manualmente que el xml se ajuste al esquema nombrado, debe agregar el encabezado del archivo xml e ingresar la ubicación del esquema con el que se validará, como se ve en el siguiente ejemplo. Una vez realizados estos cambios, se deben validar mediante alguna de las herramientas que se encuentran en el documento:
Por ejemplo, el editor XML del primer objeto. http://www.firstobject.com/dn_editor.htm), que está disponible de forma gratuita y no requiere ninguna instalación. El contenido del nodo
Una vez formateado el mensaje firmado que se enviará al servicio web, es importante asegurarse de que el mensaje enviado sea exactamente igual al mensaje firmado, incluidos espacios, tabulaciones, etc. Por otro lado, el certificado con el que se firma el mensaje debe ser emitido por una de las Autoridades de Certificación (AC) reconocidas por la Dirección General del Catastro (éstas están disponibles en http://www.catastro.minhap.es/formulario_alta_ovc2 / certificados_admitidos.htm). Otra práctica que puede resultar útil para facilitar la integración es, cuando los mensajes están correctamente construidos, invocar los servicios web especificados utilizando herramientas de invocación estilo SOAPUI (http://www.soapui.org/), que es una herramienta gratuita y muy sencilla. aplicación. de utilizar, puede resultar extremadamente útil a la hora de integrar aplicaciones a través de un servicio web.
Entorno de integración
Errores en servicios web
19 ERROR DE EXP AL VALIDAR EL ARCHIVO DE ADMINISTRACIÓN 20 ERROR DE EXP AL RECUPERAR EL MUNICIPIO DEL USUARIO. 22 ERROR EXP EN DELEGACIÓN DE USUARIO 25 ERROR EXP AL INCLUIR DELEGACIÓN 26 ERROR EXP AL REGISTRAR EL ARCHIVO. 37 ERROR EXP AL INSERTAR COMENTARIOS AL ARCHIVO 38 ERROR EXP AL AGREGAR DOCUMENTOS AL ARCHIVO 39 ERROR EXP AL ACTUALIZACIÓN DEL ESTADO DE LA SOLICITUD.
2 ERROR DE CCA AL RECORDAR TIPO DE USUARIO 3 ERROR DE CCA AL RECORDAR USUARIO SUJETO 4 ERROR DE CCA AL EVALUAR LA ENTIDAD USUARIA 5 SUJETO ASOCIADO DE CCA NO EXISTENTE. NO ES LO MISMO LA DELEGACIÓN DE LA ENTIDAD EXTRACTORA QUE LA DE LAS MERCANCÍAS. SOLO SE ACEPTAN SOLICITUDES DE PROPIEDAD REGLA DE 20 POSICIONES 15 CCA ERROR AL RECIBIR DATOS DE PROPIEDAD SOLICITADOS.
LA REFERENCIA MATERIAL DEL INMUEBLE NO PERTENECE A NINGÚN INMUEBLE DEL MUNICIPIO 17 CCA ERROR AL RECUPERAR LA IDENTIFICACIÓN DE. EL TIPO DE ARCHIVO DEBE SER LOS TIPOS COMPATIBLES EN VARPAD O CONS TYPE 22 CCA ERROR AL RECUPERAR LOS TIPOS DE ARCHIVO. 2 ERROR ACA RECUPERANDO TIPO DE USUARIO 3 ERROR ACA RECUPERANDO ENTIDAD USUARIA 4 ERROR ACA VALIDANDO ENTIDAD USUARIA 5 ERROR ACA EN DISPOSITIVO GENERAL.
LA DELEGACIÓN DE ESA UNIDAD DE PRODUCCIÓN NO ES LA MISMA QUE LA DE LAS MERCANCÍAS. 17 ERROR ACA AL VALIDAR LOS BIENES 18 ERROR ACA EN EL PRESENTADOR 19 ERROR ACA EN EL REPRESENTANTE 20 ERROR ACA EN DUEÑO. 26 ERROR ACA AL VALIDAR EL DISPOSITIVO COOPERADOR 27 ARCHIVO DE CONTROL ACA INCORRECTO 28 SOLICITUD ACA FUERA DEL CAMPO DEL ARCHIVO.
3 ERROR DE CEX DURANTE LA CREACIÓN DEL TIPO DE USUARIO 4 ERROR DE CEX DURANTE LA CONFIGURACIÓN DE LA ENTIDAD DE USUARIO 5 ERROR DE CEX DURANTE LA EVALUACIÓN DE LA ENTIDAD DE USUARIO 6 EL ASUNTO ASOCIADO DE CEX NO EXISTE. 9 ERROR DE CEX DURANTE LA RECUPERACIÓN DE LA ÚLTIMA CELDA BUENA DEVOLUCIÓN 10 CEX NO PROCESADO EN GESTIÓN.
Expedientes aceptados
Definición detallada de los mensajes
Para actualizaciones es necesario figurar como entidad con convenio en la BD del Catastro (3 N). Sólo se completa si hay una fecha de cambio diferente a la impresa en el archivo (AAAA-MM-DD).