Saltar al contenido principal

Organizaciones

Las organizaciones agrupan miembros en jerarquías B2B: cadenas, grupos, delegaciones regionales. Pensadas para escenarios donde el participante del programa no es un consumidor final sino una entidad empresarial (una farmacia, un punto de venta, un distribuidor) que forma parte de una estructura mayor.

Modelo mental​

En IncentIA:

  • Miembro = la entidad que participa en el programa de fidelización y acumula puntos, cashback o recompensas. En un programa B2B, el miembro es la empresa (la farmacia, la tienda, el partner), no un empleado dentro de ella.
  • Organización = una agrupación de miembros (una cadena de farmacias, un grupo comercial, una red de distribuidores), representada internamente como un nodo en el árbol de OrganizationUnit de ABP.
  • Relación = un miembro puede pertenecer a una o varias organizaciones (relación N..N). La jerarquía padre-hijo entre organizaciones aporta el resto del contexto.

Las campañas, en cambio, son independientes: un mismo miembro puede estar participando en varias campañas simultáneamente, y eso no afecta a sus organizaciones.

Campos de una organización​

  • Nombre — razón social.
  • Código — identificador único dentro del tenant (ej. CAD-ALPHA).
  • Tipo — Root (cabecera), Group (subgrupo), Branch (sucursal/delegación), Individual (organización unipersonal).
  • Organización padre (opcional) — para formar jerarquías.
  • Datos de contacto — email, teléfono, dirección, CIF/NIF.
  • Activa — permite desactivar una organización completa.

Crear una organización​

  1. Admin → Fidelización → Organizaciones → Crear nuevo.
  2. Rellenar nombre y código (obligatorios).
  3. Elegir tipo y (opcionalmente) organización padre.
  4. Datos fiscales y de contacto si aplican.

La vista principal muestra el árbol completo con buscador y contadores de miembros por nivel.

Asignar miembros​

Desde la vista de una organización:

  • Asignar miembros → buscador de miembros del tenant, selección múltiple.
  • Ver miembros actuales → lista páginada con opción de quitar asignación.

Pertenencia múltiple (N..N)​

Un miembro puede estar asignado a varias organizaciones simultáneamente. Las asignaciones se suman; añadir un miembro a otra organización no lo saca de la anterior. Ejemplos reales:

  • Un consultor regional puede estar asignado a varias farmacias que gestiona en su territorio.
  • Un franquiciado puede pertenecer a varias cadenas cuando opera tiendas en grupos distintos.
  • Una farmacia multi-socio puede aparecer tanto en el grupo comercial como en la cooperativa de compras.

Para retirar a un miembro de una organización concreta, usa Ver miembros actuales → Quitar. Eso solo rompe ese vínculo, sin tocar las demás asignaciones del miembro.

Casos de uso típicos​

Farmacia / salud​

  • Root: grupo farmacéutico (ej. "Farmacias del Norte").
  • Branch: farmacia individual (el member que participa en el programa).
  • Los puntos, el cashback y las campañas se asocian a la farmacia (miembro).
  • El reporting puede agregarse subiendo la jerarquía ("total de puntos de Farmacias del Norte" = suma de sus farmacias).

Retail B2B​

  • Root: cadena de tiendas.
  • Branch: tienda individual (el member).
  • Las tiendas acumulan puntos o cashback por sus compras al fabricante.

Distribuidores / canal​

  • Root: distribuidor.
  • Group: zona/región.
  • Branch: delegación concreta (el member).
  • El distribuidor principal ve la actividad agregada; cada delegación gestiona la suya.

Por qué usar organizaciones​

  • Reporting agregado por estructura — ver puntos, canjes y campañas filtradas por organización y sus hijas.
  • Herencia de permisos vía árbol de OU — al apoyarse en el árbol de OrganizationUnit de ABP, los permisos asignados a un admin sobre una organización padre se propagan automáticamente a sus hijas. No hay que duplicar asignaciones por nivel.
  • Pertenencia múltiple por miembro — un mismo miembro puede convivir en varias organizaciones (consultor regional, franquiciado, farmacia multi-socio) sin duplicar su ficha ni sus puntos.
  • Permisos granulares (roadmap) — un admin de organización podrá gestionar solo sus miembros.
  • Campañas segmentadas (roadmap) — lanzar una campaña visible solo a miembros de una rama concreta del árbol.
Consejo

Si solo necesitas segmentación por atributos (ej. "miembros VIP" o "miembros activos en últimos 30 días"), usa Segments en lugar de Organizations. Organizations está pensada para jerarquías reales con relaciones padre-hijo.

Limitaciones actuales​

  • No hay API pública para crear organizaciones desde sistemas externos (solo admin UI).
  • Import masivo por CSV no implementado.