Creación renovación de certificados de AFIP

Introducción

Para que un cliente pueda facturar utilizando la API de AFIP es necesario registrar la entidad con la cual se desea facturar. Una entidad debe constituirse con un nombre, la razón social y su CUIT.

Para ello, debemos integrar los endpoints de gestión de entidades y sus certificados. A fines demostrativos, vamos a usar un sistema de prueba al que llamaremos AFIP-Admin, indicando en cada caso el endpoint utilizado. Los certificados son permisos con expiración que genera AFIP para que una entidad pueda hacer uso de sus web services. Nuestra API de AFIP requiere de dos web services:

• Factura Electrónica.
• Servicio Consulta Padrón A5.

A fin de explicar el proceso, enumeraremos los pasos necesarios. Cada paso indicará el nombre del sistema que interviene en función de quién tiene que realizarlo: dueño de la API de AFIP (a través de AFIP-Admin) o el cliente (a través de el Portal de AFIP con clave fiscal).

Pasos

1. [AFIP-Admin] Crear la entidad usando el CUIT (POST /v1/entities).

   Necesitamos acceder a AFIP-Admin con usuario y contraseña. Esta aplicación administra los datos de entidades de la instancia de producción de la API de AFIP. Una vez dentro, en caso de no existir, necesitamos cargar una nueva entidad con sus datos básicos:

   • Nombre.
   • Razón social.
   • CUIT.
   

2. [AFIP-Admin] Listar entidades para cargar certificado (GET /v1/entities).

   Una vez creada la entidad, desde un listado de entidades, debemos cargar el certificado a la entidad deseada.

   

   Si se tratara de una entidad con un certificado existente y lo que queremos hacer es renovarlo, entonces tenemos que hacer click en la opción modificar el existente por uno nuevo.

3. [AFIP-Admin] Copiar CSR y extraerlo a archivo de texto (GET /v1/entities/:entity_id).

   El portal de AFIP requiere de un Certificate Signing Request, el cual se puede acceder desde el detalle de una entidad. Se aconseja utilizar Vim para generar el archivo, ya que se evita la copia de saltos de línea.

   

4. [Portal de AFIP con clave fiscal] Ingresar a la Administración de Certificados Digitales.

   Es necesario acceder al servicio de Administración de Certificados Digitales en el portal de AFIP, al cual se accede con clave fiscal. Es importante que el usuario que acceda tenga permisos de gestión de la entidad con la que se quiere facturar.

   Si el servicio no estuviera listado, deberá habilitarse (este proceso se realiza una única vez).

   

5. [Portal de AFIP con clave fiscal] Generar alias.

   Un alias se crea para la entidad con la que se quiere facturar. Cada alias tiene una expiración a los dos años luego de ser emitido. Para hacerlo, es necesario ingresar en "Agregar alias", y agregar un nombre y el archivo CSR generado en el punto 3 de esta guía. El nombre de alias es únicamente para identificación personal, y no afecta al resultado del proceso.

   

6. [Portal de AFIP con clave fiscal] Descargar certificado.

   Una vez que se generó el alias, necesitamos acceder a ver su detalle y luego descargar el archivo adjunto.

   

7. [AFIP-Admin] Adjuntar certificado a entidad (PATCH /v1/entities/:entity_id).

   Una vez descargado el certificado, debemos copiar su contenido. Luego, tenemos que pegar el texto en el formulario de carga de certificado de la entidad.

   Una vez hecho esto, enviamos la información a la API para finalizar la configuración.

   

8. [Portal de AFIP con clave fiscal] Acceder a Administrador de Relaciones de Clave Fiscal.

   Desde la pantalla principal del portal de AFIP, necesitamos acceder a "Administrador de Relaciones de Clave Fiscal", y luego seleccionar el contribuyente con el que se quiere operar, el cual debe ser la entidad que va a facturar.

   

9. [Portal de AFIP con clave fiscal] Habilitar facturación electrónica para alias generado.

   Ya en el Administrado de Relaciones de Clave Fiscal del portal de AFIP, necesitamos hacer click en "Adherir servicio", y buscar el servicio de "Factura Electrónica" (servicio necesario para facturar). Dicho servicio se encuentra en la categoría "AFIP" y sub-categoría "WebServices".

   En el proceso de agregado del servicio, hay que hacer click en el botón "Buscar Representante" y seleccionar el alias que creamos anteriormente.

   

10. [Portal de AFIP con clave fiscal] Habilitar consulta de padrón para alias generado.

    Necesitamos repetir los pasos 8 y 9 para adherir el servicio de "Consulta Padrón A5", ubicado en la misma sección que el servicio de "Factura Electrónica". Este nuevo servicio es necesario para obtener información de una persona desde un CUIT.