Servicio de intercambio de información de entrada y …...De partamento de Informática Tributaria Subdirección General de Aplicaciones de Aduanas e II.EE C/ Santa María Magdalena

Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EEC/ Santa María Magdalena 16, 28016 Madrid

Servicio de intercambio de información de entrada y salida de contenedores en

las terminales portuarias.Definición de requisitos.

Autor: S. G. A. A Fecha:

Edic. Rev. Fecha Descripción1 0 08/08/2012 Versión inicial

2 0 12/12/2012 Ampliación de mensajes

2 1 02/02/2015 Revisión documental

2 2 11/03/2015 Eliminación firma

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

partamento de Informática Tributaria.

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


las terminales portuarias.Definición de requisitos.

Fecha: 11/03/2015 Versión: 2.2

Revisiones Descripción A(*) Versión inicial A

Ampliación de mensajes R

Revisión documental R

Eliminación firma R

R = Reemplazar

Subdirección General de Aplicaciones de Aduanas e II.EE.


las terminales portuarias.

Páginas Todas

Todas

Todas

Todas

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

Control de contenedores en terminales portuarias

______________________________________________________________________Página 2 de 17

Índice:

1. INTRODUCCIÓN................................

2. CONTROL DE VERSIONES

2.1. Versión 1 ................................

2.2. Versión 2 ................................

3. ESQUEMA GENERAL DE F

4. ESTÁNDARES Y REQUISI

4.1. Introducción ................................

4.2. Estándares utilizados ................................

4.3. Versionado ................................

4.4. Estructura de los mensajes

4.5. Integridad transaccional

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

5. SERVICIO WEB DE ENTR

5.1. Información del servicio web.

6. SERVICIO WEB DE SALI


7. SERVICIO WEB DE MODIDECLARADO ................................


8. SERVICIO WEB DE CANCTERMINAL ................................


9. SERVICIO WEB DE CANC

Departamento de Informática Tributaria.

eral de Aplicaciones de Aduanas e II.EE

Control de contenedores en terminales portuarias – Servicios Web XML Versión 2.

______________________________________________________________________

................................................................................................

CONTROL DE VERSIONES ................................................................

................................................................................................................................

................................................................................................................................

ESQUEMA GENERAL DE FUNCIONAMIENTO. ................................

ESTÁNDARES Y REQUISITOS ................................................................

................................................................................................

................................................................................................

................................................................................................

Estructura de los mensajes ................................................................................................

accional ................................................................................................

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

SERVICIO WEB DE ENTRADA DE CONTENEDOR EN LA TERMINAL

Información del servicio web. ................................................................

SERVICIO WEB DE SALIDA DE CONTENEDOR DE LA TERMINAL


SERVICIO WEB DE MODIFICACIÓN DE DATOS DE UN CONTENEDOR PREVIA................................................................................................


SERVICIO WEB DE CANCELACIÓN DE ENTRADA DE CONTENEDOR EN LA ................................................................................................


SERVICIO WEB DE CANCELACIÓN DE SALIDA DE CONTENEDOR DE LA TER

eral de Aplicaciones de Aduanas e II.EE.

Versión 2.2

______________________________________________________________________

.................................................. 4

................................................................ 5

....................................5

....................................5

................................................................. 5

........................................................... 6

..............................................................6

................................................6

.................................................................7

.......................................7

..........................................7

....................................8

LA TERMINAL ............................ 8

..................................................................8

LA TERMINAL ................................. 9

................................................................10

UN CONTENEDOR PREVIAMENTE .............................................................11

................................................................11

E CONTENEDOR EN LA .................................................................13

................................................................13

CONTENEDOR DE LA TERMINAL14



______________________________________________________________________Página 3 de 17


10. ESQUEMAS COMUNES DE

11. INFORMACIÓN COMPLEMENTARIA

12. HERRAMIENTA PARA ENV

13. SISTEMA DE PRUEBAS ................................

14. EJEMPLOS ................................




______________________________________________________________________


ESQUEMAS COMUNES DE LOS SERVICIOS ................................

COMPLEMENTARIA ................................................................

HERRAMIENTA PARA ENVÍO – RECEPCIÓN DE MENSAJES ................................

................................................................................................

................................................................................................


Versión 2.2

______________________________________________________________________

................................................................15

..................................................................16

................................................16

........................................16

.....................................17

.........................................................17



______________________________________________________________________Página 4 de 17

1. Introducción La globalización y las Tecnologías de Información son factores que tienen gran impacto en el comercio internacional así como en las administraciones aduaneras. Éstas pueden contribuir de una manera muy especial a desarrollar las economías así como a facilitar el comercio legal, asignando recursos a las áreas de alto riesgo, y también enfocándose hacia el intercambio de in En este contexto y dentro de la estrategia de la Comisión Europea para obtener un entorno simple y exento de papeles para las Aduanas y el Comercio, la Agencia Tributaria presenta un nuevo procedimiento informático para notificar las entradas y salidas de contenedores de las terminales portuarias Este documento constituye la guía de usuario en cuanto al modo de utilización de los mensajes XML de envío de la información por parte de las terminales de conadministración aduanera. Con el objeto de proporcionar un alto grado de administración aduanera, se contempla eeficacia y eficiencia en la gestión de las declaraciones. En el procedimiento informático se definen de contenedor) por parte de las terminales de contenedoresrechazará el envío. Además, otros tres mensajes permiten realizar las rectificaciones necesarias para subsanar posibles errores previos. Mensajes de las terminales de contenedo EntradaConTerV2Ent. Mensaje con el que se declara la SalidaConTerV2Ent. Mensaje con el que se declarahabitualmente por carga en un buque. ModificacionConTerV2Ent. Mensaje con el que se modifican los datos de un contenedor previamente registrado en el sistema. CancelaEntConTerV2Ent. Mensaje con el que se cancela la declaración previa de entrada de un contenedor en una terminal portuaria. CancelaSalConTerV2Ent. Mensaje con el que se cancela la declaración previa de salida de un contenedor de una terminal portuaria. Mensajes de Respuesta de la Aduana: EntradaConTerV2Sal. Mensaje de respuesta con el que la aduana comunica si aceptentrada de un contenedor en una terminal portuaria y SalidaConTerV2Sal. Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de uno o varios contenedores de una terminal portuaria y la causa del rechazo, si hay alguna incorrección ModificacionConTerV2Sal. Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de modificación de datos de un contenedor de incorrección. CancelaEntConTerV2Sal. Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de cancelación de entrada de un contenedor en una terminal portuaria y l




______________________________________________________________________

La globalización y las Tecnologías de Información son factores que tienen gran impacto en el comercio í como en las administraciones aduaneras. Éstas pueden contribuir de una manera muy especial a

desarrollar las economías así como a facilitar el comercio legal, asignando recursos a las áreas de alto riesgo, y también enfocándose hacia el intercambio de información electrónico integrado.

En este contexto y dentro de la estrategia de la Comisión Europea para obtener un entorno simple y exento de papeles para las Aduanas y el Comercio, la Agencia Tributaria presenta un nuevo procedimiento informático para otificar las entradas y salidas de contenedores de las terminales portuarias vía servicios Web.

Este documento constituye la guía de usuario en cuanto al modo de utilización de los mensajes XML de envío de la las terminales de contenedores y de los que recibirán est

Con el objeto de proporcionar un alto grado de interoperabilidad entre las terminales de contenedores e contempla el envío de documentación digitalizada lo que redunda en beneficio de la

eficacia y eficiencia en la gestión de las declaraciones.

En el procedimiento informático se definen dos mensajes básicos de envío de la información minales de contenedores y por cada uno su mensaje de respuesta que admitirá o

Además, otros tres mensajes permiten realizar las rectificaciones necesarias para subsanar

las terminales de contenedo res:

Mensaje con el que se declara la entrada de un contenedor en una terminal portuaria

Mensaje con el que se declara la salida de uno o varios contenedorn buque.

Mensaje con el que se modifican los datos de un contenedor previamente registrado en el

Mensaje con el que se cancela la declaración previa de entrada de un contenedor en una

Mensaje con el que se cancela la declaración previa de salida de un contenedor de una

Mensajes de Respuesta de la Aduana:

Mensaje de respuesta con el que la aduana comunica si aceptentrada de un contenedor en una terminal portuaria y la causa del rechazo, si hay alguna incorrección.

Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de una terminal portuaria y la causa del rechazo, si hay alguna incorrección

Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de de un contenedor de previamente registrado en el sistema y la causa del rechazo, si hay alguna

Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de entrada de un contenedor en una terminal portuaria y la causa del rechazo, si hay alguna incorrección.


Versión 2.2

______________________________________________________________________

La globalización y las Tecnologías de Información son factores que tienen gran impacto en el comercio í como en las administraciones aduaneras. Éstas pueden contribuir de una manera muy especial a

desarrollar las economías así como a facilitar el comercio legal, asignando recursos a las áreas de alto riesgo, y

En este contexto y dentro de la estrategia de la Comisión Europea para obtener un entorno simple y exento de papeles para las Aduanas y el Comercio, la Agencia Tributaria presenta un nuevo procedimiento informático para

vía servicios Web.

Este documento constituye la guía de usuario en cuanto al modo de utilización de los mensajes XML de envío de la y de los que recibirán estas como respuesta de la

las terminales de contenedores y la digitalizada lo que redunda en beneficio de la

la información (de entrada y salida y por cada uno su mensaje de respuesta que admitirá o

Además, otros tres mensajes permiten realizar las rectificaciones necesarias para subsanar

entrada de un contenedor en una terminal portuaria.

contenedores de una terminal portuaria,

Mensaje con el que se modifican los datos de un contenedor previamente registrado en el

Mensaje con el que se cancela la declaración previa de entrada de un contenedor en una

Mensaje con el que se cancela la declaración previa de salida de un contenedor de una

Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de si hay alguna incorrección.

Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de salida de una terminal portuaria y la causa del rechazo, si hay alguna incorrección.

Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de y la causa del rechazo, si hay alguna

Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de a causa del rechazo, si hay alguna incorrección.



______________________________________________________________________Página 5 de 17

CancelaSalConTerV2Sal. Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de cancelación de salida de un contenedor de una terminal portuaria y la causa del rechazo, si hay al

2. Control de Versiones2.1. Versión 1

Creación del documento.

2.2. Versión 2 Ampliación de mensajes y eliminación firma.

3. Esquema general de funcionamiento.

Esquema general El esquema general de funcionamiento e Un camión se desplaza a la empresa o almacén del expedidor llevando un contenedor vacío. Una vez que la mercancía es cargada en el contenedor, el camión transporta la mercancía contenerizada a la Terminal de carga. Las Terminales remitirán por medios telemáticos a la Aduana:

Terminal de contenedores

Terminal envía mensaje de entrada/salida/… contenedor

Terminal Recibe Notificación del rechazo

Terminal Recibe Notificación de Aceptación




______________________________________________________________________

Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de salida de un contenedor de una terminal portuaria y la causa del rechazo, si hay al

Control de Versiones

Ampliación de mensajes y eliminación firma.

Esquema general de funcionamiento.

El esquema general de funcionamiento es el siguiente:

Un camión se desplaza a la empresa o almacén del expedidor llevando un contenedor vacío. Una vez que la mercancía es cargada en el contenedor, el camión transporta la mercancía contenerizada a la Terminal de carga.

n por medios telemáticos a la Aduana:

Aduana

(Mensaje Aceptación)

(Mensaje de rechazo) Validación, Análisis

y Registro de la Declaración


Versión 2.2

______________________________________________________________________

Mensaje de respuesta con el que la aduana comunica si acepta o rechaza un mensaje de salida de un contenedor de una terminal portuaria y la causa del rechazo, si hay alguna incorrección.

Un camión se desplaza a la empresa o almacén del expedidor llevando un contenedor vacío. Una vez que la mercancía es cargada en el contenedor, el camión transporta la mercancía contenerizada a la Terminal de carga.

Aduana

Validación, Análisis y Registro de la

Declaración



______________________________________________________________________Página 6 de 17

� Entrada de un contenedor en la Terminal

El momento de notificación de la entrada de un contenedor en la Terminal es distinto dependiendo de la Terminal de carga. Así, algunas Terminales de carga remiten un mensaje dTerminal cuando el camión entra por la puerta de la Terminal, mientras que otras Terminales de carga remiten el mensaje cuando el contenedor se deposita en la explanada de contenedores. Los titulares de las terminales marAduana los datos de identificación de de su entrada y, en su caso, la identificación del medio de transporte que lo conduce y d

� Salida de un contenedor de la Terminal La Terminal envía un mensaje con salido de la misma sin embarcar Los titulares de las terminales marítimas de mercancías deberán comunicar de forma inmediata a la Aduana los datos de las salidas contenedores de los que se declaró la entrada

4. Estándares y requisit4.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.

4.2. Estánda res utilizadosEl uso de servicios Web constituye la base de las buenas prácticas para desplegar servicios que posibiliten la interacción máquina-máquina, es decir, la automatización integral de un proceso en el que intervienen varios sistemas de información (el del ciudadano/empresa y el de la Agencia Tributaria). 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 28Octubre de 2004 en http://www.w3.org/TR/xmlschemay referenciada por el namespace http://www.w3.org/2001/XMLSchema Con relación a SOAP se utilizará SOAP V1.1 dishttp://www.w3.org/TR/2000/NOTE-SOAPhttp://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 14http://www.w3.org/TR/2001/NOTE-wsdlhttp://schemas.xmlsoap.org/wsdl/




______________________________________________________________________

Entrada de un contenedor en la Terminal : El momento de notificación de la entrada de un contenedor en la Terminal es distinto dependiendo de la Terminal de carga. Así, algunas Terminales de carga remiten un mensaje de entrada del contenedor en la Terminal cuando el camión entra por la puerta de la Terminal, mientras que otras Terminales de carga remiten el mensaje cuando el contenedor se deposita en la explanada de contenedores.

Los titulares de las terminales marítimas de mercancías deberán comunicar de forma inmediata a la Aduana los datos de identificación de los contenedores que entren por vía terrestrede su entrada y, en su caso, la identificación del medio de transporte que lo conduce y d

Salida de un contenedor de la Terminal (embarcado o no) : La Terminal envía un mensaje con el contenedor que ha salido de la Terminal y ha sido embarcado

n embarcar (por ferrocarril o carretera).

es de las terminales marítimas de mercancías deberán comunicar de forma inmediata a la salidas de las citadas terminales por vía terrestre o marít ima

contenedores de los que se declaró la entrada .

Estándares y requisit os

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

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.

res utilizados El uso de servicios Web constituye la base de las buenas prácticas para desplegar servicios que posibiliten la

máquina, es decir, la automatización integral de un proceso en el que intervienen varios ón (el del ciudadano/empresa y el de la Agencia Tributaria).

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 28http://www.w3.org/TR/xmlschema-0

http://www.w3.org/2001/XMLSchema.

Con relación a SOAP se utilizará SOAP V1.1 disponible como NOTA W3C de 08SOAP-20000508/ y referenciado por el namespace

ap.org/soap/envelope/

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

literal”). Es decir el mensaje de entrada y salida estará descrito íntegramente por su respectivo

En la descripción de los servicios utilizaremos WSDL 1.1 disponible como NOTA W3C de 14wsdl-20010315 y referenciado por el namespace


Versión 2.2

______________________________________________________________________

El momento de notificación de la entrada de un contenedor en la Terminal es distinto dependiendo de la e entrada del contenedor en la

Terminal cuando el camión entra por la puerta de la Terminal, mientras que otras Terminales de carga remiten el mensaje cuando el contenedor se deposita en la explanada de contenedores.

ítimas de mercancías deberán comunicar de forma inmediata a la los contenedores que entren por vía terrestre , la fecha y la hora

de su entrada y, en su caso, la identificación del medio de transporte que lo conduce y del transportista.

l contenedor que ha salido de la Terminal y ha sido embarcado o ha

es de las terminales marítimas de mercancías deberán comunicar de forma inmediata a la de las citadas terminales por vía terrestre o marít ima, de aquellos

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

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.

El uso de servicios Web constituye la base de las buenas prácticas para desplegar servicios que posibiliten la máquina, es decir, la automatización integral de un proceso en el que intervienen varios

La estructura de los mensajes se basa en la creación de esquemas XML utilizando la recomendación W3C de 28-

ponible como NOTA W3C de 08-Mayo-2000 en : y referenciado por el namespace

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

literal”). Es decir el mensaje de entrada y salida estará descrito íntegramente por su respectivo

En la descripción de los servicios utilizaremos WSDL 1.1 disponible como NOTA W3C de 14-Marzo-2001 en:



______________________________________________________________________Página 7 de 17

El uso de los servicios requiere tener instalado un certificado de usuario admitdesde el que se produzca el envío de la información. 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 autent

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

4.4. Estructura de los mensajes Solicitud: Mensaje de envío Contendrá una capa SOAP y en el BODY estarán los datos de la transmisión Contestación: Mensaje de respuesta Contendrá una capa SOAP y en el BODmensaje.

4.5. Integridad transaccionalLos servicios Web se despliegan utilizando el protocolo de transporte https. Básicamente una petición https consiste en una petición que procesa el 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 recibaestas ocasiones NO podemos conocer 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 integridaresultado 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 mcontrol de las peticiones duplicadas. Cada petición contiene una referencia unívoca de tal modo que caso de recibir una petición con la misma referencia que una previa actuaremos del siguiente modo:

- Si el contenido del mensaje egeneró para la primera petición.

- Si el contenido del mensaje difiere al recibido en la primera ocasión, se devolverá un error indicando el uso incorrecto de la referencia que de

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 resincronizarse 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).




______________________________________________________________________

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.

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 servicios se definirán con un convenio de versionado que facilite que las futuras actualizaciones son reconocibles y por tanto diferenciables. Para ello, detrás del nombre del servicio y de todos los objrelacionados se incluye un número de versión.

Estructura de los mensajes

Contendrá una capa SOAP y en el BODY estarán los datos de la transmisión.

Contestación: Mensaje de respuesta Contendrá una capa SOAP y en el BODY estarán los datos de la transmisión más los datos específicos de este

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 recibaestas ocasiones NO podemos conocer 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 mcontrol de las peticiones duplicadas.

Cada petición contiene una referencia unívoca de tal modo que caso de recibir una petición con la misma referencia que una previa actuaremos del siguiente modo:

Si el contenido del mensaje es idéntico al recibido en la primera ocasión, se devolverá la respuesta que se generó para la primera petición. Si el contenido del mensaje difiere al recibido en la primera ocasión, se devolverá 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 resincronizarse con garantía de integridad en el resultado final de la operación (si

ecibió 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).


Versión 2.2

______________________________________________________________________

ido por la AEAT, en el ordenador

El certificado de usuario podrá ser de Persona Física, Persona Jurídica, o la de un apoderado para este trámite.

icación del solicitante del servicio

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

Y estarán los datos de la transmisión más los datos específicos de este

Los servicios Web se despliegan utilizando el protocolo de transporte https. Básicamente una petición https

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

Esta circunstancia puede no tener importancia, por ejemplo en una consulta para conocer el estado, se volverá a d 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 garantice un

Cada petición contiene una referencia unívoca de tal modo que caso de recibir una petición con la misma

s idéntico al recibido en la primera ocasión, se devolverá la respuesta que se

Si el contenido del mensaje difiere al recibido en la primera ocasión, se devolverá un error indicando el uso

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 resincronizarse con garantía de integridad en el resultado final de la operación (si

ecibió la primera petición se procesará como nueva en caso contrario se devolverá un error indicando el uso



______________________________________________________________________Página 8 de 17

4.6. 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 Recibimos una respuesta con el xml esperado

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

No progresa la transmisión o bien no recibimos un documento xml que responde a lo esperadoRecibimos una respuesta con elemento FAULT y faultcode del tipo “soapenv:Client.”

5. Servicio We b de Mensajes del servicio

Nombre

EntradaConTerV2Ent

EntradaConTerV2Sal

Tabla 1. Mensajes implicados en servicio Web de

5.1. Información del servicio web. La información necesaria para cumplimentar los distintos mensajes descritos es la que se muestra en sus esquemas, se indica que información enviar

Definición del Servicio Web dehttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaConTerV2.wsdl

Esquema del mensaje dehttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaConTerV2Ent.xsd

Datos de negocio del mensaje

Información

Identificador del Contenedor

Ubicación a la Entrada

Fecha a la Entrada




______________________________________________________________________

Comunicación de incidencias en el procesado de las declaraciones.a 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:

Acción ta con el xml esperado OK. Mensaje procesado

Recibimos una respuesta con elemento FAULT y faultcode Reenviar mensaje

No progresa la transmisión o bien no recibimos un documento xml que responde a lo esperado

Reenviar mensaje

ecibimos una respuesta con elemento FAULT y faultcode 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.

b de entrada de contenedor en la terminal

Descripción

Envío de Datos del mensaje de entrada de un contenedor en una terminal portuaria. Respuesta de la administración aduanera.

Mensajes implicados en servicio Web de entrada de contenedor en terminal

Información del servicio web.

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

Definición del Servicio Web de entrada de contenedor en la terminalutaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaConTerV2.wsdl

Esquema del mensaje de entrada de contenedor en la terminalhttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaConTerV2Ent.x

Datos de negocio del mensaje de entrada de contenedor en la terminal Formato Obligatorio / ;otas.

Contenedor A11 SI

Formato: AAAANNNNNNN

Tamaño exacto: 11

A10 SI

Tamaño mínimo:

A8 SI


Versión 2.2

______________________________________________________________________

Comunicación de incidencias en el procesado de las declaraciones. a aplicación estás serán comunicadas tal como se describen en el protocolo SOAP

A modo de resumen como respuesta a una petición se pueden producir los siguientes casos:

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.

entrada de contenedor en la terminal

mensaje de entrada de un contenedor

Respuesta de la administración aduanera.

entrada de contenedor en terminal.

La información necesaria para cumplimentar los distintos mensajes descritos es la que se muestra en sus

entrada de contenedor en la terminal . utaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaConTerV2.wsdl

entrada de contenedor en la terminal . https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaConTerV2Ent.x

de contenedor en la terminal Obligatorio / ;otas.

AAAANNNNNNN

Tamaño exacto: 11

8, máximo: 10.



______________________________________________________________________Página 9 de 17

Hora a la Entrada

Indicador de Lleno a la Entrada

Kilos a la Entrada

Consignatario a la Entrada

Transportista a la Entrada

Puerto de Destino a la Entrada

Matricula a la Entrada

Esquema del mensaje de Respuesta al envío determinal. https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaConTerV2Sal.xd

6. Servicio Web de Mensajes del servicio

Nombre

SalidaConTerV2Ent

SalidaConTerV2Sal

Tabla 2. Mensajes implicados en servicio Web




______________________________________________________________________

Fecha en formato: AAAAMMDD.

N6 SI

Hora en formato: HHMMSS.

a la Entrada A1 SI

Valores posibles: {S,N}

S indica lleno, N indica vacío.

Sirve para indicar si el contenedor tiene

mercancía en su interior.

A15 NO

A17 NO

A17 NO

a la Entrada A5 NO

Tamaño exacto: 5

A25 SI

Indicar la matrícula del medio de

transporte de entrada.

Esquema del mensaje de Respuesta al envío de entrada de contenedor en la

https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaConTerV2Sal.x

Servicio Web de salida de contenedor d e la terminal

Descripción

Envío de Datos mensaje de salida de uncontenedores de una terminal portuaria. Respuesta de la administración aduanera.

Mensajes implicados en servicio Web de salida de contenedor en la terminal


Versión 2.2

______________________________________________________________________


ato: HHMMSS.





Tamaño exacto: 5

Indicar la matrícula del medio de

transporte de entrada.

entrada de contenedor en la

https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaConTerV2Sal.xs

e la terminal

mensaje de salida de uno o varios

ración aduanera.

salida de contenedor en la terminal.



______________________________________________________________________Página 10 de 17


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

Definición del Servicio Web https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/SalidaConTerV2.wsdl

Esquema del mensaje de https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/SalidaConTerV2Ent.xsd

Datos de negocio del mensaje

Información

Ubicación a la Salida

Modo de Salida

Manifiesto de Carga

Matrícula de Salida

NIVEL CONTENEDORES [de 1


Fecha de Salida

Hora de Salida

Indicador de Lleno a la Salida




______________________________________________________________________


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

Definición del Servicio Web de salida de contenedor d e la terminalhttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/SalidaConTerV2.wsdl

Esquema del mensaje de salida de contenedor d e la terminalhttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/SalidaConTerV2Ent.xsd

Datos de negocio del mensaje de salida de contenedor en Formato Obligatorio / ;otas.

A10 SI

Tamaño minimo:

A1 SI

Valores posibles: {M,C,F}

(M) marítima, (C) carretera, (F)

ferroviaria

A25 NO.

Solo obligatorio par

M.

A25 NO

Solo obligatorio para Modo de salida =

C o F.

Para Modo = C, indicar matrícula del

camión.

Para Modo = F, indicar identificador el

tren o vagón.

NIVEL CONTENEDORES [de 1 a n]

Identificador del Contenedor A11 SI

Formato: AAAANNNNNNN

Tamaño exacto: 11

A8 SI


N6 SI


Indicador de Lleno a la Salida A1 SI



Versión 2.2

______________________________________________________________________


e la terminal . https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/SalidaConTerV2.wsdl

e la terminal . https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/SalidaConTerV2Ent.xsd

de contenedor en la terminal Obligatorio / ;otas.

8, máximo: 10.

Valores posibles: {M,C,F}

(M) marítima, (C) carretera, (F)





AAAANNNNNNN

Tamaño exacto: 11






______________________________________________________________________Página 11 de 17

Kilos a la Salida

Consignatario en la Salida

Transportista en la Salida

Puerto Destino en la Salida

Esquema del mensaje de Respuesta al envío determinal. https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/d

7. Servicio Web de modificación de datos de un contene dor previamente declarado

Mensajes del servicio Nombre Descripción

ModificacionConTerV2Ent Envío de Datos contenedor previ

ModificacionConTerV2Sal Respuesta de la administración aduanera.

Tabla 2. Mensajes implicados en servicio Web de modificación de datos


La información necesaria para cumplimentar los distesquemas, se indica que información enviar y en qué condiciones.

Definición del Servicio Web https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/ModificacionConTerV2.wsdl

Esquema del mensaje de https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/ant.xsd




______________________________________________________________________




A15 NO

A17 NO

A17 NO

A5 NO

Tamaño exacto: 5

Esquema del mensaje de Respuesta al envío de salida

https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/SalidaConTerV2Sal.xsd

Servicio Web de modificación de datos de un contene dor previamente declarado

Descripción

Envío de Datos mensaje de modificación de datos de un contenedor previamente declarado. Respuesta de la administración aduanera.

Mensajes implicados en servicio Web de modificación de datos de contenedor



Definición del Servicio Web de modificación de datos d e https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/ModificacionConTerV2.

Esquema del mensaje de modificación de datos de un contenedorhttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/a


Versión 2.2

______________________________________________________________________


car si el contenedor tiene


Tamaño exacto: 5

alida de contenedor de la

it/adu/adct/ws/SalidaConTerV2Sal.xsd

Servicio Web de modificación de datos de un contene dor

mensaje de modificación de datos de un

de contenedor.

intos mensajes descritos es la que se muestra en sus

e un contenedor. https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/ModificacionConTerV2.

un contenedor . https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/ModificacionConTerV2E



______________________________________________________________________Página 12 de 17

Datos de negocio del mensaje Información



Fecha a la Entrada

Hora a la Entrada

Indicador de Lleno a la Entrada

Kilos a la Entrada

Consignatario a la Entrada

Transportista a la Entrada

Puerto de Destino a la Entrada

Manifiesto de Carga

Matrícula de Salida

Indicador de Lleno a la Salida




______________________________________________________________________

Datos de negocio del mensaje de modificación de datos de

Formato Obligatorio / ;otas.

Contenedor A11 SI

Formato:AAAANNNNNNN

Tamaño exacto: 11

A10 SI

Tamaño minimo:

A8 SI


N6 SI


a la Entrada A1 NO



Sirve para indicar


A15 NO

A17 NO

A17 NO

a la Entrada A5 NO

Tamaño exacto: 5

A25 NO.

Solo obligatorio para M

M.

A25 NO


C o F.


camión.


tren o vagón.

Indicador de Lleno a la Salida A1 NO






Versión 2.2

______________________________________________________________________

de un contenedor Obligatorio / ;otas.

Formato:AAAANNNNNNN

Tamaño exacto: 11

8, máximo: 10.







Tamaño exacto: 5






indica lleno, N indica vacío.





______________________________________________________________________Página 13 de 17

Kilos a la Salida

Consignatario en la Salida

Transportista en la Salida

Puerto Destino en la Salida

Regla: Es necesario indicar en los campos ”Identificador del Contenedor”, “Ubicación a la Entrada”, “Fecha a la Entrada” y “Hora a la Entrada” exactamente los mismos valores que se enviaron en su momento en el mensaje “EntradaConTerV2Ent”. Estos valores que se quiere actualizar. El resto de los campos del mensaje son opcionales. Si se incluyen, se modificarán con su contenido los valores del contenedor almacenados en la base de datos. Si spara dejarlo vacío, se debe incluir la etiqueta correspondiente en el mensaje, pero sin valor. Si no se desea modificar algún campo, no se debe incluir la etiqueta en el mensaje.

Esquema del mensaje de Respuesta al contenedor. https://www3.agenciatributaria.gob.es/static_files/common/interal.xsd

8. Servicio Web de en la terminal

Mensajes del servicio

Nombre

CancelaEntConTerV2Ent

CancelaEntConTerV2Sal


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

Definición del Servicio Web terminal. https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaEntConTerV2.wsdl




______________________________________________________________________

A15 NO

A17 NO

A17 NO

A5 NO

Tamaño exacto: 5

Es necesario indicar en los campos ”Identificador del Contenedor”, “Ubicación a la Entrada”, “Fecha a la Entrada” y “Hora a la Entrada” exactamente los mismos valores que se enviaron en su momento en el mensaje “EntradaConTerV2Ent”. Estos valores -que no son modificables- sirven para identificar unívocamente el registro que se quiere actualizar. El resto de los campos del mensaje son opcionales. Si se incluyen, se modificarán con su contenido los valores del contenedor almacenados en la base de datos. Si se desea borrar algún valor del registro para dejarlo vacío, se debe incluir la etiqueta correspondiente en el mensaje, pero sin valor. Si no se desea modificar algún campo, no se debe incluir la etiqueta en el mensaje.

Esquema del mensaje de Respuesta al envío de modificación de datos de un

https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/ModificacionConTerV2S

Servicio Web de cancelación de entrada de contenedor

Descripción

Envío de Datos del mensaje de cancelación de un contenedor en una terminal portuaria.Respuesta de la administración aduanera.

Mensajes implicados en servicio Web de cancelación de entrada de contenedor en terminal.


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

Definición del Servicio Web de cancelación de entrada de contenedor en la

https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaEntConTerV2.w


Versión 2.2

______________________________________________________________________

Tamaño exacto: 5

Es necesario indicar en los campos ”Identificador del Contenedor”, “Ubicación a la Entrada”, “Fecha a la Entrada” y “Hora a la Entrada” exactamente los mismos valores que se enviaron en su momento en el mensaje

sirven para identificar unívocamente el registro que se quiere actualizar. El resto de los campos del mensaje son opcionales. Si se incluyen, se modificarán con su

e desea borrar algún valor del registro para dejarlo vacío, se debe incluir la etiqueta correspondiente en el mensaje, pero sin valor. Si no se desea

modificación de datos de un

net/dep/aduanas/es/aeat/dit/adu/adct/ws/ModificacionConTerV2S

entrada de contenedor

cancelación de entrada de .


entrada de contenedor en terminal.

necesaria para cumplimentar los distintos mensajes descritos es la que se muestra en sus


https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaEntConTerV2.w



______________________________________________________________________Página 14 de 17

Esquema del mensaje terminal. https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaEntConTerV2Ent.xsd

Datos de negocio del mensaje cancelación de entrada de contenedor en la terminalInformación



Fecha a la Entrada

Hora a la Entrada

Regla: Es necesario indicar en los campos ”“Hora a la Entrada” exactamente los mismos valores que se enviaron en su momento en el mensaje “EntradaConTerV2Ent ”. Estos valores que se quiere cancelar.

Esquema del mensaje de Respuesta al envío contenedor en la terminalhttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaEntConTerV2Sal.xsd

9. Servicio Web de la terminal

Mensajes del servicio

Nomb re

CancelaSalConTerV2Ent

CancelaSalConTerV2Sal





______________________________________________________________________

quema del mensaje de cancelación de entrada de contenedor en la

atic_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaEntConTerV2E

Datos de negocio del mensaje cancelación de entrada de contenedor en la terminal Formato Obligatorio / ;otas.

Contenedor A11 SI

Formato:AAAANNNNNNN

Tamaño exacto: 11

A10 SI

Tamaño minimo:

A8 SI


N6 SI


Es necesario indicar en los campos ”Identificador del Contenedor”, “Ubicación a la Entrada”, “Fecha a la Entrada” y “Hora a la Entrada” exactamente los mismos valores que se enviaron en su momento en el mensaje

”. Estos valores -que no son modificables- sirven para identificar unívoca

Esquema del mensaje de Respuesta al envío de cancelación contenedor en la terminal . https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaEntConTerV2S

Servicio Web de cancelación de salida de contenedor

Descripción

Envío de Datos del mensaje de cancelación de contenedor de una terminal portuaria. Respuesta de la administración aduanera.

Mensajes implicados en servicio Web de cancelación de salida de contenedor


Versión 2.2

______________________________________________________________________


atic_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaEntConTerV2E

Datos de negocio del mensaje cancelación de entrada de contenedor en la terminal Obligatorio / ;otas.

o:AAAANNNNNNN

Tamaño exacto: 11

8, máximo: 10.



”, “Ubicación a la Entrada”, “Fecha a la Entrada” y “Hora a la Entrada” exactamente los mismos valores que se enviaron en su momento en el mensaje

sirven para identificar unívocamente la entrada

de cancelación de entrada de

https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaEntConTerV2S

salida de contenedor de

cancelación de salida de un


salida de contenedor de la terminal.



______________________________________________________________________Página 15 de 17



Defin ición del Servicio Web terminal. https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaSalConTerV2.wsdl

Esquema del mensaje dehttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaSalConTerV2Ent.xsd

Datos de negocio del mInformación


Ubicación a la Salida

Fecha de Salida

Hora de Salida

Regla: Es necesario indicar en los campos ”Identificador del Contenedor”, “Ubicación a la Salida”, “Fecha a la Salida” y “Hora a la Salida” exactamente los mismos valores que se enviaron en su momento en el mensaje “SalidaConTerV2Ent”. Estos valores se quiere cancelar. Solo se podrá cancelar la salida de un contenedor en cada mensaje.

Esquema del mensaje de Respuesta al envío decontenedor de la terminalhttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanasal.xsd




______________________________________________________________________



ición del Servicio Web de cancelación de salida de contenedor de la

/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaSalConTerV2.w

Esquema del mensaje de cancelación de salida de contenedor de la terminalhttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaSalConTerV2E

Datos de negocio del mensaje cancelación de salida de contenedor de

Formato Obligatorio / ;otas.

Identificador del Contenedor A11 SI

Formato:AAAANNNNNNN

Tamaño exacto: 11

A10 SI

Tamaño minimo:

A8 SI


N6 SI


Es necesario indicar en los campos ”Identificador del Contenedor”, “Ubicación a la Salida”, “Fecha a la Salida” y “Hora a la Salida” exactamente los mismos valores que se enviaron en su momento en el mensaje

daConTerV2Ent”. Estos valores -que no son modificables- sirven para identificar unívocamente la se quiere cancelar. Solo se podrá cancelar la salida de un contenedor en cada mensaje.

Esquema del mensaje de Respuesta al envío de cancelación decontenedor de la terminal . https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaSalConTerV2S


Versión 2.2

______________________________________________________________________


salida de contenedor de la

/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaSalConTerV2.w

salida de contenedor de la terminal . https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaSalConTerV2E

ensaje cancelación de salida de contenedor de la terminal Obligatorio / ;otas.

Formato:AAAANNNNNNN

Tamaño exacto: 11

8, máximo: 10.



Es necesario indicar en los campos ”Identificador del Contenedor”, “Ubicación a la Salida”, “Fecha a la Salida” y “Hora a la Salida” exactamente los mismos valores que se enviaron en su momento en el mensaje

sirven para identificar unívocamente la salida que se quiere cancelar. Solo se podrá cancelar la salida de un contenedor en cada mensaje.

cancelación de salida de

/es/aeat/dit/adu/adct/ws/CancelaSalConTerV2S



______________________________________________________________________Página 16 de 17

10. Esquemas comunes de los Servicios Define la mayoría de los tipos de datos comunes al resto de esquemas utilizados en el sistema. Cuando el tipo de datos no es común a varios mensajes está definido en elhttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/Da

11. Información complementaria En todos los servicios indicados en los apartados anteriores, el inicio de la comunicación parte de la terminal a través del envío de un mensaje XML correcta identificación de estos pares de mensajes, el atributo ““id” que el mensaje original. Todos los mensajes de respuesta de la Aduana llevan un “y ha sido aceptado (valor “OK”) o rechazado por contener errores

Los mensajes rechazados contendránel rechazo y, cuando proceda, el contenedor asociado a d

En el mensaje “SalidaConTerV2Entexcluyentes, es decir, solo puede rellenarse uno de los dos. El campo ““M”, marítima; “C”, carretera o camión; “F”, ferroviaria o tren.cuando el “modoSalida” sea marítimo (“M”Cuando la salida sea por carretera (“C”), se incluirá la matrícula delidentificador del tren o vagón.

12. Herramienta para envío La Agencia Tributaria distribuye para aquellas empresas a las que les pueda ser deAduanetXML para el envío - recepción de ficheros xml. Esta herramienta permiterecepción) de declaraciones XML con la Agenciaestructura predefinida de directorios. La documentación técnica con la https://www3.agenciatributaria.gob.es/static_files/common/intern En caso de usar el AduanetXML para efectuar el envío de los mensajes xml, hay que Respecto al envío: La aplicación extrae a qué Servicio Web se ha de invocartanto, si el NameSpace principal declarado es:xmlns="https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adradaConTerV2Ent.xsd" el 'AduanetXml' sabe que el Servicio a invohttps://www1.agenciatributaria.gob.es/L/inwinvoc/es.aeat.dit.adu.ad Para enviar mensajes de Pruebas con namespace del elemento raíz del mensaje XMEntradaConTerV2Ent.xsd pasa a ser dará cuenta de que tiene que dirigir la petición al servicio de pruebas.




______________________________________________________________________

Esquemas comunes de los Servicios

Define la mayoría de los tipos de datos comunes al 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. https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/Da

Información complementaria

En todos los servicios indicados en los apartados anteriores, el inicio de la comunicación parte de la terminal a XML hacia la Aduana, la cual responde con otro mensaje. Para ase

correcta identificación de estos pares de mensajes, el atributo “id” en la respuesta de la Aduana contiene el mismo

de la Aduana llevan un “codigoRespuesta” indicandoo rechazado por contener errores (valor “ER”).

os mensajes rechazados contendrán, además, una lista de errores indicando los códigos y motivos , el contenedor asociado a dicho error.

SalidaConTerV2Ent ”, los campos “manifiestoCarga” y “matrículaSalidaexcluyentes, es decir, solo puede rellenarse uno de los dos. El campo “modoSalida

amión; “F”, ferroviaria o tren. Se deberá rellenar el campo sea marítimo (“M”), y el campo “matrículaSalida” en el resto de los modos de salida.

Cuando la salida sea por carretera (“C”), se incluirá la matrícula del camión y cuando sea por ferrocarril (“F”), el

Herramienta para envío – recepción de mensajesLa Agencia Tributaria distribuye para aquellas empresas a las que les pueda ser de

recepción de ficheros xml. Esta herramienta permite recepción) de declaraciones XML con la Agencia Tributaria de forma automatizada y

directorios.

con la información relativa a esta herramientahttps://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/aduanetxml/aduanetxml.html

En caso de usar el AduanetXML para efectuar el envío de los mensajes xml, hay que

La aplicación extrae a qué Servicio Web se ha de invocar, del NameSpace principal declarado para el mismo. Portanto, si el NameSpace principal declarado es:

.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/ad

que el Servicio a invocar es: https://www1.agenciatributaria.gob.es/L/inwinvoc/es.aeat.dit.adu.adct.ws.EntradaConTer

con esta herramienta, se debe efectuar un pequeño cambio en la declaración del elemento raíz del mensaje XML, cambiando la letra 'V' de versión

pasa a ser EntradaConTerP2Ent.xsd ). Con este pequeño cambio, la herramienta se dará cuenta de que tiene que dirigir la petición al servicio de pruebas.


Versión 2.2

______________________________________________________________________

Define la mayoría de los tipos de datos comunes al resto de esquemas utilizados en el sistema. Cuando el tipo de

https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/DatosConTerV2.xsd

En todos los servicios indicados en los apartados anteriores, el inicio de la comunicación parte de la terminal a con otro mensaje. Para asegurar la

” en la respuesta de la Aduana contiene el mismo

ndo que el mensaje es correcto

una lista de errores indicando los códigos y motivos que originan

matrículaSalida” son mutuamente modoSalida” podrá contener los valores:

rellenar el campo “manifiestoCarga” en el resto de los modos de salida.

camión y cuando sea por ferrocarril (“F”), el

recepción de mensajes La Agencia Tributaria distribuye para aquellas empresas a las que les pueda ser de utilidad la herramienta

el intercambio (firma, envío y Tributaria de forma automatizada y desatendida en base a una

información relativa a esta herramienta se puede consultar en et/dep/aduanas/aduanetxml/aduanetxml.html

En caso de usar el AduanetXML para efectuar el envío de los mensajes xml, hay que tener en cuenta lo siguiente:

declarado para el mismo. Por

.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/Ent

EntradaConTerV2SOAP

debe efectuar un pequeño cambio en la declaración del de versión por la letra 'P' (ejemplo:

Con este pequeño cambio, la herramienta se



______________________________________________________________________Página 17 de 17

13. Sistema de PruePara enviar mensajes de Pruebas, sefuera: xmlns=https://www3.agenciatributaria.gob.es/adaConTerV2Ent.xsd el Servicio a invocar para Operar en Realhttps://www1.agenciatributaria.gob.es/L/inwinvoc/es.aeat.dit.adu. mientras que para Operar en Pruebahttps://www1.agenciatributaria.gob.es/L/inwinvoc/es.aeat.dit.adu.

14. Ejemplos Ejemplo de mensaje de envío de un

<?xml version="1.0" encoding="UTF-8"?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/xmlns:xsd="http://www.w3.org/2001/X <soapenv:Header/> <soapenv:Body Id="Body"> <EntradaConTerV2Ent xmlns="https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaConTerV2Ent.xsd" id="20121212115600000009 <idContenedor>ROSC0001116</ <ubicacionEntrada>0860K50033 <fechaEntrada>20121205</fechaEntrada <horaEntrada>122000</horaEntrada <indicadorLlenoEntrada>S</indicadorLleno <matriculaEntrada>MATRI123456 </EntradaConTerV2Ent> </soapenv:Body> </soapenv:Envelope>

Ejemplo de mensaje de respuesta

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/xmlns:xsd="http://www.w3.org/2001/XMLSchema <soapenv:Header/> <soapenv:Body Id="Body"> <EntradaConTerV2Sal id="20121212115600000007xmlns="https://www3.agenciatributaria.gob.es/static_files/common/nTerV2Sal.xsd"> <codigoRespuesta>OK</codigoRespuesta </EntradaConTerV2Sal> </soapenv:Body> </soapenv:Envelope>




______________________________________________________________________

Sistema de Prue bas ara enviar mensajes de Pruebas, se debe invocar a un servicio diferente. Por ejemplo,

.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/ad

Operar en Real sería: https://www1.agenciatributaria.gob.es/L/inwinvoc/es.aeat.dit.adu.adct.ws.EntradaConTer

Operar en Prueba s sería: https://www1.agenciatributaria.gob.es/L/inwinvoc/es.aeat.dit.adu.adct.ws.EntradaConTer

Ejemplo de mensaje de envío de una entrada de contenedor en terminal:

8"?> http://schemas.xmlsoap.org/soap/envelope/"

http://www.w3.org/2001/XMLSchema">

https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaCo20121212115600000009">

</idContenedor> 0860K50033</ubicacionEntrada>

fechaEntrada> horaEntrada>

indicadorLlenoEntrada> MATRI123456</matriculaEntrada>

Ejemplo de mensaje de respuesta de entrada de contenedor en terminal con admisión:

http://schemas.xmlsoap.org/soap/envelope/" http://www.w3.org/2001/XMLSchema">

20121212115600000007" https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaCo

codigoRespuesta>


Versión 2.2

______________________________________________________________________

invocar a un servicio diferente. Por ejemplo, si el NameSpace principal

tatic_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/Entr

EntradaConTerV2SOAP

ntradaConTerP2SOAP

https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaCo

con admisión:

internet/dep/aduanas/es/aeat/dit/adu/adct/ws/EntradaCo

Documents

Servicio de intercambio de información de entrada y …...De partamento de Informática Tributaria Subdirección General de Aplicaciones de Aduanas e II.EE C/ Santa María Magdalena