H. MÓDULO BÁSICO INSTALABLE DE FIRMA/VERIFICACIÓN CONTROL ACTIVEX ESPECIFICACIONES TÉCNICAS 1. Marco funcional La Agencia Tributaria, con el fin de facilitar a los contribuyentes el uso del nuevo sistema de facturación telemática, proporciona un componente con el que se podrá implementar los mecanismos básicos exigibles a la facturación telemática, y que se establecen en la Resolución 2/2003 de 14 de febrero y en la Orden Ministerial HAC/3134/2002 de 5 de diciembre, como la autenticidad del origen de las facturas telemáticas y la integridad de su contenido, lo que impide el repudio de la factura telemática por su emisor. En esta documentación, se incluye el enlace al componente ActiveX para el Sistema Operativo Microsoft Windows, versiones 95 y posteriores, en el que los certificados de usuario X.509 v3 deberán estar ubicados en el almacén de certificados de Microsoft Internet Explorer, desde su versión 4.0, es decir, en el registro de Microsoft Windows. Este componente será el responsable de generar la firma electrónica así como de verificar la firma de las facturas electrónicas. El componente se podrá utilizar realizando desarrollos propios a medida en lenguajes como C++, Visual Basic,.NET, etc... El envío de las facturas telemáticas entre emisor y receptor es ajeno a este sistema y se podrá realizar mediante correo electrónico, ftp,... 2.Módulo de generación de la firma Fra Active X Fra en Base 64 PKCS#7 La entrada al componente será el fichero que contiene la factura que se desea firmar electrónicamente para su posterior envío. El ActiveX generará el contenido íntegro de la factura en codificación estándar BASE-64. Se ha elegido este formato para asegurar la integridad de los datos que se envían entre distintas plataformas hardware y software. También generará la firma electrónica en formato PKCS#7. cuadernos 397
La firma electrónica. Marco legal y aplicaciones prácticas Ambas partes serán guardadas en un fichero de texto. El diseño de este fichero será el siguiente: <NOMFIC> </NOMFIC> <FACB64>... </FACB64> <FIRB64>... </FIRB64> donde, <NOMFIC>: Nombre del fichero factura telemática. <FACB64>: Factura en codificación BASE-64. <FIRB64>: Firma electrónica de la factura en BASE-64. Basta con enviar al receptor este fichero de factura y firma con extensión.f64, ya que desde él se podrá obtener la factura telemática original mediante la opción de Verificación. 3. Módulo de verificación de la firma Para la verificación de la firma se requerirá el fichero generado en el proceso de firma, ajustado al diseño de registro descrito en el apartado anterior. Además es imprescindible estar conectado a Internet y poder acceder al servidor web de la AEAT. En el proceso de verificación se deberá realizar una conexión https con una aplicación en el servidor web de la AEAT y enviar el fichero generado durante el proceso de firma. Si la verificación es correcta el módulo traducirá el formato de la factura desde Base Code 64 a su formato original. 4. Registrar/Quitar el componente ActiveX Para instalar y registrar el componente que acompaña a esta documentación, ubicado el fichero.dll en un camino accesible, se deberá teclear en línea de comandos: regsvr32 AEATFACT.dll 398
Para desinstalar el componente del sistema: regsvr32 /u AEATFACT.dll 5. Utilización del componente Si se desea utilizar el componente ActiveX en una arquitectura basada en Web, se deberá incrustar dicho componente mediante la etiqueta <OBJECT>, con la siguiente sintaxis: <OBJECTclassid='clsid:F171A6DF-F517-4ACB-A7DF-D8B8AE79D710' codebase='facturax.cab#version=3,2,24,0' id=ifirmar> </OBJECT> Es conveniente que el fichero empaquetado (cab) se firme con un certificado válido que tenga como propósito la firma de código, por el emisor de la aplicación como garantía de su origen. En otros entornos basta con cargarlo en la aplicación y realizar llamadas a sus métodos. Los certificados electrónicos utilizados para firmar deberán estar instalados en el almacén de certificados de Internet Explorer, y es conveniente que no existan caducados ni revocados. 6. Interfaz de llamadas al componente ActiveX Los métodos a utilizar son: 6.1. Firma Método FIRMA Parámetros obligatorios: 1/ Ruta completa con nombre del fichero de factura telemática a firmar 2/ Certificado con el que firmar. Se indica el NIF. 3/ Ruta completa con nombre del fichero donde se grabará la factura telemática firmada cuadernos 399
La firma electrónica. Marco legal y aplicaciones prácticas Este método firma la factura del primer parámetro, con el certificado del segundo y lo graba en el fichero del tercero según el formato del apartado 2. El método devolverá una cadena de 00 si la firma se realizó de forma satisfactoria, y en caso de error una cadena del tipo código-_ de_error causa. 6.2 Verificación Método VERIFICA Parámetros obligatorios: 1/ Ruta completa con nombre del fichero de factura telemática y firma a verificar 2/Ruta completa con nombre donde se grabará la factura original. Este método verifica la firma de la factura del primer parámetro, y graba la factura en el fichero del segundo. El método devolverá una cadena de 00 y el firmante si la verificación se realizó de forma satisfactoria, y en caso de error una cadena del tipo código_de_error causa. 00 01 02 03 04 05 11 12 13 14 15 16 17 18 19 20 99 (La firma se ha realizado correctamente y se ha grabado el fichero). SUBJECT del certificado en verificación (cuando se ha verificado correctamente). No se ha podido leer el fichero a firmar. No se tiene acceso al almacén de certificados. El certificado indicado no existe en el almacén de certificados. No se ha podido grabar el fichero de firma en la ruta indicada. No se ha podido realizar la firma. Formato incorrecto del fichero con firma a verificar. Firma no válida para la factura telemática incorporada. Firma errónea, debido a que el certificado está caducado. Firma errónea, debido a que el certificado está revocado. Firma errónea, debido a que el certificado firmante no es válido Firma errónea con formato inválido. No se ha podido establecer conexión https con el servidor de la AEAT para verificar la firma. Error desconocido en la verificación de firma. No se ha podido leer el fichero firmado. No se ha podido grabar la factura en la ruta indicada. Error técnico. 400
Las cadenas devueltas posibles, códigos de retorno y causa, tanto en firma como en verificación son: 7. Descarga El Control ActiveX se descarga desde la opción de menú de facturación telemática. Antes de su instalación hay que descomprimirlo con unzip. 8. Consultas técnicas Para cualquier consulta de índole técnica referente a este documento, puede ponerse en contacto mediante correo electrónico en la dirección: Asunto: FACTELEM internet@aeat.es cuadernos 401