logo NextGenerationEU
logo Transformación
TRAZA
logo GVA
logo GVA Next
Vicepresidència Tercera i Conselleria de Medi Ambient, Infraestructures, Territori i de la Recuperació

La Vicepresidencia Tercera y Conselleria de Medio Ambiente, Infraestructuras, Territorio y de la Recuperación dispone de un sistema de servicios web para que los centros de residuos NO peligrosos puedan tramitar de forma telemática los Documentos de Identificación (DI) de los traslados de residuos.

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 ligado al centro hasta que cese su actividad o se tramite su 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 ligado a la ubicación. Cualquier cambio de ubicación supone un nuevo NIMA, ya que se trata de un centro distinto.

El NIMA es al centro lo que el NIF a la empresa, pero como una empresa puede tener muchos centros, un NIF tendrá asociados varios NIMA, 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 requiera de 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 Vicepresidencia Tercera y Conselleria de Medio Ambiente, Infraestructuras, Territorio y de la Recuperación publica los NIMA 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 asignar un número a cada documento DI que se presente. 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 cumpliendo los siguientes requisitos:

2.1. Numeración de DI parte A:

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

-Tipo de documento: TDCS

-Código de procedencia: 30

-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 actúa a modo de contador para su documento.

2.2. Si el DI ha sido generado por la plataforma TRAZA, el número del DI ya vendrá dado y será del modo:

TDCS10 + 9999999999 + año + 7 dígitos secuenciales. Por ejemplo, TDCS10999999999925101234567

sendWasteTDCSA: Se invoca en el momento de la recogida del residuo. Este servicio sirve para indicar que comienza el traslado del residuo desde el centro remitente al centro destino. El DI-parte A se deberá realizar en el momento de la recogida y se deberán indicar los datos del traslado.

La dirección de acceso es: https://residuos.gva.es/wstraza/sendWasteTDCSA.svc

La dirección de acceso para el modelo de TRAZA es: https://residuos.gva.es/wstraza/sendWasteTDCSA.svc?wsdl.


sendWasteTDCSAB: Se invoca en el momento en el que el destinatario del residuo realiza la valoración de dicho residuo para lo que 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 aceptación o rechazo y se deberá indicar los datos del traslado del residuo por parte del destinatario, además de los datos de aceptación. El resto de los datos requeridos se obtienen del DI-parte A, no siendo posible modificarlos.

La dirección de acceso es: https://residuos.gva.es/wstraza/sendWasteTDCSAB.svc

La dirección de acceso para el modelo de TRAZA es: https://residuos.gva.es/wstraza/sendWasteTDCSAB.svc?wsdl.


getWasteTDCSPDF: Se puede invocar una vez realizada con éxito la presentación del documento DI, ya sea la parte A o la parte A+B (mediante el servicio sendWasteTDCSA o sendWasteTDCSAB, respectivamente). Este servicio sirve para obtener en formato PDF la representación del DI presentado a través de los servicios web y devolverá el DI en el estado que corresponda. La invocación requiere del número de DI presentado y, opcionalmente, del tipo de documento que se solicita: DI-A o DI-AB (si no se informa este segundo parámetro, se obtiene el último documento presentado), y devolverá en formato hexadecimal el fichero integrado en el xml de respuesta. El DI únicamente lo podrán recuperar aquellos centros que participan en el documento.

La dirección de acceso es: https://residuos.gva.es/wstraza/getWasteTDCSPDF.svc


queryWasteTDCS: Al igual que el servicio getWasteTDCSPDF, este servicio se puede invocar una vez realizada la presentación con éxito 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 solo requiere del número del DI presentado y devolverá el xml de respuesta. El DI únicamente lo podrán recuperar aquellos centros que participan en el documento.

La dirección de acceso es: https://residuos.gva.es/wstraza/queryWasteDCS.svc


annulledWasteTDCS: Este servicio se puede invocar para anular un DI presentado anteriormente con éxito, ya sea un DI parte A o un DI parte A+B. Para invocarlo, únicamente será necesario indicar el número de 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 fin del traslado.

La dirección de acceso es: https://residuos.gva.es/wstraza/annulledWasteTDCS.svc

La dirección de acceso para el modelo de TRAZA es: https://residuos.gva.es/wstraza/annulledWasteTDCS.svc?wsdl.


getWasteTDCSRegistroEntrada: Se puede invocar una vez se haya realizado el envío del documento DI, ya sea la parte A como la parte A+B (mediante el servicio sendWasteTDCSA o sendWasteTDCSAB, respectivamente). Este servicio sirve para obtener en formato PDF el registro de entrada del DI enviado a través de los servicios web. La invocación requiere del número del DI enviado y, opcionalmente, del tipo de documento que se solicita: DI-A o DI-AB (si no se informa este segundo parámetro, se obtiene el último documento presentado), y devolverá en formato hexadecimal el fichero integrado en el xml de respuesta. El DI únicamente lo podrán recuperar aquellos centros que participan en el documento.

La dirección de acceso es: https://residuos.gva.es/wstraza/getWasteTDCSRegistroEntrada.svc

La dirección de acceso para el modelo de TRAZA es: https://residuos.gva.es/wstraza/getWasteTDCSRegistroEntrada.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, por ejemplo, el NIMA y las autorizaciones. Para especificar de qué centro se quiere obtener información, habrá que aportar los siguientes datos:

  • NIF 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.
  • NIF, 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 NIF, 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.


Para realizar pruebas de conexión y comprobar si tiene acceso a 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_y_WSTRAZA.pdf y cumplir las siguientes condiciones:

  • Disponer de un certificado digital.
  • 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 asociado a dicho certificado.
  • Para presentar documentos de prueba, debe asegurarse de que al menos uno de los centros implicados en el documento sea un centro de pruebas (ya sea el centro operador, el centro origen o el centro de destino).

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

Id_Trazabilidad: "WSTRAZA"

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á 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  / https://residuos.gva.esproyecto de ejemplo.

Esquemas de ejemplo

Como ejemplo para los desarrolladores, ponemos a disposición los esquemas que actualmente permitimos en los servicios web: esquema https://residuos.gva.esde servicios web para SOAP-UI

En este apartado se incluirán aquellas modificaciones que se realicen a lo largo del tiempo. Algunas de ellas, pueden implicar cambios en la integración que haya realizado.

 ServicioFechaTitulo
 
No s'han trobat registres amb els filtres introduïts

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
Mida de la pàgina
 Pàgina 1 de 11, registres 1 a 30 de 309
0000000001 Resultado correcto
0000000005 Error de acceso a los servicios web
0000000018 No ha indicado el NIMA en Base64 en la etiqueta usuario de la cabecera
0000000019 Ha habido un error a la hora de comprobar su certificado digital
0000110001 No está notificado el mail del centro Productor
0000110002 No está notificado el mail del centro Gestor
0000110003 No está notificado el mail del centro Operador
0000110004 El centro Productor no dispone de CNAE. Actualice dicha información en TRAZA para poder trabajar con este centro
0000110005 No está en el sistema el CNAE del centro Gestor
0000110006 No está en el sistema el CNAE del centro Operador
0000110007 El Productor no tiene el código LER entre sus autorizados
0000110008 El Gestor no tiene el código LER entre sus autorizados, deberá tenerlo en cuenta para futuras presentaciones
0000110009 No está en el sistema el CNAE del centro Transportista
0000120020 No se ha recibido el código para Documento de Aceptación
0000120021 El código para el Documento de Aceptación no tiene la estructura correcta
0000120022 El código para el Documento de Aceptación es mayor de 25 caracteres
0000130001 No está notificado el mail del centro Productor
0000130002 No está notificado el mail del centro Gestor
0000130003 No está notificado el mail del centro Operador
0000130004 El centro Productor no dispone de CNAE. Actualice dicha información en TRAZA para poder trabajar con este centro
0000130005 No está en el sistema el CNAE del centro Gestor
0000130006 No está en el sistema el CNAE del centro Operador
0000130007 El Productor no tiene el código LER entre sus autorizados y no se pudo dar de alta
0000130008 El Gestor no tiene el código LER entre sus autorizados, deberá tenerlo en cuenta para futuras presentaciones
0000130009 El DI (parte B) es regional, el centro Productor y Gestor deben de la CV y no los son
0000130010 El campo cantidad (ClearWeight) tiene un valor incorrecto, se establecerá como 0
0000130020 No se ha recibido el código para Documento de Aceptación
0000130021 El código para el Documento de Aceptación no tiene la estructura correcta
0000130022 El código para el Documento de Aceptación es mayor de 25 caracteres
0000130023 El residuo ha sido aceptado, pero se recibieron valores de rechazo el motivo(Refused) o la fecha (RefusedDate)