Ie810V32 Presentación de Cancelación de un documento de acompañamiento.

Transcripción

1 EMCS-Servicios Web Documentos expedidos FASE 3.2 Ie810V32 Presentación de Cancelación de un documento de acompañamiento. 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 /02/2008 Versión inicial A Todas /05/2008 Control de versiones R Todas /04/2009 Adaptación a versión EMCS 2.19 R 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 Índice: 1. Introducción: 3 2. Control de versiones: Cambios de la Fase versión 3.3 (1-octubre-2015): Cambios de la Fase 3: 4 3. Servicio web Ie810V32.wsdl. Comunicación de la cancelación de un documento Mensaje IE Estructura : Consideraciones especiales: 9 5. Definición servicio y esquemas 10 Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 1/16

2 5.1. Definición servicio Ie810V32.wsdl Mensaje de entrada Ie810V32Ent.xsd Mensaje de salida correcta Ie810V32Sal.xsd Mensaje de salida con errores Ie704V32Sal.xsd URL s de acceso al servicio en los distintos entornos Lista de errores Ejemplos Ejemplo de presentación de la cancelación Ie810V32Ent Ejemplo de aceptación de la cancelación Ie810V32Sal Ejemplo de respuesta con error Ie704V32Sal 16 Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 2/16

3 1. Introducción: Dentro del sistema EMCS, con este servicio se realiza la cancelación de un documento de acompañamiento. Previamente el operador ha presentado un borrador de documento con el mensaje IE815 y la AEAT ha aceptado el movimiento devolviendo, en el mensaje IE801, el documento con número ARC asignado. Siempre con anterioridad a que se produzca la salida de las mercancías, el operador puede enviar una cancelación del documento utilizando para ello el mensaje IE810. Si ya ha cumplido la fecha+hora de expedición declarada, la cancelación ya no está permitida. El expedidor de las mercancías podrá realizar, en este caso, un cambio de destino para retornar las mercancías al lugar de despacho (debiendo emitir en este caso también un certificado de recepción a la entrada de las mercancías), o alternativamente puede realizar un cambio de destino enviando las mercancías a otro destinatario o lugar de entrega. El cambio de destino está también documentado en las especificaciones técnicas del proyecto EMCS. Un documento (ARC) que sea cancelado queda totalmente invalidado a todos los efectos sin que pueda realizarse nada con él. De dicha cancelación la AEAT informará también a la administración del estado miembro de destino, quien si lo considera oportuno informará al destinatario. En cualquier caso, el expedidor podrá reutilizar su número interno en un nuevo borrador de documento al que, en caso de ser aceptado, se le asignará un nuevo ARC. Cancelación E x p e d id o r P a í s d e D e s p a c h o P a í s d e D e s t i n o D e s t i n a t a r io E _ e x p e d id o r c a n c e la m o v im ie n t. U C E m ite c a n c e la c ió n ( IE : C _ C A N _ D A T ) U C C h e q u e a c a n c e la c ió n N o v á lid a ( IE : N _ R E J _ D A T ) V a lid a c a n c e la c ió n R _ C a n c e la c ió n r e c h a z a d a U C V a lid a c a n c e la c ió n d e l e - A A D ( IE : C _ C A N _ D A T ) U C C a n c e la c ió n A d m itid a ( IE : C _ C A N _ D A T ) R _ M o v im ie n to c a n c e la d o U C R e c ib e la c a n c e la c ió n ( IE : C _ C A N _ D A T ) R _ M o v im ie n to c a n c e la d o R _ M o v im ie n to c a n c e la d o R _ M o v im ie n to c a n c e la d o Departamento de Informática Tributaria. S.G. de Aplicaciones de Aduanas e II.EE. Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 3/16

4 2. Control de versiones: 2.1. Cambios de la Fase versión 3.3 (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: - Se ha corregido la errata existente en el esquema de entrada Ie810V32Ent.xsd, eliminando el grupo Attributes, dado que los elementos que contenía no son declarables por el emisor del mensaje. - Se ha incluido el uso opcional en la definición del atributo Test dentro del elemento raíz del mensaje 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. - Tanto en el mensaje Ie810 de entrada como en el de salida se ha añadido en el tipo complejo "CancellationType" el elemento "Complementary Information" 3. Servicio web Ie810V32.wsdl. Comunicación de la cancelación de un documento. 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 Jurídica emisora de las tarjetas, bien de un apoderado de la misma para este trámite. La definición del servicio se puede consultar en la dirección y su representación gráfica es la siguiente Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 4/16

5 En la definición de este servicio se describe que el mensaje de entrada se basa en el esquema Ie810V32Ent.xsd, la respuesta cuando se acepta el borrador en el esquema Ie810V32Sal.xsd y la respuesta cuando no es aceptado el borrador en el esquema Ie704V32Sal.xsd. El diseño del esquema de entrada se puede consultar en la dirección y la representación gráfica de los principales tipos de datos es la siguiente Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 5/16

6 El diseño del esquema de salida correcta se puede consultar en la dirección y la representación gráfica de los principales tipos de datos es la siguiente Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 6/16

7 El diseño del esquema de salida en caso de error en la cancelación se puede consultar en la dirección y la representación gráfica de los principales tipos de datos es la siguiente Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 7/16

8 4. Mensaje IE810 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. o Dependiendo del tipo de destinatario se ha establecido la obligatoriedad para la presentación de cada una de las informaciones, cada una de las columnas representa a un tipo distinto de destinatario: TWK Depósito Fiscal RCE Destinatario autorizado NRCE Operador no registrado ED Entrega directa OE Organizaciones exentas EX Exportación DD Destinatario desconocido Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 8/16

9 4.1. Estructura : CD810A Grupo D/R Nº 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 Exc.Movement E-AAD R 1 Identificación del documento 1a R AAD Reference Code 2.- Cancellation R 1 Motivo de la cancelación 2a R Cancelation Reason Code 43 2b D Complementary Information C154 2c D Complementary Information_LNG C Consideraciones especiales: Por regla general los formatos de los campos están definidos en los esquemas de los mensajes y en el documento General, pero algunos de los campos tienen formatos particulares para los documentos de acompañamiento expedidos desde España y estos son: Message sender Nombre sender Message recipient Se pondrá el NIF de la empresa expedidora de los productos Se indicará el nombre o razón social de la empresa expedidora de los productos Se indicará como valor fijo: NDEA.ES Message identifier Código de identificación del mensaje. Su longitud será como máximo de 40 posiciones (A40). Debe ser único por empresa y tipo de mensaje. Correlation identifier En la respuesta, se devolverá el valor de Message identifier del mensaje al que se responde. Date and time of validation En la respuesta, se indicará la fecha y hora en la que se acepta la cancelación of cancellation Certificado electronico del documento. En la respuesta, se devolverá el código de certificado electrónico de autentificación. Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 9/16

10 5. Definición servicio y esquemas 5.1. Definición servicio Ie810V32.wsdl La definición del servicio se puede consultar en la dirección : <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace= " xmlns=" xmlns:ent810= " xmlns:sal810= " xmlns:sal704= " xmlns:wsdl=" xmlns:wsdlsoap=" xmlns:xsd=" <wsdl:types> <schema elementformdefault="qualified" targetnamespace= " xmlns=" <xsd:import namespace= " schemalocation="ie810v32ent.xsd" /> <xsd:import namespace= " schemalocation="ie810v32sal.xsd" /> <xsd:import namespace= " schemalocation="ie704v32sal.xsd" /> <xsd:complextype name="ie810v32saltype"> <xsd:choice> <xsd:element ref="sal810:cd810a"></xsd:element> <xsd:element ref="sal704:cd704a"></xsd:element> </xsd:choice> </xsd:complextype> </schema> </wsdl:types> <wsdl:message name="entrada"> <wsdl:part name="ie810v32ent" element="ent810:cd810a" /> </wsdl:message> <wsdl:message name="salida"> <wsdl:part name="ie810v32salida" type="ie810v32saltype"></wsdl:part> </wsdl:message> <wsdl:porttype name="ie810v32"> <wsdl:operation name="ie810v32"> <wsdl:input message="entrada" name="entrada" /> <wsdl:output message="salida" name="salida" /> </wsdl:operation> </wsdl:porttype> <wsdl:binding name="ie810v32soapbinding" type="ie810v32"> <wsdlsoap:binding style="document" transport=" /> <wsdl:operation name="ie810v32"> <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="ie810v32service"> <wsdl:port binding="ie810v32soapbinding" name="ie810v32"> <wsdlsoap:address location=" /> </wsdl:port> <wsdl:port binding="ie810v32soapbinding" name="ie810v32pruebas"> <wsdlsoap:address location=" /> </wsdl:port> </wsdl:service> </wsdl:definitions> Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 10/16

11 5.2. Mensaje de entrada Ie810V32Ent.xsd El diseño del esquema de entrada se puede consultar en la dirección: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs=" xmlns=" xmlns:emcs=" xmlns:tms=" xmlns:tcl=" xmlns:ds=" xmlns:etsi=" targetnamespace= " elementformdefault="qualified" attributeformdefault="unqualified" version="1.00"> <!--========================================= --> <!--===== IE810:C_CAN_DAT --> <!--===== CANCELLATION OF AN E-AAD --> <!--========================================= --> <!--===== Imports ===== --> namespace=" schemalocation="typesv32.xsd" /> namespace=" schemalocation="tmsv32.xsd" /> namespace=" schemalocation="tclv32.xsd" /> namespace=" schemalocation="../../xades/xmldsig-core-schema.xsd" /> namespace=" schemalocation="../../xades/xades.xsd" /> <!--===== Root Element ===== --> <xs:element name="cd810a" type="cd810atype" /> <!--===== EMCS Data Groups Declarations ===== --> <xs:complextype name="cd810atype"> <xs:element name="header" type="tms:headertype" /> <xs:element name="body" type="bodytype" /> <xs:element ref="ds:signature" /> <xs:attribute name="test" type="tcl:testtipo" use="optional"> <xs:annotation> <xs:documentation> Indicador de Test. No es obligatorio. En caso de aparecer sólo podrá tomar los valores S=Modo pruebas </xs:documentation> </xs:annotation> </xs:attribute> <!--===== IE Specific Data Groups Declarations ===== --> <xs:complextype name="bodytype"> <xs:element name="confirmationofcancellationofeaad" type="confirmationofcancellationofeaadtype" /> <xs:complextype name="confirmationofcancellationofeaadtype"> <xs:element name="excisemovementeaad" type="excisemovementeaadtype" /> <xs:element name="cancellation" type="cancellationtype" /> <xs:complextype name="excisemovementeaadtype"> <xs:element name="aadreferencecode" type="emcs:aadreferencecodetype" /> <xs:complextype name="cancellationtype"> <xs:element name="cancellationreasoncode" type="emcs:cancellationreasoncodetype" /> <xs:element name="complementaryinformation" type="lsdcomplementaryinformationtype" <!--===== 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> Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 11/16

12 </xs:simplecontent> </xs:schema> 5.3. Mensaje de salida correcta Ie810V32Sal.xsd El diseño del esquema de salida correcta se puede consultar en la dirección: <?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"> <!--========================================= --> <!--===== IE810:C_CAN_DAT --> <!--===== CANCELLATION OF AN E-AAD --> <!--========================================= --> <!--===== Imports ===== --> namespace=" schemalocation="typesv32.xsd" /> namespace=" schemalocation="tmsv32.xsd" /> namespace=" schemalocation="tclv32.xsd" /> <!--===== Root Element ===== --> <xs:element name="cd810a" type="cd810atype" /> <!--===== EMCS Data Groups Declarations ===== --> <xs:complextype name="cd810atype"> <xs:element name="header" type="tms:headertype" /> <xs:element name="body" type="bodytype" /> <xs:attribute name="test" type="tcl:testtipo"> <xs:annotation> <xs:documentation> 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="confirmationofcancellationofeaad" type="confirmationofcancellationofeaadtype" /> <xs:complextype name="confirmationofcancellationofeaadtype"> <xs:element name="attributes" type="attributestype" /> <xs:element name="excisemovementeaad" type="excisemovementeaadtype" /> <xs:element name="cancellation" type="cancellationtype" /> <xs:complextype name="attributestype"> <xs:element name="dateandtimeofvalidationofcancellation" type="emcs:datetimetype" <xs:element name="certificadoelectronico" type="emcs:certificadoelectronicotipo" <xs:complextype name="excisemovementeaadtype"> <xs:element name="aadreferencecode" type="emcs:aadreferencecodetype" /> <xs:complextype name="cancellationtype"> <xs:element name="cancellationreasoncode" type="emcs:cancellationreasoncodetype" /> Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 12/16

13 <xs:element name="complementaryinformation" type="lsdcomplementaryinformationtype" <!--===== 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:schema> 5.4. Mensaje de salida con errores Ie704V32Sal.xsd El diseño del esquema de salida con errores se puede consultar en la dirección: <?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"> <!--========================================= --> <!--===== IE704:N_REJ_DAT --> <!--===== GENERIC REFUSAL MESSAGE --> <!--========================================= --> <!--===== Imports ===== --> namespace= " schemalocation="typesv32.xsd" /> namespace= " schemalocation="tmsv32.xsd" /> namespace= " schemalocation="tclv32.xsd" /> <!--===== Root Element ===== --> <xs:element name="cd704a" type="cd704atype" /> <!--===== EMCS Data Groups Declarations ===== --> <xs:complextype name="cd704atype"> <xs:element name="header" type="tms:headertype" /> <xs:element name="body" type="bodytype" /> <!--===== IE Specific Data Groups Declarations ===== --> <xs:complextype name="bodytype"> <xs:element name="genericrefusalmessage" type="genericrefusalmessagetype" /> <xs:complextype name="genericrefusalmessagetype"> <xs:element name="attributes" type="attributestype" <xs:element name="functionalerror" type="functionalerrortype" maxoccurs="unbounded" /> <xs:complextype name="attributestype"> <xs:element name="aadreferencecode" type="emcs:aadreferencecodetype" <xs:element name="sequencenumber" type="emcs:sequencenumbertype" <xs:element name="localreferencenumber" type="emcs:localreferencenumbertype" <xs:complextype name="functionalerrortype"> <xs:element name="errortype" type="tcl:functionalerrorcodes" /> Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 13/16

14 <xs:element name="errorreason" type="emcs:errorreasontype" /> <xs:element name="errorlocation" type="emcs:errorlocationtype" <xs:element name="originalattributevalue" type="emcs:originalattributevaluetype" </xs:schema> Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 14/16

15 5.5. URL s de acceso al servicio en los distintos entornos. Para el Entorno Real la URL es: Para el Entorno de Pruebas es: 6. Lista de errores Los códigos de error se pueden consultar en el documento LISTA DE CÓDIGOS DE ERROR. 7. Ejemplos 7.1. Ejemplo de presentación de la cancelación Ie810V32Ent <?xml version="1.0" encoding="utf-8"?> <CD810A Test="S" xmlns=" xmlns:tms=" xmlns:ds=" xmlns:xsi=" xsi:schemalocation= " tmsv32.xsd "> <Header> <tms:messagesender>ndea.es</tms:messagesender> <tms:messagerecipient> r</tms:messagerecipient> <tms:dateofpreparation> </tms:dateofpreparation> <tms:timeofpreparation>12:00:00</tms:timeofpreparation> <tms:messageidentifier> </tms:messageidentifier> </Header> <Body> <ConfirmationOfCancellationOfEaad> <ExciseMovementEaad> <AadReferenceCode>16ESPRU </AadReferenceCode> </ExciseMovementEaad> <Cancellation> <CancellationReasonCode>1</CancellationReasonCode> <ComplementaryInformation language="es"> Se cancela por contener errores </ComplementaryInformation> </Cancellation> </ConfirmationOfCancellationOfEaad> </Body> <ds:signature Id="idvalue0"> <ds:signedinfo Id="idvalue1"> <ds:canonicalizationmethod Algorithm=" /> <ds:signaturemethod Algorithm=" <ds:hmacoutputlength>0</ds:hmacoutputlength> </ds:signaturemethod> <ds:reference Id="idvalue2" Type=" URI=" <ds:transforms> <ds:transform Algorithm=" <ds:xpath>ds:xpath</ds:xpath> </ds:transform> </ds:transforms> <ds:digestmethod Algorithm=" /> <ds:digestvalue>0100</ds:digestvalue> </ds:reference> </ds:signedinfo> <ds:signaturevalue Id="idvalue3">0100</ds:SignatureValue> <ds:keyinfo Id="idvalue4"> <ds:keyname>ds:keyname</ds:keyname> </ds:keyinfo> <ds:object Encoding=" Id="idvalue5" MimeType=""> Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 15/16

16 <ds:spkidata> <ds:spkisexp>0100</ds:spkisexp> </ds:spkidata> </ds:object> </ds:signature> </CD810A> 7.2. Ejemplo de aceptación de la cancelación Ie810V32Sal <?xml version="1.0" encoding="utf-8"?> <CD810A Test="S" xmlns=" xmlns:tms=" xmlns:xsi=" xsi:schemalocation= " tmsv32.xsd "> <Header> <tms:messagesender>ndea.es</tms:messagesender> <tms:messagerecipient> r</tms:messagerecipient> <tms:dateofpreparation> </tms:dateofpreparation> <tms:timeofpreparation>12:01:00</tms:timeofpreparation> <tms:messageidentifier> </tms:messageidentifier> </Header> <Body> <ConfirmationOfCancellationOfEaad> <Attributes> <DateAndTimeOfValidationOfCancellation> T12:01:00 </DateAndTimeOfValidationOfCancellation> <CertificadoElectronico>E AED2033D</CertificadoElectronico> </Attributes> <ExciseMovementEaad> <AadReferenceCode>16ESPRU </AadReferenceCode> </ExciseMovementEaad> <Cancellation> <CancellationReasonCode>1</CancellationReasonCode> <ComplementaryInformation language="es"> Se cancela por contener errores </ComplementaryInformation> </Cancellation> </ConfirmationOfCancellationOfEaad> </Body> </CD810A> 7.3. Ejemplo de respuesta con error Ie704V32Sal <?xml version="1.0" encoding="utf-8"?> <CD704A xmlns=" xmlns:tms=" <Header> <tms:messagesender>ndea.es</tms:messagesender> <tms:messagerecipient> r</tms:messagerecipient> <tms:dateofpreparation> </tms:dateofpreparation> <tms:timeofpreparation>12:01:00</tms:timeofpreparation> <tms:messageidentifier> </tms:messageidentifier> <tms:correlationidentifier> </tms:correlationidentifier> </Header> <Body> <GenericRefusalMessage> <Attributes> <AadReferenceCode>16ESPRU </AadReferenceCode> <SequenceNumber>1</SequenceNumber> </Attributes> <FunctionalError> <ErrorType>12</ErrorType> <ErrorReason>03007-La mercancía ya ha sido expedida.</errorreason> <OriginalAttributeValue> :00:00</OriginalAttributeValue> </FunctionalError> </GenericRefusalMessage> </Body> </CD704A> Fecha publicación: 01/10/2015 IE810-EV31-Cancelación de un documento de acompañamiento.doc Pág.: 16/16