Creación de certificados de homologación de AFIP (testing)

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. En este otro artículo se explica cómo hacerlo en entorno productivo, pero en esta entrada se explicará cómo registar un entidad de homologación o testing para poder generar facturas de prueba, es decir, sin impacto real.

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 WSASS - Autogestión Certificados Homologación.

   Es necesario acceder al servicio de WSASS - Autogestión Certificados Homologación en el portal de AFIP, al cual se accede con clave fiscal.

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

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

   Un certificado o 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 "Nuevo certificado", y agregar un nombre y el cuerpo del 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. Luego de ingresar los datos, solo es necesario hacer click en "Crear DN y obtener certificado".

   

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

   Una vez que se generó el alias, necesitamos copiar el contenido del nuevo certificado, que aparece en la caja de texto de "Resultado".

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

   Una vez copiado el certificado, debemos pegar su contenido en el formulario de carga de certificado de la entidad. Posteriormente, enviamos la información a la API para finalizar la configuración.

   

8. [Portal de AFIP con clave fiscal] Acceder a WSASS - Autogestión Certificados Homologación y habilitar servicio para alias generado.

   Desde la pantalla principal del portal de AFIP, necesitamos acceder a "WSASS - Autogestión Certificados Homologación", en la sección "Crear autorización a servicio". Luego, seleccionar el contribuyente con el que se quiere operar, el cual debe ser la entidad que va a facturar.

   

   Buscamos el servicio de "wsfe - Facturacion Electronica" (servicio necesario para facturar) y creamos con "Crear autorización de acceso" la autorización para que el alias pueda usar dicho servicio. Si sale todo bien, veremos en resultado de la operación en la sección de "Resultado".

   

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

   Necesitamos repetir el paso 8 para adherir el servicio de "ws_sr_padron_a5 - WS de Consulta Padron A5". Este nuevo servicio es necesario para obtener información de una persona desde un CUIT.