|
8.1 Integración con el servicio de Validación y Prueba
Deberá realizarse una invocación al servicio por cada fichero con el contenido de la declaración que se desee validar. La invocación del servicio se podrá realizar de dos formas: 8.1.1.1 Envío directo al servidor de la AEAT Al servicio se le pasará por el método POST del protocolo http una cadena de caracteres encapsulada como si fuese desde un formulario. Se debe respetar el orden de las variables, que irán etiquetadas como nombre=valor, separadas mediante el símbolo &, y sólo con el valor en codificación URLEncoded. La URL de llamada directa al servicio es: https://www5.aeat.es/l/zi22zilk0022 El orden de las variables, su nombre y su contenido son los indicados a continuación:
El fichero enviado se validará con los programas HOST de 8.1.1.2 Enlace con el formulario: A través de un formulario HTML, en https://www5.aeat.es/es13/h/ie82000v.html?fic=<path_al_fichero_a_validar> Donde la variable ‘fic’ de la URL contendrá el camino, en el sistema de ficheros local, al fichero que se desea validar. Esta variable es opcional, si no se utiliza, se presentará al usuario una página HTML que permite seleccionar, a través de una ventana de diálogo, el fichero a validar. El fichero enviado se validará con los programas HOST de Las páginas de respuesta sin errores permitirán al usuario obtener una copia en PDF de la declaración validada.
Ver apartado 8.4 Requisitos comunes a los tres servicios.
8.2.Integración con el servicio de Impresión
Deberá realizarse una invocación al servicio por cada fichero con el contenido de la declaración que se desee imprimir. La invocación del servicio se podrá realizar de dos formas: 8.2.1.1 Envío directo al servidor de la AEAT Al servicio se le pasará por el método POST del protocolo http una cadena de caracteres encapsulada como si fuese desde un formulario.Se debe respetar el orden de las variables, que irán etiquetadas como nombre=valor, separadas mediante el símbolo &, y sólo con el valor en codificación URLEncoded. La URL de llamada directa al servicio es: https://www5.aeat.es/l/zi21zilk0021 (proxy) El orden de las variables, su nombre y su contenido son los indicados a continuación:
El fichero enviado se validará con los programas HOST de la AEAT y si es correcto se almacenará provisionalmente en las bases de datos de 8.2.1.2 Enlace con el formulario: A través de un formulario HTML, en https://www5.aeat.es/es13/h/ie82000b.html?fic=<path_al_fichero> Donde la variable ‘fic’ de la URL contendrá el camino, en el sistema de ficheros local, al fichero que se desea enviar al servicio de impresión. Esta variable es opcional, si no se utiliza, se presentará al usuario una página HTML que permite seleccionar, a través de una ventana de diálogo, el fichero a enviar al servicio de impresión. El fichero enviado se validará con los programas HOST de la AEAT y, si es correcto, se almacenará provisionalmente en las bases de datos de la AEAT obteniéndose como respuesta un PDF con el contenido de la declaración que puede ser impreso y utilizado para su presentación ante las EECC. Si el fichero presenta algún error, se obtendrá una página HTML con los errores encontrados.
Ver apartado 8.4 Requisitos comunes a los tres servicios.
Ver apartado 8.4 Requisitos comunes a los tres servicios. 8.3Integración con el servicio de Presentación Telemática
La invocación del servicio se podrá realizar de dos formas: 8.3.1.1Envío directo al servidor de la AEAT NOTA: Las presentes especificaciones están orientadas al uso exclusivo de ficheros de declaración generados con el programa de ayuda de la AEAT, programa PADRE, en el que el origen de firma queda expresamente definido entre las etiquetas <FIRMA></FIRMA>. En el caso de usarse ficheros generados por software comercial, el origen de firma debería ser construido por dicho software comercial, dependiendo el mismo de distintos parámetros de la declaración no descritos en esta especificación.
1.Debe disponer de un servicio de captura del fichero a transmitir. 2.Debe seleccionar determinados campos de la declaración para mostrarlos al contribuyente con objeto de:
3.Debe generar una firma electrónica con el certificado de usuario o certificado de usuario del colaborador social según se especifica en el apartado 8.3.1.1.2. 4.Debe enviar el fichero plano, datos de firma y la firma electrónica según se especifica en el apartado 8.3.1.1.3 5.Debe devolver al contribuyente los datos en formato html como resultado de la aceptación o no de la declaración según se especifica en el apartado 8.3.1.1.4 A continuación se describe cómo debe implementarse esta funcionalidad.
El fichero es una secuencia de datos etiquetados. Existe una etiqueta inicial que indica el modelo, tipo de sociedad (normal, aseguradoras, entidades de crédito, inversión colectiva), ejercicio y periodo de la declaración. Por cada página del modelo oficial existe una etiqueta de comienzo y final. También existe una etiqueta que contiene los datos a firmar. A continuación se describen las etiquetas y la localización de datos que necesita el software comercial para realizar la operación de cargo en cuenta (sólo EEFF) o para mostrar los datos relevantes necesarios para obtener la autorización del envío de la declaración2:
Primera etiqueta del fichero <T200x20080A0000>
Para la localización de los siguientes datos, se debe considerar que las posiciones que se indican a continuación se cuentan a partir del primer carácter de la correspondiente etiqueta de inicio, es decir del carácter “<”
Etiqueta <AUX>datos</AUX>
Etiquetas de principio y fin de la página 1 del modelo oficial <T200001></T200001> “Página 1”: 2 Para obtener cualquier otro dato que pueda resultar de interés, consultar el diseño de registro definitivo publicado por la AEAT en Ayuda/Diseños de registro de http://www.aeat.es
Etiquetas de principio y fin de página 8 del modelo oficial <T200008></T200008> “Página 8”:
Etiquetas de principio y fin de página 13 del modelo oficial <T200013></T200013> “Página
Etiquetas de principio y fin de página 14 del modelo oficial <T200014></T200014> “Página
Etiquetas de principio y fin página DID <T200DID></T200DID> “Documento de Ingreso/Devolución”
Los datos a firmar estarán contenidos entre la etiqueta <FIRMA></FIRMA> El software comercial firmará los datos que se han especificado anteriormente de la declaración contenidos en La firma generada debe ser equivalente a la obtenida mediante el método crypto.signText() de JavaScript en el navegador Firefox, aunque sin los CRLFs.
Se enviará a la URL de la A.E.A.T. que se indica a continuación, mediante el método POST un formulario web que contendrá, entre otros, los datos origen de la firma codificados en BASE64, junto con la firma generada. Los datos a enviar serán una cadena de caracteres encapsulada como si fuese desde un formulario por el método POST.Se ha de respetar el orden de las variables, que irán etiquetadas como nombre=valor, separadas mediante el símbolo &, y sólo con el valor va en codificación urlencoded. El orden de las variables, su nombre y su contenido son los indicados a continuación:
Los datos origen de la firma y la firma se han de enviar como Base-64 y sin que contengan caracteres de tipo CRLF. El “action” del formulario desde el que se envía el fichero de la declaración de Sociedades 2008, será: https://www5.aeat.es/es13/l/ewinewlinkin (sin autenticación)
La AEAT genera, de forma predeterminada para cualquier petición de presentación de declaraciones, una respuesta en formato HTML. Para los casos de aceptación de la declaración la respuesta contendrá, además del documento de Ingreso/Devolución, un Código Electrónico que garantiza la aceptación de la presentación, la fecha y
La página correcta siempre contendrá el código electrónico (variable CEL de Javascript) y la página de respuesta de error nunca lo contendrá. El código electrónico, junto con la fecha y hora (variables Javascript FEC y HOR), indican que la declaración se ha grabado en el servidor de la AEAT.
El título de la página correcta comienza por el código electrónico. El título de la página de rechazo tiene el texto “ERROR”.
El número máximo de errores que se mostrará será de 100. No es posible anular declaraciones ya grabadas.
En el caso de producirse algún error de comunicaciones durante la transmisión de la declaración, se podrá recuperar la página de aceptación o de error efectuando de nuevo la transmisión de
El software comercial puede guardar las páginas de respuestas aceptadas para poder mostrarlas al contribuyente en consulta. Desde el servidor de la AEAT únicamente se muestran previa autenticación de certificado de usuario del titular o presentador.
El software comercial, al haber iniciado la comunicación con el servidor de la AEAT (en este caso hace el papel de cliente), recibirá esta respuesta HTML que deberá reenviar al contribuyente, o permitir su consulta con posterioridad.
El software comercial puede proporcionar la posibilidad de comprobar que la declaración ha sido admitida por la AEAT, para lo cual puede utilizar dos alternativas:
Se enviará a la URL mediante el método POST un formulario que contendrá los datos necesarios para identificar la declaración presentada. El “action” del formulario desde el que se envían los datos para la comprobación de la presentación de la declaración será: https://www4.aeat.es/es13/l/ewcjewlinkcj (con autenticación) Los datos a enviar serán una cadena de caracteres encapsulada como si fuese desde un formulario por el método POST.Se ha de respetar el orden de las variables, que irán etiquetadas como nombre=valor, separadas mediante el símbolo &, y sólo con el valor va en codificación urlencoded. El orden de las variables, su nombre y su contenido son los indicados a continuación:
El software comercial podrá almacenar en sus sistemas la respuesta correcta devuelta por la AEAT en su día, la cual podrá mostrar al contribuyente cada vez que éste se lo solicite.
Se podrán realizar pruebas de validación del fichero de la declaración con el servicio de validación/pruebas descrito en el apartado 8.1. 8.3.1.2 Enlace con el formulario: NOTA: Las presentes especificaciones son válidas tanto para ficheros de declaración generados por el programa de ayuda de la AEAT (programa PADRE) como para ficheros generados por software comercial.
La invocación al servicio se realizará a través de un formulario HTML, en https://www5.aeat.es/es13/h/servurls.html?WEB=INTERNET&PRG=200&EJE=2008&URL=PIR&EXT=’?FIC=caminodelfichero’ Donde la variable ‘FIC’ de la URL contendrá el camino, en el sistema de ficheros local, al fichero que se desea presentar telemáticamente. Esta variable es opcional, si no se utiliza, se presentará al usuario una página HTML que permite seleccionar, a través de una ventana de diálogo, el fichero a presentar telemáticamente. El servicio de Presentación Telemática procederá a la firma electrónica de la declaración utilizando el certificado de usuario, y realizará la petición correspondiente a los programas HOST de la AEAT, que validarán la declaración y la firma y devolverán al contribuyente una página HTML con el resultado de la presentación.
Ver apartado 8.4 Requisitos comunes a los tres servicios.
Ver apartado 8.4 Requisitos comunes a los tres servicios. 8.4 Requisitos comunes a los tres servicios
Se tienen que utilizar los caracteres visibles de ISO-8859-1, ya que los invisibles (saltos de línea, tabuladores, ..) modifican la posición de los datos. Se ruega que preferentemente se envíen los caracteres alfabéticos en mayúsculas. Debido a que la página de respuesta utiliza el apóstrofe (') para delimitar las cadenas en JavaScript y los valores de las variables se devuelven desde el servidor separados por ampersand (&), en los datos de la declaración que se muestran en las página de salida (Nombre o razón Social, domicilio, Municipio) se deben sustituir el ' y el & por espacios en blanco
8.4.2.1 Ordenador. Configuración. Sistemas operativos :
8.4.2.2 Impresora Para imprimir la declaración es necesario tener instalado en el ordenador un visor de PDF (por ejemplo el Adobe Reader) e impresora. |
En cumplimiento de la LOPD 15/99 y LSSICE 34/2002, y demás disposiciones legales, se le informa que sus datos de carácter personal se encuentran en un fichero automatizado de carácter personal cuyo Responsable de Fichero es ASEFIGET. Autoriza la utilización de los mismos para las comunicaciones, incluyendo las realizadas vía correo electrónico, que ASEFIGET realice. Queda igualmente informado de la posibilidad de ejercitar sobre tales datos los derechos de acceso, rectificación, cancelación y oposición, a cuyo fin deberá dirigirse por carta a ASEGIGET c/ Alcalá 94, 2º dcha.28009 Madrid, o por email a comunicacion@asefiget.com. Si usted no desea recibir más información via e-mail remita un correo indicando la palabra "baja" en asunto.