Consultar Constancia de Inscripción de ARCA en n8n
Obtené la constancia de inscripción en segundos desde un workflow.
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
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:
- Un access_token de Afip SDK.
- El CUIT de la persona o empresa cuya constancia querés consultar.
Todos los nodos HTTP deben incluir el header Authorization: Bearer TU_ACCESS_TOKEN para comunicarse con Afip SDK.
Índice
- Introducción
- Estructura del Workflow en n8n
- Paso a Paso de la Implementación
- Personalizar la consulta
- Problemas comunes
- 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:
- manual_trigger: Permite iniciar la consulta manualmente.
- variables: Nodo Set que guarda el
access_token. - auth: Realiza la autenticación en
ws_sr_constancia_inscripciony obtienetokenysign. - obtener_datos: Ejecuta el método
getPersona_v2para traer la constancia. - 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_tokende Afip SDK. - Configuración: Seteá un valor
access_tokencon tu token vigente. - Tip: Podés reemplazarlo por una credencial de n8n para mayor seguridad.
3. Nodo: auth
- Objetivo: Generar las credenciales temporales (
TokenySign). - 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,signyexpirationTimevá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
- Operation:
- 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
401en 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_inscripcionen 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.