Onboarding por archivos
Definiciones
El ABM vía Archivos es la modalidad mediante la cual las operaciones de Alta, Baja y Modificación de entidades se realizan mediante el intercambio de archivos estructurados, procesados de forma batch por la Plataforma SUGA.
Esta modalidad está orientada a escenarios donde el adquirente:
- Opera con sistemas legados.
- Requiere cargas masivas.
- Necesita realizar migraciones.
- Prefiere procesos asincrónicos.
Los archivos deben respetar layouts previamente definidos, que describen de forma explícita:
- Estructura.
- Campos.
- Tipos de dato.
- Longitudes.
- Reglas de obligatoriedad.
Rol del ABM vía Archivos dentro de la arquitectura
El ABM vía Archivos comparte el mismo motor de validación y persistencia que las demás modalidades de ABM.
La única diferencia es el canal de ingreso.
De esta forma, SUGA desacopla:
Origen del archivo → Motor de validación ABM → Persistencia → Publicación de eventos
Flujo general
- El adquirente genera el archivo según layout.
- El archivo es enviado a SUGA via SFTP
- SUGA valida estructura y contenido.
- Se procesan registros válidos.
- Se generan resultados por registro y por lote.
Validaciones
Durante el procesamiento se realizan:
- Validaciones sintácticas (formato, tipo, longitud).
- Validaciones semánticas (reglas de negocio).
- Validaciones de integridad referencial.
Los registros inválidos son rechazados con motivo.
Resultados
El adquirente obtiene:
- Estado del lote.
- Cantidad de registros procesados.
- Cantidad de registros rechazados.
- Detalle de errores.
Responsabilidad del adquirente
- Generar archivos conforme a layout.
- Versionar layouts si aplica.
- Controlar calidad de datos antes del envío.
Beneficios
- Soporte para grandes volúmenes.
- Ideal para migraciones.
- Integración con sistemas no API-first.
Tipos de Archivos de ABM (Alta de Comercios)
C001 – Alta de comercios (CSV) Archivo para enviar datos de alta de comercios vía batch cuando no se utiliza la API de subcomercios.
C002 – Alta de comercios (TXT) Archivo alternativo al C001 en formato TXT.
C002R – Confirmación de alta de comercios Archivo de respuesta que informa qué comercios fueron dados de alta correctamente.
C002B – Datos biométricos Incluye información de validaciones biométricas realizadas por terceros que = no fue realizada desde la consola de SUGA.