Get Started
Quickstart
Inicio rápido para comenzar a trabajar con los servicios de AFIP
Setup
Requisitos para comenzar a trabajar con los servicios de AFIP.
Certificado digital
Ingresar a AFIP
Para solicitar el servicio WSASS, el usuario debe acceder a afip autenticándose con su Clave Fiscal de persona física (no persona jurídica), con nivel de autorización 2 o superior.
Adherirse
En la sección Mis Servicios pulsar en el link “Administrador de Relaciones” o en el cuadro “Administrador de Relaciones de Clave Fiscal”.
Link de ejemplo https://serviciosweb.afip.gob.ar/ClaveFiscal/AdminRel/serviceSearch2.aspx?representado=TU-CUIL.
Dónde TU-CUIL es el CUIL del usuario.
En el, tocar el cuadro de AFIP y después WebServices. Luego en el listado de servicios disponibles seleccionar “WSASS - Web Service de Autenticación y Autorización de Servicios”.
Confirmación
Pulsar “Continuar” en el formulario “Incorporar nueva relación”. Se visualizará un mensaje de confirmación de la incorporación de la relación.
Para trabajar con los servicios de la AFIP, es necesario crear una firma digital.
Desde la raíz del proyecto, se debe ejecutar el siguiente comando:
./tools/keygen.sh /C=AR/O=Nombre/CN=Nombre/serialNumber=CUIT 00000000000
Donde Nombre es el nombre de la empresa y 00000000000 es el CUIT de la empresa/persona.
Una vez creado los archivos afip.csr y afip.key, se debe enviar el archivo afip.csr a la AFIP para que sea firmado.
Desde la página de homologación, ir a la opción de “Nuevo Certificado” para acceder al formulario para crear un DN y el certificado inicialmente asociado al mismo.
Los campos a ingresar en el formulario son:
Nombre simbólico del DN
Es el alias o nombre simbólico del DN. Debe haberse creado previamente. Elegir el alias de la lista desplegable.
CUIT del DN
Es la CUIT del DN seleccionado en el Campo 1.
Nueva solicitud de certificado en formato PKCS10
Es la solicitud de certificado (Certificate Signing Request, CSR) en formato PKCS10. Se ignora el campo DN del CSR. Copiar y pegar en este campo el contenido del CSR generado anteriormente afip.csr.
Desde la página de homologación, ir a la opción de “Crear Autorizacion a Servicio” para acceder al formulario para crear una autorización para que un DN pueda utilizar un servicio representando a un contribuyente.
Nombre simbólico del DN a autorizar
Es el alias o nombre simbólico del DN a autorizar acceso al servicio. Debe haberse creado previamente. Elegir el alias de la listadesplegable.
CUIT del DN a autorizar
Es la CUIT del DN existente, que va a ser autorizado a usar el servicio en representación de un contribuyente. Este campo no puede modificarse.
CUIT representado
Es la CUIT representada por el DN. Ingresar la CUIT de una persona física o jurídica (empresa).
CUIT de quien genera la autorizacion
Es la CUIT de quien genera esta autorización (CUIT autorizante). Este campo tiene automáticamente la CUIT del usuario conectado al WSASS y no puede editarse.
Servicio al que desea acceder
Es el nombre del servicio al que el DN será autorizado a acceder, que se elige de la lista de servicios desplegable.
Levantar el proyecto
Una vez clonado el repositorio, se debe instalar las dependencias necesarias para poder ejecutar el proyecto.
cd AFIP-API
npm install
Después haber instalado las librerias y tener el certificado pem en la carpeta keys, se puede iniciar la aplicación de la siguiente manera
Para desarrollo
HOMO=true node server.js
Para producción
node server.js