Conselleria de Medi Ambient, Aigua, Infraestructures i Territori

La Conselleria de Agricultura, Desarrollo Rural, Emergencia Climática y Transición Ecológica dispone de un sistema de servicios web para que los centros de residuos peligrosos puedan tramitar las NT y los DI para gestionar los traslados de dichos resudios de forma telemática. Estos servicios web se enmarcan dentro del proyecto de estandarización electrónica de datos ambientales propulsada por las comunidades autónomas y centralizada en el Ministerio para la Transición Ecológica y el Reto Demográfico a través de la plataforma ESIR. Concretamente, nuestros servicios web conforman una simplificación de los servicios web presentados en dicha plataforma, siendo la integración con el ministerio completa a la versión actual (3.3).

Las empresas realizan sus actividades en una o más ubicaciones determinadas. Cada ubicación en la que una empresa realiza su actividad se llama centro.

Cada centro gestor o productor de residuos peligrosos se identifica de forma unívoca por un número de 10 dígitos llamado NIMA (Número de Identificación Medioambiental)

Este número está formado en sus dos primeros dígitos por el código INE de la provincia donde esté ubicado el centro y luego 8 dígitos secuenciales. Por ejemplo, un centro de Valencia será del tipo 4600000003, de Alicante del tipo 0300000004 y de Castellón 1200000005.

Este número va unido al centro hasta que el centro cese su actividad o se cambie de baja. Si una empresa abre otro centro en otra ubicación, se le asignará otro NIMA a ese nuevo centro, y si una empresa da de baja su centro actual y abre un nuevo centro en otra ubicación, se le dará a ese nuevo centro un NIMA nuevo.

Por tanto, el NIMA va unido a la ubicación, cualquier cambio de ubicación supone un nuevo NIMA ya que evidentemente el centro es un centro distinto.

El NIMA es al centro lo que el NIF a la empresa, sólo que como una empresa puede tener muchos centros, un NIF tendrá asociados varios NIMAs, uno por cada centro.

El NIMA de un centro lo asigna la Comunidad Autónoma en la que esté ubicado el centro, no la Comunidad Autónoma donde la empresa tenga su sede social.

Los servicios web utilizan los certificados de las empresas a los que pertenecen los centros, por lo que para poder utilizarlos, lo primero que deberá hacer es obtener un certificado de empresa de los centros que vayan a participar. En el caso en el que se produzca una representación por parte de terceros, se deberá de dar de alta en el servicio de representantes https://www.accv.es/servicios/registro-de-representantes/. Esta representación puede ser tanto total, como parcial (17646 - TECG - Tramitación electrónica de los documentos asociados a los traslados de residuos).

La Conselleria de Agricultura, Desarrollo Rural, Emergencia Climática y Transición Ecológica tiene publicados los NIMAs de los centros en su página web https://residuos.gva.es/res_buscaweb/buscador_residuos_avanzado.aspx.

Si quiere hacer una consulta masiva de NIMAs puede hacerlo con el servicio web queryEnvironmentalMasterData.

Para invocar a los servicios web, antes hay que darle un número a cada documento DI y NT que se mande. Los servicios web esperan ese número en una codificación concreta. Ese número lo asignará habitualmente el sistema informático que invoque al servicio web y en algunos casos puede que el DI ya haya sido numerado previamente a la invocación al servicio web y entonces habrá que transformarlo a la codificación que esperan los servicios web. Ejemplos:

2.1. Numeración de NT:

Tipo de documento + Código de procedencia + NIMA + año + 7 dígitos

-Tipo de documento: NT

-Código de procedencia, varía según la autorización del centro que genera la documentación: Productor: 20, Gestor de Tratamiento, Negociante o Agente: 30, SRA: 50.

-NIMA: NIMA del centro que genera la documentación.

-Año: año en el que se presenta la documentación.

-7 dígitos: 7 dígitos, que actual a modo de contador

2.2. Numeración de DI parte A:

Tipo de documento + Código de procedencia + NIMA + año + 7 dígitos

-Tipo de documento: DI.

-Código de procedencia, varía según la autorización del centro que genera la documentación: Productor: 20, Gestor de Tratamiento, Negociante o Agente: 30, SRA: 50.

-NIMA: NIMA del centro que genera la documentación.

-Año: año en el que se presenta la documentación.

-7 dígitos: 7 dígitos, que actual a modo de contador . a su documento.

2.3. Si el DI o la NT han sido generados por la aplicación web ADCR 3.0, el número del DI ya vendrá dado y será del modo:

NT10 + 9999999999 + año + 7 dígitos secuenciales. Por ejemplo, NT10999999999920101234567

DCS10 + 9999999999 + año + 7 dígitos secuenciales. Por ejemplo, DCS10999999999920101234567

sendWasteNT: Se invoca antes de la recogida del residuo. Este servicio sirve para notificar al centro destino y a la comunidad autónoma donde reside del futuro traslado de residuo peligroso, para el caso en el que alguno de los dos deniegue el traslado. La Notificación de traslado se deberá realizar con un periodo de 10 días antes del comienzo de los traslados. Esta notificación podrá enviarse para informar de un traslado puntual o un traslado periódico, pero el total de kilos indicados en el documento no podrá ser superado por el total de kilos indicados en los DI de traslado que hagan referencia al documento. Durante los diez siguientes días, el centro o la Consellería podrá denegar el traslado.

La dirección de acceso es: https://residuos.gva.es/e3s/sendWasteNT.svc?wsdl


getWasteNTPDF: Se puede invocar una vez realizada el envio del documento NT mediante el servicio sendWasteNT con éxito. Este servicio sirve para obtener en PDF la representación de la NT enviada a través de los servicios web. La invocación requiere unicamente del código de NT enviado, y devolverán en formato hexadecimal el fichero integrado en el xml de respuesta. La NT unicamente la podrán recuperar aquellos centros que participan en el documento.

La dirección de acceso es: https://residuos.gva.es/e3s/getWasteNTPDF.svc?wsdl


queryWasteNT: Al igual que el servicio getWasteNTPDF, este servicio se puede invocar una vez realizada la presentación de la NT. Este servicio sirve para obtener el xml presentado, así como la información necesaria para asegurar que el documento es correcto (mediante la utilización del Código Seguro de Verificación (CSV)) que se proporciona en el momento de subir el documento. La invocación requiere unicamente del código de NT enviado, y devolverán el xml de respuesta. La NT unicamente la podrán recuperar aquellos centros que participan en el documento.

La dirección de acceso es: https://residuos.gva.es/e3s/queryWasteNT.svc?wsdl


checkWasteNT: Se invoca una vez realizada la presentación de la NT. Este servicio sirve para comprobar si durante el periodo de tiempo que existe entre el momento en el que se presenta la NT y el momento en el que se presenta el DI-A, la NT sigue estando vigente y activa, no ha sido rechazada por el Destinatario del residuo o por la Comunidad Autónoma donde se encuentra el Destinatario. La invocación requiere unicamente el código de la NT enviada, y devolverá como respuesta si sigue siendo válido, y en caso de que no lo sea, la razón de ello.

La dirección de acceso es: https://residuos.gva.es/e3s/checkWasteNT.svc?wsdl


sendWasteDCSA: Se invoca en el momento de la recogida del residuo. Este servicio sirve para indicar que el residuo comienza el traslado desde el centro remitente al centro destino. El DI-parte A se deberá realizar en el momento de la recogida y se deberá indicar los datos de identificación del residuo. Los datos del sendWasteDCSA que se puedan obtener de la NT asociada se obtendrán de ella, no siendo posible modificarlos, y en el caso de que sea necesario, el centro remitente deberá de realizar otra NT. El total de kilogramos de todos los DI asociados a una NT no podrán ser superior al total de kilogramos indicados en la NT, ya se haya realizado un único traslado, o el total de todos los traslados asociados a la NT.

La dirección de acceso es: https://residuos.gva.es/e3s/sendWasteDCSA.svc?wsdl


sendWasteDCSAB: Se invoca en el momento en el que el destinatario del residuo realiza la valoración de dicho residuo, y dispone de 30 días naturales desde la fecha de entrega. Este servicio sirve para indicar la aceptación o rechazo del residuo recibido por parte del destinatario. El DI-parte A+B se deberá realizar en el momento de la recogida y se deberá indicar los datos de identificación del residuo por parte del destinatario, además de los datos de aceptación. El resto de datos del sendWasteDCSAB que se puedan obtener del DI-parte A se obtendrán de dicho documento, no siendo posible modificarlos.

22:06/2021: El documento correspondiente al DI, parte A+B no requiere del envío del operador en su información. El operador será el que ha iniciado el traslado, y por lo tanto vendrá definido desde la NT.

La dirección de acceso es: https://residuos.gva.es/e3s/sendWasteDCSAB.svc?wsdl


getWasteDCSPDF: Se puede invocar una vez realizada el envio del documento DI, ya sea la parte A como la parte A+B mediante el servicio sendWasteDCSA o sendWasteDCSAB con éxito. Este servicio sirve para obtener en PDF la representación del DI enviado a través de los servicios web, y devolverá el DI en el estado que corresponda. La invocación requiere unicamente del código de DI enviado, y devolverán en formato hexadecimal el fichero integrado en el xml de respuesta. El DI unicamente lo podrán recuperar aquellos centros que participan en el documento.

La dirección de acceso es: https://residuos.gva.es/e3s/getWasteDCSPDF.svc?wsdl


queryWasteDCS: Al igual que el servicio getWasteDCSPDF, este servicio se puede invocar una vez realizada la presentación del DI. Este servicio sirve para obtener el xml presentado, así como la información necesaria para asegurar que el documento es correcto (mediante la utilización del Código Seguro de Verificación (CSV)) que se proporciona en el momento de subir el documento. La invocación requiere unicamente del código de DI enviado, y devolverán el xml de respuesta. El DI unicamente lo podrán recuperar aquellos centros que participan en el documento.

La dirección de acceso es: https://residuos.gva.es/e3s/queryWasteDCS.svc?wsdl


annulledWasteNT: Este servicio se puede invocar para anular una NT presentada anteriormente, siempre y cuando dicha NT no haya sido utilizada para presentar un DI. Para invocarlo, unicamente será necesario indicar la NT que se desea anular, y solo podrá anular una NT el usuario que haya realizado la presentación.

La dirección de acceso es: https://residuos.gva.es/e3s/annulledWasteNT.svc?wsdl


annulledWasteDCS: Este servicio se puede invocar para anular un DI presentado anteriormente, ya sea un DI parte A o un DI parte A+B. Para invocarlo, unicamente será necesario indicar el DI que se desea anular. Si el invocador es el remitente, se anulará el DI parte A siempre y cuando no se haya presentado un DI parte A+B asociado. Si el invocador es un destinatario, se anulará el DI parte A+B siempre y cuando no hayan pasado los 30 días desde la fecha de presentación.

La dirección de acceso es: https://residuos.gva.es/e3s/annulledWasteNT.svc?wsdl


queryEnvironmentalMasterData: Se invoca antes o después del traslado del residuo, es indiferente. Este servicio permite obtener información sobre otros centros, información útil para tramitar los DI y las NT, como por ejemplo el NIMA y las autorizaciones. Para especificar de qué centro se quiere obtener información habrá que aportar los siguientes datos:

  • CIF y Municipio: Con estos parámetros de búsqueda, el servicio web devolverá información sobre todos los centros que esa empresa tiene en ese municipio, indicando el NIMA, la dirección y las autorizaciones de cada centro obtenido.
  • CIF, Municipio y NIMA: Con estos parámetros de búsqueda, el servicio web devolverá información sobre el centro especificado, indicando la dirección y las autorizaciones.

Como parámetros de entrada este servicio recibe los parámetros de búsqueda CIF, Municipio y NIMA (este último es opcional), y como parámetros de salida devuelve la información de los centros encontrados en fichero XML.

La dirección de acceso es: https://residuos.gva.es/e3s/queryEnvironmentalMasterData.svc?wsdl


sendWasteAuthorizationDoc: Este servicio sirve para subir un Documento de Autorización entre el Operador del traslado y el Remitente del traslado.

Como parámetros de entrada, este servicio recibe los NIMAs de los centros Operador y Remitente, el Documento de Autorización en formato PDF y tamaño máximo 1MB y la información de representación (este último es opcional), y como parámetros de salida devuelve si el Documento de Autorización se ha registrado correctamente.

La dirección de acceso es: https://residuos.gva.es/e3s/sendWasteAuthorizationDoc.svc?wsdl

annulledWasteAuthorizationDoc: Este servicio sirve para anular un Documento de Autorización previamente presentado entre el Operador del traslado y el Remitente del traslado.

La dirección de acceso es: https://residuos.gva.es/e3s/annulledWasteAuthorizationDoc.svc?wsdl

checkWasteAuthorizationDoc: Este servicio sirve para comprobar si existe un Documento de Autorización entre el Operador del traslado y el Remitente del traslado.

Como parámetros de entrada, este servicio recibe los NIMAs de los centros Operador y Remitente y la información de representación (este último es opcional), y como parámetros de salida devuelve si el documento existe , no existe, o esta inactivo. En caso de existir o enconstrarse inactivo, se indican la fecha de inicio y fin del Docuemtno de Autorización.

La dirección de acceso es: https://residuos.gva.es/e3s/checkWasteAuthorizationDoc.svc?wsdl


Para realizar pruebas de conexión, y comprobar si tiene acceso los servicios web, podrá utilizar la herramienta SOAP-UI, que podrá descargar desde esta url: https://www.soapui.org/downloads/soapui/. Para realizar las pruebas, deberá de seguir los pasos descritos en el siguiente documento: Tutorial_de_SoapUI_para_Testeo_de_E3S.pdf, y cumplir las siguientes condiciones:

  • Disponer de un certificado digital proporcionado por la ACCV.
  • Disponer de un centro de pruebas proporcionado por el Servicio de Residuos (para realizar las pruebas). Este centro se deberá de asociar al certificado, por lo que al solicitarlo, deberá indicar el NIF de dicho certificado.

En la cabecera de los xml se piden dos elementos obligatorios:

Id_Trazabilidad: "ADCR_3.0"

Usuario: NIMA del centro desde el que se va a realizar la consulta, codificado en base64. Por ejemplo, el NIMA 4600008296 codificado en base64 será: “NDYwMDAwODI5Ng==”

En el caso de SOAP-UI, al recuperar el esquema xml de petición, lo muestra en un orden determinado. Es importante mantener el orden de las etiquetas del xml, ya que en caso contrario, el servicio detectaría que faltan elementos.

.NET (c#)

Para los proyectos de .Net (C#), hemos realizado la siguiente documentación: proyecto de ejemplo.

Java

Para los proyectos en Java, hemos realizado la siguiente documentación: guía de ayuda de integración / proyecto de ejemplo.

Esquemas de ejemplo

Como ejemplo para los desarrolladores, ponemos a disposición los esquemas que actualmente permitimos en los servicios web: esquema de servicios web para SOAP-UI

En este apartado se incluirán aquellas modificaciones que pueden requerir de actualización de los servicios a los que estén apuntando los sistemas clientes que hagan uso de ellos.

 ServicioFechaTitulo
12
Page size:
 12 items in 2 pages
getVFVUPDF 08/11/2023 Se añade el número de certificado a XML de respuesta
Múltiples 03/11/2023 Incorporación del campo CNAE en los centros involucrados de la NT.
checkWasteAuthorizationDoc 17/05/2023 checkWasteAuthorizationDoc
checkWasteNT 28/02/2023 Se resaltan los documentos cuyo proceso se ha completado
SendWasteAuthorizationDoc 20/01/2023 Se amplía a 1MB el tamaño máximo del documento PDF enviado al servicio
checkWasteNT 02/01/2023 Se modifica el objeto de respuesta del servico
sendWasteNT 21/12/2022 Obligatoriedad de Documento de Autorización para realizar una NT.
sendWasteDCSA 21/12/2022 No se pueden realizar DI parte A de NT presentada en e-SIR
sendWasteNT 07/11/2022 Se incluye la figura de Gestores de tratamiento final en la presentación de Notificaciones Prévias.
Múltiples 07/03/2022 Se incluyen en la respuesta el CSV del documento presentado.

En este apartado se encuentra la ayuda para aquellos desarrolladores que deseen implementar el acceso al servicio web de VFVU. A nivel general la conexión a dicho servicio funciona exáctamente igual que para el resto de los servicios de E3S, pero centrándose en el servicio web de VFVU. En este enlace podrás descargarte la ayuda específica para este caso, teniendo en cuenta que la siguiente información:

  • La url del servicio de VFVU es la siguiente: https://residuos.gva.es/e3s/getVFVUPDF.svc?wsdl
  • El archivo con toda la ayuda se puede descargar desde este enlace: Guía para desarrolladores para VFVU
  • Este archivo contienen la siguiente información:
    • Diferencias entre 2.0 y 3.0.odt: documento donde se explica las diferencias entre la versión de los servicios web 2.0 de VFVU y la versión 3.0
    • Guía para la llamada a los servicios de E3S y VFVU desde java.odt: documento que explica como comenzar la implementación de los servicios VFVU con java
    • Proyecto de ejemplo para .NET.rar
    • Proyecto de ejemplo para Java.rar
    • Tutorial de SoapUI para Testeo de VFVU con ejemplo xml.odt: documento para guiar al usuario a seguir unos pasos que le permitan comprobar mediante SOAP-UI el funcionamiento de los servicios web antes de su desarrollo

Durante el envío de pruebas, o durante el uso de los servicios web, la aplicación le informará del resultado o error mediante un código y una descripción. Indicamos aquí los códigos de respuesta que puede devolver la aplicación:

CodigoDescripcion
Page size:
 631 items in 22 pages
0000000001 Ejecución finalizada sin errores.
0000000002 NT activa.
0000000003 NT anulada con éxito.
0000000004 DCS anulado con éxito.
0000000005 Error de acceso a los servicios web.
0000000006 La petición no ha podido ser procesada por saturación del servidor. Inténtelo de nuevo dentro de unos minutos.
0000000007 La aplicación ha fallado.
0000000009 Ejecución finalizada con errores. No ha sido posible procesar todos los GDEs pendientes.
0000000010 La petición no ha podido ser procesada por saturación del servidor. Inténtelo de nuevo dentro de unos minutos.
0000000011 El servicio web está deshabilitado.
0000000012 No existe representación entre el centro y el nif indicado en el certificado.
0000000013 No existe representación entre el centro y el nif indicado en el certificado.
0000000014 No existe representación entre el centro y el nif indicado en el certificado.
0000000015 No existe representación entre el centro y el nif indicado en el certificado.
0000000016 No existe representación entre el centro y el nif indicado en el certificado.
0100000003 La firma digital especificada no coincide con la de la BD (el usuario no tiene acceso al nima especificado).
0100000004 Usuario bloqueado.
0100000006 Usuario sin permisos para operación solicitada en la presentación de NT.
0100000007 Usuario no aparece en documento indicado.
0100000008 Usuario sin permisos para operación solicitada en la presentación de DI.
0100000009 Error al comprobar los datos del poseedor.
0100000010 Error al acceder al documento del poseedor.
0100000011 Error al acceder al documento.
0100000012 Error al comprobar el acceso al documento.
0100000013 Error al comprobar el usuario.
0100000014 Error al validar el usuario.
0100000015 Error al firmar el documento.
0100000016 Error al acceder al servicio web de firma.
0100000017 Error al comprobar la firma.
0100000018 Error al validar la firma.