Saltar al contenido

Integración ERP

Para qué sirve

El sistema permite registrar y sincronizar cuentas comitentes en un sistema ERP externo de gestión de cuentas. Esta integración es el puente entre el legajo aprobado en Quantian Compliance y la cuenta operativa en el back-office bursátil de su empresa.

La configuración inicial (credenciales del sistema ERP y valor de partida del numerador) la realiza el administrador del sistema. Si faltan credenciales o el numerador no está configurado, el módulo de integración ERP lo informa al intentar crear una cuenta.


Dashboard de cuentas ERP

El dashboard de integración ERP se accede desde la sección Legajos, con el botón Sincronización ERP que aparece arriba a la derecha del listado de legajos. Muestra todas las cuentas ERP registradas, su estado actual y las acciones disponibles.

La vista incluye:

  • Totales por estado.
  • Listado filtrable por estado, legajo y fecha.
  • Acceso rápido a las acciones de cada fila.

Antes de empezar: mapeo de catálogos

Antes de enviar la primera cuenta al sistema ERP es necesario sincronizar y mapear los catálogos de países y provincias. Es un paso único de configuración por organización.

Para acceder, desde el dashboard de Sincronización ERP hacé clic en Mapeo de catálogos (arriba a la derecha).

En esa pantalla:

  1. Hacé clic en Sincronizar con sistema externo. El sistema trae la lista completa de países (≈250) y provincias del ERP.
  2. Después del sync, el sistema intenta auto-mapear los valores obvios:
    • Coincidencia exacta sin tildes ni mayúsculas (ej. "Santa Fe" ↔ "Santa Fé") → se mapea automáticamente.
    • Coincidencia casi idéntica con un único candidato razonable (ej. "Slovenia" ↔ "Eslovenia") → también se mapea automáticamente.
    • Casos ambiguos o muy distintos → quedan como sugerencias clickeables para que vos confirmes.
  3. Revisá las filas marcadas como sin mapear y elegí el equivalente correcto. Las sugerencias muestran el porcentaje de similitud para ayudarte a decidir.
  4. Si quisieras forzar otro mapeo, podés cambiar uno ya configurado en cualquier momento; se reasigna al nuevo Country/Provincia.

Importante: si un legajo tiene un domicilio con un país o provincia sin mapear, el envío al ERP se bloquea con un mensaje claro indicando qué valor falta mapear. Es un control intencional para evitar que se envíe data que el sistema externo rechace silenciosamente.

Cuando agregan países o provincias nuevas al sistema externo, basta con volver a hacer clic en Sincronizar — los mappings existentes se respetan; solo se suman las nuevas filas.


Mapeo de catálogos adicionales

Estas opciones están disponibles desde la misma pantalla de Mapeo de catálogos donde configurás países y provincias.

Además de los catálogos de países, provincias y localidades, podés asociar tres conjuntos de valores adicionales con los que usa el sistema externo de tu organización.

Estos mapeos son opcionales: si quedan sin asociar, los datos correspondientes no se envían al sistema externo, pero la apertura de cuenta se realiza igualmente.

Procedencia de fondos

Asociás cada origen de fondos del legajo (por ejemplo "Ahorros", "Actividad comercial", "Herencia / donación") con el valor exacto que espera el sistema externo de tu organización.

La lista incluye los orígenes que pueden declarar tanto las personas humanas como las jurídicas. Cada origen muestra una etiqueta PH y/o PJ que indica a qué tipo de legajo aplica: algunos son propios de personas humanas (por ejemplo "Trabajo en relación de dependencia"), otros de personas jurídicas (por ejemplo "Ingresos financieros" o "Aportes de socios") y otros aplican a ambos. Conviene asociar todos los orígenes que tus legajos puedan declarar, sin importar la etiqueta.

Solo los orígenes asociados se incluyen en el envío. Si un legajo declara orígenes que no fueron asociados, esos quedan fuera del envío sin generar error.

Medio de fondeo

Asociás cada modalidad de ingreso de fondos a la cuenta (por ejemplo "Transferencia bancaria $", "Cheques de terceros", "Transferencia de títulos") con el valor que espera el sistema externo de tu organización.

Si un legajo usa modalidades que no fueron asociadas, esas quedan fuera del envío sin generar error.

Tipo de cuenta bancaria por defecto

Configurás el valor que se envía como "tipo" en cada CBU declarado en una cuenta (ejemplo: "Caja de ahorro" o "Cuenta corriente").

Si el campo queda vacío, el dato no se envía y el sistema externo aplica su valor por defecto.


Abrir la cuenta al aprobar

Cuando un legajo está listo para aprobar, el botón Aprobar ofrece dos caminos (si su organización tiene la integración con el sistema ERP activa):

  • Aprobar y abrir cuenta — aprueba el legajo y abre automáticamente la cuenta en el sistema ERP, con número asignado automáticamente y el nombre del cliente. Es el camino habitual.
  • Solo aprobar (no abrir cuenta) — aprueba el legajo sin abrir nada en el sistema ERP. Lo usás cuando la cuenta ya existe o cuando querés definir un número o una denominación particular. Después abrís la cuenta desde el legajo con el botón + que aparece junto al indicador del sistema ERP.

Desde ese + podés abrir una o varias cuentas para el mismo legajo, eligiendo número automático, número manual o asociar una cuenta ya existente, y ajustando la denominación.


Crear una cuenta ERP

Para registrar una nueva cuenta ERP:

  1. Entrá en Legajos y hacé clic en el botón Sincronización ERP.
  2. Hacé clic en Agregar cuenta ERP.
  3. Elegí el legajo de la cuenta comitente que querés dar de alta en el ERP.
  4. Elegí el modo de numeración:
    • Auto-generar — el sistema asigna el siguiente número disponible del numerador configurado. Se crea una cuenta nueva en el sistema externo.
    • Cargar manualmente — vos definís el número. Se crea una cuenta nueva en el sistema externo con ese número.
    • Asociar cuenta ya existente — usá esta opción cuando la cuenta ya fue creada manualmente en el sistema externo. Ingresás el número exacto, no se crea de nuevo y los próximos envíos serán actualizaciones.
  5. Denominación — el nombre con el que la cuenta se abre en el sistema ERP. Viene precompletado con el nombre del legajo y podés editarlo (por ejemplo, para distinguir varias cuentas del mismo cliente: "BARCOS S.A. - COMISIONES", "BARCOS S.A. - FONDO").
  6. Hacé clic en Crear y previsualizar (o Asociar y previsualizar si elegiste el tercer modo).

Vista previa del payload

Antes de enviar, el sistema muestra en un modal el JSON exacto que se enviaría al sistema ERP. Podés:

  • Copiar JSON — copiarlo al portapapeles para revisarlo o guardarlo.
  • Enviar — confirmar el envío al sistema ERP.

Si cerrás el modal sin enviar, la cuenta ERP queda en estado Pendiente y la podés enviar más adelante desde el dashboard.


Datos que se sincronizan

Además de la identificación, domicilio y perfil del titular, la sincronización incluye automáticamente —cuando están cargados en el legajo— dos datos relevantes para auditoría:

  • Clasificación de riesgo (bajo / medio / alto) de la cuenta. Si el nivel fue ajustado manualmente, se envía el nivel efectivo vigente. Como el riesgo puede recalcularse o ajustarse con el tiempo, se reenvía en cada actualización de la cuenta.
  • Datos de inscripción registral de la persona jurídica (organismo de contralor, número, fecha, tomo, libro y folio). El organismo de contralor se elige de una lista predefinida (IGJ, direcciones provinciales de personas jurídicas, etc.); si la sociedad está inscripta en un organismo que no figura en la lista, se informa como "Otros".

Normalización de nombres y denominaciones

Los nombres y apellidos de las personas (titular, cotitulares y apoderados), la denominación de las personas jurídicas y la denominación de la cuenta se envían siempre en MAYÚSCULAS, sin tildes ni signos de puntuación. Es el formato que requiere el sistema ERP para mantener la consistencia de los datos.

Por eso, aunque cargues "José Pérez" o "Barcos S.A. - Comisiones", al ERP llegan como JOSE PEREZ y BARCOS SA COMISIONES. La carga en el legajo y la documentación firmada conservan el texto original tal como lo ingresaste; la normalización solo aplica a lo que se envía al sistema ERP. Podés verificar el texto exacto en la vista previa del payload antes de confirmar el envío.


Estados de sincronización

EstadoSignificado
PendienteRegistrada en el sistema, todavía no enviada al ERP.
EnviadaEl sistema ERP recibió y confirmó la cuenta correctamente.
ErrorEl último intento de envío falló por una causa transitoria (ERP temporalmente inaccesible, timeout, etc). Se puede reintentar.
BloqueadaRequiere atención manual. Puede indicar un rechazo definitivo del ERP o que fue marcada como ignorada por el operador.

Acciones disponibles por fila

Desde el listado del dashboard, cada fila tiene las siguientes acciones según su estado:

  • Previsualizar — muestra el modal con el JSON del payload, sin enviarlo. Disponible en cualquier estado.
  • Enviar / Reintentar — envía el payload al ERP. Disponible en estado Pendiente o Error.
  • Borrar — elimina el registro ERP. Solo disponible si la cuenta nunca fue enviada (estado Pendiente).
  • Marcar como ignorada — mueve la cuenta al estado Bloqueada. Útil cuando se decide que esa cuenta no debe sincronizarse. No elimina el registro.
  • Denominación — editás el nombre de la cuenta en el sistema ERP. Si la cuenta ya fue enviada, al guardar se encola una actualización para reflejar el nuevo nombre allí.

Indicador en el legajo

El header del legajo de cada cuenta muestra los números de cuenta ERP asociados y su estado de sincronización:

  • — enviada correctamente.
  • — con error o bloqueada.
  • — pendiente de envío.

Al hacer clic en el indicador, el sistema abre el dashboard de integración ERP filtrado por esa cuenta, mostrando el detalle y las acciones disponibles.


Cosas que conviene saber

Un legajo puede tener más de una cuenta ERP. Si el mismo comitente necesita más de un número de cuenta en el sistema ERP (por ejemplo, en una operatoria con subcuentas), podés crear múltiples registros para el mismo legajo.

El número manual tiene que existir en el ERP. Si ingresás un número en modo manual que no existe en el sistema ERP, el envío va a fallar. Verificá el número directamente en el ERP antes de cargarlo.

El numerador no retrocede. Una vez que el sistema asigna un número automático, ese número queda consumido aunque el registro ERP se borre antes de enviarse. Esto garantiza que no haya números duplicados.

Los errores de envío no bloquean el legajo. Una cuenta ERP en estado Error o Bloqueada no afecta el estado del legajo en Quantian Compliance. Las dos plataformas son independientes; la integración es solo un canal de notificación.

El titular tiene que tener el perfil de inversor completo. El envío al sistema ERP incluye el perfil de inversor del titular (Conservador / Moderado / Agresivo, derivado del cuestionario configurado en Configuración > Perfil de inversor). Si el titular no completó el cuestionario, o si su puntaje queda fuera de los rangos configurados, el envío se bloquea con un mensaje indicando el titular afectado. Hay que completar el perfil y reintentar.

Los mappings de país y provincia respetan lo manual. Si manualmente forzaste un mapeo distinto al auto-sugerido, el siguiente sync no lo pisa. Eso te permite tener customizaciones estables entre actualizaciones del catálogo.