Upload
phungkien
View
219
Download
0
Embed Size (px)
Citation preview
Sistema de Información de Sanidad Exterior (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Servicio Web de Presentación de Declaraciones
por parte de los Operadores Económicos
Descripción Funcional
25 de Abril de 2007
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 2 de 45
Contenido
CONTENIDO ............................................................................................................................2
1. INTRODUCCIÓN .................................................................................................................3
2. DESCRIPCIÓN DEL SERVICIO WEB ................................................................................4
2.1. FIRMA DIGITAL DE LAS PETICIONES ................................................................................................5
2.2. DOCUMENTACIÓN ADJUNTA ...........................................................................................................7
2.3. COMPRESIÓN DE DATOS................................................................................................................8
3. INFORMACIÓN ASOCIADA A UNA DECLARACIÓN .......................................................9
ANEXO I. FICHERO DECLARACION.XSD...........................................................................17
ANEXO II. FICHERO DECLARACIONES.WSDL..................................................................32
ANEXO III. CÓDIGOS DE RESULTADO DEVUELTOS POR EL SERVICIO WEB..............33
ANEXO IV. CAMBIOS EN EL ESQUEMA RESPECTO A LA VERSIÓN ANTERIOR..........35
CAMBIO EN EL NAMESPACE..................................................................................................................36
DIRECCIONES DE ENTREGA..................................................................................................................37
DOCUMENTOS SANITARIOS / VETERINARIOS..........................................................................................38
DOCUMENTACIÓN ADJUNTA .................................................................................................................39
APELLIDOS DE LOS OPERADORES ECONÓMICOS ...................................................................................40
MEDIO DE TRANSPORTE.......................................................................................................................41
NUEVO TIPO LISTOFDELIVERYADDRESS ..............................................................................................42
NUEVO TIPO LISTOFVETERINARYDOCUMENTS......................................................................................43
NUEVOS TIPOS PARA ANEXAR DOCUMENTOS........................................................................................44
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 3 de 45
1. Introducción
Este documento recoge el Análisis Funcional del Servicio Web de Presentación de Declaraciones por parte de los Operadores Económicos. Esta funcionalidad se engloba dentro del Módulo de Mercancías y Operadores Económicos del Sistema de Información de Sanidad Exterior (SISAEX IV) del Ministerio de Sanidad y Consumo.
El objetivo de este Servicio Web es permitir a los operadores económicos enviar al Módulo de Mercancías y Operadores Económicos toda la información correspondiente a la declaración (Parte 1 del DOCSM) de una manera automática, aprovechando las propias aplicaciones de gestión de los operadores económicos, y sin tener que volver a introducir los datos en SISAEX IV.
En los anexos del presente documento se incluyen los dos ficheros que definen este Servicio Web:
• declaracion.xsd: donde se definen los tipos de datos.
• declaraciones.wsdl: donde se define el esquema de llamada al Servicio Web.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 4 de 45
2. Descripción del Servicio Web
Existen dos maneras de incorporar la información de las declaraciones telemáticas realizadas por los operadores económicos:
• Directamente en la aplicación, accediendo a la página web de SISAEX IV: https://sisaex4.msc.es.
• Mediante la recepción de las declaraciones a través de un Servicio Web ubicado en los servidores del MSC.
En este documento se describe la segunda de estas alternativas.
El Servicio Web estará publicado en las siguientes direcciones.
• Pilotaje:
https://saexpiloto.msc.es/mercancias/webservices/RegistraDeclaracionPort?WSDL
• Producción:
https://sisaex4.msc.es/mercancias/webservices/RegistraDeclaracionPort?WSDL
De estas direcciones se puede descargar además la última versión disponible de los ficheros de definición del Servicio Web. La última versión del fichero de definición del esquema XSD está disponible en la dirección:
https://saexpiloto.msc.es/mercancias/declaracion.xsd
La llamada al Servicio Web se hará mediante el protocolo SOAP basado en Document (adjunto se proporciona la versión actual del esquema).
Será necesaria una llamada por cada declaración a presentar. En esta llamada irán incluidos todos los datos necesarios de la declaración. El sistema devolverá un código de resultado cuyos valores se especifican en el Anexo 3 y, en caso de ser necesario, un texto con más información.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 5 de 45
2.1. Firma Digital de las Peticiones
Las peticiones enviadas deberán ser firmadas digitalmente. La firma digital será añadida después de haber completado toda la información, y deberá abarcar todo el documento.
Se seguirá la propuesta para firma digital “SOAP Security Extensions Digital Signature” (http://www.w3.org/TR/SOAP-dsig/). Siguiendo este esquema, la petición será del tipo:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Header> <SOAP-SEC:Signature xmlns:SOAP-SEC="http://schemas.xmlsoap.org/soap/security/2000-12" SOAP-ENV:actor="some-URI" SOAP-ENV:mustUnderstand="1"> <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#"> <ds:SignedInfo> <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2000/CR-xml-c14n-20001026"> </ds:CanonicalizationMethod> <ds:SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#dsa-sha1"/> <ds:Reference URI="#Body"> <ds:Transforms> <ds:Transform Algorithm="http://www.w3.org/TR/2000/CR-xml-c14n-20001026"/> </ds:Transforms> <ds:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <ds:DigestValue>j6lwx3rvEPO0vKtMup4NbeVu8nk=</ds:DigestValue> </ds:Reference> </ds:SignedInfo> <ds:SignatureValue>MC0CFFrVLtRlk=...</ds:SignatureValue> <ds:KeyInfo>
<ds:X509Data> <!-- certificate chain --> <!--Signer cert, issuer CN=arbolCA,OU=FVT,O=IBM,C=US, serial 4--> <ds:X509Certificate>MIICXTCCA..</ds:X509Certificate> </ds:X509Data> </ds:KeyInfo>
</ds:Signature> </SOAP-SEC:Signature> </SOAP-ENV:Header> <SOAP-ENV:Body xmlns:SOAP-SEC="http://schemas.xmlsoap.org/soap/security/2000-12" SOAP-SEC:id="Body"> ... </SOAP-ENV:Body> </SOAP-ENV:Envelope>
Si el certificado digital utilizado para la conexión HTTPS no es el mismo utilizado para la firma de la petición (por ejemplo en el caso del DNI digital, que dispone de dos certificados diferentes, uno para autenticación y otro para firma digital) será obligatorio incluir el elemento KeyInfo, que contenga el certificado X509 con el que se firma (únicamente la parte pública) para permitir la posterior verificación.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 6 de 45
Para facilitar las pruebas, en el entorno de pilotaje no será necesario firmar las peticiones. Sin embargo si se elige firmarlas se exigirá que sean correctas. De esta forma se garantiza que la firma digita no interfiere en el desarrollo del Servicio Web y que la firma digital se desarrolla de forma correcta.
Los errores producidos durante la verificación de la firma digital se devolverán mediante faults de soap. Para este efecto se ha incluido en la descripción del servicio dos faults:
• FirmaDigitalIncorrectaFault, que será lanzada cuando se produzca un error en la verificación de la firma. Siempre que sea posible se incluirá un mensaje descriptivo del error.
• FirmaDigitalObligatoriaFault, que será lanzada en el entorno de producción cuando no se reciba firma digital. Como se ha comentado antes no será lanzada nunca en el entorno de pilotaje.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 7 de 45
2.2. Documentación Adjunta
Es posible el envío de documentación adjunta relativa al expediente. Esta documentación puede referirse, por ejemplo, a los impresos de tasa o facturas relativas a la mercancía.
El fichero deberá tener como tipo tiff, jpg, gif o pdf. El tamaño máximo de los documentos a adjuntar será de 2 Mb, y se codificarán en Base 64.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 8 de 45
2.3. Compresión de Datos
El Servicio Web está preparado para recibir las peticiones comprimidas usando la codificación GZIP del estándar HTTP. La compresión se puede realizar tanto en la petición como en la respuesta.
Aunque actualmente no es obligatorio utilizar esta opción, sí es altamente recomendable, con el fin de optimizar la utilización de la red, tanto del cliente como del MSC, y mejorar los tiempos de respuesta. Además es posible que en futuras versiones del Servicio Web sea obligatoria su utilización.
Para indicar que el contenido de la petición está comprimido, se deberá utilizar la cabecera HTTP Content-Encoding:
Content-Encoding: gzip
Del mismo modo, para indicar que está preparado para recibir la respuesta comprimido, se deberá incluir la cabecera Accept-Encoding:
Accept-Encoding: gzip
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 9 de 45
3. Información Asociada a una Declaración
En este capítulo se describe la información asociada a la declaración que está contenida en el fichero XML.
Tipo complejo: declaracion
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
exportador Exportador EconomicOperator
PifRah Código del Puesto de Inspección Fronterizo o del Recinto Aduanero Habilitado donde se presenta la declaración
CompetentAuthorityCode string (7)
CentroInspeccion Centro de inspección InspectionCenterCode String(4)
destinatario Destinatario EconomicOperator
Interesado Interesado en la carga EconomicOperator
importador Importador EconomicOperator
paisDeOrigen País de origen CountryISOCode string (2)
paisDeProcedencia País de procedencia CountryISOCode string (2)
direccionesDeEntrega Lista de direcciones de entrega de la mercancía
ListOfDeliveryAddresses
fechaLlegada Fecha de llegada de la mercancía Timestamp1
documentosVeterinarios Lista de Documentos Sanitarios/Veterinarios
ListOfVeterinaryDocuments
establecimientosDeOrigen Lista de establecimientos de origen ListOfEstablishmentsOfOrigin
medioTransporte Medio de transporte MeansOfTransport
Productos Lista de productos ListOfCommodities
contenedores Lista de contenedores y precintos ListOfSealsContainers
destinoDeclarado Destino declarado de la mercancía DeclaratedDestiny
conformeConUE Si la mercancía es conforme con la UE SatisfactoryCheck enumerado2
fechaDeclaracion Fecha de la declaración DateOfDeclaration
documentosAdjuntos Lista de documentos anexos ListOfAttachments
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 10 de 45
1 String con el formato: aaaa-mm-dd hh:mm
2 Valores posibles: satisfactory, notsatisfactory
Tipo complejo: EconomicOperator
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Nif NIF/NIE/CIF del operador económico NIF string (12)
Nombre Nombre del operador económico EOName string (100)
direccionOperador Dirección del operador económico Address
Tipo Tipo de operador económico EOType Enumerado1
numAutorizacion Nº autorización del operador económico ApprovalNumber string (20)
1 Valores posibles: responsible, importer, exporter, other
Tipo complejo: Address
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Calle Nombre de la calle Street string (255)
Ciudad Ciudad y código postal City
codigoISOPais Código ISO del país CountryISOCode string (2)
Tipo complejo: City
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
codPostal Código postal PostalCode string (15)
Nombre Nombre de la ciudad CityName string (50)
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 11 de 45
Tipo complejo: ListOfDeliveryAddresses
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
direccionEntrega Dirección de entrega DeliveryAddress
Tipo complejo: DeliveryAddress
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Direccion Dirección de entrega Address
numAutorizacion Nº autorización de la dirección de entrega ApprovalNumber string (20)
Tipo complejo: ListOfVeterinaryDocuments
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
documentoVeterinario Documento Sanitario / Veterinario VeterinaryDocument
Tipo complejo: VeterinaryDocument
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Numero Número del documento VeterinaryDocumentNumber string (32)
fechaExpedicion Fecha de expedición Date1
1 Formato: aaaa-mm-dd
Tipo complejo: ListOfEstablishmentsOfOrigin
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
establecimientoOrigen Establecimiento de origen EstablishmentOfOrigin
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 12 de 45
Tipo complejo: EstablishmentOfOrigin
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Nombre Nombre del establecimiento de origen EstablishmentName string (32)
Tipo Tipo de establecimiento de origen EOType Enumerado1
numAutorizacion Nº autorización establecimiento de origen ApprovalNumber string (20)
codigoISOPais País del establecimiento CountryISOCode string(2)
1 Valores posibles: responsible, importer, exporter, other
Tipo complejo: MeansOfTransport
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Medio Tipo de medio de transporte MeansType Enumerado1
identificacion Identificación del medio de transporte Identification string (32)
numConocimiento Número de conocimiento o partida Document string (32)
numVagonVehiculoRemolque Número de vagón/vehículo/remolque WagonNumber String(20)
1 Valores posibles: tren, avion, buque, carretera
Tipo complejo: ListOfCommodities
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Producto Producto Commodity
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 13 de 45
Tipo complejo: Commodity
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Temperature Temperatura de conservación Temperature enumerado1
Package Bultos Packages
CommodityCode Código TARIC del producto CommodityCode string (10)
GrossWeight Peso bruto2 nonNegativeDecimal
NetWeight Peso neto2 nonNegativeDecimal
1 Valores posibles: refrigerado, congelado, ambiente
2 En kilogramos, con un máximo de dos decimales (separados por un punto)
Tipo complejo: Packages
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
numBultos Número de bultos nonNegativeInteger
tipoBultos Tipo de bulto TypeOfPackaging string (20)
Tipo complejo: ListOfSealsContainers
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
precintoContenedor Combinación nº contenedor y nº precinto SealContainer
Tipo complejo: SealsContainer
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Precinto Número de precinto SealNumber string (32)
contenedor Número de contenedor ContainerNumber string (20)
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 14 de 45
Tipo complejo: DeclaratedDestiny
Deberá ser uno de los siguientes valores:
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
transbordoA Si la mercancía realiza trasbordo a otro PIF de la UE o a un país tercero
TranshipmentTo
Transito Si la mercancía está destinada al tránsito a un país tercero
TransitToThirdCountry
paraReimportacion Si la mercancía es para reimportación ForReImport
paraMercadoInterior Si la mercancía es para mercado interior ForInternalMarket
paraMercanciasNoConformes Si la mercancía es no conforme ForNonConformingConsignments
Tipo complejo: TranshipmentTo
Deberá ser uno de los siguientes valores:
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Pif PIF de destino del trasbordo CompetentAuthorityCode string (7)
paisTercero País tercero de destino del trasbordo CountryISOCode string (2)
Tipo complejo: TransitToThirdCountry
Deberá ser uno de los siguientes valores:
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
paisTercero País tercero de destino del tránsito CountryISOCode string (2)
pifSalida PIF de salida del tránsito CompetentAuthorityCode string (7)
Tipo complejo: ForInternalMarket
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Tipo Tipo de mercado interior InternalMarketType Enumerado1
descripcionExtra Descripción del uso en caso de seleccionar tipo de mercado interior ‘otro’
string (150)
1 Valores posibles: consumoHumano, alimentacionAnimal, usoFarmaceutico, usoTecnico, otro
Tipo complejo: ForReImport
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 15 de 45
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Nombre Nombre del establecimiento EstablishmentName string (32)
direccionEstablecimiento Dirección del establecimiento Address
numAutorizacion Nº autorización del establecimiento ApprovalNumber string (20)
Tipo complejo: ForNonConformingConsignments
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
destinoNoConforme Tipo de destino de la mercancía NonConformingConsignmentValue enumerado1
identificacion Número de destino de la mercancía RegisteredNumber string (20)
puerto Puerto, si el destino es un buque Port string (20)
1 Valores posibles: depositoAduanero, zonaFranca, provisionistaMaritimo, buque
Tipo complejo: DateOfDeclaration
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Name Nombre del operador económico Name string (100)
SignatureDate Fecha de firma de la declaración Date1
1 Formato: aaaa-mm-dd
Tipo complejo: ListOfAttachments
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Adjunto Documento adjunto Attachment
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 16 de 45
Tipo complejo: Attachment
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
Nombre Nombre del archivo, incluida la extensión FileName string (100)
Tipo Tipo de documento adjunto DocumentType int
descripción Descripción del documento adjunto DocumentDescription string (100)
fichero Fichero propiamente dicho, codificado en Base64 y con un tamaño máximo de 2Mb
File xbase64Binary (2097152)
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 17 de 45
Anexo I. Fichero declaracion.xsd
<xs:schema xmlns="http://sisaex4.msc.es/SisaexNS" xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://sisaex4.msc.es/SisaexNS" elementFormDefault="qualified"> <xs:element name="Peticion" type="PeticionRegistro"></xs:element> <xs:element name="Respuesta" type="Response"></xs:element> <xs:complexType name="PeticionRegistro"> <xs:annotation> <xs:documentation> Petición de registro de una o varias declaraciones </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="XMLSchemaVersion" type="XMLSchemaVersion"> </xs:element> <xs:element name="fechaEnvio" type="Timestamp"></xs:element> <xs:element name="expediente" type="Declaracion" maxOccurs="1"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="Response"> <xs:annotation> <xs:documentation> Respuesta proporcionada por el sistema a una petición de registro </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="fechaEnvio" type="Timestamp"> <xs:annotation> <xs:documentation> Se corresponde con la fecha de envío de la petición </xs:documentation> </xs:annotation> </xs:element> <xs:element name="codigoRespuesta" type="xs:int"> </xs:element> <xs:element name="descrRespuesta" type="xs:string"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="Declaracion"> <xs:annotation> <xs:documentation> Describe los detalles de la declaración presentada </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="exportador" type="EconomicOperator"> </xs:element> <xs:element name="PifRah" type="CompetentAuthorityCode">
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 18 de 45
</xs:element> <xs:element name="CentroInspeccion" type="InspectionCenterCode" minOccurs="0"> </xs:element> <xs:element name="destinatario" type="EconomicOperator"> </xs:element> <xs:element name="interesado" type="EconomicOperator"> </xs:element> <xs:element name="importador" type="EconomicOperator"> </xs:element> <xs:element name="paisDeOrigen" type="CountryISOCode"> </xs:element> <xs:element name="paisDeProcedencia" type="CountryISOCode"> </xs:element> <xs:element name="direccionesDeEntrega" type="ListOfDeliveryAddresses" minOccurs="0"> </xs:element> <xs:element name="fechaLlegada" type="Timestamp"> </xs:element> <xs:element name="documentosVeterinarios" type="ListOfVeterinaryDocuments"> </xs:element> <xs:element name="establecimientosDeOrigen" type="ListOfEstablishmentsOfOrigin" minOccurs="0"> </xs:element> <xs:element name="medioTransporte" type="MeansOfTransport"> </xs:element> <xs:element name="productos" type="ListOfCommodities"> </xs:element> <xs:element name="contenedores" type="ListOfSealsContainers" minOccurs="0"> </xs:element> <xs:element name="destinoDeclarado" type="DeclaratedDestiny"> </xs:element> <xs:element name="conformeConUE" type="SatisfactoryCheck"> </xs:element> <xs:element name="fechaDeclaracion" type="DateOfDeclaration"> </xs:element> <xs:element name="documentosAdjuntos" minOccurs="0" type="ListOfAttachments"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="DeclaratedDestiny"> <xs:annotation> <xs:documentation> Destino declaraco de la mercancía </xs:documentation> </xs:annotation> <xs:choice> <xs:element name="transbordoA" type="TranshipmentTo"> </xs:element>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 19 de 45
<xs:element name="transito" type="TransitToThirdCountry"> </xs:element> <xs:element name="paraReimportacion" type="ForReImport"> </xs:element> <xs:element name="paraMercadoInterior" type="ForInternalMarket"> </xs:element> <xs:element name="paraMercanciasNoConformes" type="ForNonConformingConsignments"> </xs:element> </xs:choice> </xs:complexType> <xs:complexType name="EconomicOperator"> <xs:annotation> <xs:documentation> El operador económico es un Actor del sistema: Exportador, Importador, etc. </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="nif" type="NIF"></xs:element> <xs:element name="nombre" type="EOName"></xs:element> <xs:element name="direccionOperador" type="Address"> </xs:element> <xs:element name="tipo" type="EOType" minOccurs="0"> </xs:element> <xs:element name="numAutorizacion" type="ApprovalNumber" minOccurs="0"> </xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="EOName"> <xs:annotation> <xs:documentation> Nombre del Operador económico </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="100"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="EOType"> <xs:annotation> <xs:documentation> Tipo del operador económico </xs:documentation> </xs:annotation> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="responsible"></xs:enumeration> <xs:enumeration value="importer"></xs:enumeration> <xs:enumeration value="exporter"></xs:enumeration> <xs:enumeration value="other"></xs:enumeration> </xs:restriction> </xs:simpleType>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 20 de 45
<xs:simpleType name="ApprovalNumber"> <xs:annotation> <xs:documentation> Número de autorización del operador </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="20"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="NIF"> <xs:annotation> <xs:documentation> NIF/NIE/CIF del operador económico </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="12"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:complexType name="Address"> <xs:annotation> <xs:documentation>Dirección</xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="calle" type="Street"> </xs:element> <xs:element name="ciudad" type="City"></xs:element> <xs:element name="codigoISOPais" type="CountryISOCode"> </xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="Street"> <xs:annotation> <xs:documentation>Nombre de la calle</xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="255"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:complexType name="City"> <xs:annotation> <xs:documentation>Ciudad y código postal</xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="codPostal" type="PostalCode" minOccurs="0"> </xs:element> <xs:element name="nombre" type="CityName"></xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="PostalCode"> <xs:annotation> <xs:documentation> Representa un código postal
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 21 de 45
</xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="15"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="CityName"> <xs:annotation> <xs:documentation>Nombre de la ciudad</xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="50"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="CountryISOCode"> <xs:annotation> <xs:documentation> Código ISO de dos caracteres: BE, FR, NL,... </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:pattern value="[A-Z][A-Z]"></xs:pattern> </xs:restriction> </xs:simpleType> <xs:simpleType name="CompetentAuthorityCode"> <xs:annotation> <xs:documentation>Código Animo del PIF / RAH. El tamaño es de 7 dígitos para los Pifs y cuatro para los Rah</xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="7"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="InspectionCenterCode"> <xs:annotation> <xs:documentation>Código del Centro de Inpeccción, Si el pif dispusiera de el</xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="4"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:complexType name="VeterinaryDocument"> <xs:annotation> <xs:documentation> Documento Sanitario/Veterinario </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="numero" type="VeterinaryDocumentNumber">
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 22 de 45
</xs:element> <xs:element name="fechaExpedicion" type="Date"></xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="VeterinaryDocumentNumber"> <xs:annotation> <xs:documentation> Número de documento Sanitario/Veterinario </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"> </xs:minLength> <xs:maxLength value="32"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:complexType name="ListOfEstablishmentsOfOrigin"> <xs:annotation> <xs:documentation> Lista de establecimientos de origen </xs:documentation> </xs:annotation> <xs:sequence> <xs:element maxOccurs="unbounded" name="establecimientoOrigen" type="EstablishmentOfOrigin"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="EstablishmentOfOrigin"> <xs:annotation> <xs:documentation> Establecimiento de Origen </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="nombre" type="EstablishmentName"> </xs:element> <xs:element name="tipo" type="EOType" minOccurs="0"> </xs:element> <xs:element name="numAutorizacion" type="ApprovalNumber"> </xs:element> <xs:element name="codigoISOPais" type="CountryISOCode"> </xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="EstablishmentName"> <xs:annotation> <xs:documentation> Nombre de un establecimiento de origen </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="32"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:complexType name="MeansOfTransport">
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 23 de 45
<xs:annotation> <xs:documentation>Medio de transporte</xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="medio" type="MeansType"> </xs:element> <xs:element name="identificacion" type="Identification"> </xs:element> <xs:element name="numConocimiento" type="Document" minOccurs="0"> </xs:element> <xs:element name="numVagonVehiculoRemolque" type="WagonNumber" minOccurs="0"> </xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="MeansType"> <xs:annotation> <xs:documentation> Tipo de medio de tranporte </xs:documentation> </xs:annotation> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="tren"></xs:enumeration> <xs:enumeration value="avion"></xs:enumeration> <xs:enumeration value="buque"></xs:enumeration> <xs:enumeration value="carretera"></xs:enumeration> </xs:restriction> </xs:simpleType> <xs:simpleType name="Identification"> <xs:annotation> <xs:documentation> Identificación del medio de transporte </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="32"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="Document"> <xs:annotation> <xs:documentation> Nº de conocimiento o partida dependiendiendo del tipo de transporte </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="32"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="WagonNumber"> <xs:annotation> <xs:documentation> Número de vagón/vehículo/remolque
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 24 de 45
</xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="20"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:complexType name="Packages"> <xs:annotation> <xs:documentation>Bultos</xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="numBultos" type="nonNegativeInteger"> </xs:element> <xs:element name="tipoBultos" type="TypeOfPackaging"> </xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="TypeOfPackaging"> <xs:annotation> <xs:documentation>Tipo de los bultos</xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="20"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="Temperature"> <xs:annotation> <xs:documentation> Temperatura de conservacón </xs:documentation> </xs:annotation> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="refrigerado"></xs:enumeration> <xs:enumeration value="congelado"></xs:enumeration> <xs:enumeration value="ambiente"> </xs:enumeration> </xs:restriction> </xs:simpleType> <xs:simpleType name="CommodityCode"> <xs:annotation> <xs:documentation> Código Taric del producto </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="10"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:complexType name="ListOfCommodities"> <xs:annotation> <xs:documentation>Lista de productos</xs:documentation> </xs:annotation>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 25 de 45
<xs:sequence> <xs:element maxOccurs="unbounded" name="producto" type="Commodity"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="Commodity"> <xs:annotation> <xs:documentation> Producto incluido en un expediente </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="Temperature" type="Temperature"> </xs:element> <xs:element name="Package" type="Packages"> </xs:element> <xs:element name="CommodityCode" type="CommodityCode"> </xs:element> <xs:element name="GrossWeight" type="nonNegativeDecimal"> </xs:element> <xs:element name="NetWeight" type="nonNegativeDecimal"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="ListOfSealsContainers"> <xs:annotation> <xs:documentation> Lista de combinaciones Precinto / Contenedor </xs:documentation> </xs:annotation> <xs:sequence> <xs:element maxOccurs="unbounded" name="precintoContenedor" type="SealContainer"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="SealContainer"> <xs:annotation> <xs:documentation> Combinación de un número de contenedor y un número de precinto </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="precinto" type="SealNumber"> </xs:element> <xs:element name="contenedor" type="ContainerNumber"> </xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="SealNumber"> <xs:annotation> <xs:documentation>Número de precinto</xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="20"></xs:maxLength>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 26 de 45
</xs:restriction> </xs:simpleType> <xs:simpleType name="ContainerNumber"> <xs:annotation> <xs:documentation>Número de contenedor</xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="20"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:complexType name="TranshipmentTo"> <xs:annotation> <xs:documentation> Usado cuando la mercancía realiza transbordo a otro pif de la unión o a un país tercero </xs:documentation> </xs:annotation> <xs:choice> <xs:element name="pif" type="CompetentAuthorityCode"> </xs:element> <xs:element name="paisTercero" type="CountryISOCode"> </xs:element> </xs:choice> </xs:complexType> <xs:complexType name="TransitToThirdCountry"> <xs:annotation> <xs:documentation> La mercancía está destinada al transito a un país tercero. Será necesario indicar el pif de salida de la unión europea y el país final de destino de la mercancía </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="paisTercero" type="CountryISOCode"> </xs:element> <xs:element name="pifSalida" type="CompetentAuthorityCode"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="ForInternalMarket"> <xs:annotation> <xs:documentation>Para mercado interior</xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="tipo" type="InternalMarketType"/> <xs:element name="descripcionExtra" type="xs:string"> <xs:annotation> <xs:documentation>Obligatorio completar este campo si el tipo de mercado interior es 'otro'</xs:documentation> </xs:annotation> </xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="InternalMarketType"> <xs:annotation> <xs:documentation>Tipo de mercado interior</xs:documentation> </xs:annotation> <xs:restriction base="xs:NMTOKEN">
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 27 de 45
<xs:enumeration value="consumoHumano"></xs:enumeration> <xs:enumeration value="alimentacionAnimal"></xs:enumeration> <xs:enumeration value="usoFarmaceutico"></xs:enumeration> <xs:enumeration value="usoTecnico"></xs:enumeration> <xs:enumeration value="otro"></xs:enumeration> </xs:restriction> </xs:simpleType> <xs:complexType name="ForReImport"> <xs:annotation> <xs:documentation>Para reimportación</xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="nombre" type="EstablishmentName"> </xs:element> <xs:element name="direccionEstablecimiento" type="Address"> </xs:element> <xs:element name="numAutorizacion" type="ApprovalNumber"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="ForNonConformingConsignments"> <xs:annotation> <xs:documentation> Para partidas no conformes </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="destinoNoConforme" type="NonConformingConsignmentValue"> </xs:element> <xs:element name="identificacion" type="RegisteredNumber"> </xs:element> <xs:element name="puerto" type="Port" minOccurs="0"> </xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="RegisteredNumber"> <xs:annotation> <xs:documentation> Número del destino de la mercancía no conforme </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="20"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="Port"> <xs:annotation> <xs:documentation> Nombre del puerto si el destino de la mercancía no conforme es un buque </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 28 de 45
<xs:maxLength value="20"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="NonConformingConsignmentValue"> <xs:annotation> <xs:documentation> Tipo de destino de mercancía no conforme </xs:documentation> </xs:annotation> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="depositoAduanero"> </xs:enumeration> <xs:enumeration value="zonaFranca"></xs:enumeration> <xs:enumeration value="provisionistaMaritimo"> </xs:enumeration> <xs:enumeration value="buque"></xs:enumeration> </xs:restriction> </xs:simpleType> <xs:complexType name="DeliveryAddress"> <xs:annotation> <xs:documentation>Dirección de entrega</xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="direccion" type="Address"></xs:element> <xs:element name="numAutorizacion" type="ApprovalNumber"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="DateOfDeclaration"> <xs:annotation> <xs:documentation> Person filling the details of the consignment presented </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="Name" type="Name"></xs:element> <xs:element name="SignatureDate" type="Date"> </xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="SatisfactoryCheck"> <xs:annotation> <xs:documentation>Satisfactory check</xs:documentation> </xs:annotation> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="satisfactory"></xs:enumeration> <xs:enumeration value="notsatisfactory"></xs:enumeration> </xs:restriction> </xs:simpleType> <xs:simpleType name="nonNegativeDecimal"> <xs:annotation> <xs:documentation> Non negative decimal format </xs:documentation> </xs:annotation> <xs:restriction base="xs:decimal"></xs:restriction> </xs:simpleType>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 29 de 45
<xs:simpleType name="nonNegativeInteger"> <xs:annotation> <xs:documentation> Non negative integer format </xs:documentation> </xs:annotation> <xs:restriction base="xs:int"> <xs:minExclusive value="0"></xs:minExclusive> </xs:restriction> </xs:simpleType> <xs:simpleType name="Date"> <xs:annotation> <xs:documentation>Date format</xs:documentation> </xs:annotation> <xs:restriction base="xs:date"> <xs:pattern value="\d{4}-\d{2}-\d{2}"></xs:pattern> </xs:restriction> </xs:simpleType> <xs:simpleType name="Name"> <xs:annotation> <xs:documentation> Name of an Economic Operator </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="100"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="Timestamp"> <xs:annotation> <xs:documentation>Timestamp format</xs:documentation> </xs:annotation> <xs:restriction base="xs:dateTime"> <xs:pattern value="\d{4}-\d{2}-\d{2} \d{2}:\d{2}"> </xs:pattern> </xs:restriction> </xs:simpleType> <xs:simpleType name="XMLSchemaVersion"> <xs:annotation> <xs:documentation> Version of the XML Schema used to validate the XML file </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="32"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="UserAuthenticationString"> <xs:annotation> <xs:documentation> String object that may hold a user name or a user password </xs:documentation> </xs:annotation> <xs:restriction base="xs:string">
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 30 de 45
<xs:minLength value="5"></xs:minLength> <xs:maxLength value="80"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:complexType name="ListOfDeliveryAddresses"> <xs:annotation> <xs:documentation> Lista de direcciones de entrega </xs:documentation> </xs:annotation> <xs:sequence> <xs:element maxOccurs="unbounded" name="direccionEntrega" type="DeliveryAddress"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="ListOfVeterinaryDocuments"> <xs:annotation> <xs:documentation> Lista de documentos Sanitario/veterinarios </xs:documentation> </xs:annotation> <xs:sequence> <xs:element maxOccurs="unbounded" name="documentoVeterinario" type="VeterinaryDocument"> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="ListOfAttachments"> <xs:annotation> <xs:documentation>Lista de documentos anexos a una declaración</xs:documentation> </xs:annotation> <xs:sequence> <xs:element maxOccurs="unbounded" name="adjunto" type="Attachment"></xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="Attachment"> <xs:annotation> <xs:documentation>Documento anexo a una declaración</xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="nombre" type="FileName"></xs:element> <xs:element name="tipo" type="DocumentType"></xs:element> <xs:element name="descripcion" type="DocumentDescription"></xs:element> <xs:element name="fichero" type="File"></xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="FileName"> <xs:annotation> <xs:documentation> Nombre del fichero adjuntado. Sólo están permitidas las extensiones .JPG, .GIF , .TIF, .TIFF y .PDF </xs:documentation>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 31 de 45
</xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="4"></xs:minLength> <xs:maxLength value="100"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="DocumentType"> <xs:annotation> <xs:documentation> Código del tipo de documento. </xs:documentation> </xs:annotation> <xs:restriction base="xs:int"> <xs:minExclusive value="0"/> <xs:maxExclusive value="1000"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="DocumentDescription"> <xs:annotation> <xs:documentation> Descripción (en texto libre) del documento </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="100"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="File"> <xs:annotation> <xs:documentation> Fichero codificado en Base64, con una longitud máxima de 2Mb (2097152 bytes) </xs:documentation> </xs:annotation> <xs:restriction base="xs:base64Binary"> <xs:maxLength value="2097152"></xs:maxLength> </xs:restriction> </xs:simpleType> </xs:schema>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 32 de 45
Anexo II. Fichero declaraciones.wsdl
<?xml version="1.0" encoding="utf-8"?> <wsdl:definitions xmlns:wsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="SisaexNS" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:ssx="SisaexNS" targetNamespace="SisaexNS" name="sisaexWebService"> <wsdl:types> <xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="SisaexNS"> <xs:import namespace="SisaexNS" schemaLocation="declaracion.xsd"/> </xs:schema> </wsdl:types> <wsdl:message name="RegistraDeclaracionIn"> <wsdl:part name="data" element="ssx:Peticion" /> </wsdl:message> <wsdl:message name="RegistraDeclaracionOut"> <wsdl:part name="data" element="ssx:Respuesta" /> </wsdl:message> <wsdl:portType name="RegistraDeclaracionPort"> <wsdl:operation name="RegistraDeclaracion"> <wsdl:input message="tns:RegistraDeclaracionIn" /> <wsdl:output message="tns:RegistraDeclaracionOut" /> </wsdl:operation> </wsdl:portType> <wsdl:binding name="RegistraDeclaracionBinding" type="tns:RegistraDeclaracionPort"> <wsoap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document" /> <wsdl:operation name="RegistraDeclaracion"> <wsoap:operation soapAction="" style="document" /> <wsdl:input> <wsoap:body use="literal" /> </wsdl:input> <wsdl:output> <wsoap:body use="literal" /> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="RegistraDeclaracionService"> <wsdl:port name="RegistraDeclaracionPort" binding="tns:RegistraDeclaracionBinding"> <wsoap:address location="http://localhost:8000/pruebaServicioWeb/services/PruebaServicioWeb.wsdl" /> </wsdl:port> </wsdl:service> </wsdl:definitions>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 33 de 45
Anexo III. Códigos de Resultado Devueltos por el Servicio Web
CÓDIGO NOMBRE DESCRIPCIÓN
0 PETICION_REGISTRADA El expediente ha sido correctamente registrado en el sistema. En la descripción se devuelve el número de expediente asignado por SISAEX
1 ERROR_USUARIO_NO_AUTORIZADO El usuario no está autorizado para el envío de declaraciones en ese recinto (tanto si es un PIF como si es un RAH). Esto puede suceder porque el usuario correspondiente al certificado digital con el que se envía la declaración no tiene los permisos adecuados o no está autorizado en el recinto en cuestión
2 ERROR_USUARIO_PENDIENTE La solicitud de alta del usuario no ha sido aún tramitada
3 ERROR_USUARIO_RECHAZADO La solicitud de alta ha sido tramitada, y el usuario rechazado
4 ERROR_NIF_INCORRECTO El NIF/CIF especificado en el exportador, el importador, el interesado o el destinatario es incorrecto. Se incluye como descripción de la respuesta el campo que ha provocado el error; por ejemplo:
“El NIF del destinatario es incorrecto”
5 ERROR_PRODUCTO_DESCONOCIDO Uno de los productos enviados no se encuentra en la base de datos de SISAEX
6 ERROR_PRODUCTO_NO_VALIDO Uno de los productos no es válido en el recinto. Puede producirse si el producto no es susceptible de inspección, si el producto es OA y el recinto un RAH, si el producto es NOA y el recinto un PIF o si el producto está repetido
7 ERROR_TIPO_BULTO_DESCONOCIDO El tipo de bulto no se encuentra en la base de datos
8 ERROR_PESOS_INCORRECTOS En alguno de los productos el peso neto es mayor que el peso bruto
9 ERROR_CENTRO_INSPECCION_DESCONOCIDO
El Centro de Inspección no se encuentra en la base de datos de SISAEX
10 ERROR_CAMPO_OBLIGATORIO Se produce un error de validación de campos del expediente. Se incluye una descripción del error; por ejemplo:
“Los campos Temperatura, Nº de Bultos, Peso Bruto y Peso Neto son obligatorios”
“El campo País de Procedencia es obligatorio”
Si se detectan varios errores de este tipo, se pueden devolver todos ellos, separados entre sí por ‘;’
Se devuelven también con este código de error los errores en la secuencia de fechas; por ejemplo:
"El campo Fecha de Llegada no puede ser inferior al día actual"
100 ERROR_DESCONOCIDO Error no controlado en los casos anteriores, por ejemplo cuando la petición no se ajusta al esquema XSD, o cuando existe algún error en los servidores del MSC. Si es un problema en la petición se adjunta un texto descriptivo del problema, aunque como este texto lo proporciona directamente el sistema el texto está en inglés.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 34 de 45
Además, es posible recibir también respuestas http estándar, y las aplicaciones que se conecten al Servicio Web deberían estar preparadas para tratarlas. En particular si el certificado digital no es correcto (no es de alguna de las entidades certificadoras aceptadas por el MSC) o el usuario no está registrado en SISAEX, se recibirá el error 403 (Forbiden). Esto es así porque por seguridad, el control del acceso al sistema lo realiza un componente diferente de la aplicación.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 35 de 45
Anexo IV. Cambios en el Esquema Respecto a la Versión Anterior
Se relacionan en este Anexo todos los cambios realizados en el esquema “declaracion.xsd”, para facilitar la adaptación a la nueva versión del Servicio Web.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 36 de 45
Cambio en el Namespace
El namespace pasa a ser http://sisaex4.msc.es/SisaexNS en vez de únicamente SisaexNS. Además los elementos pasan a ser por defecto ‘qualified’:
Antes
<xs:schema xmlns="SisaexNS" xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="SisaexNS">
Ahora
<xs:schema xmlns="http://sisaex4.msc.es/SisaexNS" xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://sisaex4.msc.es/SisaexNS" elementFormDefault="qualified">
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 37 de 45
Direcciones de Entrega
Las direcciones de entrega pasan a estar englobadas dentro de un elemento de lista, con tipo ListOfDeliveryAddress:
Antes
<xs:element name="direccionEntrega" type="DeliveryAddress" minOccurs="0" maxOccurs="unbounded">
Ahora
<xs:element name="direccionesDeEntrega" type="ListOfDeliveryAddresses" minOccurs="0">
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 38 de 45
Documentos Sanitarios / Veterinarios
Los documentos sanitarios / veterinarios pasan a estar englobados dentro de un documento de lista, con tipo ListOfVeterinaryDocuments.
Antes
<xs:element name="documentosVeterinarios" type="VeterinaryDocument" maxOccurs="unbounded">
Ahora
<xs:element name="documentosVeterinarios" type="ListOfVeterinaryDocuments">
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 39 de 45
Documentación Adjunta
Se ha introducido un nuevo elemento en el tipo ‘Declaracion’ de cara a soportar el envío de documentos anexos (ver documento de Descripción Funcional).
<xs:element name="documentosAdjuntos" minOccurs="0" type="ListOfAttachments"/>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 40 de 45
Apellidos de los Operadores Económicos
Se ha eliminado el campo apellidos del tipo ‘EconomicOperator’.
Antes
<xs:complexType name="EconomicOperator"> <xs:sequence> <xs:element name="nif" type="NIF"></xs:element> <xs:element name="nombre" type="EOName"></xs:element> <xs:element name="apellidos" type="EOName"
minOccurs="0"></xs:element> <xs:element name="direccionOperador" type="Address"> </xs:element> <xs:element name="tipo" type="EOType" minOccurs="0"> </xs:element> <xs:element name="numAutorizacion" type="ApprovalNumber" minOccurs="0"> </xs:element> </xs:sequence> </xs:complexType>
Ahora
<xs:complexType name="EconomicOperator"> <xs:sequence> <xs:element name="nif" type="NIF"></xs:element> <xs:element name="nombre" type="EOName"></xs:element> <xs:element name="direccionOperador" type="Address"> </xs:element> <xs:element name="tipo" type="EOType" minOccurs="0"> </xs:element> <xs:element name="numAutorizacion" type="ApprovalNumber" minOccurs="0"> </xs:element> </xs:sequence> </xs:complexType>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 41 de 45
Medio de Transporte
Se ha cambiado el nombre del elemento que representa al tipo de medio de transporte dentro del tipo MeansOfTransport, para evitar la confusión con el medio de transporte propiamente dicho.
Antes
<xs:complexType name="MeansOfTransport"> <xs:sequence> <xs:element name="medioTransporte" type="MeansType"> </xs:element> <xs:element name="identificacion" type="Identification"> </xs:element> <xs:element name="numConocimiento" type="Document" minOccurs="0"> </xs:element>
<xs:element name="numVagonVehiculoRemolque" type="WagonNumber" minOccurs="0">
</xs:element> </xs:sequence> </xs:complexType>
Ahora
<xs:complexType name="MeansOfTransport"> <xs:sequence> <xs:element name="medio" type="MeansType"> </xs:element> <xs:element name="identificacion" type="Identification"> </xs:element> <xs:element name="numConocimiento" type="Document" minOccurs="0"> </xs:element> <xs:element name="numVagonVehiculoRemolque" type="WagonNumber" minOccurs="0"> </xs:element> </xs:sequence> </xs:complexType>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 42 de 45
Nuevo Tipo ListOfDeliveryAddress
El nuevo tipo contendrá una lista de 1…n direcciones de entrega.
<xs:complexType name="ListOfDeliveryAddresses"> <xs:annotation> <xs:documentation> Lista de direcciones de entrega </xs:documentation> </xs:annotation> <xs:sequence> <xs:element maxOccurs="unbounded" name="direccionEntrega" type="DeliveryAddress"> </xs:element> </xs:sequence> </xs:complexType>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 43 de 45
Nuevo Tipo ListOfVeterinaryDocuments
Contendrá una lista de 1…n documentos Sanitarios/Veterinarios.
<xs:complexType name="ListOfVeterinaryDocuments"> <xs:annotation> <xs:documentation> Lista de documentos Sanitario/veterinarios </xs:documentation> </xs:annotation> <xs:sequence> <xs:element maxOccurs="unbounded" name="documentoVeterinario"
type="VeterinaryDocument"> </xs:element> </xs:sequence> </xs:complexType>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 44 de 45
Nuevos Tipos para Anexar Documentos
<xs:complexType name="ListOfAttachments"> <xs:annotation> <xs:documentation>Lista de documentos anexos a una declaración</xs:documentation> </xs:annotation> <xs:sequence> <xs:element maxOccurs="unbounded" name="adjunto" type="Attachment"></xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="Attachment"> <xs:annotation> <xs:documentation>Documento anexo a una declaración</xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="nombre" type="FileName"></xs:element> <xs:element name="tipo" type="DocumentType"></xs:element> <xs:element name="descripcion" type="DocumentDescription"></xs:element> <xs:element name="fichero" type="File"></xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="FileName"> <xs:annotation> <xs:documentation> Nombre del fichero adjuntado. Sólo están permitidas las extensiones .JPG, .GIF , .TIF, .TIFF y .PDF </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="4"></xs:minLength> <xs:maxLength value="100"></xs:maxLength> </xs:restriction> </xs:simpleType> <xs:simpleType name="DocumentType"> <xs:annotation> <xs:documentation> Código del tipo de documento. </xs:documentation> </xs:annotation> <xs:restriction base="xs:int"> <xs:minExclusive value="0"/> <xs:maxExclusive value="1000"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="DocumentDescription"> <xs:annotation> <xs:documentation> Descripción (en texto libre) del documento </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:minLength value="1"></xs:minLength> <xs:maxLength value="100"></xs:maxLength> </xs:restriction> </xs:simpleType>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Presentación de
Declaraciones por parte de los Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-XMLOE-03.doc Página 45 de 45
<xs:simpleType name="File"> <xs:annotation> <xs:documentation> Fichero codificado en Base64, con una longitud máxima de 2Mb (2097152 bytes) </xs:documentation> </xs:annotation> <xs:restriction base="xs:base64Binary"> <xs:maxLength value="2097152"></xs:maxLength> </xs:restriction> </xs:simpleType>
Sistema de Información de Sanidad Exterior (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Servicio Web de Consulta
por parte de los Operadores Económicos
Descripción Funcional
25 de Abril de 2007
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 2 de 16
Contenido
CONTENIDO ............................................................................................................................2
1. INTRODUCCIÓN .................................................................................................................3
2. DESCRIPCIÓN DEL SERVICIO WEB ................................................................................4
2.1. DESCARGA DE TIPOS DE BULTO .....................................................................................................5
2.2. DESCARGA DE TIPOS DE DOCUMENTO............................................................................................6
2.3. CONSULTA DEL ESTADO DEL EXPEDIENTE ......................................................................................7
2.4. COMPRESIÓN DE DATOS................................................................................................................9
3. INFORMACIÓN ASOCIADA A LAS CONSULTAS..........................................................10
ANEXO I. FICHERO DESCARGAS.WSDL..........................................................................12
ANEXO II. FAULTS DEVUELTAS POR EL SERVICIO WEB...............................................16
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 3 de 16
1. Introducción
Este documento recoge el Análisis Funcional del Servicio Web de Consulta por parte de los Operadores Económicos. Esta funcionalidad se engloba dentro del Módulo de Mercancías y Operadores Económicos del Sistema de Información de Sanidad Exterior (SISAEX IV) del Ministerio de Sanidad y Consumo (MSC).
El objetivo de este Servicio Web es permitir a los operadores económicos conocer el estado en el que se encuentran las declaraciones presentadas, así como los datos necesarios para el envío de dichas declaraciones mediante el Servicio Web de Presentación de Declaraciones.
En los anexos del presente documento se incluye el fichero que define este Servicio Web.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 4 de 16
2. Descripción del Servicio Web
El Servicio Web está dividido en tres operaciones, cada una de ellas destinada a la descarga de distintos datos:
• DescargarTipoBulto: descarga los distintos tipos de bulto existentes en el sistema.
• DescargarTipoDocumentacion: descarga los distintos tipos de documentación que es posible adjuntar a las declaraciones presentadas.
• ConsultarEstadoExpediente: consulta el estado actual del expediente y, en su caso, devuelve también los códigos NRC para el despacho de la mercancía.
El Servicio Web estará publicado en las siguientes direcciones:
• Pilotaje:
https://saexpiloto.msc.es/mercancias/webservices/DescargasPort?WSDL
• Producción:
https://sisaex4.msc.es/mercancias/webservices/DescargasPort?WSDL
La llamada al Servicio Web se hará mediante el protocolo SOAP basado en Document (adjunto se proporciona la versión actual del esquema).
A continuación se describe cada una de las operaciones.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 5 de 16
2.1. Descarga de Tipos de Bulto
La operación destinada a la descarga de los tipos de bulto existentes en el sistema se denomina DescargarTipoBulto. Recibe como parámetro un documento vacío (destinado únicamente a realizar la llamada) y devuelve una lista de tipo ListaTipoBultoType, según el siguiente esquema:
<xsd:element name="tipoBultoResponse" type="tns:ListaTipoBultoType" /> <xsd:element name="tipoBultoRequest" /> <xsd:complexType name="ListaTipoBultoType"> <xsd:sequence> <xsd:element name="tipoBulto" type="tns:TipoBultoType" maxOccurs="unbounded" minOccurs="0"> </xsd:element> </xsd:sequence> </xsd:complexType> <xsd:complexType name="TipoBultoType"> <xsd:sequence> <xsd:element name="codigo" type="xsd:int"></xsd:element> <xsd:element name="descripcion" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 6 de 16
2.2. Descarga de Tipos de Documento
La operación destinada a la descarga de los tipos de documentos existentes en el sistema se denomina DescargarTipoDocumentacion. Recibe como parámetro un documento vacío (destinado únicamente a realizar la llamada) y devuelve una lista de tipo ListaTipoDocumentacionType, según el siguiente esquema:
<xsd:element name="tipoDocumentacionRequest"/> <xsd:element name="tipoDocumentacionResponse" type="tns:ListaTipoDocumentacionType" /> <xsd:complexType name="ListaTipoDocumentacionType"> <xsd:sequence> <xsd:element name="tipoDocumentacion" type="tns:TipoDocumentacionType" maxOccurs="unbounded" minOccurs="0"> </xsd:element> </xsd:sequence> </xsd:complexType> <xsd:complexType name="TipoDocumentacionType"> <xsd:sequence> <xsd:element name="codigo" type="xsd:int"></xsd:element> <xsd:element name="descripcion" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 7 de 16
2.3. Consulta del Estado del Expediente
La operación destinada a la consulta del estado actual en el que se encuentra el expediente se denomina ConsultarEstadoExpediente. Recibe como parámetro un elemento de tipo EstadoExpedienteRequestType y devuelve una lista de tipo EstadoExpedienteType, según el siguiente esquema:
<xsd:element name="estadoExpedienteRequest" type="tns:EstadoExpedienteRequestType"/> <xsd:element name="estadoExpedienteResponse" type="tns:EstadoExpedienteType"/> <xsd:complexType name="EstadoExpedienteRequestType"> <xsd:sequence> <xsd:element name="codigoExpediente" type="xsd:string"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="EstadoExpedienteType"> <xsd:sequence> <xsd:element name="tipo" type="tns:TipoEstadoExpedienteType"/> <xsd:element name="apto" type="xsd:boolean" minOccurs="0"/> <xsd:element name="ListaNRC" type="tns:ListaNRCType" minOccurs="0"/> </xsd:sequence> </xsd:complexType> <xsd:simpleType name="TipoEstadoExpedienteType"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Inicial"/> <xsd:enumeration value="Definitivo"/> <xsd:enumeration value="EnTramite"/> <xsd:enumeration value="Cerrado"/> <xsd:enumeration value="Anulado"/>
</xsd:restriction> </xsd:simpleType> <xsd:complexType name="ListaNRCType"> <xsd:sequence> <xsd:element name="nrcProducto" type="tns:NrcProductoType"
maxOccurs="unbounded"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="NrcProductoType"> <xsd:sequence> <xsd:element name="codigoProducto" type="xsd:string"/> <xsd:element name="nrc" type="xsd:string"/> </xsd:sequence> </xsd:complexType>
Es decir, para cada expediente se devuelve el estado en el que se encuentra, si ha sido declarado apto o no apto (sólo para los estados En Tramite y Cerrado), y un listado de pares producto-NRC, para todos los productos del expediente. Este listado sólo se enviará en el caso de expedientes cerrados declarados aptos.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 8 de 16
En caso de que el código de expediente no tenga el formato correcto se devolverá la fault CodigoIncorrectoFault, y en caso de que el expediente no haya sido encontrado ExpedienteNoEncontradoFault.
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 9 de 16
2.4. Compresión de Datos
El Servicio Web está preparado para recibir las peticiones comprimidas usando la codificación GZIP del estándar HTTP. La compresión se puede realizar tanto en la petición como en la respuesta.
Aunque actualmente no es obligatorio utilizar esta opción, sí es altamente recomendable, con el fin de optimizar la utilización de la red, tanto del cliente como del MSC, y mejorar los tiempos de respuesta. Además es posible que en futuras versiones del servicio sea obligatoria su utilización.
Para indicar que el contenido de la petición está comprimido, se deberá utilizar la cabecera HTTP content-encoding:
Content-Encoding: gzip
Del mismo modo, para indicar que está preparado para recibir la respuesta comprimido, se deberá incluir la cabecera Accept-Encoding:
Accept-Encoding: gzip
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 10 de 16
3. Información Asociada a las Consultas
En este capítulo se describe la información asociada a las consultas que está contenida en el fichero WSDL.
Tipo complejo: ListaTipoBultoType
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
tipoBulto Lista de Tipos de Bulto TipoBultoType
Tipo complejo: TipoBultoType
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
codigo Código del tipo de bulto int
descripcion Descripción del tipo string
Tipo complejo: ListaTipoDocumentacionType
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
tipoDocumentacion Lista de tipos de documentación TipoDocumentacionType
Tipo complejo: TipoDocumentacionType
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
codigo Código del tipo de documentación int
descripcion Descripción del tipo string
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 11 de 16
Tipo complejo: EstadoExpedienteRequestType
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
codigoExpediente Código del expediente a buscar (tal y como lo devuelve el servicio web de alta) string
Tipo complejo: EstadoExpedienteType
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
tipo1 Tipo de estado actual del expediente string
apto
Indica si el expediente ha sido declarado apto (si el estado no es ‘Cerrado’ se trata de un dato provisional, que puede cambiar posteriormente)
boolean
ListaNRC Lista de pares Producto-NRC ListaNRCType
1 Contendrá uno de los siguientes valores: Inicial, Definitivo, EnTramite, Cerrado, Anulado
Tipo complejo: NrcProductoType
ELEMENTO DESCRIPCIÓN TIPO TIPO CAMPO
codigoProducto Código Taric del producto string
nrc Número de Referencia Completa, para el despacho de la mercancía en Aduanas string
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 12 de 16
Anexo I. Fichero descargas.wsdl
<?xml version="1.0" encoding="UTF-8"?> <wsdl:definitions name="descargas" xmlns:wsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://sisaex4.msc.es/SisaexNS/descargas" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://sisaex4.msc.es/SisaexNS/descargas" > <wsdl:types> <xsd:schema targetNamespace="http://sisaex4.msc.es/SisaexNS/descargas" xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <xsd:element name="tipoBultoResponse" type="tns:ListaTipoBultoType" /> <xsd:element name="tipoBultoRequest" /> <xsd:complexType name="ListaTipoBultoType"> <xsd:sequence> <xsd:element name="tipoBulto" type="tns:TipoBultoType" maxOccurs="unbounded" minOccurs="0"> </xsd:element> </xsd:sequence> </xsd:complexType> <xsd:complexType name="TipoBultoType"> <xsd:sequence> <xsd:element name="codigo" type="xsd:int"></xsd:element> <xsd:element name="descripcion" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType> <xsd:element name="tipoDocumentacionRequest"> </xsd:element> <xsd:element name="tipoDocumentacionResponse" type="tns:ListaTipoDocumentacionType" /> <xsd:complexType name="ListaTipoDocumentacionType"> <xsd:sequence> <xsd:element name="tipoDocumentacion" type="tns:TipoDocumentacionType" maxOccurs="unbounded" minOccurs="0"> </xsd:element> </xsd:sequence> </xsd:complexType> <xsd:complexType name="TipoDocumentacionType"> <xsd:sequence> <xsd:element name="codigo" type="xsd:int"></xsd:element> <xsd:element name="descripcion" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 13 de 16
<xsd:complexType name="EstadoExpedienteRequestType"> <xsd:sequence> <xsd:element name="codigoExpediente" type="xsd:string"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="EstadoExpedienteType"> <xsd:sequence> <xsd:element name="tipo" type="tns:TipoEstadoExpedienteType"/> <xsd:element name="apto" type="xsd:boolean" minOccurs="0"/> <xsd:element name="ListaNRC" type="tns:ListaNRCType" minOccurs="0"/> </xsd:sequence> </xsd:complexType> <xsd:simpleType name="TipoEstadoExpedienteType"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Inicial"/> <xsd:enumeration value="Definitivo"/> <xsd:enumeration value="EnTramite"/> <xsd:enumeration value="Cerrado"/> <xsd:enumeration value="Anulado"/> </xsd:restriction> </xsd:simpleType> <xsd:complexType name="ListaNRCType"> <xsd:sequence> <xsd:element name="nrcProducto" type="tns:NrcProductoType" maxOccurs="unbounded"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="NrcProductoType"> <xsd:sequence> <xsd:element name="codigoProducto" type="xsd:string"/> <xsd:element name="nrc" type="xsd:string"/> </xsd:sequence> </xsd:complexType> <xsd:element name="estadoExpedienteRequest" type="tns:EstadoExpedienteRequestType"/> <xsd:element name="estadoExpedienteResponse" type="tns:EstadoExpedienteType"/> <!-- FAULT --> <xsd:complexType name = "DescargasFaultType"> <xsd:sequence> <xsd:element name="mensaje" type="xsd:string"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name = "CodigoIncorrectoFaultType"> <xsd:complexContent> <xsd:extension base="tns:DescargasFaultType"/> </xsd:complexContent> </xsd:complexType> <xsd:complexType name = "ExpedienteNoEncontradoFaultType"> <xsd:complexContent> <xsd:extension base="tns:DescargasFaultType"/> </xsd:complexContent> </xsd:complexType>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 14 de 16
<xsd:element name="CodigoIncorrectoFault" type="tns:CodigoIncorrectoFaultType"/> <xsd:element name="ExpedienteNoEncontradoFault" type="tns:ExpedienteNoEncontradoFaultType"/> </xsd:schema> </wsdl:types> <wsdl:message name="tipoBultoResponseMsg"> <wsdl:part element="tns:tipoBultoResponse" name="tipoBultoResponsePart" /> </wsdl:message> <wsdl:message name="tipoBultoRequestMsg"> <wsdl:part element="tns:tipoBultoRequest" name="tipoBultoRequestPart" /> </wsdl:message> <wsdl:message name="tipoDocumentacionRequestMsg"> <wsdl:part name="tipoDocumentacionRequestPart" element="tns:tipoDocumentacionRequest"> </wsdl:part> </wsdl:message> <wsdl:message name="tipoDocumentacionResponseMsg"> <wsdl:part name="tipoDocumentacionResponsePart" element="tns:tipoDocumentacionResponse"> </wsdl:part> </wsdl:message> <wsdl:message name="estadoExpedienteRequestMsg"> <wsdl:part name="estadoExpedienteRequestPart" element="tns:estadoExpedienteRequest"> </wsdl:part> </wsdl:message> <wsdl:message name="estadoExpedienteResponseMsg"> <wsdl:part name="estadoExpedienteResponsePart" element="tns:estadoExpedienteResponse"> </wsdl:part> </wsdl:message> <!-- Faults lanzadas por consulta del estado del expediente --> <wsdl:message name="CodigoIncorrectoFault"> <wsdl:part name="msg" element="tns:CodigoIncorrectoFault"/> </wsdl:message> <wsdl:message name="ExpedienteNoEncontradoFault"> <wsdl:part name="fault" element="tns:ExpedienteNoEncontradoFault"/> </wsdl:message> <wsdl:portType name="DescargasPort"> <wsdl:operation name="DescargarTipoBulto"> <wsdl:input message="tns:tipoBultoRequestMsg" /> <wsdl:output message="tns:tipoBultoResponseMsg" /> </wsdl:operation> <wsdl:operation name="DescargarTipoDocumentacion"> <wsdl:input message="tns:tipoDocumentacionRequestMsg"></wsdl:input> <wsdl:output message="tns:tipoDocumentacionResponseMsg"></wsdl:output> </wsdl:operation> <wsdl:operation name="ConsultarEstadoExpediente"> <wsdl:input message="tns:estadoExpedienteRequestMsg"></wsdl:input> <wsdl:output message="tns:estadoExpedienteResponseMsg"></wsdl:output> <wsdl:fault name="CodigoIncorrectoFault" message="tns:CodigoIncorrectoFault"/>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 15 de 16
<wsdl:fault name="ExpedienteNoEncontradoFault" message="tns:ExpedienteNoEncontradoFault"/> </wsdl:operation> </wsdl:portType> <wsdl:binding name="DescargasBinding" type="tns:DescargasPort"> <wsoap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document" /> <wsdl:operation name="DescargarTipoBulto"> <wsoap:operation soapAction="http://sisaex4.msc.es/SisaexNS/descargas/tipoBulto" style="document"/> <wsdl:input> <wsoap:body use="literal" /> </wsdl:input> <wsdl:output> <wsoap:body use="literal" /> </wsdl:output> </wsdl:operation> <wsdl:operation name="DescargarTipoDocumentacion"> <wsoap:operation soapAction="http://sisaex4.msc.es/SisaexNS/descargas/tipoDocumentacion" style="document"/> <wsdl:input> <wsoap:body use="literal"/> </wsdl:input> <wsdl:output> <wsoap:body use="literal"/> </wsdl:output> </wsdl:operation> <wsdl:operation name="ConsultarEstadoExpediente"> <wsoap:operation soapAction="http://sisaex4.msc.es/SisaexNS/descargas/estadoExpediente" style="document"/> <wsdl:input> <wsoap:body use="literal"/> </wsdl:input> <wsdl:output> <wsoap:body use="literal"/> </wsdl:output> <wsdl:fault name="CodigoIncorrectoFault"> <wsoap:fault name="CodigoIncorrectoFault" use="literal"/> </wsdl:fault> <wsdl:fault name="ExpedienteNoEncontradoFault"> <wsoap:fault name="ExpedienteNoEncontradoFault" use="literal"/> </wsdl:fault> </wsdl:operation> </wsdl:binding> <wsdl:service name="DescargasService"> <wsdl:port name="DescargasPort" binding="tns:DescargasBinding"> <wsoap:address location="http://localhost:8000/pruebaServicioWeb/services/PruebaServicioWeb.wsdl" /> </wsdl:port> </wsdl:service> </wsdl:definitions>
SISTEMA DE INFORMACIÓN DE SANIDAD EXTERIOR (SISAEX IV)
Módulo de Mercancías y Operadores Económicos
Descripción Funcional del Servicio Web de Consulta por parte de los
Operadores Económicos
25/04/2007 MSC-SISAEXIV-AF-SWCOE-01.doc Página 16 de 16
Anexo II. Faults Devueltas por el Servicio Web
NOMBRE DESCRIPCIÓN
CodigoIncorrectoFault El formato del código del expediente es incorrecto
ExpedienteNoEncontradoFault El expediente no existe en base de datos, o el usuario no tiene permiso de acceso al expediente
Además, es posible recibir también respuestas http estándar, y las aplicaciones que se conecten al Servicio Web deberían estar preparadas para tratarlas. En particular si el certificado digital no es correcto (no es de alguna de las entidades certificadoras aceptadas por el MSC) o el usuario no está registrado en SISAEX, se recibirá el error 403 (Forbiden). Esto es así porque por seguridad, el control del acceso al sistema lo realiza un componente diferente de la aplicación.