Resolución N° 5.616/2024. Más información

Descargar Mis Comprobantes de ARCA en n8n

Automatizá la descarga de comprobantes emitidos o recibidos con Afip SDK.


Descargar Mis Comprobantes de ARCA en n8n

Si todavía no conocés cómo funciona el servicio Mis Comprobantes en Afip SDK, te recomiendo revisar primero la guía para usar la API directamente.

Descargar Mis Comprobantes de ARCA via API

Descargar Mis Comprobantes de ARCA via API

Con pocas líneas de código

A continuación vas a encontrar una guía paso a paso para importar y entender el workflow de n8n que descarga comprobantes de ARCA usando Afip SDK. Está pensado para que adaptes los filtros a tus necesidades y puedas reutilizarlo como parte de un flujo mayor.

Te dejo el archivo afip-sdk-mis-comprobantes.json para que lo importes en tu instancia de n8n antes de continuar.


Requisitos previos

Antes de seguir la guía asegurate de tener:

Vamos a usar los nodos oficiales de Afip SDK, por lo tanto, deberás configurar el credential en n8n y setear tu ACCESS_TOKEN en cualquier nodo de AfipSdk con la opción Set up credential completando el campo Bearer Token.


Índice

  1. Introducción
  2. Estructura del Workflow en n8n
  3. Paso a Paso de la Implementación
  4. Personalizar filtros
  5. Problemas comunes
  6. Conclusiones

Introducción

El servicio Mis Comprobantes de ARCA permite consultar los comprobantes emitidos o recibidos. Con Afip SDK esta operación se expone como una automatización lista para usar desde nuestra API de automations. El workflow de n8n que acompaña esta nota crea la automatización, espera a que finalice y descarga los resultados como un archivo JSON listo para almacenar o compartir con otros sistemas.


Estructura del Workflow en n8n

El flujo está compuesto por 3 nodos conectados de forma secuencial:

  1. manual_trigger: Inicia la ejecución bajo demanda.
  2. Run automation and wait: Crea la automatización mis-comprobantes en Afip SDK con los filtros deseados y espera su resultado.
  3. Convert to File: Genera un archivo result.json con el contenido devuelto por Afip SDK.

En la imagen debajo puedes ver cómo luce visualmente el workflow, lo cual ayuda a comprender la secuencia de nodos.

Workflow en n8n

Paso a Paso de la Implementación

1. Nodo: manual_trigger

  • Función: Ejecutar el workflow cuando lo necesites desde la interfaz de n8n.
  • Configuración: No requiere parámetros adicionales.

2. Nodo: Run automation and wait

  • Objetivo: Crear la automatización mis-comprobantes y esperar el resultado.
  • Body:
    {
      "automation": "mis-comprobantes",
      "params": {
        "cuit": "20111111112",
        "username": "20111111112",
        "password": "contraseña#segura?",
        "filters": {
          "t": "R",
          "fechaEmision": "01/01/2024 - 31/01/2024"
        }
      }
    }
    
  • Resultado esperado: El nodo devuelve los datos solicitados de la automatización.

3. Nodo: Convert to File

  • Función: Convertir la respuesta final en un archivo descargable.
  • Configuración:
    • Operation: toJson
    • Binary Property: result.json
    • File Name: result.json
  • Resultado: Una vez que la automatización finaliza, podés descargar el archivo con todos los comprobantes desde el panel de ejecuciones de n8n.

Personalizar filtros

El nodo Run automation and wait replica los filtros disponibles en la automatización Mis Comprobantes. Para cambiar el alcance de la búsqueda editá el objeto filters con las claves admitidas:

  • t: Define si buscás comprobantes emitidos (E) o recibidos (R).
  • fechaEmision: Rango de fechas en formato dd/mm/yyyy - dd/mm/yyyy.
  • puntosVenta, tiposComprobantes, comprobanteDesde, comprobanteHasta, tipoDoc, nroDoc, codigoAutorizacion: Campos opcionales para filtrar con mayor precisión.

Recordá mantener el formato de fechas y utilizar arrays para los campos que admiten múltiples valores.


Problemas comunes

  • Credenciales inválidas: Si el nodo Run automation and wait devuelve un error 401, verificá que el token esté vigente y que el usuario/contraseña de ARCA sean correctos.
  • Automatización sin resultados: Es posible que la automatización finalice en complete pero con un array vacío. Revisá los filtros aplicados, especialmente el rango de fechas y los puntos de venta.
  • Demora en el procesamiento: Para empresas con muchos comprobantes, deberás usar los nodos Run automation y Get automation result ampliando el tiempo de este último para evitar llegar al límite de peticiones concurrentes.

Conclusiones

Con este workflow podés automatizar la descarga de comprobantes de ARCA en cuestión de minutos y dejar que n8n se encargue de la espera y la conversión de resultados. Aprovechá la estructura para integrarla con otras herramientas, por ejemplo subiendo el archivo a un almacenamiento en la nube o notificando por email cuando finalice la descarga.

Ante cualquier duda, sumate a la Comunidad Afip SDK y compartí tus experiencias automatizando tareas con n8n.

Conéctate a ARCA hoy mismo

Evitá la complejidad de ARCA. Con Afip SDK integrás tu sistema en minutos y te enfocás en hacer crecer tu negocio.