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