servicios web calidad ambiental dcscalidadambiental.aragon.es/dcs/descargas/servicios_web... ·...

Servicios Web Calidad Ambiental - DCS

Revisión:

v 2.0

Fecha última versión:

marzo de 2006

Título: Calidad Ambiental - DCS Revisión: v 2.0 2 Fecha: marzo de 2006

Índice

1_ Introducción........................................................................................................ 3

2_ Alcance ................................................................................................................ 4

3_ Autenticación...................................................................................................... 6

4_ Anotaciones de sindicación al servicio DCS.................................................. 9

4.1_ Métodos comunes ............................................................................................ 9

4.2_ WS_DCS_Datos ............................................................................................. 10

4.3_ WS_DCS_LN.................................................................................................. 13 5_ Ejemplos............................................................................................................ 42

5.1_ Access............................................................................................................. 42

5.2_ Axis - JAVA ..................................................................................................... 46

5.3_ Infopath. .......................................................................................................... 47

5.4_ .NET................................................................................................................ 49


1_ Introducción El presente documento introduce los servicios Web de la aplicación DCS – Documentos de Control y Seguimiento. La aplicación se encuentra divida en dos partes, con la misma funcionalidad, la aplicación Web, que se accede desde un navegador, y los servicios Web que permite a las aplicaciones actuales existentes en el entorno de usuario comunicar la información necesaria al módulo. Para ello es necesaria una pequeña modificación de las mismas para que puedan comunicarse con el servicio. Todos estos puntos se describen más detalladamente en los apartados siguientes

• En el apartado de Alcance se describe la estructura que tiene la aplicación así como un desarrollo más detallado de los servicios.

• En el apartado de Autenticación se describen las medidas de seguridad empleadas en los servicios para trabajar con los distintos métodos, y que deben seguirse para un correcto funcionamiento.

• En el siguiente apartado se definen los distintos métodos presentados por los servicios Web

• Por último se muestran ejemplos en distintas tecnologías, por lo que trasladar a otras no debe suponer mayor esfuerzo.


2_ Alcance El presente documento detalla brevemente la arquitectura del sitio Web http://calidadambiental.aragon.es, marcando las directrices para poder utilizar sus Servicios Web.

Como se podrá comprobar el efecto que se intenta alcanzar es que el portal calidadambiental.aragon.es sea flexible, permitiendo que las aplicaciones terceras de gestores de vehículos o residuos, puedan interactuar, intercambiar y aprovechar sus datos de forma transparente, llegando a una interrelación total entre empresas y administración pública.

Desde la interfaz Servicios Web se permite realizar la misma operatoria que desde las aplicaciones Web, menos aquellas opciones como la impresión asociadas directamente al aplicativo. Entiéndase que por definición un servicio es una aplicación modular y autodescriptiva que se puede evocar desde cualquier punto. De esta manera esta capa intermedia presenta una serie de módulos que pueden utilizarse independiente del sistema operativo y/o lenguaje de programación, posibilitando que la información esté disponible en cualquier momento y en cualquier lugar.

Esta tecnología utiliza para ello un lenguaje XML y un protocolo SOAP que describe el significado de los datos permitiendo que mantengan su integridad al ser transmitidos y manejados por múltiples sitios y usuarios

Por supuesto SOAP no recae en un software de desarrollo específico; los distintos fabricantes han lanzado sus paquetes que incluyen asistentes, código de ejemplo y


manuales para los desarrolladores. Como modelo, hemos utilizado la herramienta gratuita SOAP ToolKit de Microsoft para los ejemplos Access, describiendo brevemente su utilización con otras herramientas como Infopath o Axis para java.

Para descarga los ejemplos http://calidadambiental.aragon.es/Servicios.htm.

Por último como paso previo para poder realizar cualquier operación contra la BD oficial, previamente debe solicitarse una conexión al departamento de medio ambiente. La aprobación de esta petición permitirá el acceso tanto a los programas "vehículos fuera de uso", "documentos de control y seguimiento" y "gestión de residuos no peligrosos" como a los servicios Web asociados a cada uno de ellos. A partir de dicha conexión podrá trabajar con sus datos de forma totalmente online.


3_ Autenticación Antes de realizar cualquier operación contra el servicio, la aplicación que lo está empleando debe autenticarse correctamente con un usuario y una contraseña que habrá sido proporcionada por los servicios centrales a cada empresa. Una vez autenticado se podrá trabajar correctamente con el servicio. Para que este servicio sea capaz de reconocer que el usuario se encuentra autenticado, se debe mantener la sesión almacenada en la aplicación local. Si la aplicación empleada para la comunicación es un navegador Web, esta gestión se realiza automáticamente, si se trata de una aplicación Access, se mantiene mientras permanezca abierto el canal de comunicación con el servicio, mientras que si se tratan de aplicaciones Java o C#, ésta operación debe ser realizada por la propia aplicación. En apartados posteriores se explica un ejemplo. En caso de no realizar la autenticación correctamente, los distintos métodos avisarán de la situación mediante un mensaje de error, o con la devolución de estructuras de datos vacías. Éste punto es crítico a la hora del correcto comportamiento de la comunicación. En caso de duda, en todos los servicios se encuentra disponible un método que no requiere de autenticación que permite comprobar que el servicio está activo y la conexión es correcta. Este método se denomina ping y devuelve la dirección IP desde donde se realiza la petición además de la fecha y hora de respuesta. Los servicios Web emplean el protocolo SOAP para realizar la comunicación, y la descripción del método Ping, junto con un ejemplo de repuesta es la siguiente:

HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <PingResponse xmlns="http://calidamabiental.aragon.es/dcs"> <PingResult>string</PingResult> </PingResponse> </soap:Body> </soap:Envelope> Ejemplo respuesta SOAP.

<?xml version="1.0" encoding="utf-8" ?> <string xmlns="http://calidamabiental.aragon.es/dcs"> Ping response to 1.21.1.78: 08:53:48 21/06/2005</string>

Una vez comprobada la conexión y como paso previo a la utilización del resto de los métodos, debemos autenticarnos. Para ello, se ha publicado el método Autenticar que recibe dos parámetros usuario y password.


POST /Catwebservice/Vehiculos.asmx HTTP/1.1 Host: calidadambiental.aragon.es Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://calidamabiental.aragon.es/dcs/Autenticar" <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <Autenticar xmlns="http://calidamabiental.aragon.es/dcs"> <usuario>string</usuario> <password>string</password> </Autenticar> </soap:Body> </soap:Envelope> Ejemplo petición SOAP

Recordar en este punto que en el módulo SAU, Servicio de Autenticación Universal del Gobierno de Aragón, la primera vez que se autentique vía WebService o aplicación Web, necesitará cambiar la password, para ello se ha habilitado el método ModificarPassword. Método que sólo podrá utilizarse si se ha autenticado previamente y que sigue las siguientes normas:

1. La contraseña nueva deberá ser distinta a todas las que haya utilizado anteriormente

2. Tener una longitud mayor o igual a 8 caracteres. 3. Tener una letra minúscula. 4. Tener una letra mayúscula. 5. Tener un dígito. 6. Tener un carácter que no sea ni dígito ni letra entre las posiciones 2 y 6 de la

contraseña. La nueva contraseña tiene una validez de 3 meses. Pasado ese tiempo ha de cambiarse por otra distinta a cualquiera que haya utilizado hasta el momento. Si se equivoca más de 5 veces consecutivas su cuenta será automáticamente bloqueada. Nótese que puede realizar la petición con https para cifrar los datos de la solicitud SOAP. Si por el contrario es el web service el que requiere que la petición sea https, previamente tendrá que tener instalado en su almacén de certificados el certificado de servidor del site calidadambiental.aragon.es.


4_ Anotaciones de sindicación al servicio DCS

Los servicios Web existentes son los siguientes:

• http://calidadambiental.aragon.es/dcswebservice/WS_DCS_Datos.asmx

• http://calidadambiental.aragon.es/dcswebservice/WS_DCS_LN.asmx

La descripción de cada servicio está disponible en las URL:

• http://calidadambiental.aragon.es/dcswebservice/WS_DCS_Datos.asmx?WSDL

• http://calidadambiental.aragon.es/dcswebservice/WS_DCS_LN.asmx?WSDL

El primer servicio Web engloba los métodos relacionados con la consulta de datos necesarios para emplear la codificación actual. El segundo de ellos incluye los métodos relacionados con la lógica de negocio como son la inserción de documentos, la inserción de empresas, etc.

Si se observa se puede comprobar que el servicio WS_DCS_Datos incluye la información común e idéntica a todos los usuarios y que debe ser empleada correctamente en el servicio WS_DCS_LN. El último incluye las funcionalidades y datos propios a cada usuario.

Para el correcto funcionamiento de la aplicación, y obtener el mejor rendimiento de la misma se recomiendan los siguientes pasos

1. Descargar toda la información necesaria para la comunicación de la información contenida en el método WS_DCS_Datos. Como la información contenida puede sufrir actualizaciones, se recomienda que cada cierto tiempo se vuelva a realizar una petición de los datos.

2. Una vez realizado el primer paso se puede trabajar con el segundo servicio, WS_DCS_LN, y trabajar con los métodos incluidos en el mismo.

4.1_ Métodos comunes

Cuando se obtenga la descripción de los distintos servicios se comprobará que en todos existen tres métodos comunes:


1. Ping: Comprueba que la conexión y comunicación con el servicio es correcta. No requiere autenticación previa.

2. Autenticar: Comprueba que el usuario que intenta realizar operaciones contra el servicio dispone de los permisos pertinentes.

3. ModificarPassword: Se recuerda que las contraseñas caducan cada tres meses. Este hecho es notificado por el método Autenticar. En este punto es necesario realizar el cambio de la contraseña, según se describe en el apartado de Autenticación.

4.2_ WS_DCS_Datos

Con anterioridad a la utilización de los métodos, se deberá comprobar que las tablas de codificación de nuestra aplicación local, coinciden con las codificaciones que utiliza el portal internamente. Para ello, se han publicado los métodos Listar que permiten conocer la codificación interna de la aplicación, desde tipos de transporte hasta los código INE de provincias y municipios. Todos estos métodos se incluyen en el servicio Web WS_DCS_Datos.

• ListarComunidadesAutónomas: Devuelve las Comunidades Autónomas españolas en una estructura de tipo DataSet. Este DataSet contiene una tabla con 3 columnas:

1. ID. Identificador de la CCAA de tipo string.

2. DESCRIPCION. Nombre de la CCAA de tipo string.

3. CODIGO. Código de la CCAA de tipo string.

• ListarProvincias: Devuelve las provincias de una Comunidad Autónoma en una estructura de tipo DataSet. Para ello hay que indicar el código de la Comunidad Autónoma deseada como argumento.

La tabla que devuelve tiene las siguientes columnas:

1. PRV_PROVINCIA. Identificador de la provincia de tipo string.

2. PRV_DENOMI. Denominación de la provincia de tipo string.

• ListarMunicipios: Devuelve los municipios de una provincia en una estructura de tipo DataSet. Para ello es necesario indicar el código de la provincia deseada como argumento.

La tabla que devuelve tiene las siguientes columnas:

1. MUN_MUNICIPIO. Indentificador del municipio de tipo string.

2. MUN_DENOMI. Denominación del municipio de tipo string.


• ListarCER: Devuelve los distintos códigos de la lista europea de residuos en una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:

1. ID. Identificador del residuo de tipo string.

2. DESCRIPCION. Descripción del residuo de tipo string.

3. PELIGROSO. Sus posibles valores son S, N y null. Indican si un residuo es peligroso o no.

• ListarCERP: Devuelve los distintos códigos de la lista europea de residuos peligrosos en una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:



• ListarTabla1: Devuelve los distintos códigos de la tabla 1 en una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:






















• ListarTiposTransporte: Devuelve los distintos tipos de transporte en una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:

1. ID. Identificador del tipo de transporte de tipo string.

2. DESCRIPCION. Descripción del tipo de transporte de tipo string.

• ListarTiposMovimiento: Devuelve los distintos tipos de movimiento de los residuos (Aragón - Aragón, Aragón – Otra CA, Otra CA – Aragón) en una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:

1. ID. Identificador del tipo de movimiento de tipo string.

2. DESCRIPCION. Descripción del tipo de movimiento de tipo string.

• ListarCNAE: Devuelve los distintos códigos de la Clasificación Nacional de Actividades Económicas de las empresas en una estructura de tipo DataSet. . El DataSet tiene una tabla con las siguientes columnas:

1. CODIGO. Identificador del CNAE de tipo string.

2. TITULO. Descripción del CNAE de tipo string.

• ListarEstadosNT: Devuelve todos los estados en los que se puede encontrar una notificación en una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:

1. ID. Identificador del estado de tipo string.

2. DESCRIPCION. Descripción del estado de tipo string.

• ListarRoles: Devuelve todos los roles que puede tener un centro en una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:

1. ID. Identificador del rol de tipo string.

2. DESCRIPCION. Descripción del rol de tipo string.


• ListarContenedores: Devuelve todos los tipos de contenedor que pueden aparecer en un documento de Aceites B en una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:

1. ID. Identificador del contenedor de tipo string.

2. DESCRIPCION. Descripción del contenedor de tipo string.

• ListarTiposAceite: Devuelve todos los tipos de aceites que pueden aparecer en un documento de Aceites B en una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:

1. ID. Identificador del tipo de aceite de tipo string.

2. DESCRIPCION. Descripción del aceite de tipo string.

• ListarTiposInstalacion: Devuelve todos los tipos de instalación que pueden aparecer en un documento de Aceites B en una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:

1. ID. Identificador del tipo de instalación de tipo string.

2. DESCRIPCION. Descripción de la instalacion de tipo string.

• ListarTiposGestion: Devuelve todos los tipos de gestion que pueden aparecer en un documento de Aceites B en una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:

1. ID. Identificador del tipo de gestión de tipo string.

2. DESCRIPCION. Descripción de la gestión de tipo string.

Se recuerda que si no se siguen las normas, o se produce un error no esperado, la estructura que devolverán estará vacía.

4.3_ WS_DCS_LN

El resto de métodos se encuentran en el último servicio:

1. DetalleEmpresa: Muestra la información actual del usuario autenticado. Devuelve una estructura con la siguiente información:

• Cif. CIF de la empresa de tipo string.

• RazonSocial. Razón Social de la empresa de tipo string.

• Direccion. Dirección de la empresa de tipo string.

• IdCcaa. Identificador de la Comunidad Autónoma de tipo string.


• IdProvincia. Identificador de la Provincia de tipo string.

• IdMunicipio. Identificador del Municipio de tipo string.

• CodigoPostal. Código Postal de la empresa de tipo string.

• Telefono. Teléfono de la empresa de tipo string.

• Fax. Fax de la empresa de tipo string.

• Email. Dirección de correo de la empresa de tipo string.

• PersonaResponsable. Persona Responsable de la empresa de tipo string.

• Observaciones. De tipo string.

• Fecha de Baja. Fecha de baja de la empresa de tipo string.

2. ListarCentros: Muestra los centros actuales de la empresa cuyo cif se le pasa como parámetro. Devuelve una estructura de tipo DataSet. El DataSet tiene una tabla con las siguientes columnas:

• CE_CO_NUM_CENTRO_SEC. Número de centro dentro de la empresa de tipo int.

• CE_PRV. Identificador de la provincia de tipo string.

• CE_MUN. Identificador del municipio de tipo string.

• CE_DIRECCION. Dirección del centro de tipo string.

• CE_NOMBRE_RESPONSABLE. Nombre del responsable del centro de tipo string.

• CN_TEL. Teléfono del centro de tipo string.

• CN_FAX. Fax del centro de tipo string.

• CN_CP. Código postal del centro de tipo string.

• CN_EMAIL. Dirección de correo del centro de tipo string.

• CE_CCAA. Identificador de la Comunidad Autónoma de tipo string.

• CE_NUM_AUTORIZACION. Nº de autorización del centro de tipo string.

• CE_DENOMINACION. Denominación del centro de tipo string.

• CE_DNI. DNI del responsable del centro de tipo string.

• CE_NIRI. NIRI del centro de tipo int.

• CE_CNAE. CNAE del centro de tipo string.

3. InsertarEmpresa: Inserta una nueva empresa con su primer centro asociado. Estos datos no podrán ser modificados posteriormente excepto


si se utiliza la aplicación Web. Sólo podrán introducir empresas aquellas que se hayan autenticado como gestoras.

Nótese en este punto, que los campos que comparte codificación con la aplicación, y que deben obtenerse mediante el primer servicio son:

• Comunidad Autónoma

• Provincia

• Municipio

• CNAE

• Rol

En caso de error se devolverá un mensaje con el formato “errXXX Descripción”. Si todo funciona correctamente se devolverá el cif de la empresa introducida. En resumen, los parámetros esperados por el método son los siguientes:

• cif: CIF/NIF de la empresa de tipo string. • niri: NIRI del centro de la empresa de tipo string. • razonSocial: razón social de la empresa de tipo string. Longitud

máxima 100. • direccion: dirección de la empresa de tipo string. Longitud

máxima 100. • codCcaa: código de la Comunidad Autónoma de la empresa de

tipo string. • codProvincia: código de la provincia de la empresa de tipo string. • codMunicipio: código del municipio de la empresa de tipo string. • codigoPostal: código postal de la empresa de tipo string y

longitud 5. Esta información es opcional. • telefono: teléfono de la empresa de tipo string y longitud 9. • fax: fax de la empresa de tipo string y longitud 9. Esta

información es opcional. • email: email de la empresa de tipo string con longitud máxima de

100. Esta información es opcional. • personaResponsable: persona responsable de la empresa de

tipo string. Longitud máxima 100. • dni: DNI de la persona responsable de tipo string. Esta

información es opcional. • cnae: cnae del centro de la empresa de tipo string. • observaciones: campo para introducir las observaciones de tipo

string. Longitud máxima 255. Esta información es opcional. • numeroAutorizacion: nº de autorización del centro. Dependiendo

del rol deberá comenzar por: o Productor: AR/P- o Pequeño Productor: AR/PP- o Pequeño Productor Sanitario: AR/PPS- o Transportista: AR/TRP-

Esto se aplica sólo a centros de la CCAA de Aragón.


• denominación: denominación del primer centro de la empresa que se insertará a la vez que la misma de tipo string. Longitud máxima 100.

• rol: rol del centro de la empresa que se está introduciendo de tipo string. Se pueden introducir centros de tipo productor, pequeño productor, pequeño productor sanitario y transportista.

4. InsertarCentro: Inserta los datos de un centro de una empresa. Los datos que hay que recoger proporcionados en la primera parte son:

• Comunidad Autónoma

• Provincia

• Municipio

• CNAE

• Rol

En caso de error se devolverá un mensaje con el formato “errXXX Descripción”. Si todo funciona correctamente se devolverá un string con el número asociado al centro.

Por último, se indican los campos que hay que rellenar:

• cifEmpresa: CIF/NIF de la empresa a la que se le asocia el centro de tipo string.

• codCcaa: código de la Comunidad Autónoma del centro de tipo string.

• codProvincia: código de la provincia del centro de tipo string.

• codMunicipio: código del municipio del centro de tipo string.

• direccion: dirección del centro de tipo string. Longitud máxima 100.

• personaResponsable: nombre de la persona responsable del centro de tipo string. Longitud máxima 100.

• telefono: nº de teléfono del centro de tipo string y longitud 9.

• fax: nº de fax del centro de tipo string y longitud 9. Este dato no es obligatorio.

• cogidoPostal: código postal del centro de tipo string y longitud 5.


• email: dirección de correo electrónico del centro de tipo string. Longitud máxima 100. Este dato no es obligatorio.

• observaciones: observaciones del centro de tipo string. Longitud máxima 100. Este dato no es obligatorio.

• denominación: denominación del centro de tipo string. Longitud máxima 100.

• Niri: NIRI del centro de la empresa de tipo string.

• Cnae: CNAE del centro de la empresa de tipo string.

• numAutos: string que contiene los números de autorización del centro dependiendo de su rol. Estos roles irán separados por una coma. Por ejemplo, si el centro tiene 2 roles de tipo productor y transportista, la cadena quedará de la forma: AR/P-XXX,AR/TRP-XXX

Dependiendo del rol deberá comenzar por: o Productor: AR/P- o Pequeño Productor: AR/PP- o Pequeño Productor Sanitario: AR/PPS- o Transportista: AR/TRP-

Esto se aplica sólo a centros de la CCAA de Aragón.

• roles: string con los roles que tiene el centro asociado. Los códigos de los roles deben ir separados por una coma. Siguiendo el ejemplo anterior, la cadena quedaría de la forma: 01,06

• dni: DNI de la persona responsable del centro. Este dato no es obligatorio.

5. InsertarDocumento: Inserta un nuevo Documento de Control y Seguimiento de Residuos Peligrosos. La operatoria a través de este interfaz permite la grabación de certificados con estado aceptado, rechazado u objeciones, es decir, los datos no podrán modificarse desde la aplicación aunque podrán imprimirse, o introducir únicamente el apartado A del documento, en el que el usuario aparezca como origen y gestor intermedio, o introducir únicamente el apartado B de un documento pendiente en el que el usuario es gestor destinatario. Nótese en este punto, que los campos que comparte codificación con la aplicación, y que deben obtenerse mediante el primer servicio:

• Tipo de movimiento

• Código Cer

• Códigos desde la tabla 1 hasta la tabla 7


• Tipos de transportes

En caso de error se devolverá un mensaje con el formato “errXXX Descripción”. Si todo funciona correctamente se devolverá el código del certificado insertado.

Los parámetros de entrada que se piden son:

• id: identificador del documento de tipo string. El identificador puede estar vacío o tener una longitud de 9. Tiene que estar formada por:

código CCAA + nº del documento (7 dígitos)

• codTipoMovimiento: código del tipo de movimiento del residuo de tipo string.

• gestorIntermedio: tiene dos posibles valores. 0 indica que el emisor del residuo es un productor y 1 indica que se trata de un gestor intermedio.

• cifProductor: cif del productor del residuo de tipo string.

• cifGestor: cif del gestor del residuo de tipo string.

• numSecCentroProductor: número de centro del que sale el residuo de tipo int.

• numSecCentroGestor: número de centro al que llega el residuo de tipo int.

• numeroAceptacion: número de aceptación del documento de tipo string. Longitud máxima 50.

• numeroOrden: número del orden del documento de tipo string. Longitud máxima 30. Este dato no es obligatorio.

• caracteristicas: características del traslado del residuo de tipo string. Longitud máxima 100. Este dato no es obligatorio.

• cer: código CER del residuo de tipo string.

• kgsNetos: kilos netos de la cantidad de residuo transportado de tipo double.


• kgsBrutos: kilos brutos de la cantidad de residuos transportados de tipo double.

• tabla1: código del residuo en la tabla 1 de tipo string.




• tabla4B: código del residuo en la tabla 4 b de tipo string. Este dato no es obligatorio.





• descripción: descripción del residuo peligroso de tipo string. Longitud máxima 100.

• fechaInicioTransporte: fecha de inicio del transporte del residuo de tipo string. Tiene que tener el formato: dd/MM/yyyy.

• fechaFinTransporte: fecha final del transporte del residuo. Tiene que tener el formato: dd/MM/yyyy.

• razonSocialTransporte: razón social de la empresa de transporte de tipo string. Longitud máxima 100.

• matriculaTransporte: matrícula del medio de transporte del residuo de tipo string. Longitud máxima 10.

• codTipoTransporte: código del tipo de transporte del residuo de tipo string.

• nifTransporte: CIF/NIF de la empresa de transportes de tipo string.


• telefonoTransporte: teléfono de la empresa de transporte de tipo string.

• faxTransporte: fax de la empresa de transporte de tipo string. Este dato no es obligatorio.

• fechaInicioTransporte2: fecha de inicio del segundo transporte si fuera necesario. Tiene que tener el formato: dd/MM/yyyy. Este dato no es obligatorio si no hay segundo transporte.

• fechaFinTransporte2: fecha final del segundo transporte si fuera necesario. Tiene que tener el formato: dd/MM/yyyy. Este dato no es obligatorio si no hay segundo transporte.

• razonSocialTransporte2: razón social de la empresa de transporte de tipo string. Longitud máxima 100. Este dato no es obligatorio si no hay segundo transporte.

• matriculaTransporte2: matrícula del vehículo que transportará el residuo de tipo string. Longitud máxima 10. Este dato no es obligatorio si no hay segundo transporte.

• codTipoTransporte2: código del tipo de transporte que se utilizará en el segundo desplazamiento de tipo string. Este dato no es obligatorio si no hay segundo transporte.

• nifTransporte2: CIF/NIF de la segunda empresa transporte de tipo string. Este dato no es obligatorio si no hay segundo transporte.

• telefonoTransporte2: teléfono de la segunda empresa de transporte de tipo string. Este dato no es obligatorio si no hay segundo transporte.

• faxTransporte2: fax de la segunda empresa de transporte de tipo string. Este dato no es obligatorio.

• acepta: código que indica si se acepta o no el certificado. 0 en caso afirmativo. 1 en caso negativo.

• incidencias: campo que recoge las incidencias que se hayan podido producir de tipo string. Longitud máxima 200.

• fechaAceptacion: fecha de aceptación del certificado. Tiene que tener el formato: dd/MM/yyyy.


• firmado: nombre de la persona que firma el documento de tipo string. Longitud máxima 150.

6. ListarDocumentos: Muestra todos los documentos de control y seguimiento de los residuos peligrosos en un objeto de tipo DataSet. Hay que pasar como parámetro 2 fechas entre las que se realizará la búsqueda. Son de tipo string y tienen que tener el formato dd/MM/yyyy.

El DataSet tiene una tabla con las siguientes columnas:

• DCS_ID_DCS. Identificador del documento de tipo string.

• DCS_ESTADO. Identificador del estado de tipo string.

• EST_DESCRIPCION. Descripción del estado de tipo string.

• DCS_CO_TIPO_MOV. Identificador del tipo de movimiento de tipo string.

• MOV_DESCRIPCION. Descripción del movimiento de tipo string.

• EM_CIF1. Cif de la empresa origen de tipo string.

• NOM1_EMPRESA. Nombre de la empresa de origen de tipo string.

• NUM_SEC1. Número del centro de la empresa de tipo int.

• DEN1_CENTRO. Denominación del centro de la empresa de origen de tipo string.

• EM_CIF2. Cif de la empresa destino de tipo string.

• NOM2_EMPRESA. Nombre de la empresa de origen de tipo string.

• NUM_SEC2. Número del centro de la empresa de tipo int.

• DEN2_CENTRO. Denominación del centro de la empresa de destino de tipo string.

• DCS_RES_NUM_ACEPTACION. Nº de aceptación del documento de tipo string.

• DCS_RES_NUM_ORDEN. Nº de orden del documento de tipo string.

• DCS_RES_CARACT_TRANS. Características del transporte de tipo string.

• DCS_RES_CO_CER. Código LER del residuo de tipo string.

• DCS_RES_KG_NETOS. Kilogramos netos del residuo de tipo double.

• DCS_RES_KG_BRUTOS. Kilogramos brutos del residuo de tipo double.

• DCS_RES_CO_TB1. Código de la tabla 1 de tipo string.





• DCS_RES_CO_TB4B. Código de la tabla 4 de tipo string.


• DCS_RES_CO_TB5B. Código de la tabla 5 de tipo string.



• DCS_RES_DESCRIPCION. Descripción del residuo de tipo string.

• DCS_TR_FC_INICIO. Fecha de inicio del primer transporte de tipo string.

• DCS_TR_FC_FIN. Fecha final del primer transporte de tipo string.

• DCS_TR_RZN_SOCIAL. Razón social de la empresa de transporte de tipo string.

• DCS_TR_MATRICULA. Matrícula del vehículo del primer transporte de tipo string.

• DCS_TR_CO_TIPO_TR. Identificador del tipo de transporte de tipo string.

• TRANS1_DESCRIPCION. Descripción del tipo de transporte de tipo string.

• DCS_TR_NIF. Nif de la empresa de transporte de tipo string.

• DCS_TR_TEL. Teléfono de la empresa de transporte de tipo string.

• DCS_TR_FAX. Fax de la empresa de transporte de tipo string.

• DCS_TR_FC_INICIO2. Fecha de inicio del segundo transporte de tipo string.

• DCS_TR_FC_FIN2. Fecha final del segundo transporte de tipo string.

• DCS_TR_RZN_SOCIAL2. Razón social de la empresa de transporte de tipo string.

• DCS_TR_MATRICULA2. Matrícula del vehículo del segundo transporte de tipo string.

• DCS_TR_CO_TIPO_TR2. Identificador del tipo de transporte de tipo string.


• TRANS2_DESCRIPCION. Descripción del tipo de transporte de tipo string.

• DCS_TR_NIF2. Nif de la empresa de transporte de tipo string.

• DCS_TR_TEL2. Teléfono de la empresa de transporte de tipo string.

• DCS_TR_FAX2. Fax de la empresa de transporte de tipo string.

• DCS_BLOQUEB_ACEPTA. 0 si está aceptado. 1 si está rechazado.

• DCS_BLOQUEB_INCIDENCIAS. Incidencias del documento de tipo string.

• DCS_BLOQUEB_FC_ACEPTACION. Fecha de aceptación del documento de tipo string.

• DCS_FIRMADO. Nombre del firmante del documento de tipo string.

7. InsertarNotificacion: Inserta una nueva notificación. La notificación se encontrará en estado Enviada, lo que significa que no se podrán modificar sus datos. Los datos que comparten codificación, y que deben obtenerse mediante el primer servicio son:

• Tipo de movimiento

• Comunidades Autónomas

• Provincias

• Localidades

• Tipos de transporte

• Códigos LER

• Códigos de las tablas.

En caso de error se devolverá un mensaje con el formato “errXXX Descripción”. Si todo funciona correctamente se devolverá el identificador del documento.

Por último, los datos que se deben introducir son:

• codTipoMovimiento: identificador del tipo de movimiento de tipo string. De momento sólo está permitido Aragón – Aragón que tiene el código 00.

• gestorIntermedio: tiene dos posibles valores. 0 indica que el emisor del residuo es un productor y 1 indica que se trata de un gestor intermedio.


• cifProductor: CIF/NIF de la empresa productora del residuo de tipo string.

• cifGestor: CIF/NIF de la empresa gestora del residuo de tipo string.

• numSecCentroProductor: número de centro productor del residuo de tipo int.

• numSecCentroGestor: número de centro gestor del residuo de tipo int.

• numAceptacion: número de aceptación del certificado de tipo string. Longitud máxima 50. Este dato no es obligatorio.

• cer: código CER del residuo a gestionar de tipo string.

• kgs: cantidad del residuo que se va a gestionar de tipo double.










• descripción: descripción del residuo de tipo string. Longitud máxima 100.

• fcT: fecha de transporte de tipo string. El formato tiene que ser: dd/MM/yyyy.


• rznSocialT: razón social de la empresa transportadora de tipo string. Longitud máxima 100.

• direccionT: dirección de la empresa transportadora de tipo string. Longitud máxima 100.

• contactoT: nombre de la persona de contacto de la empresa transportadora de tipo string. Longitud máxima 100.

• codCcaaT: código comunidad autónoma de la empresa transportadora de tipo string.

• codPrvT: código de la provincia de la empresa transportadora de tipo string.

• codLocT: código de la localidad de la empresa transportadora de tipo string.

• matriculaT: matrícula del vehículo que se va a utilizar en el transporte de tipo string. Longitud máxima 10.

• nifT: NIF/CIF de la empresa transportadora de tipo string.

• telT: teléfono de la empresa transportadora de tipo string.

• faxT: fax de la empresa transportadora de tipo string. Este dato no es obligatorio.

• codTipoTrans: código del tipo de transporte de tipo string.

• ccaas: campo en el que se indican las comunidades autónomas por las que va a atravesar el residuo de tipo string. Longitud máxima 200.

• itinerario: indica los lugares por los que se va a trasladar el residuo de tipo string. Longitud máxima 200.

• observaciones: campo en el que se pueden insertar las observaciones de la notificación de tipo string. Este dato no es obligatorio.

8. ListarNotificaciones: Muestra todas las notificaciones introducidas por la empresa autenticada en un DataSet. Hay que pasar como parámetro 2 fechas entre las que se realizará la búsqueda. Son de tipo string y tienen que tener el formato dd/MM/yyyy.

El DataSet contiene una tabla con las siguientes columnas:


• NT_ID_NOTIFICACION. Identificador de la notificación de tipo string.

• NT_ESTADO. Identificador del estado de tipo string.


• NT_CO_MOVIMIENTO. Identificador del movimiento de tipo string.

• MOV_DESCRIPCION. Descripción del tipo de movimiento de tipo string.

• NT_FC_ACEPTACION_RECHAZO. Fecha de aceptación de la notificación.

• NT_CO_RECHAZO. Identificador del tipo de rechazo de tipo string.

• RECH_DESCRIPCION. Descripción del rechazo de tipo string.

• CIF_EMPRESA1. Cif de la empresa productora de tipo string.

• NOM1_EMPRESA. Razón social de la empresa productora de tipo string.

• NUM_SEC_C1. Número del centro de la empresa productora de tipo entero.

• DEN1_CENTRO. Denominación del centro de tipo string.

• NT_GESTOR_INTERMEDIO. String con valor 0 si es productor. 1 si es un gestor intermedio.

• CIF_EMPRESA2. Cif de la empresa gestora de tipo string.

• NOM2_EMPRESA. Razón social de la empresa gestora de tipo string.

• NUM_SEC_C2. Número del centro de la empresa gestora de tipo entero.

• DEN2_CENTRO. Denominación del centro de tipo string.

• NT_NUM_ACEPTACION. Número de aceptación de tipo string.

• NT_RES_CO_CER. Código LER del resíduo de tipo string.

• NT_RES_KG. Cantidad de residuo de tipo double.

• NT_RES_CO_TB1. Identificador de la tabla 1 de tipo string.




• NT_RES_CO_TB4_2. Identificador de la tabla 4 de tipo string.



• NT_RES_CO_TB5_2. Identificador de la tabla 5 de tipo string.



• NT_RES_DESC_RESIDUO. Descripción del residuo de tipo string.

• NT_TR_FC_TRANSPORTE. Fecha de transporte de tipo string.

• NT_TR_RZN_SOCIAL. Razón social de la empresa de transporte de tipo string.

• NT_TR_DIRECCION. Dirección de la empresa de transporte de tipo string.

• NT_TR_PER_CONTACTO. Persona de contacto de la empresa de transporte.

• NT_TR_CCAA. Identificador de la CCAA de la empresa de transporte de tipo string.

• NT_TR_PROV. Identificador de la provincia de la empresa de transporte de tipo string.

• NT_TR_LOCALIDAD. Identificador de la localidad de la empresa de transporte de tipo string.

• NT_TR_MATRICULA. Matrícula del vehículo de transporte de tipo string.

• NT_TR_TIP_TR. Identificador del tipo de transporte de tipo string.

• NT_TR_NIF. NIF de la empresa de transporte de tipo string.

• NT_TF_TEL. Teléfono de la empresa de transporte de tipo string.

• NT_TR_FAX. Fax de la empresa de transporte de tipo string.

• NT_CCAA_TRANSITO. Comunidades Autónomas de transito de tipo string.

• NT_ITINERARIO. Itinerario previsto de tipo string.

• NT_OBSERVACIONES. Observaciones de tipo string.

9. InsertarAceitesB: Inserta un documento de aceites usados (aceites B). Para ello hay que tener en cuenta los códigos proporcionados en la primera parte.

• Tipos de movimiento

• Tipos de contenedor

• Tipos de aceites

• Códigos CER


• Tipos de instalaciones

• Tipos de gestión

• Comunidades Autónomas

• Provincias

• Municipios

En caso de error se devolverá un mensaje con el formato “errXXX Descripción”. Si todo funciona correctamente se devolverá el código del certificado insertado.

Y los parámetros que se pasan son:

• id: identificador del documento rellenado. Este campo puede estar vacío o tener una longitud de 9. Tiene que venir de la siguiente forma:

Código CCAA + nº del documento (7 dígitos)

• codTipoMovimiento: código del tipo de movimiento que sufre el residuo de tipo string.

• fcEmision: fecha de emisión del documento de tipo string. El formato es dd/MM/yyyy.

• fcLlegada: fecha en la que el residuo llegará a la empresa gestora para tratarlo de tipo string. El formato es dd/MM/yyyy.

• gestorInter: código que indica si el emisor del residuo se trata de un productor (0), un recogedor (1) o un gestor intermedio (2).

• cifProductor: CIF/NIF de la empresa productora del residuo de tipo string.

• cifGestor: CIF/NIF de la empresa gestora del residuo de tipo string.

• numSecCentroProductor: número del centro productor de tipo int.

• numSecCentroGestor: número del centro gestor de tipo int.

• codContenedor: código del tipo de contenedor que se usará para el transporte del residuo de tipo string.


• cantidad: cantidad de kilos o contenedores que se utilizarán el en transporte de tipo double.

• codTipoAceite: código del tipo de aceite que se va a transportar de tipo string.

• codLer: código LER del residuo a transportar de tipo string.

• fcTransporte: fecha en la que se realizará el transporte de tipo string. Tiene el formato dd/MM/yyyy.

• rznSocialTransporte: razón social de la empresa de transporte de tipo string. Longitud máxima 100.

• matriculaTransporte: matrícula del vehículo que transportará el residuo de tipo string. Longitud máxima 10.

• nifTransporte: NIF/CIF de la empresa de transporte de tipo string.

• niriTransporte: NIRI de la empresa de transporte de tipo string. Este campo no es obligatorio.

• domicilioTransporte: dirección de la empresa de transporte de tipo string. Longitud máxima 100.

• telefonoTransporte: número de teléfono de la empresa de transporte de tipo string.

• codCcaaTransporte: código de la Comunidad Autónoma a la que pertenece la empresa de transporte de tipo string.

• codPrvTransporte: código de la provincia de la empresa de transporte de tipo string.

• codMunTransporte: código del municipio de la empresa de trasnporte de tipo string.

• cpTransporte: código postal de la empresa de transporte de tipo string.

• numAutorizacionTransporte: número de autorización de la empresa de transporte de tipo string.


• responsableTransporte: persona responsable de la empresa de transporte de tipo string. Longitud máxima 100.

• dniRespTransporte: DNI del responsable de la empresa de transporte de tipo string. Este dato no es obligatorio.

• codTipoInstalacion: código que establece el tipo de instalación en el que se va a tratar el residuo de tipo string.

• codTipoGestion: código que señala el tipo de gestión de residuo de tipo string.

• combustión: si el código de tipo gestión es el 00, un 0 en este campo indica que la combustión es < 3Mw y un 1 que es > 3Mw. De tipo string.

• aceptación: código que indica si se acepta el documento (1) o si no se acepta (0). De tipo string.

• inADes: incidencias del bloque A del documento de tipo string. Longitud máxima 150. Este campo no es obligatorio.

• inBDes: incidencias del bloque B del documento de tipo string. Longitud máxima 150. Este campo no es obligatorio.

• inCDes: incidencias del bloque C del documento de tipo string. Longitud máxima 150. Este campo no es obligatorio.

• inDDes: incidencias del bloque D del documento de tipo string. Longitud máxima 150. Este campo no es obligatorio.

10. ListarAceitesB: Devuelve en un DataSet todos los documentos de aceites usados en los que interviene la empresa autenticada. Hay que pasar como parámetro 2 fechas entre las que se realizará la búsqueda. Son de tipo string y tienen que tener el formato dd/MM/yyyy.


• AC_ID. Identificador del documento de tipo string.

• AC_ESTADO. Identificador del estado del documento de tipo string.


• AC_TIPO_MOVIMIENTO. Identificador del tipo de movimiento de tipo string.

• MOV_DESCRIPCION. Descripción del movimiento de tipo string.


• AC_FC_EMISION. Fecha de emisión de tipo dateTime.

• AC_FC_LLEGADA. Fecha de llegada de tipo dateTime.

• AC_GESTOR_INTERMEDIO. String con valor 0 si es productor, 1 si es recogedor y 2 si es gestor intermedio.

• EM_CIF1. Cif de la empresa productora de tipo string.

• NUM_SEC1. Número del centro productor de tipo int.

• EM_CIF2. Cif de la empresa gestora de tipo string.

• NUM_SEC2. Número del centro gestor de tipo int.

• AC_CO_CONTENEDOR. Identificador del contenedor de tipo string.

• DESCRIPCION_CONT. Descripción del contenedor de tipo string.

• AC_CUANTOS. Cantidad de residuo de tipo int.

• AC_CO_TIPO_ACEITE. Identificador del estado del aceite de tipo string.

• DESCRIPCION_ACEITE. Descripción del estado del aceite de tipo string.

• AC_LER. Código LER del residuo de tipo string.

• AC_TR_FC. Fecha de transporte de tipo DateTime.

• AC_TR_RZN_SOCIAL. Razón social de la empresa de transporte de tipo string.

• AC_TR_MATRICILA. Matrícula del vehículo de tipo string.

• AC_TR_NIF. Nif de la empresa de transporte de tipo string.

• AC_TR_NIRI. Niri de la empresa de transporte de tipo int.

• AC_TR_DOMICILIO. Dirección de la empresa de transporte de tipo string.

• AC_TR_TEL. Teléfono de la empresa de transporte de tipo string.

• AC_TR_PRV. Identificador de la provincia de la empresa de transporte de tipo string.

• AC_TR_MUN. Identificador del municipio de la empresa de transporte de tipo string.

• AC_TR_CCAA. Identificador de la CCAA de la empresa de transporte de tipo string.


• AC_TR_COD_POSTAL. Código postal de la empresa de transporte de tipo string.

• AC_TR_NUM_AUTORIZACION. Número de autorización de la empresa de transporte de tipo string.

• AC_TR_NOMBRE_RESP. Nombre del responsable de la empresa de transporte de tipo string.

• AC_TR_DNI_RESP. DNI del responsable de la empresa de transporte de tipo string.

• AC_CO_TIPO_INSTALACION. Identificador del tipo de instalación de tipo string.

• DESCRIPCION_INST. Descipción del tipo de instalación de tipo string.

• AC_CO_TIPO_GESTION. Identificador del tipo de gestión del residuo de tipo string.

• DESCRIPCION_GESTION. Descripción del tipo de gestión de tipo string.

• AC_COMBUSTION_MENOR_3MW. String con valor 0 si el valor es < 3Mw y 1 si es > 3 Mw. Este campo es válido si el tipo de gestión es combustión (00).

• AC_ACEPTACION. String con valor 1 si el documento está aceptado. 0 en caso contrario.

• AC_IN_A_DES. Incidencias en el apdo. A del documento de tipo string.

• AC_IN_B_DES. Incidencias en el apdo. B del documento de tipo string.

• AC_IN_C_DES. Incidencias en el apdo. C del documento de tipo string.

• AC_IN_D_DES. Incidencias en el apdo. D del documento de tipo string.

• RSGESTOR. Razón social de la empresa gestora de tipo string.

• RSPRODUCTOR. Razón social de la empresa productora de tipo string.

11. InsertarDocumentoPequenoProductor: con este servicio web se procede a la inserción de un documento de residuos tóxicos de pequeños productores. Los códigos que se usan en esta ocasión de los que se proporcionan en la primera parte son:

• Códigos LER

• Códigos de las tablas 1 a la 7


• Tipos de transporte

En caso de error se devolverá un mensaje con el formato “errXXX Descripción”. Si todo funciona correctamente se devolverá el código del certificado introducido.

Los parámetros de entrada que se piden son:

• Id: identificador del documento de tipo string. Se puede dejar vacío o introducir el código con el siguiente formato:

ARPP + nº documento

Tiene que tener una longitud de 11.

• numSecCentroGestor: número del centro del gestor cuyo usuario se ha logueado de tipo int.

• descripción: descripción del residuo tóxico de tipo string. Longitud máxima 100.

• caracteristicas: características del transporte del residuo. Este dato no es obligatorio. Longitud máxima 100.










• cer: código CER del residuo de tipo string.

• razonSocialTransporte: razón social de la empresa de transporte de tipo string. Longitud máxima 100.


• nifTransporte: NIF/CIF de la empresa de transporte de tipo string.

• niriTransporte: NIRI de la empresa de transporte de tipo string. Este dato no es obligatorio.

• codTipoTransporte: código del tipo de transporte utilizado para el traslado del residuo de tipo string.

• matriculaTransporte: matrícula del vehículo que se utilizará para el transporte del residuo de tipo string. Longitud máxima 10.

• anotaciones: una anotación es un ArrayList cuyos objetos son de tipo Anotacion. Una AnotacionPP consta de 5 campos:

o CIF: entero que identifica a un pequeño productor de tipo string.

o numSecCentro: string que representa un centro del pequeño productor.

o unidades: entero que denota el número de unidades del residuo que se recoge.

o kgs: double que indica el número de kgs de cada unidad de residuo.

o fecha: fecha en la que el residuo ha sido recogido de tipo DateTime.

12. ListarDocumentosPequenosProductores : Devuelve en un DataSet todos los documentos de residuos tóxicos de pequeños productores relacionados con la empresa autenticada. Los datos que devuelven se corresponden con los del gestor, del residuo y del transporte.

Hay que introducir las fechas entre las que se buscarán los documentos. Son de tipo string y tienen el formato dd/MM/yyyy.



• CE_CO_NUM_CENTRO_SEC. Número del centro de la empresa de tipo int.

• DCS_RES_CARACT_TRANS. Características del transporte de tipo string.

• DCS_RES_CO_CER. Código LER del residuo de tipo string.






• DCS_RES_CO_TB4_2. Código de la tabla 4 de tipo string.


• DCS_RES_CO_TB5_2. Código de la tabla 5 de tipo string.



• DCS_RES_DESCRIPCION. Descripción del residuo de tipo string.

• DCS_TR_RZN_SOCIAL. Razón social de la empresa de transporte de tipo string.

• DCS_TR_MATRICULA. Matrícula del vehículo de tipo string.

• DCS_TR_CO_TIPO_TR. Identificador del tipo de transporte de tipo string.

• DESCRIPCION_TR. Descripción del vehículo de tipo string.

• DCS_TR_NIF. NIF de la empresa de transportes de tipo string.

• DCS_TR_NIRI. NIRI de la empresa de transportes de tipo int.

• DCS_ESTADO. Identificador del estado del documento de tipo int. Devuelve 0 si está abierto y 1 si está cerrado.

• EM_RZN_SOCIAL. Razón social de la empresa a la que pertenece el usuario autenticado de tipo string.

• EM_CIF. CIF de la empresa a la que pertenece el usuario autenticado de tipo string.

13. ListarAnotacionesDocumentosPequenosProductores : Muestra todas las anotaciones asociadas a un documento de residuos tóxicos. Cada anotación se corresponde con la recogida de los residuos a un pequeño productor. Como parámetro hay que pasar el identificador de un documento de pequeño productor. Devuelve un DataSet con una tabla que tiene las siguientes columnas:

• EM_RZN_SOCIAL. Razón social de la empresa pequeña productora emisora del residuo de tipo string.

• DCS_FECHA. Fecha de recogida del residuo de tipo DateTime.

• DCS_NUM_UDS. Nº de unidades recogidas de tipo int.

• DCS_PESO. Peso del residuo de tipo double.

• CE_CO_NUM_CENTRO_SEC. Nº del centro de la empresa pequeña productora de tipo int.


• DCS_CE_DENOMINACION. Denominación del centro de la empresa de tipo string.

• DCS_EM_CIF. CIF de la empresa pequeña productora de tipo string.

14. InsertarDocumentoAceiteA: Inserta un documento de pequeños productores de control de recogida de Aceites A.

En caso de error se devolverá un mensaje con el formato “errXXX Descripción”. Si todo funciona correctamente se devolverá el código del certificado introducido.

Los datos que se deben introducir se comentan a continuación:

• id: identificador del documento. Se puede dejar vacío o introducir el código con el siguiente formato:

APP + nº documento

Tiene que tener una longitud de 10.

• numSecCentroRecogedor: número de centro de la empresa a la que pertenece el usuario registrado. A ese centro llegarán los residuos. De tipo int.

• cifDepositoPrevio: CIF/NIF de la empresa en la que se hará el depósito previo (si lo hubiera). Este dato no es obligatorio. De tipo string.

• numSecCentroDepositoPrevio: denominación del centro de la empresa en la que se realizará el depósito previo. Este dato no es obligatorio. De tipo int.

• Anotaciones: parámetro de tipo ArrayList que contiene objetos de tipo AnotaciónA. Cada AnotaciónA contiene los siguientes campos:

o cif: string que indica el cif de la empresa pequeña productora.

o numSecCentro: string que representa el identificador del centro de la empresa pequeña productora.

o numeroJustificante: string que indica el número del justificante de la recogida del residuo.

o unidades: entero que contiene el número de bidones de aceite recogidos.

o Kgs: doble que denota los kilos de aceite recolectados.


o Fecha: fecha en la que se ha recogido el residuo al pequeño productor. De tipo string y formato dd/MM/yyyy.

o LER: código LER del residuo.

15. ListarDocumentosAceitesA: Devuelve en un DataSet todos los documentos de aceites A de pequeños productores relacionados con la empresa autenticada. Los datos que devuelven se corresponden con los del recogedor y del depósito previo. Se piden de paámetros de entrada las fechas entre las que se realizará la búsqueda. El formato es dd/MM/yyyy.

El DataSet que devuelve tiene una tabla con las siguientes columnas:


• NUM_SEC1. Identificador del centro de la empresa gestora de tipo int.

• NUM_SEC2. Identificador del centro de la empresa que hace el almacenamiento intermedio de tipo int.

• DCS_ESTADO. Entero con valor 0 si el documento está abierto (se puede modificar) o 1 si está cerrado (no se puede modificar).

• CIFG. Cif de la empresa gestora de tipo string.

• CIFP. Cif de la empresa de almacenamiento intermedio de tipo string.

• RZN_SOCIAL1. Razón social de la empresa gestora de tipo string.

• RZN_SOCIAL2. Razón social de la empresa de almacenamineto intermedio de tipo string.

16. ListarAnotacionesDocumentosAceitesA: Muestra todas las anotaciones asociadas a un documento de aceites A. Cada anotación se corresponde con la recogida de los residuos a un pequeño productor.

Como parámetro hay que pasar el identificador de un documento de recogida de aceites A. Devuelve un DataSet con una tabla que tiene las siguientes columnas:

• EM_RZN_SOCIAL. Razón social de la empresa pequeña productora del residuo de tipo string.

• DCS_NUM_JUSTIFICANTE. Nº de justificante de tipo string.

• DCS_BIDONES. Nº de bidones de tipo string.

• DCS_KG. Cantidad de residuo de tipo double.

• DCS_FECHA. Fecha de entrega del residuo de tipo DateTime.

• CE_CO_NUM_CENTRO_SEC. Nº de centro de la empresa pequeña productora de tipo int.


• DCS_CO_LER. Código LER del residuo de tipo string.

• DCS_CE_DENOMINACION. Denominación del centro productor de tipo string.

• DCS_EM_CIF. CIF de la empresa pequeña productora de tipo string.

Los primeros métodos devuelven la información sobre las empresas relacionadas con el usuario conectado. El resto de los métodos se refieren a la introducción y listados de los distintos tipos de documentos de control y seguimiento.

El formato que deben seguir todas las fechas pasadas como argumento deben ser “dd/MM/yyyy”, es decir, el día con dos dígitos, relleno con ceros por la izquierda, el mes con dos dígitos, relleno con ceros por la izquierda y el año con 4 dígitos. Tanto el día, como el mes y año deben estar separados por el carácter ‘/’. Así el 14 de junio de 2005 debe pasarse como “14/06/2005”

Los distintos códigos de error que pueden devolver los métodos son los siguientes:

01 Error 02 No se encuentra autenticado 03 Error en el tipo de movimiento

04 Error en el código CER 05 Error en el código de la tabla 1

06 Error en el código de la tabla 2 07 Error en el código de la tabla 3 08 Error en el código de la tabla 4

09 Error en el código de la tabla 4 B 10 Error en el código de la tabla 5 11 Error en el código de la tabla 5 B 12 Error en el código de la tabla 6

13 Error en el código de la tabla 7 14 No existe el centro gestor

15 La empresa productora no existe 16 No existe el centro productor

17 Error en el identificador del documento de control y seguimiento

18 Tipo de transporte inválido 19 No hay anotaciones 20 El número de anotaciones es mayor del permitido 21 Error en el NIF/CIF de la empresa pequeña productora 22 No existe la empresa pequeña productora 23 No existe el centro del pequeño productor 24 Fecha incorrecta 25 Error en el NIF/CIF de la empresa de depósito previo 26 No existe el centro de la empresa del depósito previo 27 Identificador inválido 28 Dirección inválida 29 Teléfono inválido 30 Fax inválido 31 Razón social inválida


32 NIRI inválido 33 Código postal inválido 34 Dirección de correo electrónico inválido 35 Comunidad Autónoma inválida 36 Provincia inválida 37 Municipio inválido 38 Denominación inválida 39 La empresa gestora no existe 40 Error de validación 41 Tipo de contenedor inválido 42 Tipo de aceite inválido 43 Tipo de instalación inválido 44 Tipo de gestión inválido 45 Código inválido 46 Código duplicado 47 Código de rol inválido 48 DNI inválido 49 Número de autorización inválido 50 CNAE inválido 51 Persona responsable obligatoria 52 Empresa duplicada 53 Número de autorización duplicado 54 Error en número de autorización-rol

55 Fecha inicio transporte no válida 56 Fecha fin transporte no válida 57 Cantidad de Kg incorrectos 58 Descripción inválida

59 Razón social de transporte inválida 60 Matrícula de transporte inválida 61 Tipo de transporte inválido 62 Firma inválida

63 Fecha inválida 64 Fecha de transporte inválida

65 Las comunidades autónomas de paso son obligatorias 66 El itinerario es obligatorio 67 La cantidad es obligatoria 68 Fecha de emisión inválida 69 Fecha de llegada inválida 70 Combustión inválida 71 Aceptación inválida 72 Gestor intermedio inválido 73 Longitud excedida en observaciones 74 Longitud excedida en numDocT 75 Longitud excedida en numOrden 76 Fecha de aceptacion inválida 77 Fecha inicio del segundo transporte no válida 78 Fecha fin del segundo transporte no válida

79 El centro gestor no pertenece a una comunidad autónoma acorde con el tipo de movimiento 80 El centro productor no pertenece a una comunidad autónoma acorde con el tipo de movimiento 81 Ni la empresa gestora ni la productora se corresponden con la empresa logueada

82 El centro no tiene el rol productor 83 El centro no tiene el rol gestor 84 Dirección de la empresa de transportes inválida

85 Persona responsable de la empresa de transportes inválida


86 Teléfono de la empresa de transportes inválido 87 NIRI de la empresa de transportes inválido

88 Número de autorización de la empresa de transportes inválido

89 Código postal de la empresa de transportes inválido 90 DNI del responsable de la empresa de transportes inválido

91 NIF/CIF de la empresa de transportes inválido 92 Exceso de longitud en la incidencia 93 El fax de la empresa de transporte es inválido 94 NIF/CIF de la segunda empresa de transportes inválido

95 Razón social de la segunda empresa de transportes inválida

96 Matrícula del segundo transporte inválida 97 Teléfono de la segunda empresa de transporte inválido 98 Fax de la segunda empresa de transporte inválido 99 Segundo tipo de transporte inválido 100 El centro no tiene el rol pequeño productor 101 El ejercicio es inválido 102 CIF inválido 103 El número de centro gestores tiene que ser mayor que 0 104 Apellidos del representante inválidos 105 Nombre del representante inválido 106 Cargo del representante inválido

107 El número de procesos gestores de residuos peligrosos es inválido

108 La energía es inválida 109 La potencia es inválida 110 Error en la inserción

111 No ha insertado el apartado 1 y 2 de la memoria anual de gestores

112 Número de empleados inválido 113 CNBS inválido 114 Descripción de Anejo 1 inválida 115 Descripción de Anejo 2 inválida 116 Número de proceso inválido 117 Arancel inválido

118 Tipo de recipiente inválido 119 Código de almacenamiento inválido 120 Mes inválido 121 Nº DCS inválido 122 Nº de unidades inválido 123 Nº de días inválido 124 CIF del representante inválido 125 Dirección del representante inválida 126 Código postal del representante inválido 127 Fax del representante inválido 128 Teléfono del representante inválido 129 Provincia del representante inválida 130 Municipio del representante inválido 131 Código postal del centro inválido 132 Fax del centro inválido 133 Teléfono del centro inválido 134 Provincia del centro inválida 135 Municipio del centro inválido

136 No se puede realizar la inserción ya que la memoria se encuentra validado


137 Error en la inserción. Compruebe que no haya ni materias primas ni productos finales ni residuos generados duplicados

138 Perfil inválido para realizar la operación 139 Longitud de número de orden excedido 140 Longitud de características excedida 141 Longitud de firmado excedida

En caso de error y tratarse de una estructura de datos la información devuelta por el método, ésta aparecerá vacía


5_ Ejemplos

5.1_ Access.

Como se cita en los apartados anteriores, hemos utilizado la herramienta gratuita SOAP ToolKit de Microsoft http://msdn.microsoft.com/library/default.asp?url=/downloads/list/websrv.asp que contiene un asistente de generación de definiciones, documentación y ejemplos denominado Web Service References Tool, que permite realizar búsquedas de descripción, descubrimiento e integración (UDDI, Universal Description Discovery and Integration) de aquellos servicios registrados o abrir directamente su archivo de descripción. (WSDL, Web Services Description Language). Una vez instalada la herramienta SOAP ToolKit, para iniciar Web Service References Tool, haga clic en Web Service References del menú Herramientas en el Editor de Visual Basic de Access. Como hemos comentado anteriormente, la herramienta proporciona una interfaz que permite descubrir los servicios, seleccionar los deseados y crear clases que actúan como servidores proxy en sus proyectos VBA (Visual Basic para Aplicaciones).

En nuestro caso invocaremos directamente la descripción del servicio (WSDL) seleccione la opción Dirección URL y escriba:


http://calidadambiental.aragon.es/DCSWebService/WS_DCS_LN.asmx?wsdl A continuación presione el Botón Buscar(1), Deberá aparecer en la parte derecha de la pantalla el servicio y sus métodos(2). Si por ultimo optamos por la opción de Agregar( 3), se añadirá a nuestro proyecto la clase Proxy que hace referencia al servicio seleccionado.

Para utilizar los métodos de la clase de servidor proxy generada cree primero una instancia de dicha clase mediante la instrucción Set con la palabra clave New para asignar la clase a una variable. A continuación utilice la variable para ejecutar los métodos públicos de la clase, como vemos en el ejemplo de la función Ping_click:

Private Sub Ping_Click()

On Error GoTo Fallo_Ping: Set claseWS = New clsws_Service1 claseWS.wsm_Ping Comprobando = "La conexión es correcta." 'Inscripción que queda en pantalla. MsgBox "Conexión correcta.", vbInformation Exit Sub Fallo_Ping: Comprobando = "No hay conexión." 'Inscripción que queda en pantalla. MsgBox "No hay conexión.", vbExclamation

End Sub

Nótese en este punto, que en el caso de realizar cualquier llamada a los métodos de inserción de las distintas aplicaciones del departamento de medio ambiente, la codificación deberá coincidir con la existente en la aplicación, debiendo previamente "descargarse" todas las tablas de codificación.


El siguiente ejemplo, nos muestra como realizar la descarga de estas tablas de codificación a la aplicación local. Para ello, deberemos trabajar con el DOM (Document Object Model) implementado por Microsoft XML Parser. Este parser o analizador para XML es "el programa" que lee el documento XML y hace que los datos que contiene estén accesibles de forma ágil. El parser de Microsoft (msxml.dll), se distribuye a partir de la versión 5.5 de IExplorer permitiendo que los datos estén disponibles a través de una serie de objetos como el utilizado por nosotros MSXML2 . En el ejemplo siguiente mostramos la descarga de la Tabla con el Catálogo Europeo de Residuos CER.

Private Sub Descargar_DCS_Click()

On Error GoTo Fallo_Cer: 'nos autenticamos (user + pwd) If Not IsNull(Usuario) And Not IsNull(Clave) Then Set claseWS = New clsws_DCS If (claseWS.wsm_Autenticar(Usuario, Pwd) = "Correcto") Then Dim cmd1 As Command Dim strSQL As String Dim oFullNodeList As MSXML2.IXMLDOMNodeList Dim oFilteredNodeList As MSXML2.IXMLDOMNodeList Dim oNode As MSXML2.IXMLDOMNode Dim oNode2 As MSXML2.IXMLDOMNode Dim iRow As Integer Dim lcntRows As Integer Dim id, descripcion, peligroso As String Set oFullNodeList = claseWS.wsm_ListarLER Set oFilteredNodeList = _ oFullNodeList.Item(1).selectNodes("CerDataSet") Set xdd = New MSXML2.DOMDocument40 With xdd .async = False .preserveWhiteSpace = True .LoadXml oFullNodeList.Item(1).XML Set xdlRows = xdd.selectNodes("//CER") End With lcntRows = xdlRows.length - 1 DoCmd.SetWarnings False

'borramos el contenido actual DoCmd.RunSQL "DELETE * FROM SICA_DCS_CER" 'Se almacenan en la tabla de codigo CER For Each oNode In oFilteredNodeList For iRow = 0 To lcntRows id = oNode.childNodes.Item(iRow).selectSingleNode("ID").Text descripcion = oNode.childNodes.Item(iRow).selectSingleNode("DESCRIPCION").Text peligroso = oNode.childNodes.Item(iRow).selectSingleNode("PELIGROSO").Text DoCmd.RunSQL "INSERT INTO SICA_DCS_CER values('" & id & "','" & descripcion & "','" & peligroso & "')" Next Next DoCmd.SetWarnings True MsgBox "Recuperadas" & Str(lcntRows + 1) & " filas de la tabla de CÓDIGOS CER.", vbInformation DoCmd.OpenTable "SICA_DCS_CER" Else MsgBox "Error en el usuario o la clave.", vbExclamation End If End If

Fallo_Cer: MsgBox "Error." & Err.Description & " " & Err.Number, vbExclamation


End Sub

A continuación mostramos como invocar a un método que permite cambiar la password del usuario. El ejemplo es extensible a todas las funciones de inserción de datos.

Private Sub cambiar_pwd_Click()

On Error GoTo Err_chg

If Not IsNull(Usuario) And Not IsNull(Clave) Then Set claseWS = New clsws_Vehiculo If (claseWS.wsm_Autenticar(Usuario, Pwd) = "Correcto") Then MsgBox (claseWS.wsm_ModificarPassword(Usuario, Pwd, NewPWD)) Else MsgBox "Compruebe usuario y contraseña! " End If Else MsgBox "Indique usuario y clave.", vbExclamation End If

Exit Sub

Err_chg: MsgBox Err.Description Resume Exit_Comando14_Click

End Sub


5.2_ Axis - JAVA

Para poder utilizar un servicio Web desde Java se puede emplear el asistente de Eclipse, AXIS u otras herramientas. En concreto en este apartado se describe la opción de AXIS.

AXIS permite generar las clases cliente a un servicio Web de forma similar al asistente de Visual Studio .NET. Posee otras funcionalidades. Para más información acudir a los siguientes enlaces.

http://ws.apache.org/axis/

http://www.w3.org/TR/soap/

http://www.w3.org/TR/wsdl/

Para este ejemplo únicamente nos interesan las librerías de AXIS. En el package org.apache.axis.wsdl existe la clase WSDL2Java a la que se le pasa como argumento un fichero wsdl que contiene la definición de un servicio Web.

java org.apache.axis.wsdl.WSDL2Java fichero.wsdl

Esta llamada genera las distintas clases asociadas al servicio Web así como los métodos que llaman al servicio WEB. Estas clases podrán ser empleadas en el proyecto correspondiente.


5.3_ Infopath.

InfoPath 2003 es una nueva aplicación de Microsoft Office System que agiliza el proceso de recopilación de información al permitir a los equipos y las organizaciones crear y trabajar con avanzados formularios dinámicos de forma sencilla. La información recopilada se puede integrar con una amplia gama de procesos empresariales, ya que InfoPath admite esquemas XML (Lenguaje de marcado extensible) definidos por el cliente y se integra con los servicios Web XML. En consecuencia, InfoPath ayuda a conectar a los trabajadores de la información directamente con la información de la organización y les ofrece la posibilidad de actuar sobre ella, lo cual repercute positivamente en el negocio.

Para emplear los Servicios Web desde InfoPath 2003 se debe diseñar un formulario desde una conexión de datos. Esto lanza un asistente que permite crear una conexión a una base de datos o a un servicio Web. En el siguiente paso se debe indicar si se trata de una consulta de datos, un envío de datos o ambos. En el ejemplo expuesto se trata de un formulario únicamente de envío. La recepción de ciertos datos se configurará posteriormente.

El siguiente paso es indicar la localización del servicio web a emplear. En caso de duda se puede acudir al apartado de Servicios desde la página principal o buscar uno por medio de un servidor UDDI. Cuando se encuentre localizado el servicio Web se mostrarán todos los métodos disponibles en el mismo. Se debe seleccionar aquél que se desee emplear y darle un nombre. Una vez hecho aparece la ventana principal con una barra de tareas a la derecha. Una de las opciones es el origen de los datos. Si se presiona en dicha opción se mostrará la conexión recién creada con los campos que requiere el método. Si se hubieran creado más conexiones se podría emplear el desplegable para seleccionar la deseada.


Si se arrastra el nodo tns al formulario se generan automáticamente los campos y se asocian a los argumentos de la llamada. Una vez hecho se puede modificar la apariencia y añadir los controles que sean necesarios. Algunos campos requieren información de otros servicios. Para poder tener acceso a dichos métodos es necesario autenticarse previamente. Para ello hay que generar una nueva conexión al servicio Web que se ejecute al comienzo del formulario. También se pueden añadir los campos de autenticación al formulario y añadir un botón de refresco que realice la operación. Para ellos se debe acudir al menú de herramientas y seleccionar la opción de conexiones de datos. En la ventana que aparece a continuación se muestran las conexiones existentes. Se debe añadir una nueva siguiendo los pasos antes descritos. El Asistente ofrece la posibilidad de que dicha llamada se ejecute al cargar el formulario. De este modo se autentica al incio y se pueden realizar el resto de llamadas sin problemas. Este método necesita la definición de los valores para los argumentos. Se deben indicar el usuario y la contraseña que tiene asignada.

Por último se deben cargar el resto de datos con distintas llamadas. Para ello se debe actuar de manera similar. Una vez hecho se puede seleccionar uno de las controles existentes e indicarle que el origen de los datos es uno de los creados anteriormente. Para ello se debe acudir a las propiedades del control, modificar su tipo a las necesidades e indicar la conexión de la que recuperará la información. Ciertos campos permiten asignar un valor a uno de los parámetros y una descripción del valor mediante otro. Con todo esto se crearía un formulario de modo sencillo y rápido.

Otras opciones que permite InfoPath es realizar validaciones de los campos, ejecutar código según ciertos eventos, acceder a bases de datos, etc. con lo que la flexibilidad e integración de la información con otros sistemas es sencilla y rápida. Una vez terminado con el diseño se puede publicar en la Web, en un directorio, o en el sistema SharePoint de Microsoft.


5.4_ .NET C# es el nuevo lenguaje de programación de la plataforma .NET de Microsoft. .NET permite desarrollar en otros muchos lenguajes, como Visual Basic .NET, J#, Delphi .NET y otros. Como ejemplo se van a explicar unos pequeños pasos para utilizar un Servicio Web desde Visual Studio .NET, entorno de desarrollo de .NET. Como lenguaje de programación se emplea C#, aunque migrar a cualquier otro lenguaje es sencillo, ya que las clases que ofrece el .NET Framework son las mismas para los distintos lenguajes. El primer paso es crear un nuevo proyecto dentro del entorno para C#. Una vez creado se debe añadir la referencia Web. Para ello se deben seguir los siguientes pasos. Presionar sobre la opción Añadir Referencia Web dentro del menú Proyecto, o elegir la misma opción en el Explorador de la Solución, al presionar con el botón derecho del ratón sobre el proyecto. Seguir los pasos del asistente de modo similar al SOAP Toolkit explicado en apartados anteriores. Esto genera las clases cliente al Servicio Web dentro del proyecto. Con esto podemos invocar al servicio y a los distintos métodos que publica. Si en el asistente no se ha indicado ningún otro nombre, la clase se habrá creado con el nombre WS_DCS_LN dentro del Namespace Proyecto.es.aragon.calidadambiental de la solución para el servicio de la aplicación DCS. En el método que se encargue de llamar al servicio debemos añadir el siguiente código para poder llamar al servicio.

using Example.es.aragon.calidadambiental; namespace Proyecto { ... private void metodo () { resultado.Text = "Esperando Respuesta"; try { WS_DCS_LN servicio = new WS_DCS_LN(); servicio.CookieContainer = new System.Net.CookieContainer(); resultado.Text = servicio.Autenticar(login.Text, password.Text).ToString(); dataGrid.DataSource = servicio.ListarComunidadesAutonomas().Tables[0]; } catch (Exception exception) { resultado.Text = exception.Message; } } ... }


En el código anterior se recogen las comunidades autónomas dadas de alta en la aplicación y se muestran en un DataGrid. Para ello se siguen los siguientes pasos.

• resultado es un Label dentro del WinForm que muestra el estado actual de la llamada.

• dataGrid es una DataGrid dentro del WinForm que muestra los datos. • Antes de llamar al servicio al método de autenticación se crea un

almacén de cookies, ya que el servicio mantiene la sesión. En caso de no utilizar este almacén en la propiedad CookieContainer del servicio, el método ListarComunidadesAutonomas no funcionará correctamente y no devolverá la información. Esto es únicamente necesario en aplicaciones de tipo WinForm, ya que las aplicaciones ASP.NET mantienen las cookies por medio del navegador.

• Antes de poder llamar al método ListarComunidadesAutonomas es necesario autenticarse en el servicio. Para ello se le pasan como argumentos el login y la contraseña que se capturan por medio de dos variables de tipo TextBox dentro del WinForm.

servicios web calidad ambiental dcscalidadambiental.aragon.es/dcs/descargas/servicios_web... ·...

Documents