Compromisos de donación

Tiempo estimado: 30 minutos
Nivel: Intermedio
Módulo: Donaciones

Qué vas a lograr

Registrar promesas de pago con monto total y vencimiento, cargar los cobros parciales vinculados y hacer seguimiento del saldo — entendiendo cómo el sistema distribuye cada pago, qué pasa con el excedente y qué ves en Facturación → Comisiones.

Antes de empezar

• Módulo Gestión de compromisos habilitado en tu plan (donations.commitment_management).
• Permiso Gestionar compromisos (donations:manage_commitments).
• Para registrar pagos: permiso Crear donación manual (donations:create_manual).

Si tu plan no incluye compromisos v2, podés usar la opción legacy Es compromiso en donación manual (un solo cobro pendiente).

Dónde encontrarlo

También podés crear un compromiso desde una campaña, desde Reportes → Carritos abandonados (acción Crear compromiso en un carrito de donación) o ver compromisos en la ficha de persona.

Compromiso v2 vs. donación manual “Es compromiso”

Usá compromisos v2 cuando el donante prometió un monto total y lo va cumpliendo en varios pagos.

Crear un compromiso

1. Donaciones → Compromisos → Nuevo compromiso (o desde una campaña / carrito abandonado).
2. Completá donante (nombre, apellido; email recomendado para vincular pagos online).
3. Monto total y moneda — no se pueden editar después del alta.
4. Fecha de vencimiento — obligatoria; máximo 24 meses desde hoy.
5. Opcional: campaña o proyecto vinculado.
6. Guardá.

Si llegás desde un carrito abandonado, los datos del donante y el monto vienen prellenados. Al guardar, el carrito se archiva automáticamente (motivo “Convertido a compromiso”) y deja de recibir recordatorios de recuperación.

Al registrar el compromiso, MeSumo devenga la comisión sobre el monto total prometido (según tu plan comercial). Los pagos vinculados que solo reducen el saldo no generan comisión adicional.

Cómo se vinculan los pagos

Hay tres formas de que un cobro impacte en un compromiso:

Requisitos para la auto-vinculación

El sistema solo auto-vincula si se cumplen todas estas condiciones:

• El pago está confirmado (manual, online o suscripción).
• El donante no es anónimo (necesitamos identificar al usuario).
• Hay compromisos pendientes o parciales del mismo donante, misma moneda y sin vencer.
• El pago no es el registro del compromiso en sí (el “ancla” del alta).

Si no se cumple alguna condición, el cobro queda como donación suelta y no baja ningún saldo hasta que lo vincules manualmente o reasignes.

Distribución automática (cascade)

Cuando un pago puede cubrir más de un compromiso, MeSumo lo reparte en orden cronológico: primero el compromiso más antiguo con saldo, después el siguiente, y así sucesivamente.

Ejemplo: el donante tiene compromiso A ($10.000 pendientes, enero) y compromiso B ($10.000 pendientes, marzo). Paga $25.000 en una sola donación:

Si querés que el reparto empiece en un compromiso que no es el más antiguo, usá Reasignar con el modo Cascade desde uno (ver más abajo).

Escenarios prácticos

Estos ejemplos muestran qué hace el sistema en situaciones habituales. Los montos son ilustrativos.

1. Compromiso sin pagos (pendiente)

• Situación: Registrás un compromiso de $50.000, vence en 6 meses. Todavía no hubo cobros.
• Saldo: $50.000 pendientes. Estado En curso.
• Comisión: Se devengó al registrar el compromiso (track Compromisos en Facturación).
• Campaña: Si está vinculada, el progreso suma el saldo pendiente del compromiso.

2. Pago parcial dentro del saldo

• Situación: Compromiso de $50.000; el donante transfiere $15.000 vinculados al compromiso.
• Saldo: $35.000 pendientes. Estado Parcial.
• Comisión: $0 adicional sobre esos $15.000 (aparece en Facturación bajo Donaciones como “Donación vinculada”).
• Campaña: Los $15.000 ya cobrados suman como donación efectiva; el pendiente sigue contando una sola vez.

3. Varios pagos chicos hasta completar

• Situación: Compromiso de $30.000; tres transferencias de $10.000 cada una.
• Saldo: Tras la tercera, $0. Estado Cumplido.
• Comisión: Solo la del registro inicial del compromiso; las tres cuotas vinculadas sin comisión extra.

4. Pago que supera el saldo (excedente)

• Situación: Compromiso con $8.000 pendientes; cobrás $12.000 vinculados.
• Distribución: $8.000 al compromiso → Cumplido; $4.000 quedan como donación libre.
• Comisión: $0 sobre los $8.000 aplicados; comisión normal solo sobre los $4.000 de excedente (track Donaciones, tipo “Excedente de donación”).
• En Facturación: Podés ver el desglose: total del pago, monto aplicado al compromiso y excedente.

5. Un pago, dos compromisos (cascade)

• Situación: Dos compromisos activos del mismo donante ($10.000 cada uno) y una donación de $30.000.
• Distribución: $10.000 + $10.000 a los compromisos en orden de antigüedad; $10.000 de excedente.
• Comisión: Excedente comisionado; tramos aplicados a compromisos sin comisión adicional.

6. Donación online con auto-vinculación

• Situación: El donante tiene un compromiso pendiente y dona por el formulario web con la misma cuenta (no anónima).
• Comportamiento: Al confirmarse el pago en Mercado Pago, MeSumo intenta vincularlo al compromiso pendiente (o cascade si hay varios).
• Si no hay compromiso elegible: La donación queda suelta, con comisión normal de donación online.

7. Cuota de suscripción aplicada al compromiso

• Situación: El donante tiene suscripción recurrente activa y un compromiso pendiente (mismo usuario, misma moneda).
• Comportamiento: Al cobrarse cada cuota, el sistema puede auto-vincularla al compromiso como un pago más.
• Comisión de la cuota: La política de suscripciones sigue aplicando; la porción que solo reduce saldo del compromiso no suma comisión de compromiso adicional.

8. Anular un pago vinculado

• Situación: Anulás desde el detalle del compromiso un pago de $10.000 que había bajado el saldo.
• Efecto: El saldo del compromiso sube de nuevo $10.000. Si el compromiso estaba cumplido, vuelve a Parcial o En curso.
• Comisión: Si ese pago tenía excedente comisionado, se genera el crédito correspondiente en el ledger.
• Importante: No uses la cancelación genérica de donaciones para pagos vinculados; el sistema te pedirá Anular pago en el compromiso.

9. Reasignar un pago a otro compromiso

• Situación: Un pago de $50.000 quedó vinculado al compromiso equivocado, o querés repartirlo entre dos compromisos ($30.000 + $20.000).
• Dónde: Detalle de la donación → Reasignar a otro compromiso (solo pagos confirmados, ya vinculados, no anónimos, no el ancla del alta).
• Modos:
  • Distribuir montos: Elegís compromiso y monto por línea; la suma debe coincidir con el total del pago.
  • Cascade desde uno: Elegís desde qué compromiso empezar; el sistema reparte el total en orden cronológico a partir de ahí.
• Comisiones: MeSumo recalcula las entradas de comisión del pago según la nueva distribución (aplicado vs. excedente).

Registrar donaciones vinculadas (manual)

Desde el detalle del compromiso:

1. Registrar pago → te lleva a donación manual con el compromiso ya vinculado.
2. Ingresá el monto cobrado (efectivo, transferencia, etc.).
3. Confirmá.

El saldo del compromiso baja automáticamente. Si el pago supera el saldo pendiente, el excedente se trata como donación normal y puede comisionarse aparte.

Comisiones: qué ves en Facturación

En Facturación → Comisiones las operaciones se agrupan en tracks para que entiendas el origen:

Regla simple para el equipo

1. Al crear el compromiso → pagás comisión una vez sobre el monto prometido.
2. Cada pago que solo cumple el compromiso → comisión $0 (igual puede aparecer la fila para trazabilidad).
3. Lo que sobra del pago → comisión como donación normal.

En el detalle de cada fila vas a ver:

• Fecha de la operación (cuándo se cobró el pago, no solo cuándo se registró el compromiso).
• Pagador con enlace al detalle cuando aplica.
• Desglose de montos si hubo excedente (total del pago, aplicado al compromiso, excedente).
• Enlaces al compromiso y a la donación relacionada.

Progreso de campaña

En campañas con meta, el tablero suma:

• Donaciones efectivas (cobradas), más
• Compromisos activos (saldo pendiente),

sin contar dos veces los pagos ya vinculados al compromiso.

Estados del compromiso

No podés registrar pagos vinculados a un compromiso vencido; primero resolvé el estado (cancelación o contacto con el donante).

Cancelar un compromiso

En el detalle, sección Cancelar compromiso:

Siempre tenés que indicar el motivo de cancelación.

Copy de referencia en la UI:

• Sin pagos: “Podés cancelar en cualquier momento y se devuelve la comisión del compromiso.”
• Con pagos, en ventana de 7 días: “Devolución de comisión sobre el saldo pendiente hasta {fecha}.”
• Fuera de la ventana: “La cancelación no revierte comisión sobre el saldo pendiente.”

Personas y reportes

• En Personas → ficha, ves compromisos y donaciones del contacto.
• En Reportes → Log de pagos aparecen las donaciones vinculadas a cada compromiso.
• Las comisiones del compromiso figuran en Facturación / Comisiones del panel admin.

Validación

• Compromiso creado con monto, vencimiento y donante correctos
• Al menos un pago vinculado reduce el saldo esperado
• Probar un caso con excedente y verificar desglose en Facturación
• Progreso de campaña coherente (si aplica)
• Cancelación o anulación de prueba con motivo registrado
• (Opcional) Reasignación con split manual entre dos compromisos

Problemas frecuentes

Siguiente paso

• Donación manual
• Suscripciones recurrentes
• Crear campaña
• Personas
• Reportes básicos