Generación de Certificados Digitales para Utilización con Webservices AFIP
1 Introducción
- Objetivo
El siguiente documento tiene como objetivo mostrar los distintos pasos para la obtención de un certificado digital válido solamente para el entorno de producción. Se presupone que ya se posee clave fiscal de nivel acorde a los servicios que se utilizan (3), tramitada en una dependencia de AFIP.
- Alcance
Aquellos desarrolladores o contactos técnicos de las Empresas o Contribuyentes que necesiten consumir un Webservice provisto por AFIP.
- Siglas, Acrónimos y Referencias
CSR: Solicitud de Certificado de Firma (en ingles Certificate Signing Request). Webservice: Servicio HTTP SOAP implementado por AFIP y consultado por Contribuiyentes.
2 Solicitud del Certificado Digital
2.1 Presentación de Situación
Para ejemplificar el procedimiento se utilizará un caso ficticio. En este caso el usuario JOSE PEREZ ROMERO (CUIT 20120940288) es un técnico informático que trabaja para la empresa “EMPRESA DE FACTURACION S.A.” (CUIT 30710955057). La empresa es una firma que brinda servicio de facturación a otras empresas. A su vez factura electrónicamente a sus clientes. El Administrador de Relaciones de la Empresa le ha delegado a JOSE PEREZ ROMERO el servicio “Administrador de Certificados Digitales”.
2.2 Acceso al Sistema
Ingresando por el portal institucional (http://www.afip.gob.ar) deberá ubicar el botón de acceso directo con la Clave Fiscal.
Luego de ingresar el usuario y la contraseña presionar el botón “INGRESAR”. Se desplegara el listado de servicios habilitados para el usuario.
El servicio a utilizar se denomina “Administración de Certificados Digitales”. En caso de contar con el servicio, hacer clic sobre el titulo para acceder. Caso contrario referirse al instructivo de utilización del Administrador de Relaciones para Delegación de un Servicio.
La primera acción a realizar en el servicio, será determinar en nombre de quien se transaccionará.
El sistema presenta la pantalla con un desplegable conteniendo todas las personas que han autorizado al usuario para Administrar sus Certificados Digitales. Para más información acerca de la Delegación de este y cualquier otro servicio, remitirse al instructivo de utilización del Administrador de Relaciones.
En este ejemplo la empresa “EMPRESA DE FACTURACION S.A.” es la empresa que utilizará los Webservices, por lo tanto es la empresa que solicitará el Certificado Digital. Se deberá seleccionar entonces a “EMPRESA DE FACTURACION S.A.” del desplegable.
NOTA: En el caso de que el mismo usuario sea el que solicita el certificado digital, y ninguna otra persona le hubiera delegado el servicio, esta pantalla es omitida por el sistema, ya que el usuario solo podría seleccionarse a si mismo.
Inicialmente la pantalla se presenta vacía, ya que la persona no tiene Certificados Digitales habilitados. Para solicitar un nuevo certificado digital, deberá presionar el botón “Agregar Alias”.
La solicitud de un nuevo certificado le requiere que ingrese dos datos. El Alias del certificado y un archivo CSR. El alias es el nombre descriptivo que la persona quiera para distinguir sus certificados. Internamente AFIP asociará al Alias del certificado, la CUIT de la persona solicitante.
El archivo CSR es un archivo de texto que puede ser generado con cualquier herramienta de algoritmos de Seguridad, como por ejemplo OpenSSL (http://www.openssl.org). El punto 3 del presente documento tiene una guía para la generación de solicitudes de Certificados Digitales utilizando OpenSSL.
En este caso el Alias elegido es “facturacion-1”. Luego de completar el alias y subir el archivo CSR, el sistema muestra la pantalla inicial, ahora con el nuevo certificado solicitado.
Al seleccionar la opción de Ver el detalle del certificado, el sistema trae la información que contenía la solicitud generada.
En la primer sección de la página muestra los datos identificatorios del Computador Fiscal: CUIT, Alias, y DN (Distinguish Name). La segunda tabla tiene el listado de certificados digitales asociados al computador. Utilizando el icono “Descargar” podrá obtener el certificado digital emitido (Archivo CRT), que en conjunto con la Clave Privada generada al momento de realizar la solicitud, podrá compilar para generar el Certificado Digital (Archivo PFX) instalable en su equipo.
Los certificados emitidos por AFIP tienen una vigencia de 2 años calendarios. Una vez vencidos ya no podrá operar más con ese certificado. Para continuar utilizándolo deberá solicitar un nuevo certificado asociado a ese computador fiscal. Para esto, deberá utilizar el botón “Agregar Certificado”. Este botón lo remite a la pantalla de solicitud de Certificado, donde deberá consignar el mismo Alias y enviar un nuevo CSR para la generación de un nuevo certificado.
3 Generación de Solicitud de Certificado utilizando OpenSSL
Esta es una de las partes mas complicadas, pero con ALFA Gestion, simplemente deberá elegir la opción 1) GENERAR LA CLAVE PRIVADA Y EL ARCHIVO CSR (Esta opción está dentro de configuración del Sistema, o utilizando la herramienta “Asistente para Generar Certificado Digital AGCDALFA.EXE “.
Clickeando esta opción, el sistema se encarga de descargar el openssl y generar la clave privada.key, y el archivo clave.csr.
Utilizar el Certificado Digital Una vez que haya generado correctamente su CSR, puede usarlo para obtener su certificado digital X.509, utilizando las instrucciones de este Documento Técnico. Luego deberá asociar el certificado al Web Service de Negocio que necesite, usando el servicio “Administrador de Relaciones de Clave Fiscal”. Para más información, por favor remitase al manual del Administrador de Relaciones.
Nota: Para el caso del entorno de Testing, envíelo por e-mail a webservices@afip.gov.ar aclarando a qué WS “de negocio” (por ej.: “wsfe”, “wsseg”, etc.) pretende acceder usando este certificado. El certificado le será devuelto por e-mail.