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:

Todos los nodos HTTP deben incluir el header Authorization: Bearer TU_ACCESS_TOKEN para comunicarse con Afip SDK.


Í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 cinco nodos:

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

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: variables

  • Objetivo: Almacenar el access_token de Afip SDK.
  • Configuración: Seteá un valor access_token con tu token vigente.
  • Tip: Podés reemplazarlo por una credencial de n8n para mayor seguridad.

3. Nodo: auth

  • Objetivo: Generar las credenciales temporales (Token y Sign).
  • Endpoint: POST https://app.afipsdk.com/api/v1/afip/auth
  • Headers:
    • Authorization: Bearer {{ $('variables').item.json.access_token }}
    • Content-Type: application/json
  • 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.

4. Nodo: obtener_datos

  • Objetivo: Consultar la constancia usando el método getPersona_v2.
  • Endpoint: POST https://app.afipsdk.com/api/v1/afip/requests
  • Headers:
    • Authorization: Bearer {{ $('variables').item.json.access_token }}
    • Content-Type: application/json
  • 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.).

5. 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.