1. No category

Departamento de Informática Tributaria
Subdirección General de Aplicaciones de Aduanas e II.EE.
C/ Santa María Magdalena 16, 28016 Madrid
Servicio de Exportación
Definición de requisitos.
S.G.A.A.
Autor:
17/02/2015
Fecha:
0.2
Versión:
Revisiones
Edi.
Rev.
Fecha
Descripción
A(*) Páginas
0
0
1
2
25/09/2013
17/02/2015
Versión inicial
Cambio de URL
A
R
(*) Acción:
A= Añadir;
Todas
2,5,7
R= Reemplazar
Índice:
1.
Control de versiones
2
1.1.
Primera versión v0.1
2
1.2.
Segunda versión v0.2
2
2.
Introducción
2
3.
Estándares utilizados
2
4.
Consulta de Exportación
3
4.1.
Modelo de difusión de la información
4.2.
Especificaciones de diseño
4.2.1. Requisitos:
4.2.2. Diseño propuesto para el intercambio de información de certificados
4.2.3. Consulta de Exportación – ConsAutV2.wsdl
5.
6.
Consideraciones de diseño
4
5
5
5
5
6
5.1.
Versionado
6
5.2.
Comunicación de incidencias en el procesado de las declaraciones.
6
Ejemplo de uso
7
Página: 1/7
Departamento de Informática Tributaria
Subdirección General de Aplicaciones de Aduanas e II.EE.
Servicios de consulta de Exportación
1.
Versión: 0.2
Control de versiones
1.1. Primera versión v0.1
Versión inicial del servicio web.
1.2. Segunda versión v0.2
Cambios de las URLs de acceso al servicio:
https://www1.agenciatributaria.gob.es/L/inwinvoc/es.aeat.adex.jdit.ws.consaut.ConsAutV2SOAP
2.
Introducción
El presente servicio se proporciona para informar de la situación de despacho de un MRN
de Exportación, de su estado y de la aduana real de salida de la mercancía. A dicha
información podrán acceder el exportador, el declarante o el declarante de llegada,
además de las personas autorizadas por estos mediante los mecanismos habituales
habilitados para este fin.
Toda la documentación técnica relativa a este servicio web se encuentra publicada bajo el
epígrafe “Consulta de Exportación” en la página de internet:
https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/ws.html
3.
Estándares utilizados
El 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 interviene 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 será descrita sobre la base de la creación de esquemas XML
utilizando para ello la recomendación W3C de 28-Octubre de 2004 en
http://www.w3.org/TR/xmlschema-0
y
referenciada
por
el
namespace
http://www.w3.org/2001/XMLSchema
Con relación a SOAP se utilizará SOAP V1.1 disponible como NOTA W3C de 08Mayo-2000 en : http://www.w3.org/TR/2000/NOTE-SOAP-20000508/ y referenciado
por el namespace http://schemas.xmlsoap.org/soap/envelope/
En SOAP-1.1 existen dos estilos para implementar servicio, modo “rpc” y modo
“document”, en línea con las recomendaciones actuales se utilizará siempre el modo
“document” (style=”document”) sin ningún tipo de codificación (use=”literal”). Es decir
el mensaje de entrada y salida estará descrito íntegramente por su respectivo esquema
XML.
Pág: 2/7
Departamento de Informática Tributaria
Subdirección General de Aplicaciones de Aduanas e II.EE.
Servicios de consulta de Exportación
Versión: 0.2
Con relación a la descripción de los servicios utilizaremos WSDL 1.1 disponible como
NOTA W3C de 14-Marzo-2001 en: http://www.w3.org/TR/2001/NOTE-wsdl-20010315
y referenciado por el namespace http://schemas.xmlsoap.org/wsdl/.
4.
Consulta de Exportación
En este apartado detallamos a nivel funcional qué se intercambia entre el solicitante
(cliente) del servicio y la AEAT.
Información a enviar a la AEAT
Formato
Obligatorio
MRN
A18
SI
Respuesta de la AEAT
Formato
Obligatorio
MRN
Despachado
EstadoECS
AduanaSalidaECS
A18
A2
A2
A8
SI
SI
NO
NO
El campo “Despachado” puede contener los valores SI, NO o NE en función del estado
de Despacho de ese Documento.
Valores Significado de la repuesta de la AEAT
SI
NO
MRN DESPACHADO
MRN NO DESPACHADO
El campo “AduanaSalidaECS” puede contener los valores de la aduana real de salida de
la mercancía. Puede ser cualquiera de los valores de la "Customs Office List – COL"
(listado oficial de las aduanas europeas).
Valores Significado de la repuesta de la AEAT
FR006010
ES002801
Paris Aeroespacial
Barajas Aeropuerto
Pág: 3/7
Departamento de Informática Tributaria
Subdirección General de Aplicaciones de Aduanas e II.EE.
Servicios de consulta de Exportación
Versión: 0.2
...
...
El campo “EstadoECS” puede contener los valores del estado de la Exportación ECS.
Valores
Significado de la
repuesta de la AEAT
Envío de EAL necesario
para dar salida efectiva
AN
DE
DS
PL
PS
RC
RE
RO
RQ
RZ
SA
SD
SG
SR
ST
SV
Anulado
Despachado Indirecto
Despachado Directo
Pendiente Levante
Pendiente de Salida
Recapitulativo
Recibido
Recibida en otro País
Solicitada a UE
Desvío rechazado
Salida Efectiva
Salió por Valor Directa
Sin Grabar
Salió por Valor-Recibido
Parado
Salió por Valor
NO
SI
NO
NO
NO
NO
NO
NO
NO
NO
NO
NO
NO
OPCIONAL
NO
OPCIONAL
4.1. Modelo de difusión de la información
Cliente
A.E.A.T.
Clave MRN
Despachado (SI/NO/NE)
Estado ECS (PL/DE/...)
Adu. Salida (FR006010/...)
Pág: 4/7
Departamento de Informática Tributaria
Subdirección General de Aplicaciones de Aduanas e II.EE.
Servicios de consulta de Exportación
Versión: 0.2
4.2. Especificaciones de diseño
4.2.1. Requisitos:
Obtener información relativa a la situación de Despacho de un DUA de Exportación.
4.2.2. Diseño propuesto para el intercambio de información de certificados
El cliente debe enviar el MRN sobre el que quiere obtener la información de Despacho.
La AEAT devolverá de forma síncrona una respuesta indicando el estado de Despacho.
Para realizar esta funcione se crean el siguiente Servicios Web
Proceso
Consulta de
Exportación
Servicio WEB
ConsAutV2
Descripción
Origen
Consulta de estado de Despacho de Cliente
MRN de Exportación, estado ECS
y aduana de salida.
Destino
AEAT
4.2.3. Consulta de Exportación – ConsAutV2.wsdl
La consulta de Exportación se trasladará a la AEAT para ello se utilizará el servicio
descrito por “ConsAutV2.wsdl” para obtener los datos de la situación de despacho.
En la definición de este servicio se describe que el mensaje de entrada se basa en el
esquema ConsAutV2Ent.xsd y la respuesta en el esquema ConsAutV2Sal.xsd
La información necesaria para cumplimentar los distintos mensajes descritos es la que se
muestra en sus esquemas. Se indica qué 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/d
it/adu/adex/ws/consaut/ConsAutV2.wsdl
Esquema del mensaje de consulta:
https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/d
it/adu/adex/ws/consaut/ConsAutV2Ent.xsd
Esquema del mensaje de respuesta:
https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/d
it/adu/adex/ws/consaut/ConsAutV2Sal.xsd
Pág: 5/7
Departamento de Informática Tributaria
Subdirección General de Aplicaciones de Aduanas e II.EE.
Servicios de consulta de Exportación
5.
Versión: 0.2
Consideraciones de diseño
5.1. Versionado
Los servicios se definirán con un convenio de versionado que facilite que las futuras
actualizaciones sean reconocibles y por tanto diferenciables. Para ello detrás del nombre
del servicio y de todos los objetos relacionados se incluye un número de versión.
5.2. Comunicación de incidencias en el procesado de las
declaraciones.
En caso de incidencias en la aplicación estás serán comunicadas tal como se
describen en el protocolo SOAP V1.1, es decir utilizando el elemento FAULT.
A modo de resumen como respuesta a una petición se pueden producir los
siguientes casos:
Resultado
Acción
Recibimos una respuesta con el xml
esperado
OK. Mensaje procesado
Recibimos un respuesta con elemento
FAULT y faultcode del tipo
“soapenv:Server.”
Reenviar mensaje
No progresa la trasmisión o bien no
recibimos un documento xml que responde
a lo esperado
Reenviar mensaje
Recibimos un respuesta con elemento
FAULT y faultcode del tipo
“soapenv:Client.”
La respuesta enviada NO es formalmente
incorrecta, o bien contiene referencia única
duplicada de otra con distinto contenido.
La declaración NO se debe reenviar.
Pág: 6/7
Departamento de Informática Tributaria
Subdirección General de Aplicaciones de Aduanas e II.EE.
Servicios de consulta de Exportación
6.
Versión: 0.2
Ejemplo de uso
Mensaje de consulta
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:con="https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/adex
/jdit/ws/consaut/ConsAutV2Ent.xsd">
<soapenv:Header/>
<soapenv:Body>
<con:ConsAutV2Ent>
<con:MRN>14ES00999910002247</con:MRN>
</con:ConsAutV2Ent>
</soapenv:Body>
</soapenv:Envelope>
Mensaje de respuesta
<?xml version="1.0" encoding="UTF-8"?>
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body Id="Body">
<ConsAutV2Sal
xmlns="https://www3.agenciatributaria.gob.es/static_files/common/internet/dep/aduanas/es/aeat/adex/jdit/
ws/consaut/ConsAutV2Sal.xsd">
<MRN>14ES00999910002247</MRN>
<Despachado>NO</Despachado>
<EstadoECS>AN</EstadoECS>
<AduanaSalidaECS>ES009999</AduanaSalidaECS>
</ConsAutV2Sal>
</env:Body>
</env:Envelope>
Pág: 7/7