GUIA DE SERVICIOS ROHS - Agencia Tributaria

69
Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE. C/ Santa María Magdalena 16, 28016 Madrid GUIA DE SERVICIOS ROHS Intercambio de información entre Comercio y Aduanas mediante mensajes XML y funcionalidad de Punto Único de Entrada y servicios ROHS/RAEE Autor: S. G. A. A Fecha: 25/052022 Versión: 1.0 Revisiones Edic. Rev. Fecha Descripción A(*) Páginas 0 0.1 13/05/2020 Borrador. A Todas 1 0.3 07/07/2020 Versión 0.3 A Todas 2 0.6 28/09/2020 Version 0.6 A Todas 3 0.7 08/02/2021 Version 0.7 A Todas 4 0.8 12/03/2021 Version 0.8 A Todas 5 0.9 01/12/2021 Versión 0.9 A Todas 6 1.0 25/052022 Versión 1.0 A Todas (*) Acción: A = Añadir; R = Reemplazar

Transcript of GUIA DE SERVICIOS ROHS - Agencia Tributaria

Page 1: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria.

Subdirección General de Aplicaciones de Aduanas e II.EE. C/ Santa María Magdalena 16, 28016 Madrid

GUIA DE SERVICIOS ROHS

Intercambio de información entre Comercio y Aduanas mediante mensajes XML y funcionalidad de Punto Único de Entrada y servicios

ROHS/RAEE

Autor: S. G. A. A Fecha: 25/052022 Versión: 1.0

Revisiones

Edic. Rev. Fecha Descripción A(*) Páginas

0 0.1 13/05/2020 Borrador. A Todas

1 0.3 07/07/2020 Versión 0.3 A Todas

2 0.6 28/09/2020 Version 0.6 A Todas

3 0.7 08/02/2021 Version 0.7 A Todas

4 0.8 12/03/2021 Version 0.8 A Todas

5 0.9 01/12/2021 Versión 0.9 A Todas

6 1.0 25/052022 Versión 1.0 A Todas

(*) Acción: A = Añadir; R = Reemplazar

Page 2: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 2 de 69

Contenido

REVISIONES .......................................................................................................................................................... 1

1. CONTROL DE VERSIONES ...................................................................................................................... 8

1.1. Versión 0 .................................................................................................................................................. 8

2. INTRODUCCIÓN ........................................................................................................................................ 9

3. FLUJO DE INFORMACIÓN. .................................................................................................................... 11

3.1. Flujo Detallado. ...................................................................................................................................... 11

4. MODELO DE DIFUSIÓN DE LA INFORMACIÓN. .................................................................................. 15

4.1. Servicios web contemplados .................................................................................................................. 16

5. [ROHS-1]: SOLICITUD DEL OPERADOR DEL CERTIFICADO ROHS. .............................................. 17

5.1. Información del servicio. ........................................................................................................................ 17

5.2. Información de los datos. ....................................................................................................................... 18

5.3. Diagrama con los Elementos de información del mensaje de Entrada. ................................................... 20

5.4. Diagrama con los Elementos de información del mensaje de Respuesta. ............................................... 21

6. [ROHS-2]: SERVICIO DE ALTA DE SOLICITUD ROHS. ...................................................................... 21

6.1. Información del servicio. ........................................................................................................................ 22

6.2. Información de los datos. ....................................................................................................................... 23

6.3. Diagrama con los Elementos de información del mensaje de respuesta. ................................................ 23

7. [ROHS-3]: ENVÍO DE DATOS ADICIONALES DE LA SOLICITUD ROHS. ......................................... 24

7.1. Información del servicio. ........................................................................................................................ 24

7.2. Información de los datos. ....................................................................................................................... 25

7.3. Diagrama con los Elementos de información del mensaje de envío. ....................................................... 26

7.4. Diagrama con los Elementos de información del mensaje de respuesta. ................................................ 26

Page 3: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 3 de 69

8. [ROHS3B]: ENVIÓ DE DATOS ADICIONALES ROHS ESQUEMA SALIDA ....................................... 28

8.1. Información del servicio. ........................................................................................................................ 28

8.2. Información de los datos. ....................................................................................................................... 28

8.3. Diagrama con los Elementos de información del mensaje de respuesta. ................................................ 29

9. SERVICIO PUE-1: ENVÍO DE COMUNICACIÓN A OPERADOR Y/O PETICIÓN DE DOCUMENTACIÓN. .......................................................................................................................................... 30

9.1. INFORMACIÓN DEL SERVICIO. ............................................................................................................. 30

9.2. INFORMACIÓN DE LOS DATOS. ............................................................................................................ 31

9.3. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE ENVÍO. .................... 32

9.4. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE

RESPUESTA. ..................................................................................................................................................... 32

10. SERVICIO PUE-2: ENVÍO AL ORGANISMO DE DOCUMENTACIÓN REQUERIDA AL OPERADOR. ...................................................................................................................................................... 34

10.1. INFORMACIÓN DEL SERVICIO. ............................................................................................................. 34

10.2. INFORMACIÓN DE LOS DATOS. ........................................................................................................... 35

10.3. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE. ....................................... 36

11. SERVICIO PUE-3: ENVÍO DE COMUNICACIÓN DEL OPERADOR. ................................................... 37

11.1. INFORMACIÓN DEL SERVICIO. ............................................................................................................. 37

11.2. INFORMACIÓN DE LOS DATOS. ........................................................................................................... 38

11.3. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE ENVÍO. .................... 39

11.4. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE

RESPUESTA. ..................................................................................................................................................... 39

12. SERVICIO PUE-4: ENVÍO DE COMUNICACIÓN DEL OPERADOR AL ORGANISMO. ..................... 41

12.1. INFORMACIÓN DEL SERVICIO. ............................................................................................................. 41

12.2. INFORMACIÓN DE LOS DATOS. ........................................................................................................... 42

Page 4: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 4 de 69

12.3. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE. ....................................... 42

13. SERVICIO PUE-5: OBTENCIÓN LISTA CLAVES DE REGISTRO DE DOCUMENTACIÓN DE LA AEAT. ..................................................................................................................................................... 44

13.1. INFORMACIÓN DEL SERVICIO. ............................................................................................................. 44

13.2. INFORMACIÓN DE LOS DATOS. ........................................................................................................... 45

13.3. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE ENVÍO. .................... 46

13.4. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE

RESPUESTA. ..................................................................................................................................................... 47

14. SERVICIO PUE-6: OBTENCIÓN DOCUMENTO ANEXO. ..................................................................... 47

14.1. INFORMACIÓN DEL SERVICIO. ............................................................................................................. 48

14.2. INFORMACIÓN DE LOS DATOS. ........................................................................................................... 49

14.3. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE ENVÍO. .................... 50

14.4. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE

RESPUESTA. ..................................................................................................................................................... 50

15. SERVICIO PUE-7: SERVICIO WEB PARA EL ENVÍO DE DOCUMENTOS......................................... 52

15.1. INFORMACIÓN DEL SERVICIO. ............................................................................................................. 52

15.2. INFORMACIÓN DE LOS DATOS. ........................................................................................................... 53

15.3. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE ENVÍO ..................... 55

15.4. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE

RESPUESTA. ..................................................................................................................................................... 55

16. SERVICIO PUE-8: ANULACIÓN CERTIFICADOS. ................................................................................ 56

16.1. INFORMACIÓN DEL SERVICIO. ............................................................................................................. 56

LA FUNCIÓN DEL SERVICIO ES LA ANULACIÓN DE UN CERTIFICADO . ............................................... 56

16.2. INFORMACIÓN DE LOS DATOS. ........................................................................................................... 56

Page 5: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 5 de 69

16.3. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE ENVÍO. .................... 57

16.4. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE

RESPUESTA ...................................................................................................................................................... 58

17. SERVICIO PUE-9: EXPEDICIÓN CERTIFICADO GENÉRICO. ............................................................. 58

17.1. INFORMACIÓN DEL SERVICIO .............................................................................................................. 58

17.2. INFORMACIÓN DE LOS DATOS. ........................................................................................................... 59

17.3. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE ENVÍO. .................... 61

¡ERROR! MARCADOR NO DEFINIDO.

Page 6: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 6 de 69

17.4. DIAGRAMA CON LOS ELEMENTOS DE INFORMACIÓN DEL MENSAJE DE

RESPUESTA. ..................................................................................................................................................... 62

62

18. DEFINICIÓN DE TIPOS DE DATOS COMUNES A LOS SERVICIOS .................................................. 62

19. RECEPCIÓN DE MENSAJES DESDE EL BUZÓN “BANDEJA DE ENTRADA” ................................ 62

20. CONSULTAS Y HERRAMIENTAS .......................................................................................................... 63

20.1. CONSULTA DE MENSAJES ENVIADOS ............................................................................................... 63

20.2. CLIENTE EN SEDE ELECTRÓNICA ...................................................................................................... 64

21. INFORMACIÓN ANTICIPADA (IA) .......................................................................................................... 64

22. COMUNICACIÓN POR CORREO CON LOS OPERADORES. EJEMPLOS ........................................ 64

23. SERVICIO WEB ACTUAL DE COMERCIO ............................................................................................ 64

24. SISTEMA DE PRUEBAS ......................................................................................................................... 64

25. ESTÁNDARES Y CONSIDERACIONES DE DISEÑO............................................................................ 65

25.1. INTRODUCCIÓN ...................................................................................................................................... 65

25.2. ESTÁNDARES UTILIZADOS................................................................................................................... 65

Page 7: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 7 de 69

25.3. VERSIONADO .......................................................................................................................................... 66

25.4. ESTRUCTURA DE LOS MENSAJES ...................................................................................................... 66

25.5. INTEGRIDAD TRANSACCIONAL ........................................................................................................... 66 25.5.1. Funcionamiento del Identificador único del mensaje y su posible uso para el seguimiento de la subsanación de errores funcionales de la declaración. .......................................................................................... 66

25.6. RECOMENDACIONES ............................................................................................................................. 67

25.7. COMUNICACIÓN DE INCIDENCIAS EN EL PROCESADO DE LAS DECLARACIONES. ................. 67

26. INFORMACIÓN AMPLIADA .................................................................................................................... 68

26.1. FORMATO MRN ....................................................................................................................................... 68

26.2. REFERENCIA SOLICITUD EN LOS SERVICIOS PUE .......................................................................... 68

26.3. FORMATOS DUA, SUM Y SUA .............................................................................................................. 68

26.4. TIPOS INSPECCIÓN FÍSICA ................................................................................................................... 69

27. EJEMPLOS XML ...................................................................................................................................... 69

28. MENSAJES INTERCAMBIADOS ............................................................................................................ 69

29. ABREVIATURAS ...................................................................................................................................... 69

Page 8: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 8 de 69

1. Control de Versiones

1.1. Versión 0

Versión 0.0 Publicación de Borrador.

Page 9: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 9 de 69

2. Introducción La Agencia Tributaria y la Secretaría General de Comercio Exterior del Mº de Industria, Comercio y Turismo, (en adelante Comercio), se planteó la necesidad agilizar el sistema de control e importación de aquellos productos aduaneros que necesitan un certificado no aduanero previo a la importación. Para ello, se ha propuesto un sistema centralizado de gestión de los certificados no aduaneros, conocido como Punto Único de Entrada (PUE) El objetivo del proyecto, es conseguir las siguientes funcionalidades:

Comunicación con el Operador de la información relativa a los certificados ROHS, a través de la AEAT y el PUE de la Ventanilla Única Aduanera (VUA).

Reutilización de información de la declaración de Importación para la solicitud del ROHS.

Compartir la información en la AEAT de los ROHS expedidos por Comercio.

Controlar y gestionar la presentación de los ROHS en las declaraciones de Importación que los requieran.

Informar a Comercio de la gestión, uso y despacho de declaraciones de Importación con ROHS.

Gestionar la solicitud del certificado de partidas ROHS ESTACICE ROHS es una nueva plataforma que se implementa para la gestión de los controles a realizar por el Servicio de Inspección SOIVRE de la Secretaría de Estado de Comercio. Se enmarcan en el Real Decreto 219/2013 sobre restricciones a la utilización de determinadas sustancias peligrosas en aparatos eléctricos y electrónicos. (ROHS) y Real Decreto 110/2015 sobre residuos de aparatos eléctricos y electrónicos (RAEE). El sistema cerrará dos medidas: ROHS y RAEE, que se contestarán por separado. En el certificado actual de SOIVRE seguridad, también se incluirán las medidas referidas a ROHS y RAEE. los certificados ROHS se piden a través del PUE salvo en algunos casos que coinciden con seguridad que van por la vía de ESTACICE Industriales. Un certificado ROHS está relacionado con una y solo una partida de un DUA, cuya mercancía se ve afectada por una medida TARIC “Restricción del despacho a libre práctica”. Una partida de un DUA se puede asociar a un solo certificado ROHS. En un DUA habrá tantos ROHS como partidas tenga afectadas por la medida. Aduanas inicia el proceso de Solicitud del ROHS cuando detecta que la mercancía de una partida del DUA está afectada por la medida TARIC que necesita un certificado no aduanero. Se pondrá a disposición del operador un servicio para comenzar el alta de certificado ROHS. Anteriormente, estos certificados se obtenían, a través de una relación externa entre los Operadores y los SIF. Estos últimos aportaban el certificado a la aduana, antes de hacer el levante. En el caso de los certificados de SOIVRE, en la actualidad emplean el servicio web: “COMERCIO - Certificados SOIVRE: SEG (1310), CAL(N003), AGR(C644), ROS ().”. Con este nuevo servicio web, utilizando el PUE como base, se consigue una reutilización de los datos que posee la administración y se centraliza la solicitud de los certificados no aduaneros en un único punto de entrada.

Page 10: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 10 de 69

Además, se contempla la coordinación de este servicio, con los servicios aduaneros de importación, para que cualquier cambio, que se haga en la solicitud de importación y que este afectado por alguna de las medidas ROHS, sea adecuadamente coordinado con Comercio. En esta guía se han contemplado todos los servicios web que intervienen en el proceso de obtención del certificado, obteniendo una simplificación con respecto al anterior, ya que con un número mínimo de datos a aportar y sin necesidad de aportar aquella información que ya tiene la aduana (IA0, IA2, IA3) al SIF, es posible la obtención del Certificado ROHS. En el caso de DVD, y a espera a desarrollar un Pre DVD que aportará de forma automática (similar a los IA0, IA2, IA3) a Comercio los datos aduaneros, se va a facilitar aquella información necesaria para comercio y que posees la AEAT, a través de la Bandeja de Entrada.

Para desarrollar el proyecto se ha considerado importante definirlo bajo estándares que faciliten su desarrollo y que permitan una alta funcionalidad, para ello se propone utilizar servicios Web que permitirán una difusión de la información prácticamente en tiempo real. Dichos servicios cubrirán el intercambio de información bidireccional entre Comercio la AEAT y el Operador.

El objeto del este documento es describir este intercambio de información mediante servicios web y constituye la guía de usuario en cuanto al modo de utilización de los mensajes XML y el tratamiento de estos.

En el procedimiento informático se definen los mensajes de envío de la información y en su caso, el correspondiente mensaje de respuesta, que admitirá o rechazará el envío. La información a intercambiar entre Comercio y la AEAT se detalla más adelante.

Page 11: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 11 de 69

3. Flujo de información.

3.1. Flujo Detallado.

Page 12: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 12 de 69

Envío Solicitud ROHS

WS (ROHS 2)

Interroga buzón Bandeja Entrada

º

Interroga buzón Bandeja Entrada

WS (ROHS 3)

Envío Documentación Adicional

WS (PUE7)

Operador AEAT Organismo

Solicitud PDI, PDC, DUA, DVD ROHS (BE)

Proporciona Documentos [PUE-7]

Clave del registro de documentación de la AEAT.

Interroga Buzón Bandeja de Entrada

Comunicación a operador [ACK]

WS (PUE1)

Correo a operador [ACK]

01

Comunicación expedición certificado

Comunicación a operador

WS (PUE1)

Correo a operador (ACK)

10

WS (ROHS 1]

DATOS DECLARACIÓN

Correo Pendiente Datos Declaración

Envío Documentación Requerida

Envío Datos Declaración Requerida

WS (PUE2)

02

Comunicación a operador Correo a operador (ACK)

03 WS (PUE1)

Correo a operador (ACK) WS (PUE9)

Comunicación expedición certificado

10

Correo a OP de la solicitud datos y doc. adicional

WS (PUE1)

Sol. al OP de datos y doc. adicional

04WS (ROHS EXPEDICION)

DATOS ANEXOS

Envío Datos Adicionales

WS (ROHS 3)

(ACK)

(ACK)

Envío Declaración de Certificados

WS (PUE9)

WS (PUE7)

Page 13: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 13 de 69

Interroga buzón Bandeja Entrada

B.E.: Bandeja Entrada.

La comunicación se lleva a cabo mediante servicios web a través de la infraestructura de la AEAT “Bandeja de Entrada “, donde Aduanas deposita los mensajes y Comercio los recoge.

Envío Lista Anexos

WS (PUE2) DE CLAVES

Comunicación a operador WS (PUE1)

Correo a operador (ACK)

(ACK)

Comunicación expedición certificado

WS (PUE9)

Correo a operador (ACK)

Operador AEAT Organismo

05

10

Page 14: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 14 de 69

Estados Solicitud.

ESTADOS* MENSAJE

01 Solicitud Recibida

02 Pendiente Datos Declaración

03 Datos Declaración Recibidos

04 En Espera Datos Adicionales

05 En control

10 Expedición certificado

* Los estados hasta la versión definitiva son susceptibles de ser modificados.

En la etiqueta del servicio web PUE1 :

Se debe de indicar desde el Organismo, el estado al que avanzará la solicitud.

Page 15: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 15 de 69

4. Modelo de difusión de la información. El intercambio de información entre el Ministerio de Comercio y la AEAT se establece mediante servicios Web que definen las funciones:

1. Alta o Modificación de solicitud ROHS: la AEAT deposita mensajes en el buzón ‘Bandeja de Entrada’ con los datos de la necesarios para la solicitud.

2. Aceptación o Denegación de la Solicitud: una vez recibida la solicitud ROHS, Comercio mediante servicio web puede comunicar a la AEAT, que Deniega la Solicitud. La comunicación para la Aceptación es opcional: se asume esto si después se envía la expedición del Certificado.

3. Comunicaciones al Operador, Documentación adicional: mediante servicio web Comercio transmite a la AEAT las comunicaciones que considere oportunas, entre ellas la de solicitar de Documentación adicional. La AEAT mediante correo electrónico, transmite la comunicación al operador. Si se ha solicitado Documentación, el operador la aporta mediante servicio y la AEAT deposita en Bandeja de Entrada mensajes con los documentos aportados.

4. Comunicaciones del Operador a Comercio: mediante servicio web el Operador transmite a la AEAT las comunicaciones que considere oportunas, y la AEAT deposita en Bandeja de Entrada mensajes con las comunicaciones recibidas.

5. Expedición de Certificado ROHS: con un servicio web, Comercio comunica a la AEAT la Expedición de un Certificado ROHS, informando del Nº de Registro, si es Apto o No Apto, del día en que finaliza su vigencia, el PDF de Expedición del ROHS y texto para enviar por correo electrónico. Aduanas comunica esta información al Operador.

6. Modificación/Anulación datos de Expedición ROHS, Hay tres momentos clave para poder modificar un DUA respecto al estado de la solicitud:

Espera información de control.

En control

Estado “anulable / modificable”

7. Información de gestión aduanera: La AEAT mediante el buzón ‘Bandeja de Entrada’, proporciona información del uso de ROHS.

8. Consulta: La AEAT, mediante servicios web proporciona información del estado del certificado ROHS

Page 16: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 16 de 69

4.1. Servicios web contemplados

Servicios web ROHS

1. Solicitud del Operador del Certificado ROHS. (Operador a la AEAT)

2. Alta Solicitud ROHS [ PDI, PDC, DUA, DVD]. (Operador a la AEAT)

3. Envío de datos adicionales de la solicitud. (Operador a la AEAT)

4. Expedición del Certificado ROHS. (Organismo a la AEAT)

5. Consulta de estado Solicitud/Certificado. (Organismo/Operador a la AEAT)

6. Solicitud/anulación de partidas de la solicitud. (Operador a la AEAT)

7. Captura datos específicos DVD. (Organismo a la AEAT)

Servicios web PUE

1. PUE-1. Envío al Operador de Comunicación y/o Petición de Documentación (Organismo a la AEAT)

2. PUE-2. Envío al Organismo de Documentación Requerida previamente al Operador. (La AEAT a Organismo mediante BE).

3. PUE-3. Envío de Comunicación del Operador al Organismo no aduanero (Operador a la AEAT).

4. PUE-4. Envío de Comunicación del Operador al Organismo no aduanero (La AEAT a Organismo mediante BE)

5. PUE-5. Envío de Petición desde el Organismo de lista claves del registro de la documentación de la AEAT, los previos al despacho y/o los relacionados con determinada Autorización o Certificado. (Organismo a la AEAT).

6. PUE-6. Envío de Petición desde el Organismo de la imagen de un Documento anexo a una declaración. (Organismo a la AEAT).

7. PUE-7 Servicio para envió documentos.

8. PUE-8 Servicio web para envío de Control Físico. (Organismo a la AEAT).

Todos los servicios Web de la Agencia se encuentran publicados en la siguiente página: https://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/ws.html

Los servicios de ROHS se encuentran publicados bajo el encabezamiento:

“Comercio – ROHS”

Page 17: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 17 de 69

5. [ROHS-1]: Solicitud del Operador del Certificado ROHS.

Mensajes del servicio Nombre Descripción

ROHSSolicitudCertificadoV1Ent.xsd Mensaje con los datos que componen la petición mínima de solicitud para certificado ROHS

ROHSSolicitudCertificadoV1Sal.xsd Mensaje con los datos de respuesta de la petición mínima de solicitud para certificado ROHS

5.1. Información del servicio.

La función del servicio es solicitar un certificado ROHS, por parte del Operador.

Una vez realizada la presentación de la solicitud, en la ventanilla única aduanera (VUA). La AEAT, le informa de la necesidad o no de facilitar certificados no aduaneros. En el caso de que sea un certificado con las medidas ROHS/RAEE, el Operador utilizará este servicio web, para realizar la solicitud de ese Certificado. A través de este servicio, y aportando unos datos mínimos, el operador realizará la solicitud del certificado al SIF de SOIVRE. Estos datos mínimos aportados por el operador, junto a los e IA0, IA2, IA3 puestos a disposición en la bandeja de entrada del SIF SOIVRE, permitirán obtener el Certificado aduanero a través de un único punto único de entrada. La información necesaria para cumplimentar los mensajes descritos es la que se muestra en sus esquemas, se indica que información enviar y en qué condiciones.

Definición del Servicio. ROHSSolicitudCertificadoV1.wsdl

Esquema del mensaje de entrada. ROHSSolicitudCertificadoV1Ent.xsd

Esquema del mensaje de salida. ROHSSolicitudCertificadoV1Sal.xsd

Page 18: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 18 de 69

5.2. Información de los datos. Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje XML se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1:n) obligatorio, (0:n) opcional/condicionado.

Información de los datos del mensaje. Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio

Segmentos de servicio y operación del mensaje

- Identificador único del mensaje Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos de la Solicitud ROHS

Tipo de Operación TipoOperacion A 03 1:1 Tipo de Operación para ALTA(ALT) o Modificación(MOD) solicitud

Especificidades Especificidades A 02 1:1 Obligatorio

- Valor especificidades Valor A 02 1:N Obligatorio

ReferenciaDocucice ReferenciaDocucice A 20 0:1 Obligatorio en PDI, DVD, SUMARIA

TipoDocumento TipoDocumento A 04 1:1 Tipo Documento DUA o DVD

MRNPartida MRNPartida A 23 1:1

UnidadDeMedidaDeMercancia Unidad UnidadDeMedidaDeMercancia

A 20 1:1 Unidad mercancia

CantidadDeUnidadesDeMercancia CantidadDeUnidadesDeMercancia

A 20 1:1 cantidad

MRNPartidaPrecedente MRNPartidaPrecedente

A 23 0:1

IdSolSoivrePrecedente IdSolSoivrePrecedente

A 20 0:1 Id solicitud Soivre precedente

CodCice CodCice A 02 0:1 Codigo Cice

CodPI CodPI A 02 0:1 Codigo Puesto Inspeccionc

email email A 40 1:1

TipoDeclaracion TipoDeclaracion A 02 1:1

01· Expediente SOIVRE nuevo 02· Expediente relacionado con otro expediente SOIVRE 03· Mercancía en demora 04· Gestión de no conformidades 99· Otros

CertificadoSolicitadoROHS

CertificadoSolicitadoROHS

A 02 1:1 01·declaración normal 02·no procede la emisión del certificado. 03.consulta si procede

CertificadoSolicitadoRAEE CertificadoSolicitadoRAEE

A 02 1:1 01·declaración normal 02·no procede la emisión del certificado. 03.consulta si procede

CodigoRAEE CodigoRAEE A 06 0:1 Código RAEE

Page 19: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 19 de 69

Información de los datos del mensaje de respuesta de la AEAT. Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

- Numero de Solicitud NumeroSolicitud A 14 1:1 Numero identificación único generado por cada solicitud

MRNPartida MRNPartida A 23 1:1

Código de respuesta CodigoRespuesta A 04 1:1 0000 – envío aceptado Otro valor - envío No aceptado

Descripción de la Respuesta

DescripcionRespuesta A 250 1:1

Page 20: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 20 de 69

5.3. Diagrama con los Elementos de información del mensaje de Entrada.

Page 21: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 21 de 69

5.4. Diagrama con los Elementos de información del mensaje de Respuesta.

6. [ROHS-2]: Servicio de Alta de Solicitud ROHS.

Mensajes del servicio Nombre Descripción

ROHSsolicitudV1Sal.xsd Mensaje con los datos que componen la petición de solicitud que se deja en la BE

Page 22: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 22 de 69

6.1. Información del servicio.

La función del servicio es enviar a Comercio la solicitud de la petición del Certificado ROHS [ROHS-1] por parte del operador a Comercio.

Aduanas deposita mensajes en el buzón “Bandeja de Entrada” (BE) de la AEAT, con los datos básicos para tramitar una solicitud de certificado ROHS para un número de partida.

La comunicación se lleva a cabo mediante servicios Java a través de la infraestructura de la AEAT “Bandeja de Entrada “, donde Aduanas deposita los mensajes y Comercio los recoge.

La información necesaria para cumplimentar los mensajes descritos es la que se muestra en sus esquemas, se indica que información enviar y en qué condiciones.

Definición del Servicio. ROHSsolicitudV1.wsdl

Esquema del mensaje de salida. ROHSsolicitudV1Sal.xsd

Page 23: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 23 de 69

6.2. Información de los datos. Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje XML se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1:n) obligatorio, (0:n) opcional/condicionado. DUDAS

Información de los datos del mensaje. Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos de la Solicitud ROHS

Nif Nif A 17 1:1

Especificidades Especificidades A 02 1:1

- Valor Valor especificidades A 02 1:N

ReferenciaDocucice ReferenciaDocucice A 20 0:1

MRNPartida MRNPartida A 23 1:1

CodCice CodCice A 02

CodPi CodPi A 02

email email A 70

6.3. Diagrama con los Elementos de información del mensaje de respuesta.

Page 24: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 24 de 69

7. [ROHS-3]: Envío de datos adicionales de la solicitud ROHS.

Mensajes del servicio Nombre Descripción

ROHSEnvioDatosAdicionalesVxEnt Mensaje de envío datos adicionales por Operador/Comercio

ROHSEnvioDatosAdicionalesVxSal Respuesta de la Administración Tributaria

7.1. Información del servicio.

Remitente : Operador. Destinatario Intermedio : AEAT. Destinatario Final : Organismo no aduanero (SIF).

Si la Solicitud una vez recibidos los datos de la declaración necesarios, tras el análisis de riesgo, no llega a Certificado Verde sin Control (“Conforme” o “No procede”), deberá de aportar una serie de datos adicionales que serán solicitados por el SIF al Operador (utilizando el servicio web PUE-1)

A través de este servicio, el Operador aporta datos adicionales específicos del Certificado

El SIF, le comunicará al OP, la necesidad de aportar los datos adicionales utilizando el servicio web PUE-1

Definición del Servicio. SolicitudDatosAdicionalesROHSV1.wsdl

Esquema del mensaje de Petición. SolicitudDatosAdicionalesROHSV1Ent.xsd

Esquema del mensaje de Respuesta a la Petición. SolicitudDatosAdicionalesROHSV1Sal.xsd

Page 25: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 25 de 69

7.2. Información de los datos. Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje XML se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1:n) obligatorio, (0:n) opcional/condicionado.

Información de los datos del mensaje de envío.

Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos de respuesta de la Solicitud ROHS

MRNPartida MRNPartida A 23 1:1 Nº de referencia de la Importación consultada Formato MRN: AAESRRRRRRTANNNNNDPPPPP

Datos adicionales del Fabricante

NifFabricante Nif A 17 0:1

NombreFabricante NombreFabricante A 66 0:1

Localidad Localidad A 45 0:1

LocAdicionalMercancia LocAdicionalMercancia A 250 0:1

PaisFabricante PaisFabricante A 250 0:1

Marca Marca A 45 0:1

Modelo Modelo A 45 0:1

LoteMercancia LoteMercancia A 45 0:1

NumFactura NumFactura A 45 0:1

Page 26: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 26 de 69

Información de los datos del mensaje de la respuesta.

Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Código de respuesta CodigoRespuesta A 04 1:1 0000 – envío aceptado Otro valor - envío No aceptado

Descripción de la Respuesta

DescripcionRespuesta A 250 1:1

7.3. Diagrama con los Elementos de información del mensaje de envío.

7.4. Diagrama con los Elementos de información del mensaje de respuesta.

Page 27: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 27 de 69

Page 28: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 28 de 69

8. [ROHS3B]: Envió de datos adicionales ROHS esquema salida

8.1. Información del servicio.

La función del servicio es enviar a Comercio la solicitud de la petición de datos adicionales ROHS [ROHS-3] por parte del operador a Comercio.

Aduanas deposita mensajes en el buzón “Bandeja de Entrada” (BE) de la AEAT, con los datos adicionales para tramitar una solicitud de certificado ROHS para un número de partida.

La comunicación se lleva a cabo mediante servicios Java a través de la infraestructura de la AEAT “Bandeja de Entrada “, donde Aduanas deposita los mensajes y Comercio los recoge.

La información necesaria para cumplimentar los mensajes descritos es la que se muestra en sus esquemas, se indica que información enviar y en qué condiciones.

Definición del Servicio. ROHSsolicitudAdicionalesV1.wsdl

Esquema del mensaje de salida. ROHSsolicitudAdicionalesV1Sal.xsd

8.2. Información de los datos. Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje XML se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1:n) obligatorio, (0:n) opcional/condicionado.

Información de los datos del mensaje. Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos de respuesta de la Solicitud ROHS

MRNPartida MRNPartida A 23 1:1 Nº de referencia de la Importación consultada Formato MRN: AAESRRRRRRTANNNNNDPPPPP

Datos adicionales del Fabricante

NifFabricante Nif A 17 0:1

NombreFabricante NombreFabricante A 66 0:1

Localidad Localidad A 45 0:1

LocAdicionalMercancia

LocAdicionalMercancia A 250 0:1

Marca Marca A 45 0:1

Page 29: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 29 de 69

Modelo Modelo A 45 0:1

LoteMercancia LoteMercancia A 45 0:1

NumFactura NumFactura A 45 0:1

8.3. Diagrama con los Elementos de información del mensaje de respuesta.

Page 30: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 30 de 69

9. Servicio PUE-1: Envío de Comunicación a Operador y/o Petición de Documentación.

Remitente : Organismo no aduanero (SIF). Destinatario Intermedio : AEAT. Destinatario Final : Operador. Momento del mensaje por el remitente:

a) Cuando el SIF reclame nueva documentación al operador: tipo de mensaje = R. b) Cuando el SIF comunique al operador información textual: tipo de mensaje = O. c) Cuando el SIF evalúa la solicitud del certificado: tipo de mensaje = A, D, Z.

Notas: el mensaje de correo que remitirá la AEAT al operador será a la dirección de correo declarada en el mensaje de anexar documentación por parte del operador y previa a la solicitud al SIF [ROHS]. Para el caso de CITES la dirección de correo se tomará de la dirección primera de la declaración aduanera en caso de importación. Para exportación la dirección de correo se tomará del servicio específico para realizar la solicitud.

Mensajes del servicio Nombre Descripción

PUEmensajeAOperadorVxEnt Envío del mensaje de Petición de Documentación por el Organismo y otras comunicaciones

PUEmensajeAOperadorVxSal Respuesta de la AEAT

9.1. Información del servicio.

La función del servicio es el envío, desde el Organismo no aduanero a la AEAT, de la petición al Operador de Documentación adicional requerida para el certificado no aduanero en curso, o bien otro tipo de comunicación dirigida al operador (incluida la Aceptación/Denegación de solicitudes).

Posteriormente la AEAT trasladará esta comunicación al Operador vía correo electrónico.

La información necesaria para cumplimentar los mensajes descritos es la que se muestra en sus esquemas, se indica que información enviar y en qué condiciones.

Definición del Servicio. PUEmensajeAOperadorV1.wsdl

Esquema del mensaje de Petición. PUEmensajeAOperadorV1Ent.xsd

Esquema del mensaje de Respuesta a la Petición. PUEmensajeAOperadorV1Sal.xsd

Page 31: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 31 de 69

9.2. Información de los datos.

Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje XML se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1: n) obligatorio, (0: n) opcional/condicionado.

Información de los datos del mensaje de envío. Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

Debe ser único. Se sugiere utilizar TimeStamp del tipo AAAAMMDDHHMMSSNNNNNN, aunque puede ser cualquiera siempre que el operador garantice la unicidad.

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

- Indicador de Test Test A 01 0:1 No es obligatorio. Sólo admite el valor 'S'= Modo pruebas

Datos de Gestión

Tipo de solicitud o Certificado/ Autorización

DocuCertiAutoriz A 35 1:1

Valores posibles: XXXX – Documento de Organismo XXXX YYYY – Documento de Organismo XXXX ROHS – Documento de Comercio ROHS ECO-– Documento de Comercio ECO

Código solicitud o Certificado/ Autorización

ReferenciaSolicitud A 35 1:1 Ver información ampliada

Número de Referencia del DUA-partida de la Solicitud

ReferenciaDUA A 23 0:1 Formato MRN: Ver información ampliada

asunto asunto A 512 1:1 Asunto para correo operador

Tipo de Mensaje TipoMensaje A 02 1:1

Valores posibles: 01 – SOLICITUD_RECIBIDA 02 – PENDIENTE_DATOS_DECLARACION 03 – DATOS_DECLARACION_RECIBIDOS 04 – EN_ESPERA_DATOS_ADICIONALES 05 - EN_CONTROL 06 - ANULADO 10 – EXPEDIDO_CERTIFICADO

Mensaje Mensaje A 600 1:1 Mensaje a enviar por correo electrónico

ReferenciaCorreo. ReferenciaCorreo A 70 1:1 Correo electrónico de envio

Información de los datos de la respuesta.

Page 32: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 32 de 69

Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

- Indicador de Test Test A 01 0:1 No es obligatorio. Sólo admite el valor 'S'= Modo pruebas

Código de respuesta CodigoRespuesta A 04 1:1 0000 – envío aceptado Otro valor - envío No aceptado

Descripción de la Respuesta DescripcionRespuesta A 250 1:1

Nombre etiqueta relacionada con el error

EtiquetaError A 35 0:1

Valor de Etiqueta relacionada con el error

EtiquetaErrorValor A 600 0:1

9.3. Diagrama con los Elementos de información del mensaje de envío.

9.4. Diagrama con los Elementos de información del mensaje de respuesta.

Page 33: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 33 de 69

Page 34: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 34 de 69

10. Servicio PUE-2: Envío al Organismo de Documentación requerida al Operador.

Remitente : AEAT. Destinatario Final : Organismo no aduanero (SIF). Infraestructura utilizada comunicación AEAT-SIF: Bandeja de Entrada.

Momento del mensaje por el remitente: La AEAT irá depositando en la Bandeja de Entrada las claves del registro de la documentación de la AEAT que el organismo requirió al operador mediante [PUE-1] y éste envió mediante [PUE-7]. Serán recuperadas por el SIF mediante este servicio, “interroga Buzón – Bandeja de entrada”.

Mensajes del servicio Nombre Descripción

DetalleV4Ent.xsd Petición de mensaje de Documentación en Bandeja de Entrada

PUEdocuRequeVxSal Mensaje con Documentos aportados Requeridos por el Organismo no aduanero

10.1. Información del servicio.

La función del servicio es enviar al Organismo no aduanero los Documentos que ha requerido anteriormente al Operador. Se puede requerir más de una vez nueva documentación al operador.

La AEAT deposita mensajes en el buzón “Bandeja de Entrada” de la AEAT, la lista de las claves del registro de documentación de la AEAT.

La información necesaria para cumplimentar los mensajes descritos es la que se muestra en sus esquemas, se indica que información enviar y en qué condiciones. Para obtener los documentos digitalizados aportados por el Operador, el Organismo necesitará realizar un paso más: utilizará el servicio web “PUEdocumentoAnexoV1” [PUE-6] definido más adelante. Para obtener un documento tiene que proporcionar al servicio citado la referencia del documento, (etiqueta ‘referenciaDocumento’). Su valor se toma de la etiqueta ‘referenciaDocumento’ de este mensaje [PUE-2]

Definición del Servicio. PUEdocuRequeV1.wsdl

Esquema del mensaje de Petición. El servicio no tiene un esquema propio, se utiliza el estándar de la ‘Bandeja de Entrada’: DetalleV4Ent.xsd

Esquema del mensaje de Respuesta a la Petición. PUEdocuRequeV1Sal.xsd

Page 35: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 35 de 69

10.2. Información de los datos.

Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje XML se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1: n) obligatorio, (0: n) opcional/condicionado.

Información de los datos del mensaje. Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

- Indicador de Test Test A 01 0:1 No es obligatorio. Sólo admite el valor 'S'= Modo pruebas

Datos de Gestión

Carpeta del Expediente Electrónico donde están depositados los Documentos

Carpeta A 35 1:1

Valores posibles: DOVI – Documento de Comercio DOVI CITES – Documento de Comercio CITES ROHS – Documento de Comercio ROHS

Número de Referencia del DUA-partida de la Solicitud

ReferenciaDUApartida A 23 1:1

Formato AAESRRRRRRNNNNNNNNPPPPP compuesto de: Formato AAESRRRRRRNNNNNNNN compuesto de: AA(año de registro) + "ES"(país, siempre España) + RRRRRR (aduana) + NNNNNNNN (número) + PPPPP (nº de la partida)

Documentos proporcionados por el Operador que ha Requerido el Organismo como Documentos Adicionales

Documento digitalizado: Documento 1:99

- Descripción del documento descripcionDocumento A 35 1:1 Descripción del Operador

- Nº de referencia del documento

referenciaDocumento A 17 1:1 Código con el que Aduanas registra el Documento

Page 36: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 36 de 69

10.3. Diagrama con los Elementos de información del mensaje.

Page 37: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 37 de 69

11. Servicio PUE-3: Envío de Comunicación del Operador.

Remitente : Operador Destinatario Intermedio : AEAT. Destinatario Final : Organismo no aduanero (SIF). Infraestructura utilizada comunicación AEAT-SIF: Bandeja de Entrada con el siguiente servicio PUE-4.

Momento del mensaje por el remitente: El operador podrá comunicarse con el SIF mediante el envío de un mensaje de texto con este servicio web. Esta información es remitida a la AEAT para que con posterioridad (en [PUE-4]) lo deposite en la bandeja de Entrada de donde lo recuperará el SIF.

De forma paralela a este servicio web se dispone de trámite equivalente en Sede electrónica a través de formulario para el operador.

Mensajes del servicio Nombre Descripción

PUEmensajeDelOperadorVxEnt.xsd Mensaje con la comunicación del Operador a la AEAT

PUEmensajeDelOperadorVxSal.xsd Mensaje de Respuesta de la AEAT a Operador

11.1. Información del servicio.

La función del servicio es la de recibir comunicaciones del Operador relacionadas con una solicitud, Autorización/Certificado de un Organismo no aduanero.

Con este mensaje la AEAT recibe la comunicación, para posteriormente trasladarla al Organismo no aduanero, mediante un servicio de Bandeja de Entrada.

La información necesaria para cumplimentar los mensajes descritos es la que se muestra en sus esquemas, se indica que información enviar y en qué condiciones.

Definición del Servicio. PUEmensajeDelOperadorV1.wsdl

Esquema del mensaje de Petición. PUEmensajeDelOperadorV1Ent.xsd

Esquema del mensaje de Respuesta a la Petición. PUEmensajeDelOperadorV1Sal.xsd

Page 38: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 38 de 69

11.2. Información de los datos.

Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje XML se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1: n) obligatorio, (0: n) opcional/condicionado.

Información de los datos del mensaje de envío. Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

Debe ser único. Se sugiere utilizar TimeStamp del tipo AAAAMMDDHHMMSSNNNNNN, aunque puede ser cualquiera siempre que el operador garantice la unicidad.

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos de Gestión

Documento, Certificado o Autorización relacionado con la comunicación

DocuCertiAutoriz A 35 1:1 Valores posibles: CITES – Documento de Comercio CITES ROHS – Documento de Comercio ROHS

Número de Referencia del DUA-partida relacionado con el Documento, Certificado o Autorización

ReferenciaDUApartida A 23 1:1

Formato AAESRRRRRRNNNNNNNNPPPPP compuesto de: Formato AAESRRRRRRNNNNNNNN compuesto de: AA(año de registro) + "ES"(país, siempre España) + RRRRRR (aduana) + NNNNNNNN (número) + PPPPP (nº de la partida)

Mensaje Mensaje A 600 1:1 Mensaje a enviar al Organismo no aduanero

ReferenciaCorreo ReferenciaCorreo A 70

1:1 correo

Información de los datos de la respuesta. Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Código de respuesta CodigoRespuesta A 04 1:1 0000 – envío aceptado Otro valor - envío No aceptado

Descripción de la Respuesta

DescripcionRespuesta A 250 1:1

Page 39: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 39 de 69

11.3. Diagrama con los Elementos de información del mensaje de envío.

11.4. Diagrama con los Elementos de información del mensaje de respuesta.

Page 40: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 40 de 69

Page 41: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 41 de 69

12. Servicio PUE-4: Envío de Comunicación del Operador al Organismo.

Remitente : AEAT Destinatario Final : Organismo no aduanero (SIF). Infraestructura utilizada comunicación AEAT-SIF: Bandeja de Entrada.

Momento del mensaje por el remitente: La AEAT depositará en la Bandeja de Entrada las comunicaciones remitidas por el operador en [PUE-3] Posteriormente el SIF las recuperará interrogando al buzón de Entrada. La recuperación se efectúa con este mensaje [PUE-4]

Nombre Descripción

DetalleV4Ent.xsd Petición de mensaje de Comunicación en Bandeja de Entrada

PUEcomunicacionOperadorVxSal.xsd Mensaje con Comunicación del Operador al Organismo.

12.1. Información del servicio.

La función del servicio es la de enviar comunicaciones del Operador al Organismo no aduanero.

La AEAT ha recibido anteriormente la comunicación del Operador mediante [PUE-3]: y ahora la traslada al

Organismo, mediante el servicio de Bandeja de Entrada. La información necesaria para cumplimentar los mensajes descritos es la que se muestra en sus esquemas, se indica que información enviar y en qué condiciones.

Definición del Servicio. PUEcomunicacionOperadorV1.wsdl

Esquema del mensaje de Petición. El servicio no tiene un esquema propio, se utiliza el estándar de la ‘Bandeja de Entrada’: DetalleV4Ent.xsd

Esquema del mensaje de Respuesta a la Petición. PUEcomunicacionOperadorV1Sal.xsd

Page 42: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 42 de 69

12.2. Información de los datos.

Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje XML se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1: n) obligatorio, (0: n) opcional/condicionado.

Información de los datos del mensaje de Respuesta en Bandeja Entrada Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

Debe ser único. Se sugiere utilizar TimeStamp del tipo AAAAMMDDHHMMSSNNNNNN, aunque puede ser cualquiera siempre que el operador garantice la unicidad.

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD.

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos de Gestión

Documento, Certificado o Autorización relacionado con la comunicación

DocuCertiAutoriz A 35 1:1 Valores posibles: CITES – Documento de Comercio CITES ROHS – Documento de Comercio ROHS

ReferenciaSolicitud ReferenciaSolicitud A 35 1:1 ReferenciaSolicitud

Número de Referencia del DUA-partida relacionado con el Documento, Certificado o Autorización

ReferenciaDUApartida A 23 1:1

Formato AAESRRRRRRNNNNNNNNPPPPP compuesto de: Formato AAESRRRRRRNNNNNNNN compuesto de: AA(año de registro) + "ES"(país, siempre España) + RRRRRR (aduana) + NNNNNNNN (número) + PPPPP (nº de la partida).

Mensaje Mensaje A 600 1:1 Mensaje a enviar al Organismo no aduanero.

Referencia/asunto Mensaje ReferenciaCorreo A 35 1:1 Referencia del correo que envió el Operador.

12.3. Diagrama con los Elementos de información del mensaje.

Page 43: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 43 de 69

Page 44: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 44 de 69

13. Servicio PUE-5: Obtención Lista claves de registro de documentación de la AEAT.

Remitente : AEAT Destinatario Final : Organismo no aduanero (SIF).

La AEAT responderá de forma síncrona a esta petición de lista de claves. Por último, el SIF recuperará el documento digitalizado utilizando la clave de documentación de la AEAT por medio del mensaje [PUE-6]

Mensajes del servicio Nombre Descripción

PUElistaDocAnexosVxEnt.xsd Mensaje con la petición del Organismo a la AEAT

PUElistaDocAnexosVxSal.xsd Mensaje de Respuesta de la AEAT a Organismo

13.1. Información del servicio.

La función del servicio es la de proporcionar la lista de las claves de registro de documentación de la AEAT, bien sea de documentación previa al despacho y/o los relacionados con determinada Autorización o Certificado de un Organismo no aduanero.

La lista está formada por la descripción y número de referencia de cada uno de los anexos.

Definición del Servicio. PUElistaDocAnexosV1.wsdl

Esquema del mensaje de Petición. PUElistaDocAnexosV1Ent.xsd

Esquema del mensaje de Respuesta a la Petición. PUElistaDocAnexosV1Sal.xsd

Page 45: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 45 de 69

13.2. Información de los datos.

Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje XML se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1: n) obligatorio, (0: n) opcional/condicionado.

Información de los datos del mensaje de envío. Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

Debe ser único. Se sugiere utilizar TimeStamp del tipo AAAAMMDDHHMMSSNNNNNN, aunque puede ser cualquiera siempre que el operador garantice la unicidad.

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos Documentación solicitada

Proyecto Proyecto A 35 0:1 Valores posibles: ECO – Documento de Comercio ECO ROHS – Documento de Comercio ROHS

Número de Referencia del DUA-partida relacionado

ReferenciaDua A 23 1:1

Formatos posibles: MRN: AAESRRRRRRNNNNNNNN compuesto de: Formato AAESRRRRRRNNNNNNNN compuesto de: AA(año de registro) + "ES"(país, siempre España) + RRRRRR (aduana) + NNNNNNNN (número)

Información de los datos de la respuesta. Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio 1:1 Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos de Gestión

Código de respuesta CodigoRespuesta A 04 1:1 0000 – envío aceptado Otro valor - envío No aceptado

Page 46: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 46 de 69

Descripción de la Respuesta DescripcionRespuesta A 250 1:1

Certificado o Autorización relacionado con la Documentación solicitada

Proyecto A 35 0:1 ECO – Documento de Comercio ECO ROHS – Documento de Comercio ROHS

Número de Referencia del DUA-partida relacionado

ReferenciaDua A 23 1:1

Formatos posibles: MRN: AAESRRRRRRNNNNNNNN MRN compuesto de: Formato AAESRRRRRRNNNNNNNN compuesto de: AA(año de registro) + "ES"(país, siempre España) + RRRRRR (aduana) + NNNNNNNN (número

Número Documentos NumDocumentos N 02 0:1 Numero de Documentos Proyecto

Documentos Digitalizados

- Descripción del documento descripcionDocumento A 35 1:1 Descripción del Operador

- referenciaDocumento referenciaDocumento A 17 1:1 Código con el que Aduanas registra el Documento

- Descripción del documento descripcionDocumento A 35 1:1 Descripción del Operador

13.3. Diagrama con los Elementos de información del mensaje de envío.

Page 47: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 47 de 69

13.4. Diagrama con los Elementos de información del mensaje de respuesta.

14. Servicio PUE-6: Obtención Documento anexo.

Remitente : AEAT Destinatario Final : Organismo no aduanero (SIF). Momento del mensaje por el remitente:

La AEAT responderá de forma síncrona a una petición de documento digitalizado en función de la clave del registro de documentación en la AEAT.

Mensajes del servicio Nombre Descripción

PUEdocumentoAnexoVxEnt.xsd Mensaje con la petición del Organismo a la AEAT de un Documento

Page 48: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 48 de 69

PUEdocumentoAnexoVxSal.xsd Mensaje de Respuesta de la AEAT al Organismo con el Documento

14.1. Información del servicio.

La función del servicio es la de proporcionar el Documento digitalizado solicitado, anexo a una declaración utilizando la clave de documentación de la AEAT.

Definición del Servicio. PUEdocumentoAnexoV1.wsdl

Esquema del mensaje de Petición. PUEdocumentoAnexoV1Ent.xsd

Esquema del mensaje de Respuesta a la Petición. PUEdocumentoAnexoV1Sal.xsd

Page 49: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 49 de 69

14.2. Información de los datos.

Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje XML se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1: n) obligatorio, (0: n) opcional/condicionado.

Información de los datos del mensaje de envío. Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

Debe ser único. Se sugiere utilizar TimeStamp del tipo AAAAMMDDHHMMSSNNNNNN, aunque puede ser cualquiera siempre que el operador garantice la unicidad.

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos Documentación solicitada

Nº de referencia del documento

referenciaDocumento A 17 1:1 Clave del registro de documentación de la AEAT.

Información de los datos de la respuesta.

Descripción Etiqueta xml T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos de Gestión

Código de respuesta CodigoRespuesta A 04 1:1 0000 – envío aceptado Otro valor - envío No aceptado

Descripción de la Respuesta DescripcionRespuesta A 250 1:1

Documento Digitalizado

Documento Anexo documentoAnexo 0:1 Documento Anexo

Descripción del documento descripcionDocumento A 35 1:1 Descripción del Operador

Referencia del documento referenciaDocumento A 17 1:1 Referencia del documento

Imagen Documento imagenDocumento 1:1 Imagen del documento en base64Binary

Page 50: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 50 de 69

Extensión del Documento extensionDocumento A 4 1:1

Extensiones disponibles: DOC - Documento Microsoft Word DOCX - Documento Microsoft Word GIF - Imagen GIF JPEG - Imagen JPEG JPG - Imagen JPG PDF - Documento PDF RTF - Rich Text Format TIF - Tagged Image File Format TIFF - Tagged Image File Format TXT - Documento TXT XLS - Hoja de cálculo Microsoft XLSX - Hoja de cálculo Microsoft ZIP - Archivo comprimido ZIP 7Z - Archivo comprimido 7Z

Tipo de documento tipoDocumento A 20 1:1

FACTU – Factura

JPAGO - Justificante de Pago.

DTPTE – Documento Transporte

CERTIFICADO - Certificado

DTECN – Documentación Técnica

COMPR - Compromisos u otras cartas

operador

OTROS- Otros

14.3. Diagrama con los Elementos de información del mensaje de envío.

14.4. Diagrama con los Elementos de información del mensaje de respuesta.

Page 51: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 51 de 69

Page 52: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 52 de 69

15. Servicio PUE-7: Servicio web para el envío de Documentos.

Remitente : Operador Destinatario Intermedio : AEAT. Destinatario Final : Organismo no aduanero (SIF) / AEAT.

Momento del mensaje por el remitente:

El operador envía documentos que le han sido requeridos para anexar a una determinada Solicitud de un organismo no aduanero mediante [PUE-1]. Lo hará mediante la opción "01 Documentación para Solicitud de Documentos No Aduaneros” Una vez recibidos los documentos, la AEAT los registra, proporcionando las claves correspondientes al organismo mediante [PUE-2] a través de Bandeja de Entrada. El envío de documentos por parte del operador, también responde a la necesidad de anexar documentación específica para la aduana para declaraciones aduaneras (dúa de importación, dúas de importación con valor especifico hasta 150 €, etc.): para esta última se usará la opción “02 Importación. Documentación Previa al despacho”.

De forma paralela a este servicio web se dispone de trámite equivalente en Sede electrónica a través de formulario para el operador.

Mensajes del servicio Nombre Descripción

PUEenvioDocumentoVxEnt Envío del mensaje con un documento digitalizado.

PUEenvioDocumentoVxSal Respuesta de la Administración Tributaria

15.1. Información del servicio.

El objeto de este servicio es aportar los documentos requeridos por determinadas operaciones administrativas. En el mensaje de envío se indica la Operación a la que se remite el documento, el documento digitalizado y, si es el caso, la información adicional que requiera la Operación. Se pueden realizar varios envíos para una misma Operación, hasta completar todos los requeridos. Y será el operador el que indique en la etiqueta “Solicitud” si da por finalizado el envío de todo lo requerido. Está autorizado el operador o un tercero que esté apoderado a realizar dicho trámite.

Definición del Servicio. PUEenvioDocumentoV1.wsdl

Esquema del mensaje de Envío. PUEenvioDocumentoV1Ent.xsd

Esquema del mensaje de Respuesta al envío.

Page 53: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 53 de 69

PUEenvioDocumentoV1Sal.xsd

Las operaciones disponibles y los datos adicionales particulares de cada operación se describen en este documento y en las tablas auxiliares AASWOPER y AASWETAD, disponibles en:

Sede Electrónica - Agencia Tributaria: > Inicio > Todos los trámites > Aduanas > Otros procedimientos y servicios aduaneros > Consultas Tablas códigos. > Tablas auxiliares

15.2. Información de los datos.

Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje XML se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1:n) obligatorio, (0:n) opcional/condicionado.

Información de los datos del envío.

Descripción Etiqueta XML T L.M

. Veces Valores / Condiciones / Reglas

Datos comunes a todas las Operaciones

SegmentosDeServicio: SegmentosDeServicio

- Identificador único del mensaje

Id A 40 1:1

Debe ser único. Se sugiere utilizar TimeStamp del tipo AAAAMMDDHHMMSSNNNNNN, aunque puede ser cualquiera mientras que la Administración origen garantice la unicidad.

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Código de la Operación que requiere la documentación

Operacion A 02 1:1

Operaciones disponibles: 01 - Documentación para Solicitud de

Documentos No Aduaneros. 02 - Importación. Documentación Previa al despacho 03 - Importación. Documentación para declaración complementaria por falta de documentos.

Documento digitalizado: DocumentoAnexo 1:1

- Descripción del documento descripcionDocumento A 35 1:1

- Imagen del Documento imagenDocumento 1:1 Imagen del documento en base64Binary

Page 54: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 54 de 69

- Extensión del Documento extensionDocumento A 4 1:1

Extensiones disponibles: DOC - Documento Microsoft Word DOCX - Documento Microsoft Word GIF - Imagen GIF JPEG - Imagen JPEG JPG - Imagen JPG PDF - Documento PDF RTF - Rich Text Format TIF - Tagged Image File Format TIFF - Tagged Image File Format TXT - Documento TXT XLS - Hoja de cálculo Microsoft XLSX - Hoja de cálculo Microsoft ZIP - Archivo comprimido ZIP 7Z - Archivo comprimido 7Z

- Tipo de documento tipoDocumento A 5 1:1

FACTU – Factura JPAGO - Justificante de Pago. CERTIFICADO - certificado DTPTE – Documento Transporte DTECN – Documentación Técnica COMPR-Compromisos u otras cartas operador OTROS- Otros

Referencia del DUA-Partida DocuCertiAutoriz A 40 1:1

Siglas proyecto

Referencia del DUA ReferenciaDuaPartida A 23 1:1 ”ReferenciaDuaPartida”

ReferenciaDua ReferenciaDua A 18 1:1 ReferenciaDua

Page 55: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 55 de 69

15.3. Diagrama con los Elementos de información del mensaje de envío

15.4. Diagrama con los Elementos de información del mensaje de respuesta.

Page 56: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 56 de 69

16. Servicio Pue-8: Anulación Certificados.

Mensajes del servicio Nombre Descripción

PUEAnulacionCertificadoV1Ent.xsd Mensaje con la petición del Organismo a Aduanas de anulación de certificado

PUEAnulacionCertificadoV1Sal.xsd Mensaje de Respuesta de Aduanas al Organismo con la respuesta de la anulación

16.1. Información del servicio.

La función del servicio es la anulación de un certificado .

Definición del Servicio. PUEAnulacionCertificadoV1.wsdl

Esquema del mensaje de Petición. PUEAnulacionCertificadoV1Ent.xsd

Esquema del mensaje de Respuesta a la Petición. PUEAnulacionCertificadoV1Sal.xsd

16.2. Información de los datos.

Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje xml se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1: n) obligatorio, (0: n) opcional/condicionado.

Información de los datos del mensaje de envío.

Descripción Etiqueta xml T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

Page 57: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 57 de 69

- Identificador único del mensaje

Id A 40 1:1

Debe ser único. Se sugiere utilizar TimeStamp del tipo AAAAMMDDHHMMSSNNNNNN, aunque puede ser cualquiera siempre que el operador garantice la unicidad.

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos solicitados

TipoCertificado TipoCertificado A 10 1:1 Código del certificado a anular

NumeroCertificado NumeroCertificado A 35 1:1 Numero certificado

Información de los datos de la respuesta.

Descripción Etiqueta xml T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Datos de Gestión

Código de respuesta CodigoRespuesta A 04 1:1 0000 – envío aceptado Otro valor - envío No aceptado

Descripción de la Respuesta DescripcionRespuesta A 250 1:1

16.3. Diagrama con los Elementos de información del mensaje de envío.

Page 58: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 58 de 69

16.4. Diagrama con los Elementos de información del mensaje de respuesta

17. Servicio PUE-9: Expedición certificado genérico.

Mensajes del servicio Nombre Descripción

ExpCertificadoPUEV1Ent.xsd Mensaje con la petición del Organismo a Aduanas de anulación de certificado

ExpCertificadoPUEV1Sal.xsd Mensaje de Respuesta de Aduanas al Organismo con la respuesta de la anulación

17.1. Información del servicio

La función del servicio es la de emitir un certificado .

Definición del Servicio.

ExpCertificadoPUEV1.wsdl

Esquema del mensaje de Petición.

ExpCertificadoPUEV1Ent.xsd

Esquema del mensaje de Respuesta a la Petición.

ExpCertificadoPUEV1Sal.xsd

Page 59: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 59 de 69

17.2. Información de los datos.

Definiciones de las tablas Estructura del mensaje. Cada fila representa un Grupo o un Elemento de datos. La descripción de los grupos de elementos aparece en cursiva. La secuencia de los datos en el mensaje xml se corresponde al orden en el que se muestran las filas. T Tipo de los datos: A (alfanumérico), N (número entero) y D (número decimal). L.M. Longitud máxima. Veces Mínimo y Máximo número de repeticiones del dato. Indica obligación; (1: n) obligatorio, (0: n) opcional/condicionado.

Información de los datos del mensaje de envío.

Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

Debe ser único. Se sugiere utilizar TimeStamp del tipo AAAAMMDDHHMMSSNNNNNN, aunque puede ser cualquiera siempre que el operador garantice la unicidad.

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Tipo de Certificado TipoCertificado A 10 1:1 Tipo de certificado (1230-C644) ROHS-ECO

Tipo de Operación TipoOperacion A 03 1:1 Tipo de Operación para ALTA(ALT), Modificación(MOD) de expedición certificado, VALIDACION(VAL)

Identificación Solicitud SOIVRE

IdSolSOIVRE A 20 1:1 Identificador de la solicitud por SOIVRE

Nº de identificación del Importador

ImportadorNID A 17 1:1 Código del NIF o Número de identificación de la persona Física o Jurídica Casilla 8 del DUA

Nombre del Importador ImportadorNombre A 70 1:1 Nombre o Razón social de la persona a identificar Casilla 8 del DUA

País de Origen PaisOrigen A 02 1:1 Código del País de Origen de la mercancía Casilla 34 del DUA

Destino Final Mercancía DestinoFinalMercancia A 02 0:1 Código identificativo del destino final de mercancía se introduce siempre que vaya un NO APTO

Causa No Procede CausaNoProcede A 512 0:N Descripción del motivo por el cual no procede , se introduce siempre que vaya un NO PROCEDE.

TipoDocumentoPrecedente TipoDocumentoPrecedente A 4 1:1 DUA,SUA(sumaria Aerea),SUM(Sumara Terrestre),DVD

Documento Aduanero DocAduanero A 39 1:1

DUA: formato MRN: AAESRRRRRRTANNNNND Nº de Declaración sumaria Marítima o Terrestre: RRRRANNNNNN (RRRR: recinto + A: Año + NNNNNN: nº de sumaria) Documento DVD DVDRRRRAAAANNNNNNPPP

Documento aduanero precedente

DocAduaneroPrecedente A 23 0:1

DUA: formato MRN: AAESRRRRRRTANNNNND Nº de Declaración sumaria Marítima o Terrestre: RRRRANNNNNNPPPPP (RRRR: recinto + A: Año + NNNNNN: nº de sumaria + PPPPP: Nº de la partida) Documento DVD DVDRRRRAAAANNNNNNPPP

Page 60: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 60 de 69

Número de Referencia del Certificado Expedido

ReferenciaCertificado A 35 1:1

Indicador de Apto RAEE AptoProcedeRAEE A 01 0:1 Valores posibles: 1,2,3 SI/NO/NP (No Procede) En caso de certificado 1230-ROHS obligatorio

Indicador de Apto ROHS AptoProcedeROHS A 01 0:1 Valores posibles: 1,2,3, SI/NO/NP (No Procede) , En caso de certificado 1230-ROHS obligatorio

Indicador de Apto ECO AptoProcedeECO A 01 0:1 Valores posibles: 1,2,3 SI/NO/NP (No Procede) En caso de certificado C644-ECO obligatorio

Fecha Inicio de Validez FechaInValidez A 08 1:1 Formato: AAAAMMDD

Fecha Fin de Validez FechaFinValidez A 08 1:1 Formato: AAAAMMDD

Mercancia

Código TARIC de la Mercancía

CodigoMercancia A 10 1:1 Código TARIC que identifica la mercancía Casilla 33.1-2 del DUA

Peso Neto (KN) MasaNetaKg D 12,3 1:1 Peso neto de la mercancía en Kilogramos Netos. Casilla 38 del DUA

Numero Partida NumPartida A 5 0:1 Numero de partida XXXXX

Cantidad de Unidades CantidadUnidades D 12,3 0:1 Cantidad de Unidades de la mercancía. Solo se envía cuando es obligatorio declararse en Casilla 41 del DUA unidades UN

Observaciones Observaciones A 512 0:1 Observaciones

Información de los datos de la respuesta.

Descripción Etiqueta XML T L.M. Veces Valores / Condiciones / Reglas

SegmentosDeServicio: SegmentosDeServicio Segmentos de servicio y operación del mensaje

- Identificador único del mensaje

Id A 40 1:1

- Fecha del mensaje fecha A 08 0:1 Fecha del mensaje en formato AAAAMMDD

- Hora del mensaje hora A 06 0:1 Hora del mensaje con precisión de segundos HHMMSS

Documento Aduanero DocAduanero A 23 1:1

DUA: formato MRN: AAESRRRRRRTANNNNND Nº de Declaración sumaria Marítima o Terrestre: RRRRANNNNNNPPPPP (RRRR: recinto + A: Año + NNNNNN: nº de sumaria + PPPPP: Nº de la partida) Documento DVD DVDRRRRAAAANNNNNNPPP

TipoDocumentoPrecedente TipoDocumentoPrecedente A 4 1:1 DUA,SUA(sumaria Aerea),SUM(Sumara Terrestre),DVD

Identificación Solicitud SOIVRE

IdSolSOIVRE A 20 1:1 Identificador de la solicitud por SOIVRE

Código de respuesta CodigoRespuesta A 04 1:1 0000 – envío aceptado Otro valor - envío No aceptado

Descripción de la Respuesta

DescripcionRespuesta A 250 1:1

Page 61: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 61 de 69

17.3. Diagrama con los Elementos de información del mensaje de envío.

Page 62: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 62 de 69

17.4. Diagrama con los Elementos de información del mensaje de respuesta.

18. Definición de tipos de datos comunes a los servicios

Define la mayoría de los tipos de datos comunes del resto de esquemas utilizados en el sistema. Cuando el tipo de datos no es común a varios mensajes está definido en el propio mensaje.

ROHSTiposDeDatosV1.xsd

19. Recepción de mensajes desde el Buzón “Bandeja de Entrada”

Para la recepción de los mensajes se empleará la infraestructura del servicio web de Bandeja de Entrada. Comercio realizará periódicamente peticiones al servicio web de Bandeja de Entrada, enviando el NIF que el organismo tendrá autorizado para recibir esta comunicación. Con este NIF el servicio de bandeja de entrada se encargará de transmitir todos los mensajes relacionados con el organismo, que tiene pendientes de recoger. Se puede consultar la descripción y documentación del servicio web de Bandeja de Entrada en: BandejaEntrada.pdf

Page 63: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 63 de 69

Con el NIF, la AEAT le entregará una lista con los mensajes que tiene pendiente de leer. Si el NIF es compartido por otros organismos de Comercio, se discriminarán los mensajes para elegir solo los de ROHS, (por ejemplo: Origen = “ROHSgestionV1”). Cada elemento de la lista tiene una clave propia de la Bandeja de Entrada y la referencia de la Autorización implicada. Con la primera clave se obtiene posteriormente el contenido de un mensaje concreto. Con la referencia de la Autorización, Comercio puede discriminar de la lista de mensajes los que le interesa obtener o tratar de un modo determinado.

20. Consultas y Herramientas

20.1. Consulta de mensajes enviados

La transmisión de mensajes enviados mediante servicio web y el estado de estos se puede consultar en la sede electrónica de la AEAT en: https://www1.agenciatributaria.gob.es/wlpl/ADHT-CTRL/ControlQuery

Page 64: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 64 de 69

20.2. Cliente en Sede Electrónica

La Agencia Tributaria dispone en sede una página para la petición de servicios web de importación. Sede Electrónica - Agencia Tributaria: > Inicio > Todos los trámites > Aduanas > Presentación y despacho de declaraciones > Importación > Petición de Servicios Web de Importación El acceso directo es: ClienteSWimporta.html

21. Información anticipada (IA) La Información anticipada a los organismos (IA), es un servicio de la VUA, que mediante intercambio de

mensajes XML depositados en la Bandeja de Entrada (BE) de la AEAT, permite a Puertos del Estado y

Organismos No Aduaneros, obtener vía servicio Web, información anticipada que la Aduana tiene de las

Declaraciones de PDI, PDC, DUA y de las posibles intervenciones físicas a realizar por los Organismos No

aduaneros.

Se puede consultar información adicional en la página web de los servicios web de la AEAT (https://www2.agenciatributaria.gob.es/ADUA/internet/ws.html), en el apartado “VUA - Ventanilla Única Aduanera. / Información anticipada a organismos” (VUA Guía Servicio Web Información

Anticipada a Organismos V1.4.docx)

22. Comunicación por correo con los Operadores. Ejemplos

En este apartado se incluirá ejemplos y como se estable la comunicación con el Operador

23. Servicio web actual de comercio En la actualidad comercio utiliza el servicio web: “COMERCIO - Certificados SOIVRE: SEG (1310), CAL(N003), AGR(C644), ROS ().”. para la emisión de certificados. Una vez puesto en marcha el nuevo servicio web, la información facilitada por este servicio sobre:

Imputación. Movimiento de cargo sobre un Certificado.

Eliminación. Movimiento de abono sobre un Certificado.

Notificación del despacho de un Documento de Comercio Exterior. Serán facilitados por los IAS enviados a la Bandeja de Entrada

24. Sistema de Pruebas En el Entorno de Pruebas de la AEAT.

Para enviar mensajes al entorno de Pruebas hay que utilizar el "namespace" definido en el WSDL del servicio.

Page 65: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 65 de 69

Así para el servicio de Expedición de ROHS: “https://ws.iax.aeat.es/wlpl/AD44-JDIT/ws/rohs/ROHSexpedicionV1SOAP”

25. Estándares y consideraciones de diseño

25.1. Introducción

El contenido de un mensaje es un fichero XML. Un documento XML debe cumplir las reglas descritas en los diferentes esquemas los cuales proporcionan normas respecto a formatos, obligatoriedad, etc., pero son los intervinientes los que deben encargarse de la coherencia de los datos. Cada esquema está organizado en Grupos de Datos que contienen Elementos de Datos, estos se han agrupado de modo que constituyen bloques lógicos, manteniendo una coherencia con el ámbito de cada esquema.

25.2. Estándares utilizados

Se pretende utilizar los estándares de facto para el desarrollo de servicios Web. La estructura de los mensajes se basa en la creación de esquemas XML utilizando la recomendación W3C de 28-Octubre de 2004 en http://www.w3.org/TR/xmlschema-0 y referenciada por el namespace http://www.w3.org/2001/XMLSchema. Respecto a SOAP se utilizará SOAP V1.1 disponible como NOTA W3C en: http://www.w3.org/TR/2000/NOTE-SOAP-20000508/ de 08-Mayo-2000 y referenciado por el namespace http://schemas.xmlsoap.org/soap/envelope/ En SOAP-1.1 existen dos estilos para implementar servicio, modo “rpc” y modo “document”, en línea con las recomendaciones actuales se utilizará siempre el modo “document” (style =” document”) sin ningún tipo de codificación (use=” literal”). Es decir, el mensaje de entrada y salida estará descrito íntegramente por su respectivo esquema XML. En la descripción de los servicios utilizaremos WSDL 1.1 disponible como NOTA W3C de 14-Marzo-2001 en: http://www.w3.org/TR/2001/NOTE-wsdl-20010315 y referenciado por el namespace http://schemas.xmlsoap.org/wsdl/ La comunicación se puede realizar por internet o mediante la red SARA. El uso de los servicios requiere tener instalado un certificado de usuario admitido por la AEAT, en el ordenador desde el que se produzca el envío de la información. Por internet es necesario que el certificado sea de usuario, por la red SARA se utilizará de sello. El certificado de usuario podrá ser de Persona Física, Persona Jurídica, o la de un apoderado para este trámite. La aceptación de los mensajes se realiza previa autenticación del solicitante del servicio Los certificados admitidos por la AEAT pueden consultarse en: Certificado electrónico

Page 66: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 66 de 69

25.3. Versionado

Los servicios se definirán con un convenio de versionado que facilite que las futuras actualizaciones sean reconocibles y por tanto diferenciables. Para ello, detrás del nombre del servicio y de todos los objetos relacionados se incluye un número de versión.

25.4. Estructura de los mensajes

Solicitud: Mensaje de envío Contiene una capa SOAP y el BODY con la información a transmitir. Contestación: Mensaje de respuesta Contiene una capa SOAP y el BODY con la información de respuesta a un mensaje de envío.

25.5. Integridad transaccional

Los servicios Web se despliegan utilizando el protocolo de transporte https. Básicamente una petición https consiste en una petición que procesa el servidor y genera su respectiva respuesta. En condiciones normales el protocolo descrito anteriormente responde a las necesidades de un servicio Web, pero puede ocurrir por diversos motivos (caída de red, caída del servidor, …) que el cliente no reciba la respuesta y en estas ocasiones NO se puede saber si el servidor ha procesado la petición o no. Esta circunstancia puede no tener importancia, por ejemplo, en una consulta para conocer el estado, se volverá a pedir más tarde no afectando a la integridad de los datos, sin embargo, si el servicio actualiza la base de datos el resultado después de aplicar dos peticiones iguales podría alterar de forma sustancial lo esperado. Por lo anterior, en todo servicio Web que actualice información se implementa un mecanismo que garantiza un control de las peticiones duplicadas. Cada petición contiene una referencia unívoca, el identificador único del mensaje/transacción, (elemento “Id”), de tal modo que caso de recibir una petición, de un mismo tipo de mensaje xml, firmante y referencia que una previa, se actúa del siguiente modo:

- Si el contenido del mensaje es idéntico al recibido en la primera ocasión, se devuelve la respuesta que se generó para la primera petición.

- Si el contenido del mensaje difiere al recibido en la primera ocasión, se devuelve un error indicando el uso incorrecto de la referencia que debería ser unívoca.

Con este mecanismo el cliente, en caso de error y por tanto de indeterminación de sí se ha procesado o no la petición, tiene una forma fácil de re sincronizarse con garantía de integridad en el resultado final de la operación (si no se recibió la primera petición se procesará como nueva en caso contrario se devolverá un error indicando el uso incorrecto de la referencia que debería ser unívoca).

25.5.1. Funcionamiento del Identificador único del mensaje y su posible uso para el

seguimiento de la subsanación de errores funcionales de la declaración. Se expone a continuación cómo funciona el Id en combinación con el contenido del mensaje, y su posible uso para controlar modificaciones de un mensaje que pretendan, por ejemplo, subsanar posibles errores funcionales (como un error dado por un valor incorrecto en una casilla determinada de una declaración):

Page 67: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 67 de 69

a) Cuando se realiza el envío de una declaración lo primero que se comprueba es la unicidad de la terna: N.I.F. del firmante + tipo de mensaje + Id. 1.- Si es única, la declaración se admite pudiendo obtener una respuesta correcta (sin errores) o respuesta incorrecta (con errores funcionales). 2.- Si no es única, puede darse uno de los casos siguientes: 2.1.- Que el contenido de este segundo envío (ya había otro con anterioridad con el mismo Id) para este tipo de mensaje del remitente) coincida exactamente (a nivel físico/función hash) con el primer envío: la respuesta que se obtendría a este segundo envío sería la misma que la del primero. 2.2.- Que el contenido de este segundo envío no coincida exactamente con el del primer envío: en este caso se rechaza este segundo envío, ya que la información no es exactamente igual. b) Cuando una misma declaración tiene varios envíos debido a errores funcionales, y se quieren controlar por parte del remitente los envíos realizados.

En este caso, como todos los envíos tienen distinto contenido, para subsanar el error correspondiente, el Id que se debe mandar ha de ser también diferente en cada envío.

Una posible solución, que algunos operadores están adoptando, aunque cada operador puede optar por la solución que más le convenga: si pretende realizar este seguimiento de los envíos realizados para subsanar errores funcionales es dividir el Id en dos sub-Id. De esta forma, la primera parte del Id es única y la segunda parte es un numero secuencial que se corresponde con cada envío. Nota importante: La AEAT mantiene en línea durante 15 días, aproximadamente, el histórico (log) de los envíos efectuados. Así, si pasados esos 15 días se realizara un envío con la misma terna de N.I.F. del firmante + tipo de mensaje + Id y no se encontrará en este histórico en línea, se devolvería un error indicando que es imposible la recuperación de información del citado histórico. Por consiguiente, no se devolvería la respuesta del primer envío.

25.6. Recomendaciones

Valores en “Content-Type” de las peticiones.

Para facilitar el tratamiento y resolución de incidencias es recomendable que las peticiones se envíen con Content-Type = a text/xml, application/xml o application/soap+xml.

Así, si se envía application/x-www-form-urlencoded, que quiere decir que los datos vienen de un formulario en lugar de un XML, no se puede visualizar el mensaje en formato XML.

25.7. Comunicación de incidencias en el procesado de las declaraciones.

En caso de incidencias en la aplicación estás serán comunicadas tal como se describen en el protocolo SOAP V1.1, es decir utilizando el elemento FAULT. A modo de resumen como respuesta a una petición se pueden producir los siguientes casos: Resultado Acción

Recibimos una respuesta con el xml esperado OK. Mensaje procesado

Recibimos una respuesta con elemento FAULT y faultcode del tipo “soapenv: Server.”

Reenviar mensaje

No progresa la transmisión o bien no recibimos un documento Reenviar mensaje

Page 68: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 68 de 69

xml que responde a lo esperado

Recibimos una respuesta con elemento FAULT y faultcode del tipo “soapenv:Client.”

La respuesta enviada NO es formalmente incorrecta, o bien contiene referencia única duplicada de otra con distinto contenido. La declaración NO se debe reenviar.

26. Información Ampliada

26.1. Formato MRN

Formato: AAESRRRRRRNNNNNNNNPPPPP compuesto de: AA (año de registro) + "ES"(país, siempre España) + RRRRRR (aduana) + NNNNNNNN (número) + PPPPP (nº de la partida)

Para los siguientes casos el MRN de la declaración aduanera de importación o de exportación no se conocerá:

ROHS para DVD: solicitud realizada para entrada a deposito aduanero.

Para poder identificar al principio el envío de la solicitud al Organismo, desde los flujos de ROHS, la AEAT generará un MRN ficticio, que sólo conocerán AEAT y Organismo, ya que, con el Operador, la identificación se realizará por medio de la Referencia de Solicitud que nos proporciona el SIF a partir de ese momento.

Para el resto de los casos, en que se conozca el MRN, el formato a declarar será el siguiente:

Tipo de mensaje = R, O AAESRRRRRRNNNNNNNNPPPPP

Tipo de mensaje = A, D, Z. 1. ROHS.

AAESRRRRRRNNNNNNNNPPPPP

26.2. Referencia Solicitud en los servicios PUE

Es la Referencia de Solicitud la que servirá para identificación en el intercambio de información con el Operador.

ROHS: La referencia de la Solicitud es la que proporciona el Organismo tras realizar la Solicitud, pero en el momento de Expedición, se obtendrá un Certificado, diferente al número de la solicitud.

26.3. Formatos DUA, SUM y SUA

Número de Referencia de la declaración:

DUA: Documento Único Aduanero. longitud 23. AAESRRRRRRTANNNNNDPPP ('AA' año + ES país España +'RRRRRR' Aduana + 'T' tipo documento 'ANNNNN' Nº referencia + 'PPPPP’: Nº de partida)

SUM: Sumaria Marítima o Terrestre: longitud 16. RRRRANNNNNNPPPPP ('RRRR' Aduana + 'A' último dígito de año + 'NNNNNN' Nº secuencial + 'PPPPP': Nº de partida)

SUA: Sumaria Aérea: longitud máx. 39. RRRRAAAAMMDDCCCNNNNNKKKKKKKKKKKKKKKKKKK (RRRR recinto + AAAAMMDD fecha del vuelo + CCC código de compañía aérea, de 2 o 3 caracteres + NNNNN nº de vuelo, de 4 o 5 caracteres + KKKKKKKKKKKKKKKKKKKK nº de conocimiento aéreo de hasta 19 caracteres)

Page 69: GUIA DE SERVICIOS ROHS - Agencia Tributaria

Departamento de Informática Tributaria. Subdirección General de Aplicaciones de Aduanas e II.EE.

Servicios Web ROHS Comercio Versión 0.1

______________________________________________________________________ Página 69 de 69

26.4. Tipos Inspección Física

A: APERTURA: en caso de apertura para extracción de muestras, apertura de puertas, inspección primeras filas (apertura, que no implica descarga)

D: DESCARGA: descarga y estiba mercancía, vaciado contenedor.

E: EXTERNO: inspección exterior del equipamiento, por ejemplo, inspección maquinaria refrigeración, detección de radiación, inspección equipos especiales

I: CONTROL DE IDENTIDAD: inspección ocular de los precintos de los contenedores, estampillas o marcas que sean obligatorias

P: PASILLO: hasta el fondo, parcial, inspección con perros

X: ESCANER: con furgoneta, arco, etc.

27. Ejemplos XML

28. Mensajes intercambiados

29. Abreviaturas