🎯 Manejo de Donaciones Únicas en Salesforce Legacy (NPSP)
Este instructivo detalla las mejores prácticas para gestionar donaciones únicas en entornos que utilizan el paquete NPSP (Nonprofit Success Pack) en su versión Legacy de Salesforce. También se explican los problemas conocidos y cómo evitarlos.
🧩 ¿Cómo se manejan las Donaciones Únicas?
En Salesforce Legacy con NPSP, el manejo correcto de donaciones únicas requiere especial atención debido a un bug en el sistema.
🚫 Problema con el objeto "Legacy Recurring Donations"
Cuando se intenta registrar una donación única dentro del objeto Legacy Recurring Donations, el sistema realiza la siguiente secuencia:
- Crea una oportunidad.
- Elimina esa oportunidad inmediatamente.
- Repite este ciclo hasta que finalmente genera una oportunidad “válida”.
⚠️ Este proceso de creación y eliminación ocurre tan rápido que los triggers no logran detectar ni gestionar correctamente los eventos.
🎯 Consecuencia del error
Como los triggers no alcanzan a procesar la eliminación, los registros asociados de Debi Pago (TC Pago) no se eliminan.
Esto provoca que al generarse finalmente la oportunidad válida, se creen nuevos registros Debi Pago, lo cual duplica los pagos relacionados a una misma donación.
🛑 Esto puede resultar en errores contables, cobros duplicados o problemas de trazabilidad.
✅ Solución recomendada
Para evitar este comportamiento:
- No utilices donaciones únicas dentro del objeto Legacy Recurring Donations.
- En su lugar, registra todas las donaciones únicas como "Oportunidades sueltas" dentro del objeto Oportunidades.
- Si ya tienes donaciones únicas ingresadas de forma incorrecta, se recomienda migrarlas manualmente al formato correcto.
💡 Esta práctica asegura estabilidad, evita duplicidades y mejora la trazabilidad de las donaciones únicas.
🗄️ Consideraciones sobre el almacenamiento
El uso del objeto Oportunidades no implica un mayor consumo de almacenamiento significativo comparado con el proceso erróneo del objeto Legacy Recurring Donations. Al mantener los registros únicos bien definidos, se facilita la gestión y análisis a largo plazo.
📅 Fechas en Oportunidades (Salesforce Legacy)
Salesforce Legacy asigna las fechas de las oportunidades según la fecha de creación de la donación original, lo cual impacta en la consistencia futura de los registros.
🧪 Ejemplos de comportamiento:
| Fecha de creación de la donación | Día asignado a futuras oportunidades |
|---|---|
| 1 de marzo de 2019 | Día 1 de cada mes |
| 25 de marzo de 2019 | Día 25 de cada mes |
🗓️ Recomendación clave
Para mantener la coherencia de fechas en futuras oportunidades:
- Establece siempre el día 1 como fecha de creación para nuevas donaciones.
- Esta práctica evita errores de sincronización y asegura un comportamiento predecible del sistema.
📌 Conclusión
El correcto manejo de donaciones únicas en Salesforce Legacy con NPSP requiere evitar el uso del objeto Legacy Recurring Donations para estos casos.
Registra las donaciones únicas como oportunidades independientes y estandariza la fecha de creación al día 1 para una gestión más estable y predecible.
🛠️ Si tu organización aún opera en NPSP Legacy, estas recomendaciones pueden ayudarte a prevenir errores y asegurar una estructura de datos más confiable.