Ie813RsV32 Recogida de cambio de destino desde formulario web de un documento expedido.

Transcripción

1 EMCS-Servicios Web Documentos expedidos FASE 3.2 Ie813RsV32 Recogida de cambio de destino desde formulario web de un documento expedido. Autor: S.G.A.A. e II.EE. Fecha: 01/10/2015 Versión de este documento: 3.1 Revisiones Edi. Rev. Fecha Descripción A(*) Páginas /09/2009 Versión inicial A Todas /11/2010 Cambios de URL s y nombres de esquemas y servicios R Todas /06/2011 Adaptaciones a la Fase 3 del EMCS R Todas /10/2015 Adaptaciones a la Fase 3.2 del EMCS R Todas (*) Acción: A= Añadir; R= Reemplazar Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág.: 1/14

2 Índice: 1. Introducción: 3 2. Control de versiones: Cambios de la Fase versión 3.1 (1-octubre-2015): Cambios de la Fase 3: 4 3. Servicio web Ie813RsV32.wsdl. Recogida de un cambio de destino de un documento expedido. Servicio para sincronismo con acciones web 4 4. Mensaje IE Estructura : 7 5. Definición servicio y esquemas Definición servicio Ie813RsV32.wsdl Mensaje de entrada DetalleV4Ent.xsd Mensaje de salida Ie813V32Sal.xsd Direcciones de los servicios Ejemplos Respuesta del servicio de la bandeja ListaDecV Recuperar la información de detalle Detalle de la respuesta recibida. 14 Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 2/14

3 1. Introducción: En el marco del proyecto EMCS si un operador está suscrito a la presentación de documentos mediante servicios Web, y por la razón que sea realiza un cambio de destino de un documento expedido mediante los formularios de la Oficina Virtual de Aduanas, en el momento que se acepte dicho cambio, se le generará un mensaje IE813, que se pondrá a disposición del operador mediante una infraestructura de servicios asíncronos que están descritos en el documento Bandeja de entrada en el portal EMCS apartado de documentación técnica. Tal y como se describe en el citado documento, el operador receptor debe previamente recuperar la referencia del mensaje del documento que la AEAT ha puesto a su disposición en la bandeja de entrada, utilizando para ello el servicio Lista de respuestas descrito por ListaDecV4.wsdl. Una vez que haya recuperado la lista con las referencias de los mensajes que la AEAT ha puesto a su disposición, tendrá que utilizar el servicio descrito a continuación en este documento para recuperar la información completa y detallada de cada uno de los cambios de destinatario correspondientes a los documentos de acompañamiento electrónicos en los que él figura como expedidor de los productos. 2. Control de versiones: 2.1. Cambios de la Fase versión 3.1 (1-octubre-2015): - Se modifican los nombres de los esquemas y servicios pasando de la versión V3 a la versión V32. - Se cambia la ruta de los namespaces de la aplicación pasando de la anterior a la nueva: - En el esquema Ie813 se añade el elemento ComplementaryInformation (A350) dentro del grupo UpdateEaad para enviar información complementaria en el cambio de destino. - En el esquema Ie813 se añade el elemento EoriNumber (A17) dentro del grupo NewConsigneeTrader para identificar al destinatario de un movimiento con destino exportación. Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 3/14

4 - Se sustituye la condición C013 por la C165 en los grupos (Delivery Place) Trader y (Delivery Place) Customs Office Cambios de la Fase 3: - Se modifican los nombres de los esquemas y servicios pasando de la versión V2 a la versión V3. - En el esquema Ie813 tanto de entrada como de salida se han realizado los siguientes cambios: o o En el elemento "TransportDetails" se admite hasta un máximo de 99 ocurrencias. El elemento "IdentityOfTransportUnits" pasa a ser opcional. 3. Servicio web Ie813RsV32.wsdl. Recogida de un cambio de destino de un documento expedido. Servicio para sincronismo con acciones web Dicho servicio requiere tener instalado un certificado de usuario admitido por la AEAT en el ordenador desde el que se produzca el envío de la información. El certificado de usuario podrá ser, bien de la persona física o jurídica titular del establecimiento receptor de los productos, bien de un apoderado para este trámite. La definición del servicio se puede consultar en la dirección: En la definición de este servicio se describe que el mensaje de entrada se basa en el esquema DetalleV4Ent.xsd y la respuesta en el esquema Ie813V32Sal.xsd El diseño del esquema de entrada con el que se realiza la petición para que nos devuelva un cambio de destinatario concreto, se puede consultar en la dirección: y su representación gráfica es la siguiente Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 4/14

5 El diseño del esquema de salida con la información del cambio de destinatario del documento de acompañamiento se basa en el esquema Ie813V32Sal.xsd. La definición de dicho esquema se puede consultar en la dirección Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 5/14

6 Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 6/14

7 4. Mensaje IE813 En la descripción de los esquemas se usan las siguientes notaciones: o Los campos o grupos de datos pueden ser obligatorios o no, para ello se usará: ( R ) Requerido: el campo o grupo de datos es obligatorio ( O ) Opcional: el campo o grupo de datos no es obligatorio ( D ) Condicional: el campo o grupo de datos sólo se rellena en ciertas condiciones Estas notaciones se utilizan tanto en la columna D/R correspondiente a la obligatoriedad de los grupos, como en las columnas de los distintos tipos de destinatario. o El número incluido en la columna nº indica el número de veces que un grupo de datos se repite o puede repetir en el mensaje. o En las columnas C/R se indican los códigos de las condiciones (Cxxx) o de las reglas (Rxxx, TRxxx) que deben cumplir los grupos de datos o los campos. o En la columna Lista se indica el código de lista que contiene los distintos valores que puede tomar un campo Estructura : CD813A Grupo D/R Dº C/R Campo C/R Lista.- Message R 1 Datos del Mensaje R MessageSender O NombreSender R MessageRecipient R Date of preparation R Time of preparation R Message Identifier D Correlation Identifier TR Attributes R 1 Datos autenticación R Date&Time of Validation of Change of Destination C149 R Código seguro de verificación C (New transport Arranger) Trader D 1 C103 Datos del nuevo responsable del transporte 14a R VAT Nº 14b R Trader Name 14c R Street-name 14e R Postcode 14f R City 14g R Nad-Lng 12 14d O Street-number Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 7/14

8 15.- (New transporter) Trader O 1 Datos del nuevo transportista 15a O VAT Nº 15b R Trader Name 15c R Street-name 15e R Postcode 15f R City 15g R Nad-Lng 12 15d O Street-number 16.- Transport Details O 99 Datos del transporte 16a R Transport Unit Cod b D Identity T.Units C156 16c O Commercial Seal Identification 16f O Complementary Information 16g D Complementary Information Lng C d O Seal Information 16e D Seal Information Lng C Update E-AAD R 1 Datos del Documento de acompañamiento 2b R AAD Reference code 1b O Journey Time R054 1c O Changed transport arrangement 70 D Sequence number R059 9c O Invoice date 9b O Invoice number 13a O Transport mode code 67 13b D Complementary Information C162 13c D Complementary Information_LNG (Changed) Destination R 1 Nuevo tipo de destino 1a R Destination Type Code (New Consignee) Trader O 1 Datos del nuevo Destinatario 5a R Trader ID C010 R045 5b R Trader Name 5c R Street-name 5d O Street-number 5e R Postcode 5f R City 5a D EORI Number C180 5g R Nad-Lng (Delivery Place) Trader D 1 C165 Datos del lugar de entrega 7a R Trader ID C074 R045 7b O Trader Name C079 7c O Street-name C078 7e O Postcode C078 7f O City C078 7g O Nad-Lng C d O Street-number 8.- (Delivery Place) Customs Office D 1 C165 Datos de la Aduana de Exportación 8a R Reference Number Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 8/14

9 5. Definición servicio y esquemas 5.1. Definición servicio Ie813RsV32.wsdl <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace= " xmlns:ser= " xmlns:ent=" xmlns:sal= " xmlns:wsdl=" xmlns:wsdlsoap=" xmlns:xsd=" <wsdl:types> <schema elementformdefault="qualified" targetnamespace= " xmlns=" <xsd:import namespace=" schemalocation="../../adws/banent/detallev4ent.xsd"> </xsd:import> <xsd:import namespace= " schemalocation="ie813v32sal.xsd"> </xsd:import> </schema> </wsdl:types> <wsdl:message name="entrada"> <wsdl:part name="detallev4ent" element="ent:detallev4ent" /> </wsdl:message> <wsdl:message name="salida"> <wsdl:part name="cd813a" element="sal:cd813a"></wsdl:part> </wsdl:message> <wsdl:porttype name="ie813rsv32"> <wsdl:operation name="ie813rsv32"> <wsdl:input message="ser:entrada" name="entrada" /> <wsdl:output message="ser:salida" name="salida" /> </wsdl:operation> </wsdl:porttype> <wsdl:binding name="ie813rsv32soapbinding" type="ser:ie813rsv32"> <wsdlsoap:binding style="document" transport=" /> <wsdl:operation name="ie813rsv32"> <wsdlsoap:operation soapaction="" /> <wsdl:input name="entrada"> <wsdlsoap:body use="literal" /> </wsdl:input> <wsdl:output name="salida"> <wsdlsoap:body use="literal" /> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="ie813rsv32service"> <wsdl:port binding="ser:ie813rsv32soapbinding" name="ie813rsv32"> <wsdlsoap:address location= " /> </wsdl:port> <wsdl:port binding="ser:ie813rsv32soapbinding" name="ie813rsv32pruebas"> <wsdlsoap:address location= " /> </wsdl:port> </wsdl:service> </wsdl:definitions> Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 9/14

10 5.2. Mensaje de entrada DetalleV4Ent.xsd <?xml version="1.0" encoding="utf-8"?> <schema targetnamespace=" xmlns=" xmlns:detallev4ent=" xmlns:ds=" xmlns:etsi=" elementformdefault="qualified"> <!-- <import namespace=" schemalocation="../../xades/xmldsig-core-schema.xsd"/> <import namespace=" schemalocation="../../xades/xades.xsd"/> --> <annotation> <documentation>esquema del mensaje de petición del Servicio que nos proporciona un mensaje que queremos recuperar de la Bandeja de Entrada. En este mensaje se envia la clave del mensaje que queremos recuperar. Esta clave representa unívocamente el mensaje que queremos recuperar.</documentation> </annotation> <element name="detallev4ent" type="detallev4ent:detallev4ent" /> <complextype name="detallev4ent"> <annotation> <documentation>tipo principal del mensaje. Respresenta la clave del mensaje que queremos recuperar. clave: Clave representa unívocamente el mensaje que queremos recuperar. ds:signature: Firma en el caso de que el mensaje vaya firmado.</documentation> </annotation> <sequence> <element name="clave" type="string" maxoccurs="1" minoccurs="1" /> <!-- <element ref="ds:signature" minoccurs="0"></element> --> </sequence> </complextype> </schema> 5.3. Mensaje de salida Ie813V32Sal.xsd <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs=" xmlns=" xmlns:emcs=" xmlns:tms=" xmlns:tcl=" targetnamespace= " elementformdefault="qualified" attributeformdefault="unqualified" version="1.00"> <!--========================================= --> <!--===== IE813:C_UPD_DAT --> <!--===== CHANGE OF DESTINATION --> <!--========================================= --> <!--===== Imports ===== --> <xs:import namespace=" schemalocation="typesv32.xsd" /> <xs:import namespace=" schemalocation="tmsv32.xsd" /> <xs:import namespace=" schemalocation="tclv32.xsd" /> <!--===== Root Element ===== --> <xs:element name="cd813a" type="cd813atype" /> <!--===== EMCS Data Groups Declarations ===== --> <xs:complextype name="cd813atype"> <xs:element name="header" type="tms:headertype" /> <xs:element name="body" type="bodytype" /> <xs:attribute name="test" type="tcl:testtipo" use="optional"> <xs:annotation> <xs:documentation> Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 10/14

11 Indicador de Test. No es obligatorio. En caso de aparecer sólo podrá tomar los valores S=Modo pruebas, indica que se responde a un presentación en modo de pruebas </xs:documentation> </xs:annotation> </xs:attribute> <!--===== IE Specific Data Groups Declarations ===== --> <xs:complextype name="bodytype"> <xs:element name="changeofdestination" type="changeofdestinationtype" /> <xs:complextype name="changeofdestinationtype"> <xs:element name="attributes" type="attributestype" /> <xs:element name="newtransportarrangertrader" type="newtransportarrangertradertype" <xs:element name="newtransportertrader" type="newtransportertradertype" <xs:element name="transportdetails" type="transportdetailstype" minoccurs="0" maxoccurs="99" /> <xs:element name="updateeaad" type="updateeaadtype" /> <xs:element name="changeddestination" type="changeddestinationtype" /> <xs:complextype name="attributestype"> <xs:element name="dateandtimeofvalidationofchangeofdestination" type="emcs:datetimetype" <xs:element name="certificadoelectronico" type="emcs:certificadoelectronicotipo" <xs:complextype name="newtransportarrangertradertype"> <xs:element name="vatnumber" type="emcs:vatnumbertype" <xs:element name="tradername" type="emcs:tradernametype" /> <xs:element name="streetname" type="emcs:streetnametype" /> <xs:element name="streetnumber" type="emcs:streetnumbertype" <xs:element name="postcode" type="emcs:postcodetype" /> <xs:element name="city" type="emcs:citytype" /> <xs:attribute name="language" type="emcs:languagecodetype" use="required" /> <xs:complextype name="newtransportertradertype"> <xs:element name="vatnumber" type="emcs:vatnumbertype" <xs:element name="tradername" type="emcs:tradernametype" /> <xs:element name="streetname" type="emcs:streetnametype" /> <xs:element name="streetnumber" type="emcs:streetnumbertype" <xs:element name="postcode" type="emcs:postcodetype" /> <xs:element name="city" type="emcs:citytype" /> <xs:attribute name="language" type="emcs:languagecodetype" use="required" /> <xs:complextype name="transportdetailstype"> <xs:element name="transportunitcode" type="emcs:transportunitcodetype" /> <xs:element name="identityoftransportunits" type="emcs:identityoftransportunitstype" <xs:element name="commercialsealidentification" type="emcs:commercialsealidentificationtype" <xs:element name="complementaryinformation" type="lsdcomplementaryinformationtype" <xs:element name="sealinformation" type="lsdsealinformationtype" <xs:complextype name="updateeaadtype"> <xs:element name="aadreferencecode" type="emcs:aadreferencecodetype" /> <xs:element name="journeytime" type="emcs:journeytimetype" <xs:element name="changedtransportarrangement" type="tcl:transportarrangement" <xs:element name="sequencenumber" type="emcs:sequencenumbertype" <xs:element name="invoicedate" type="emcs:datetype" <xs:element name="invoicenumber" type="emcs:invoicenumbertype" <xs:element name="transportmodecode" type="emcs:transportmodecodetype" <xs:element name="complementaryinformation" type="lsdcomplementaryinformationtype" Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 11/14

12 <xs:complextype name="changeddestinationtype"> <xs:element name="destinationtypecode" type="tcl:changeofdestinationtypecode" /> <xs:element name="newconsigneetrader" type="newconsigneetradertype" <xs:element name="deliveryplacetrader" type="deliveryplacetradertype" <xs:element name="deliveryplacecustomsoffice" type="deliveryplacecustomsofficetype" <xs:complextype name="newconsigneetradertype"> <xs:element name="traderid" type="emcs:traderidtype" <xs:element name="tradername" type="emcs:tradernametype" /> <xs:element name="streetname" type="emcs:streetnametype" /> <xs:element name="streetnumber" type="emcs:streetnumbertype" <xs:element name="postcode" type="emcs:postcodetype" /> <xs:element name="city" type="emcs:citytype" /> <xs:element name="eorinumber" type="emcs:eorinumbertype" <xs:attribute name="language" type="emcs:languagecodetype" use="required" /> <xs:complextype name="deliveryplacetradertype"> <xs:element name="traderid" type="emcs:traderidtype" <xs:element name="tradername" type="emcs:tradernametype" <xs:element name="streetname" type="emcs:streetnametype" <xs:element name="streetnumber" type="emcs:streetnumbertype" <xs:element name="postcode" type="emcs:postcodetype" <xs:element name="city" type="emcs:citytype" <xs:attribute name="language" type="emcs:languagecodetype" use="optional" /> <xs:complextype name="deliveryplacecustomsofficetype"> <xs:element name="referencenumber" type="emcs:exciseofficecodetype" /> <!--===== IE Specific Data Items Declarations ===== --> <xs:complextype name="lsdcomplementaryinformationtype"> <xs:simplecontent> <xs:extension base="emcs:complementaryinformationtype"> <xs:attribute name="language" type="emcs:languagecodetype" use="required" /> </xs:extension> </xs:simplecontent> <xs:complextype name="lsdsealinformationtype"> <xs:simplecontent> <xs:extension base="emcs:sealinformationtype"> <xs:attribute name="language" type="emcs:languagecodetype" use="required" /> </xs:extension> </xs:simplecontent> </xs:schema> Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 12/14

13 5.4. Direcciones de los servicios Entorno real de producción: Para recuperar la lista de mensajes pendientes de la Bandeja de entrada Para la recogida de un mensaje por clave Entorno de pruebas con datos de pruebas: Para recuperar la lista de mensajes pendientes de la Bandeja de entrada Para la recogida de un mensaje por clave Para este servicio no existe un entorno real de pruebas. Las peticiones de Lista de mensajes a la Bandeja de entrada no deben realizarse a intervalos inferiores a 10 minutos tanto en el entorno de pruebas como en el real para evitar sobrecargar de peticiones nuestro sistema. 6. Ejemplos Respuesta del servicio de la bandeja ListaDecV4 En la respuesta del servicio de la bandeja ListaDecV4 se reciben los valores siguientes de una declaración existente recibida en la Bandeja de Entrada. <declaracion> <clave> </clave> <referencia> es00076h7001k</referencia> <tiporespuesta> </tiporespuesta> </declaracion> Recuperar la información de detalle El fichero a enviar es: <?xml version="1.0" encoding="utf-8"?> <DetalleV4Ent xmlns=" xmlns:xsi=" xsi:schemalocation= " "> <clave> </clave> </DetalleV4Ent> Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 13/14

14 6.2. Detalle de la respuesta recibida. Como respuesta a la petición, se recibirá el fichero Ie813V32Sal con la información solicitada del cambio de destino: <?xml version="1.0" encoding="utf-8"?> <CD813A xmlns:tms=" xmlns:xsi=" xmlns=" xsi:schemalocation= " tmsv32.xsd "> <Header> <tms:messagesender>ndea.es</tms:messagesender> <tms:messagerecipient> r</tms:messagerecipient> <tms:dateofpreparation> </tms:dateofpreparation> <tms:timeofpreparation>12:01:03</tms:timeofpreparation> <tms:messageidentifier> es00076h7001k</tms:messageidentifier> </Header> <Body> <ChangeOfDestination> <Attributes> <DateAndTimeOfValidationOfChangeOfDestination> T12:01:03 </DateAndTimeOfValidationOfChangeOfDestination> <CertificadoElectronico>9JFI8BG278IBDE48</CertificadoElectronico> </Attributes> <NewTransporterTrader language="es"> <TraderName>Transportes Mora</TraderName> <StreetName>Pol. Ind. Norte</StreetName> <StreetNumber>30</StreetNumber> <Postcode>28666</Postcode> <City>Navalmoral</City> </NewTransporterTrader> <TransportDetails> <TransportUnitCode>2</TransportUnitCode> <IdentityOfTransportUnits>MA5432TR</IdentityOfTransportUnits> <CommercialSealIdentification>Mercurio</CommercialSealIdentification> <ComplementaryInformation language="es">transporte Terrestre Urgente</ComplementaryInformation> <SealInformation language="es">precinto correcto</sealinformation> </TransportDetails> <UpdateEaad> <AadReferenceCode>16ESPRU </AadReferenceCode> <JourneyTime>D07</JourneyTime> <SequenceNumber>2</SequenceNumber> <TransportModeCode>3</TransportModeCode> </UpdateEaad> <ChangedDestination> <DestinationTypeCode>1</DestinationTypeCode> <NewConsigneeTrader language="es"> <Traderid>GBWK </Traderid> <TraderName>Thomas Dereck And Co.</TraderName> <StreetName>Wellington Aveniu</StreetName> <StreetNumber>2345</StreetNumber> <Postcode> </Postcode> <City>Liverpool</City> </NewConsigneeTrader> <DeliveryPlaceTrader language="es"> <Traderid>GBUK </Traderid> <TraderName>Thomas Dereck And Co. WareHouses</TraderName> <StreetName>Wellington Aveniu Docks 21, 22, 23</StreetName> <StreetNumber>2345</StreetNumber> <Postcode> </Postcode> <City>Liverpool</City> </DeliveryPlaceTrader> </ChangedDestination> </ChangeOfDestination> </Body> </CD813A> Fecha publicación: 01/10/2015 IE813Rs-SEV31-Recogida de cambio destino expedido-sincronismo.docx Pág: 14/14