sistema de información de sanidad exterior módulo de ... · la última versión del fichero de...

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)


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






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.






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.

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






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.






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.






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






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






1 String con el formato: aaaa-mm-dd hh:mm

2 Valores posibles: satisfactory, notsatisfactory

Tipo complejo: EconomicOperator


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


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


codPostal Código postal PostalCode string (15)

Nombre Nombre de la ciudad CityName string (50)






Tipo complejo: ListOfDeliveryAddresses


direccionEntrega Dirección de entrega DeliveryAddress

Tipo complejo: DeliveryAddress


Direccion Dirección de entrega Address

numAutorizacion Nº autorización de la dirección de entrega ApprovalNumber string (20)

Tipo complejo: ListOfVeterinaryDocuments


documentoVeterinario Documento Sanitario / Veterinario VeterinaryDocument

Tipo complejo: VeterinaryDocument


Numero Número del documento VeterinaryDocumentNumber string (32)

fechaExpedicion Fecha de expedición Date1

1 Formato: aaaa-mm-dd

Tipo complejo: ListOfEstablishmentsOfOrigin


establecimientoOrigen Establecimiento de origen EstablishmentOfOrigin






Tipo complejo: EstablishmentOfOrigin


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


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


Producto Producto Commodity






Tipo complejo: Commodity


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


numBultos Número de bultos nonNegativeInteger

tipoBultos Tipo de bulto TypeOfPackaging string (20)

Tipo complejo: ListOfSealsContainers


precintoContenedor Combinación nº contenedor y nº precinto SealContainer

Tipo complejo: SealsContainer


Precinto Número de precinto SealNumber string (32)

contenedor Número de contenedor ContainerNumber string (20)






Tipo complejo: DeclaratedDestiny

Deberá ser uno de los siguientes valores:


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



Pif PIF de destino del trasbordo CompetentAuthorityCode string (7)

paisTercero País tercero de destino del trasbordo CountryISOCode string (2)

Tipo complejo: TransitToThirdCountry



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


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







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


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


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


Adjunto Documento adjunto Attachment






Tipo complejo: Attachment


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)






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">






</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>






<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>






<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






</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">






</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">






<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






</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>






<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>






</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">






<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>






<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>






<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">






<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>






</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>






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>






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.






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.






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.






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">






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">






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">






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"/>






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>






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>






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>






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>






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>






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


Servicio Web de Consulta

por parte de los Operadores Económicos

Descripción Funcional

25 de Abril de 2007



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






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.






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.






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>






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>






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.






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.






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






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


tipoBulto Lista de Tipos de Bulto TipoBultoType

Tipo complejo: TipoBultoType


codigo Código del tipo de bulto int

descripcion Descripción del tipo string

Tipo complejo: ListaTipoDocumentacionType


tipoDocumentacion Lista de tipos de documentación TipoDocumentacionType

Tipo complejo: TipoDocumentacionType


codigo Código del tipo de documentación int

descripcion Descripción del tipo string






Tipo complejo: EstadoExpedienteRequestType


codigoExpediente Código del expediente a buscar (tal y como lo devuelve el servicio web de alta) string

Tipo complejo: EstadoExpedienteType


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


codigoProducto Código Taric del producto string

nrc Número de Referencia Completa, para el despacho de la mercancía en Aduanas string






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>

<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"/>  <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>

<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>  <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"/>






<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>






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.