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

Consultar Constancia de Inscripción de ARCA en n8n

Obtené la constancia de inscripción en segundos desde un workflow.


Consultar Constancia de Inscripción de ARCA en n8n

Si todavía no viste cómo funciona este proceso mediante la API, te recomiendo leer el artículo introductorio:

Consultar constancia de Inscripción de ARCA via API

Consultar constancia de Inscripción de ARCA via API

Con pocas líneas de código

En esta guía vas a importar un workflow de n8n que autentica contra el servicio ws_sr_constancia_inscripcion de ARCA y obtiene la constancia de inscripción de un CUIT específico utilizando Afip SDK.

Descargá el archivo afip-sdk-constancia-de-inscripcion.json para importarlo en tu espacio de trabajo.


Para operar con este web service necesitás un certificado digital. En modo desarrollo podés usar el CUIT 20409378472 que ofrece Afip SDK para pruebas sin certificados propios.

Cuando quieras usar tus credenciales oficiales, seguí la guía de integración con certificados en n8n.


Requisitos previos

Asegurate de contar con:

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 la consulta
  5. Problemas comunes
  6. Conclusiones

Introducción

La constancia de inscripción es uno de los documentos más consultados por áreas de compliance y equipos comerciales. Afip SDK expone este servicio a través de nuestra API de integración usando el web service ws_sr_constancia_inscripcion. El workflow de n8n que acompaña esta nota resuelve toda la cadena: autentica, consulta los datos del contribuyente y entrega un archivo listo para descargar o enviar.


Estructura del Workflow en n8n

El flujo se compone de cuatro nodos:

  1. manual_trigger: Permite iniciar la consulta manualmente.
  2. auth: Realiza la autenticación en ws_sr_constancia_inscripcion y obtiene token y sign.
  3. obtener_datos: Ejecuta el método getPersona_v2 para traer la constancia.
  4. Convert to File: Convierte la respuesta JSON en un archivo descargable.

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: Ejecución manual desde n8n para probar el flujo o integrarlo a un disparador posterior.
  • Configuración: No requiere ajustes adicionales.

2. Nodo: auth

  • Nodo: Get authorization token (TA) de Afip SDK
  • Objetivo: Generar las credenciales temporales (Token y Sign).
  • Body:
    {
      "environment": "dev",
      "tax_id": "20409378472",
      "wsid": "ws_sr_constancia_inscripcion"
    }
    
  • Resultado esperado: Obtendrás token, sign y expirationTime válidos para realizar la consulta.

3. Nodo: obtener_datos

  • Nodo: Execute web service request de Afip SDK
  • Objetivo: Consultar la constancia usando el método getPersona_v2.
  • Body:
    {
      "environment": "dev",
      "method": "getPersona_v2",
      "wsid": "ws_sr_constancia_inscripcion",
      "params": {
        "token": "{{$json.token}}",
        "sign": "{{$json.sign}}",
        "cuitRepresentada": "20409378472",
        "idPersona": 33693450239
      }
    }
    
  • Resultado esperado: La respuesta incluye la constancia completa (datosGenerales, actividadMonotributo, impuestos, etc.).

4. Nodo: Convert to File

  • Función: Generar un archivo JSON con la respuesta del servicio.
  • Configuración:
    • Operation: toJson
    • Binary Property: result.json
    • File Name: result.json
  • Resultado: Descargá el archivo desde la ejecución para compartirlo con otras áreas o almacenarlo en tu sistema.

Personalizar la consulta

Modificá el campos idPersona dentro del nodo obtener_datos para apuntar al CUIT correcto.


Problemas comunes

  • CUIT inexistente: Si el servicio devuelve personaNoRegistrada, verificá que el CUIT esté correctamente tipeado.
  • Token inválido: Los tokens caducan rápido. Si obtenés un 401 en el nodo obtener_datos, ejecutá nuevamente el nodo auth.
  • Permisos insuficientes: En producción asegurate de que el certificado tenga habilitado el servicio ws_sr_constancia_inscripcion en ARCA.

Conclusiones

Con este workflow podés automatizar la obtención de constancias de inscripción desde n8n sin escribir código. Adaptalo para enviarlo por correo, guardarlo en un CRM o habilitarlo como servicio interno para otros equipos.

Para recibir ayuda adicional o compartir mejoras, sumate a la Comunidad Afip SDK.

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.