# Manual de uso de donoradmin 2.3.0 ## Guia por perfiles y responsabilidades Actualizacion: 02/09/2026 Este manual describe las capacidades visibles y autorizadas por el codigo actual. Las opciones pueden aparecer deshabilitadas cuando el estado del registro impide una accion, aunque el perfil tenga permiso general. --- ## 1. Perfiles disponibles | Perfil | Codigo | Finalidad | | --- | --- | --- | | IT | `it` | Configuracion, seguridad, diagnostico y acceso administrativo completo. | | Administracion | `adm` | Gestion interna de donantes, donaciones, recurrencias y operativa SEPA. | | Marketing | `mkt` | Campañas, contenidos, plantillas, medios y canales. | | Donante | `don` | Acceso restringido a su area personal. | ## 2. Funciones comunes de IT, Administracion y Marketing Los tres perfiles de oficina pueden consultar el dashboard, donantes, donaciones, recurrencias y campañas; abrir fichas; usar filtros y ordenacion; y descargar informes Excel de estos listados. La posibilidad de modificar un dato concreto depende del perfil, del estado del registro y de las validaciones indicadas en cada ficha. Todos deben cerrar sesion al terminar, comprobar el registro antes de una accion irreversible y evitar usar exportaciones fuera de los fines autorizados. ## 3. Perfil IT IT dispone del alcance administrativo mas amplio. Ademas de las funciones comunes puede acceder a toda la configuracion: - General, integraciones y pasarelas de pago. - Estado de SMTP, emails y envios programados. - Biblioteca de medios, plantillas, canales y textos de notificacion. - Usuarios y roles, seguridad, politicas y fiscalidad. - Alineacion Salesforce y revision de donaciones. - Duplicados, conciliacion y mandatos SEPA. - Logs, mantenimiento, catalogos tecnicos e intentos de donacion. IT puede gestionar campañas, editar direcciones, administrar mandatos, revisar trazas tecnicas y ejecutar las acciones de mantenimiento que la interfaz habilite. Debe verificar dependencias y migraciones antes de cambiar configuracion, descargar logs solo cuando sea necesario y no usar mantenimiento como sustituto de un procedimiento de despliegue. ## 4. Perfil Administracion Administracion gestiona la operativa diaria de donantes, donaciones y recurrencias. Puede consultar campañas e informes y acceder a estas herramientas de sistema: - Alineacion Salesforce. - Revision de donaciones. - Duplicados SEPA. - Conciliacion SEPA. - Mandatos SEPA. Puede editar direcciones desde las fichas autorizadas, gestionar mandatos de donaciones o recurrencias y eliminar cuotas canceladas cuando no conservan donaciones pagadas. Las acciones quedan sujetas a estados, presentaciones bancarias, confirmaciones y auditoria. No accede a configuracion general, usuarios, seguridad, logs tecnicos, plantillas ni intentos de donacion. ## 5. Perfil Marketing Marketing consulta la informacion operativa y gestiona campañas y contenidos. Puede crear y reordenar campañas y acceder a: - Biblioteca de medios. - Plantillas. - Canales. - Textos y notificaciones. No puede editar direcciones reservadas a Administracion e IT ni acceder a configuracion tecnica, usuarios, seguridad, conciliacion, mandatos, revision de donaciones o intentos. Los cambios de plantillas deben previsualizarse y comprobar sus variables antes de publicarse. ## 6. Perfil Donante El perfil Donante tiene acceso restringido a su dashboard y area personal. No entra en las pantallas de oficina ni en Configuracion. Su objetivo es consultar y gestionar exclusivamente la informacion propia que la aplicacion exponga. ## 7. Donantes El listado permite buscar, filtrar, ordenar, abrir fichas y exportar resultados. La ficha agrupa identidad, direcciones, telefonos, emails, preferencias, donaciones, recurrencias, documentos y comunicaciones. Antes de editar debe comprobarse que se esta actuando sobre el contacto correcto. Los cambios propuestos desde la pasarela requieren revision; fusionar o alterar datos principales puede afectar documentos y futuras comunicaciones. ## 8. Donaciones El listado permite localizar operaciones por estado, campaña, importe y otros criterios. La ficha muestra pago, contacto, campaña, documentos y trazabilidad. Los estados economicos no deben cambiarse para resolver un problema de correo. `devuelta` corresponde a una devolucion bancaria SEPA; `reembolsada`, a una devolucion de importe efectuada por CARF o la pasarela. Los reenvios de email deben responder a una solicitud real del donante. ## 9. Recurrencias Las recurrencias permiten revisar periodicidad, importe, proximo cobro, cuotas y mandato. El importe o la cancelacion solo pueden modificarse cuando las cuotas afectadas no han sido presentadas en remesa. Una presentacion bancaria bloquea cambios que romperian la integridad del fichero. ## 10. Campañas e informes Los perfiles de oficina consultan campañas, recaudacion, participantes y evolucion. IT y Marketing pueden crear y ordenar campañas. Las exportaciones respetan los filtros activos; antes de compartir un Excel debe revisarse su contenido y destinatario. ## 11. Operativa SEPA La revision de duplicados localiza recurrencias potencialmente repetidas. La conciliacion analiza presentaciones y respuestas bancarias, previsualiza el resultado y aplica estados de forma trazable. Mandatos SEPA permite sustituir referencias provisionales en lote. Antes de aplicar una operacion debe confirmarse el fichero, el periodo, los importes, el mandato y la secuencia. Un fichero ya procesado debe poder reconocerse sin duplicar efectos. Las devoluciones recirculadas conservan su historico y solo vuelven a remesa cuando son elegibles. ## 12. Plantillas, medios y comunicaciones La biblioteca aloja recursos reutilizables. Las plantillas definen emails y documentos y pueden tener versiones. Deben comprobarse asunto, HTML, texto alternativo, variables, imagenes y previsualizacion antes de publicar. Un fallo SMTP aparece como incidencia de comunicacion y no implica que la donacion haya fallado. La configuracion o prueba de canales tecnicos corresponde a IT. ## 13. Intentos de donacion Solo IT accede al seguimiento tecnico. Los intentos abandonados esperan 15 minutos y los denegados o con error, 2 minutos. La recuperacion se omite si ya existe una donacion valida de esa persona el mismo dia o si ya se envio otra recuperacion equivalente. `Pendiente`, `Enviado`, `Fallido` y `Omitido` describen el email de recuperacion, no necesariamente el estado economico. Antes de un envio manual debe revisarse el motivo tecnico y la actividad posterior del donante. ## 14. Usuarios, seguridad, logs y mantenimiento Estas secciones son exclusivas de IT. Usuarios y roles permite invitaciones, reenvios y control de acceso sin dejar el sistema sin un IT activo. Seguridad muestra sesiones, bloqueos y diagnosticos. Logs separa auditoria funcional y trazas tecnicas. Mantenimiento debe ejecutarse con objetivo, comprobacion previa y registro del resultado. ## 15. Matriz resumida de acceso | Area | IT | ADM | MKT | DON | | --- | --- | --- | --- | --- | | Dashboard propio | Si | Si | Si | Si | | Donantes, donaciones y recurrencias | Gestion | Gestion | Consulta operativa | No | | Campañas | Gestion | Consulta | Gestion | No | | Informes Excel de oficina | Si | Si | Si | No | | Direcciones administrativas | Si | Si | No | Solo area propia si se habilita | | Salesforce y revision de donaciones | Si | Si | No | No | | Duplicados, conciliacion y mandatos SEPA | Si | Si | No | No | | Medios, plantillas, canales y textos | Si | No | Si | No | | Intentos de donacion | Si | No | No | No | | Configuracion, usuarios y seguridad | Si | No | No | No | | Logs, mantenimiento y catalogos tecnicos | Si | No | No | No | ## 16. Buenas practicas y escalado 1. Confirmar contacto, importe, campaña, estado y metodo antes de actuar. 2. No corregir incidencias de email alterando el estado economico. 3. No eliminar ni fusionar registros sin revisar dependencias. 4. Exportar solo los datos necesarios y custodiar los ficheros. 5. En SEPA, previsualizar antes de aplicar y conservar los ficheros bancarios autorizados. 6. Escalar a IT los errores de permisos, SMTP, rutas, documentos, pasarelas o procesos programados. 7. Registrar el contexto de la incidencia sin copiar datos personales innecesarios en canales tecnicos.