> ## Documentation Index
> Fetch the complete documentation index at: https://emir.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<AccordionGroup>
  <Accordion icon="pager" title="Darse de alta">
    <Steps>
      <Step title="Ingresar a AFIP">
        Para solicitar el servicio WSASS, el usuario debe acceder a [afip](www.afip.gob.ar) autenticándose con su
        Clave Fiscal de persona física (no persona jurídica), con nivel de autorización 2 o superior.
      </Step>

      <Step title="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”.
      </Step>

      <Step title="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.
      </Step>
    </Steps>

    <Info>Para más información se puede leer el siguiente documento [Cómo adherirse](https://www.afip.gob.ar/ws/WSASS/WSASS_como_adherirse.pdf)</Info>
  </Accordion>

  <Accordion icon="github" title="Clonar repositorio">
    Es necesario clonar el repositorio de [AFIP-API](https://github.com/sarriaroman/AFIP-API) para poder acceder a los servicios de AFIP.

    ```bash theme={null}
    git clone git@github.com:sarriaroman/AFIP-API.git
    ```

    <Info>Para más información sobre cómo utilizar el proyecto, se puede consultar el archivo [README.md](https://github.com/sarriaroman/AFIP-API/blob/master/readme.md)</Info>
  </Accordion>

  <Accordion icon="signature" title="Creación de firmas">
    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:

    ```bash theme={null}
    ./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:

    <Steps>
      <Step title="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.
      </Step>

      <Step title="CUIT del DN">
        Es la CUIT del DN seleccionado en el Campo 1.
      </Step>

      <Step title="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`.
      </Step>
    </Steps>

    <Info>Para más información sobre ingresar las firmas, se puede consultar el manual [WSASS\_manual.pdf](https://www.afip.gob.ar/ws/WSASS/WSASS_manual.pdf)</Info>
  </Accordion>

  <Accordion icon="rectangle-terminal" title="Autorizar servicios">
    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.

    <Steps>
      <Step title="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.
      </Step>

      <Step title="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.
      </Step>

      <Step title="CUIT representado">
        Es la CUIT representada por el DN. Ingresar la CUIT de una persona física o jurídica (empresa).
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>

      Luego presionar el botón “Crear Autorización de Acceso”.
    </Steps>

    <Info>Para más información sobre ingresar las firmas, se puede consultar el manual [WSASS\_manual.pdf](https://www.afip.gob.ar/ws/WSASS/WSASS_manual.pdf)</Info>
  </Accordion>
</AccordionGroup>

### Levantar el proyecto

<AccordionGroup>
  <Accordion icon="rectangle-terminal" title="Instalar paquets">
    Una vez clonado el repositorio, se debe instalar las dependencias necesarias para poder ejecutar el proyecto.

    ```bash theme={null}
    cd AFIP-API
    npm install
    ```
  </Accordion>

  <Accordion icon="rocket" title="Arrancar el webservice">
    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

    <br />

    Para desarrollo

    ```bash theme={null}
    HOMO=true node server.js
    ```

    <br />

    Para producción

    ```bash theme={null}
    node server.js
    ```
  </Accordion>
</AccordionGroup>