---
title: Onboarding por archivos
slug: onboarding-por-archivos
docTags: 
createdAt: 2026-01-24T19:08:53.827Z
---

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

:::BlockQuote
Origen del archivo → Motor de validación ABM → Persistencia → Publicación de eventos
:::



## Flujo general

1. El adquirente genera el archivo según layout. 
2. El archivo es enviado a SUGA via SFTP 
3. SUGA valida estructura y contenido. 
4. Se procesan registros válidos. 
5. 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.