Post on 14-Apr-2020
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
Servicio de intercambio de información de entrada y salida de contenedores en
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.
Servicio de intercambio de información de entrada y salida de contenedores en
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
6.1. Información del servicio web.
7. SERVICIO WEB DE MODIDECLARADO ................................
7.1. Información del servicio web.
8. SERVICIO WEB DE CANCTERMINAL ................................
8.1. Información del servicio web.
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
Información del servicio web. ................................................................
SERVICIO WEB DE MODIFICACIÓN DE DATOS DE UN CONTENEDOR PREVIA................................................................................................
Información del servicio web. ................................................................
SERVICIO WEB DE CANCELACIÓN DE ENTRADA DE CONTENEDOR EN LA ................................................................................................
Información del servicio web. ................................................................
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
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________Página 3 de 17
9.1. Información del servicio web.
10. ESQUEMAS COMUNES DE
11. INFORMACIÓN COMPLEMENTARIA
12. HERRAMIENTA PARA ENV
13. SISTEMA DE PRUEBAS ................................
14. EJEMPLOS ................................
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.
______________________________________________________________________
Información del servicio web. ................................................................
ESQUEMAS COMUNES DE LOS SERVICIOS ................................
COMPLEMENTARIA ................................................................
HERRAMIENTA PARA ENVÍO – RECEPCIÓN DE MENSAJES ................................
................................................................................................
................................................................................................
eral de Aplicaciones de Aduanas e II.EE.
Versión 2.2
______________________________________________________________________
................................................................15
..................................................................16
................................................16
........................................16
.....................................17
.........................................................17
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________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
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.
______________________________________________________________________
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.
eral de Aplicaciones de Aduanas e II.EE.
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.
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________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
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.
______________________________________________________________________
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
eral de Aplicaciones de Aduanas e II.EE.
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
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________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/
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.
______________________________________________________________________
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
eral de Aplicaciones de Aduanas e II.EE.
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:
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________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).
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.
______________________________________________________________________
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).
eral de Aplicaciones de Aduanas e II.EE.
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
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________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
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.
______________________________________________________________________
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
eral de Aplicaciones de Aduanas e II.EE.
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.
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________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
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.
______________________________________________________________________
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
eral de Aplicaciones de Aduanas e II.EE.
Versión 2.2
______________________________________________________________________
Fecha en formato: AAAAMMDD.
ato: HHMMSS.
Valores posibles: {S,N}
S indica lleno, N indica vacío.
Sirve para indicar si el contenedor tiene
mercancía en su interior.
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.
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________Página 10 de 17
6.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
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
Identificador del Contenedor
Fecha de Salida
Hora de Salida
Indicador de Lleno a la Salida
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.
______________________________________________________________________
Información del servicio web.
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
Fecha en formato: AAAAMMDD.
N6 SI
Hora en formato: HHMMSS.
Indicador de Lleno a la Salida A1 SI
Valores posibles: {S,N}
eral de Aplicaciones de Aduanas e II.EE.
Versión 2.2
______________________________________________________________________
La información necesaria para cumplimentar los distintos mensajes descritos es la que se muestra en sus
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)
Solo obligatorio para Modo de salida =
Solo obligatorio para Modo de salida =
Para Modo = C, indicar matrícula del
Para Modo = F, indicar identificador el
AAAANNNNNNN
Tamaño exacto: 11
Fecha en formato: AAAAMMDD.
Hora en formato: HHMMSS.
Valores posibles: {S,N}
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________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
7.1. Información del servicio web.
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
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.
______________________________________________________________________
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
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
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 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
eral de Aplicaciones de Aduanas e II.EE.
Versión 2.2
______________________________________________________________________
S indica lleno, N indica vacío.
car si el contenedor tiene
mercancía en su interior.
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
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________Página 12 de 17
Datos de negocio del mensaje Información
Identificador del Contenedor
Ubicación a la Entrada
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
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.
______________________________________________________________________
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
Fecha en formato: AAAAMMDD.
N6 SI
Hora en formato: HHMMSS.
a la Entrada A1 NO
Valores posibles: {S,N}
S indica lleno, N indica vacío.
Sirve para indicar
mercancía en su interior.
A15 NO
A17 NO
A17 NO
a la Entrada A5 NO
Tamaño exacto: 5
A25 NO.
Solo obligatorio para M
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.
Indicador de Lleno a la Salida A1 NO
Valores posibles: {S,N}
S indica lleno, N indica vacío.
Sirve para indicar si el contenedor tiene
mercancía en su interior.
eral de Aplicaciones de Aduanas e II.EE.
Versión 2.2
______________________________________________________________________
de un contenedor Obligatorio / ;otas.
Formato:AAAANNNNNNN
Tamaño exacto: 11
8, máximo: 10.
Fecha en formato: AAAAMMDD.
Hora en formato: HHMMSS.
Valores posibles: {S,N}
S indica lleno, N indica vacío.
Sirve para indicar si el contenedor tiene
mercancía en su interior.
Tamaño exacto: 5
Solo obligatorio para Modo de salida =
Solo obligatorio para Modo de salida =
Para Modo = C, indicar matrícula del
Para Modo = F, indicar identificador el
Valores posibles: {S,N}
indica lleno, N indica vacío.
Sirve para indicar si el contenedor tiene
mercancía en su interior.
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________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
Tabla 1. Mensajes implicados en servicio Web de
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
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.
______________________________________________________________________
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.
Información del servicio web.
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
eral de Aplicaciones de Aduanas e II.EE.
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 .
Respuesta de la administración aduanera.
entrada de contenedor en terminal.
necesaria para cumplimentar los distintos mensajes descritos es la que se muestra en sus
entrada de contenedor en la
https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/dit/adu/adct/ws/CancelaEntConTerV2.w
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________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
Identificador del Contenedor
Ubicación a la Entrada
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
Tabla 2. Mensajes implicados en servicio Web de
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.
______________________________________________________________________
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
Fecha en formato: AAAAMMDD.
N6 SI
Hora en formato: HHMMSS.
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
eral de Aplicaciones de Aduanas e II.EE.
Versión 2.2
______________________________________________________________________
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 Obligatorio / ;otas.
o:AAAANNNNNNN
Tamaño exacto: 11
8, máximo: 10.
Fecha en formato: AAAAMMDD.
Hora en formato: HHMMSS.
”, “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
Respuesta de la administración aduanera.
salida de contenedor de la terminal.
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________Página 15 de 17
9.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.
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
Identificador del Contenedor
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
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.
______________________________________________________________________
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.
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
Fecha en formato: AAAAMMDD.
N6 SI
Hora en formato: HHMMSS.
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
eral de Aplicaciones de Aduanas e II.EE.
Versión 2.2
______________________________________________________________________
La información necesaria para cumplimentar los distintos mensajes descritos es la que se muestra en sus
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.
Fecha en formato: AAAAMMDD.
Hora en formato: HHMMSS.
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
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________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.
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.
______________________________________________________________________
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.
eral de Aplicaciones de Aduanas e II.EE.
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
Departamento de Informática TributariaSubdirección General de Aplicaciones de Aduanas e II.EE
Control de contenedores en terminales portuarias
______________________________________________________________________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>
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.
______________________________________________________________________
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>
eral de Aplicaciones de Aduanas e II.EE.
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