Módulo ABM comercios

definiciones el módulo abm (alta, baja y modificación) constituye la capa primaria de ingreso y mantenimiento de datos maestros dentro de la plataforma suga desde este módulo se gestionan las entidades fundamentales del ecosistema (por ejemplo, comercios, subcomercios, adquirentes, medios, configuraciones base, entre otros), y actúa como el punto de origen de la información que alimenta al resto de los procesos y subprocesos de la plataforma en términos conceptuales, abm representa la fuente de verdad sobre la cual se construyen los flujos de onboarding, operación, transacciones, costos, liquidaciones, conciliaciones y reporting flowchart td ui\[onboarding digital\<br/>ui suga saas] api\[abm via api] files\[abm via archivos] ui > abm\[motor abm\<br/>validacion + contratos de datos + persistencia] api > abm files > abm abm > core\[plataforma suga] core > mods\[modulos consumidores\<br/>comercios, medios de pago, costos, transacciones, terminales, liquidaciones, etc ] qué muestra el diagrama existen tres canales de ingreso todos convergen en un único motor abm los módulos downstream consumen la misma fuente de verdad rol del abm dentro de la arquitectura de suga el abm implementa el dominio de gestión de datos maestros , garantizando que la información estructural de la plataforma sea consistente sea validada sea versionable sea trazable todos los módulos que conforman la plataforma(gestión de comercios, medios de pago, costos de servicio, transacciones, smartcoupon, terminales, liquidaciones, etc ) consumen datos generados o mantenidos desde abm como consecuencia, la calidad de la operación de la plataforma está directamente relacionada con la calidad de los datos ingresados en este módulo componentes — estándares de calidad de datos los siguientes estándares aplican a todos los canales de ingreso su cumplimiento es obligatorio para garantizar el comportamiento predecible de la plataforma campos obligatorios todos los campos definidos como obligatorios en el contrato de datos de cada entidad deben estar completos antes de ser enviados al motor abm no se admite la práctica de ingresar valores temporales o ficticios para saltar validaciones con intención de completar datos posteriormente tipos de dato, longitudes y formatos los tipos de dato (texto, numérico, fecha, booleano) deben respetarse en su totalidad las longitudes máximas definidas por el layout no deben ser superadas ni truncadas arbitrariamente los formatos de fecha deben seguir el estándar iso 8601 (yyyy mm dd) salvo indicación explícita contraria en el layout los identificadores fiscales (cuit, cuil, rfc, nif, entre otros) deben validarse contra el formato del país del comercio antes del ingreso los códigos de categoría de comercio (mcc) deben corresponder a la clasificación internacional vigente y ser representativos de la actividad real del comercio unicidad del mid la plataforma suga asigna un único mid por comercio, válido tanto para operaciones de tarjeta presente como no presente está prohibido intentar generar múltiples mids para el mismo comercio como práctica de evasión de controles el mid se genera automáticamente por la plataforma una vez que el expediente digital del comercio es aprobado integridad referencial los subcomercios deben estar vinculados a un comercio padre existente y activo en la plataforma los medios de pago asignados a un comercio deben pertenecer al catálogo habilitado por el adquirente los planes de cuotas referenciados deben existir y estar activos en el módulo de gestión de medios de pago las terminales asociadas deben estar registradas y activas en el módulo de gestión de dispositivos prohibición de duplicidades no deben existir entidades duplicadas en la plataforma antes de crear un nuevo comercio, el operador debe verificar que no exista ya un registro activo o inactivo con el mismo identificador fiscal la detección de duplicidades debe escalarse y resolverse antes de proceder con el alta importancia de la calidad de datos en abm abm es el principal input de datos del sistema errores, omisiones o inconsistencias en esta capa se propagan de forma transversal al resto de la plataforma, impactando potencialmente en autorizaciones cálculo de costos aplicación de reglas liquidaciones conciliaciones reportes por este motivo, es crítico que se respeten las documentaciones técnicas vigentes se utilicen correctamente los layouts definidos se completen todos los campos obligatorios se validen tipos de datos, longitudes y formatos abm como contrato de datos dentro de suga, cada entidad administrada por abm posee un contrato de datos estructura campos tipos reglas de obligatoriedad relaciones este contrato actúa como acuerdo entre canales de ingreso de datos → plataforma → módulos consumidores respetar este contrato garantiza integridad referencial compatibilidad entre módulos comportamiento predecible de la plataforma canales de operación del abm las operaciones de abm pueden realizarse típicamente mediante interfaz digital automatizada apis archivos batch con layout definido independientemente del canal, las mismas reglas de validación aplican beneficios del enfoque abm en suga centralización de datos maestros reducción de duplicidades menor necesidad de correcciones posteriores mayor confiabilidad operativa base sólida para escalabilidad