Cambiar de plataforma de donaciones es fácil de justificar y doloroso de ejecutar. Tu lista de donantes, historial de campañas y años de registros de donaciones viven dentro de Donorbox, y mudarse a una nueva plataforma tradicionalmente ha significado una de dos cosas: empezar de cero y perder tu historial, o pasar días luchando manualmente con hojas de cálculo para darles forma.

El Importador de Donorbox para Charitable Pro elimina esa disyuntiva.

Lee los mismos archivos CSV que Donorbox ya te permite exportar, los mapea al modelo de datos de Charitable y te guía a través de toda la migración en un asistente guiado de seis etapas. Donantes, campañas, historial de donaciones y registros de planes recurrentes aterrizan en Charitable intactos, listos para potenciar tus correos de agradecimiento, campañas de reactivación y reportes a largo plazo.

Un modo de simulación integrado te permite previsualizar exactamente lo que se importará antes de que se escriba un solo registro. Y si algo parece incorrecto después de confirmar, una reversión con un clic elimina todo lo que la importación creó, dejando tu base de datos exactamente como estaba.

Disponible en Charitable Pro 1.8.14 y versiones posteriores.

Aquí tienes un adelanto de cómo es la herramienta:

¿Qué contiene esta guía?

Lo que obtienes en el Importador de Donorbox

Esto es lo que se incluye en esta función:

• Asistente de seis etapas: subir, previsualizar, opciones, importar, resultados y reversión opcional.
• Importa donantes, campañas, donaciones y planes recurrentes (solo archivo) de exportaciones CSV estándar de Donorbox.
• Detecta automáticamente las columnas CSV de una lista blanca de esquema estable con alias de encabezado múltiples por campo.
• El modo de simulación previsualiza todo sin escribir un solo registro.
• Las marcas de ID de lote por importación marcan cada registro para que una reversión completa esté a un clic de distancia si la importación es incorrecta.
• Reversión síncrona para importaciones pequeñas y reversión asíncrona por lotes para las muy grandes.
• Formato de fecha configurable (ISO, MM/DD/AAAA, DD/MM/AAAA) para CSV de diferentes regiones.
• Anulación opcional de donantes y donaciones duplicados en la reimportación.
• Uso opcional de las cantidades convertidas de Donorbox para sitios multidivisa.
• Limpieza de 24 horas de importaciones abandonadas, para que una pestaña del navegador cerrada no deje archivos temporales atrás.
• La protección de concurrencia evita que dos importaciones se ejecuten al mismo tiempo.

¿Por qué usar el Importador de Donorbox?

Alejarse de Donorbox sin perder su historial era, hasta ahora, un ejercicio manual de manipulación de hojas de cálculo.

El Importador de Donorbox es un asistente de seis etapas. Cada etapa espera una confirmación explícita antes de continuar, y la simulación se puede repetir tantas veces como desee antes de confirmar.

Sus donantes, sus campañas y el historial de donaciones que demuestra la relación, todo aterriza en Charitable, donde pueden potenciar correos de agradecimiento, campañas de reactivación segmentadas y sus informes continuos.

Requisitos

• Charitable Pro 1.8.14 o posterior
• PHP 7.4 o superior (el importador comprueba y se niega a ejecutarse por debajo de esto)
• Copia de seguridad reciente de la base de datos (muy recomendable antes de cualquier importación grande)
• Cuenta de Donorbox con permiso para exportar Donaciones, Colaboradores y Planes Recurrentes como CSV

Empezar

Antes de empezar, inicie sesión en su panel de control de Donorbox y exporte sus datos como CSV utilizando la opción “Todas las columnas” :

• CSV de Donaciones (requerido)
• CSV de Colaboradores (opcional pero recomendado)
• CSV de Planes Recurrentes (opcional)

Importante: Haga una copia de seguridad de su base de datos de WordPress. Puede usar una herramienta como Duplicator para hacer una copia de seguridad rápida de su sitio web.

Tenga en cuenta que los tokens de pago de Donorbox no son portátiles. Los planes recurrentes importados son solo para archivo y llegan a Charitable con un estado de cancelado. Deberá volver a recopilar la autorización de pago de esos donantes si desea que la facturación recurrente continúe en Charitable.

Dónde encontrar el Importador de Donorbox

En su administrador de WordPress, vaya a Charitable → Herramientas → Importar → Donorbox.

Empieza a migrar a Charitable

El importador de Donorbox es un asistente de seis etapas. Cada etapa espera una confirmación explícita antes de continuar, y la simulación se puede repetir tantas veces como desee antes de confirmar.

Etapa 1: Subir CSVs

Cargue su CSV de Donaciones de Donorbox. Los CSV de Colaboradores y Planes Recurrentes son opcionales pero muy recomendables. Una vez que haga clic en Continuar, el importador analiza las cabeceras, detecta el delimitador (coma, punto y coma o tabulación) y hace coincidir las columnas con el esquema de Donorbox.

Etapa 2: Previsualizar recuentos

Se ejecuta una simulación contra sus archivos cargados e informa cuántos donantes, campañas, donaciones y planes recurrentes se encontraron. Nada se escribe en su base de datos en esta etapa. Utilice los recuentos para verificar que la importación ve lo que espera.

Etapa 3: Opciones de importación

Seleccione qué entidades importar y configure el comportamiento avanzado:

• Qué importar: Donantes, Campañas, Donaciones, Planes Recurrentes
• Anular duplicados en la importación
• Usar importes convertidos de Donorbox (para sitios multidivisa)
• Simulación (solo vista previa, no se escribe nada)
• Formato de fecha: ISO (AAAA-MM-DD), MM/DD/AAAA o DD/MM/AAAA

Etapa 4: Importando

El importador procesa una fase a la vez (donantes, luego campañas, luego recurrentes, luego donaciones) en lotes de 200 filas por defecto. El progreso se actualiza en vivo en el navegador, y cada registro importado se marca con el ID del lote de importación.

Etapa 5: Resultados

Un resumen muestra el recuento de registros importados, omitidos y con errores para cada entidad, además de cualquier advertencia. Desde aquí puede mantener la importación o activar una reversión.

Etapa 6: Reversión (Opcional)

Si la importación no es lo que esperabas, el botón Revertir elimina todo lo marcado con el ID de lote de esta importación. Las importaciones pequeñas se ejecutan de forma síncrona; las importaciones muy grandes (más de 5.000 registros por defecto) se ejecutan en lotes en segundo plano.

Al revertir, verás un mensaje de advertencia para confirmar tu decisión. De esa manera, no iniciarás una reversión accidentalmente.

Opciones de configuración

Opciones de importación (Etapa 3)

Opción	Tipo	Predeterminado	Descripción
Importar donantes	booleano	verdadero	Procesa el CSV de Colaboradores (cuando se cargue) para crear registros de donantes.
Importar campañas	booleano	verdadero	Crea campañas benéficas a partir de nombres de campaña únicos en la exportación de donaciones.
Importar donaciones	booleano	verdadero	Crea registros de donaciones vinculados a donantes y campañas.
Importar Planes Recurrentes	booleano	verdadero (cuando se carga el CSV de planes)	Crea registros de planes recurrentes de archivo (estado cancelado).
Anular Duplicados	booleano	false	Cuando está marcado, la reimportación de un registro actualiza el existente en lugar de omitirlo.
Usar Importes Convertidos	booleano	false	Usa la columna de importe convertido de Donorbox en lugar de la moneda de donación original.
Simulación	booleano	false	Lee y analiza todo sin escribir ningún registro en la base de datos.
Formato de Fecha	cadena	iso	iso (AAAA-MM-DD), mdy (MM/DD/AAAA), o dmy(DD/MM/AAAA).

Campos de Donorbox importados

CSV de Donaciones (requerido)

ID de donación, correo electrónico/nombre/apellido del donante, importe, importe convertido, divisa, fecha de donación, estado de la donación, método de pago, IDs de transacción de Stripe/PayPal, comisión de procesamiento, importe de reembolso, nombre y ID de campaña, comentario, indicador anónimo, Gift Aid, empleador, ocupación, indicador recurrente, ID de plan, dirección completa, teléfono, UTM de origen/medio/campaña, dirección IP.

CSV de Colaboradores (opcional)

Correo electrónico del donante, nombre/apellido, dirección completa, teléfono, empleador, ocupación, fecha de alta, ID de donante de Donorbox, recuento total de donaciones, importe total.

CSV de Planes Recurrentes (opcional)

ID de plan de Donorbox, correo electrónico del donante, nombre/apellido, nombre de campaña, importe, divisa, frecuencia, fecha de inicio, fecha de próximo cargo, estado, método de pago, recuento de donaciones.

El importador acepta múltiples nombres de alias para cada campo (por ejemplo, email, donor_email, email_address se mapean todos al correo electrónico del donante), por lo que las exportaciones antiguas o con nombres de campos modificados suelen funcionar sin limpieza manual.

Personalización

Tamaño del Lote

El tamaño de lote predeterminado es de 200 filas por solicitud. Define CHARITABLE_DONORBOX_BATCH_SIZE en wp-config.php para anularlo en todo el entorno, o utiliza el filtro charitable_donorbox_batch_size para un control más detallado:

add_filter( 'charitable_donorbox_batch_size', function( $size ) {
    return 500;
} );

Solución de problemas

“Ya hay otra importación de Donorbox en curso”

El importador solo permite una importación a la vez. Espera a que finalice la importación existente, o utiliza el flujo de reversión en la importación existente antes de iniciar una nueva.

“Versión de PHP no compatible”

El importador requiere PHP 7.4+. Actualiza PHP en el panel de control de tu hosting y recarga la página.

Columnas CSV no reconocidas

Reexporta desde Donorbox utilizando la opción “Todas las columnas”. Donorbox cambia ocasionalmente los nombres de las cabeceras; si tu exportación utiliza una cabecera que el importador no reconoce, utiliza el filtro charitable_donorbox_csv_schema para ampliar la lista de permitidos.

Los planes recurrentes se importan como cancelados

Esto es intencionado. Los tokens de pago de Donorbox no son portátiles, por lo que los planes se importan como registros históricos de archivo. Para reanudar la facturación recurrente en Charitable, necesitarás volver a solicitar la autorización de pago a esos donantes utilizando un formulario de donación recurrente de Charitable.

¿La importación parece incorrecta? ¿Cómo puedo deshacerla?

Utiliza el botón Revertir en la pantalla de Resultados. El importador marca cada registro que crea con el ID del lote de la importación y la reversión solo elimina esos registros.

Recursos para desarrolladores

Ganchos y filtros

• charitable_donorbox_batch_size — cambia cuántas filas CSV se procesan por solicitud AJAX (por defecto 200).
• charitable_donorbox_csv_schema — extiende o anula la lista de columnas permitidas por tipo de entidad (donaciones, donantes, planes).
• charitable_donorbox_rollback_async_threshold — cambia el recuento de registros por encima del cual la reversión se ejecuta de forma asíncrona (por defecto 5.000).
• charitable_donorbox_verbose_logging — habilita el registro interno detallado para la importación activa.

Constantes

• CHARITABLE_DONORBOX_BATCH_SIZE — define en wp-config.php para una anulación del tamaño del lote a nivel de entorno.

Clases útiles

• Charitable_Donorbox_Importer — orquestador principal. El orden de las fases es donantes → campañas → recurrentes → donaciones.
• Charitable_Donorbox_CSV_Parser — analizador CSV en streaming con detección de delimitadores, normalización de encabezados y listas de permitidos de esquemas por entidad.

Registro

Los eventos de importación se registran con la fuente donorbox y aparecen en los registros estándar de Charitable (Charitable → Herramientas → Registros), filtrables por la fuente de Importación de Donorbox.

Preguntas frecuentes

¿Necesito reformatear mi CSV de Donorbox antes de importarlo? 

En la mayoría de los casos, no. Exporta tus datos de Donorbox utilizando la opción “Todas las columnas” y carga el archivo tal cual. El importador reconoce múltiples alias de encabezado por campo, por lo que las exportaciones antiguas o renombradas suelen funcionar sin ninguna limpieza manual.

¿La importación afectará a mi sitio web en vivo mientras se ejecuta? 

El importador procesa los registros en lotes en segundo plano, por lo que tu sitio permanece en línea. Sin embargo, recomendamos encarecidamente hacer una copia de seguridad completa de la base de datos antes de ejecutar cualquier importación grande, por si acaso.

¿Qué pasa con mis donantes recurrentes? 

Los planes recurrentes se importan como registros de archivo con estado cancelado. Los tokens de pago de Donorbox no son portátiles, por lo que la facturación activa no se puede transferir. Para reanudar las donaciones recurrentes en Charitable, deberás volver a solicitar la autorización de pago a esos donantes utilizando un formulario de donación recurrente de Charitable.

¿Puedo previsualizar la importación antes de confirmarla? 

Sí. El modo de simulación lee y analiza tus archivos CSV e informa exactamente qué se importaría – donantes, campañas, donaciones y planes recurrentes – sin escribir un solo registro en tu base de datos. Puedes ejecutarlo tantas veces como quieras antes de confirmarlo.

¿Qué pasa si importo algo por error? 

Usa el bot ilde{n> de Revertir en la pantalla de Resultados. El importador sella cada registro que crea con un ID de lote ilde{n>ico, por lo que la reversi ilde{n> solo elimina lo que esa importaci ilde{n> cre ilde{o} y nada m ilde{a>s. Las importaciones peque ilde{n>as se revierten al instante; las importaciones muy grandes ejecutan la reversi ilde{n> en segundo plano.

extquestion{Puedo ejecutar el importador m ilde{a>s de una vez?} 

S ilde{i}, pero solo se puede ejecutar una importaci ilde{n> a la vez. Si necesitas volver a importar, espera a que termine la importaci ilde{n> actual o revi ilde{r>tela primero. Habilita la opci ilde{o>n Anular duplicados si quieres que los registros reimportados actualicen los existentes en lugar de omitirse.

Mis columnas CSV no se reconocen. extquestion{Qu ext> hago? 

Vuelve a exportar desde Donorbox usando la opci ilde{o>n extquotedblleft Todas las columnas extquotedblright, ya que Donorbox ocasionalmente cambia los nombres de las cabeceras. Si el problema persiste, un desarrollador puede usar el filtro `charitable_donorbox_csv_schema` para a extntilde{adir} nombres de columna no reconocidos a la lista de permitidos.

extquestion{El importador soporta formatos de fecha no estadounidenses? 

S ilde{i}. Puedes elegir entre tres formatos de fecha en la etapa de Opciones de Importaci ilde{o>n: ISO (YYYY extminus{}MM extminus{}DD), MM/DD/AAAA o DD/MM/AAAA, para que coincida con el formato que use tu CSV.

extquestion{Qu ext> pasa si cierro la pesta extntilde{a} del navegador a mitad de la importaci ilde{o>n? 

Los archivos temporales que queden se limpiar ilde{a>n autom ilde{a>ticamente despu exttext>s de 24 horas. El guardia de concurrencia tambi exttext>n evitar exttext> que comience una nueva importaci exttext>n hasta que se borre la abandonada.

extquestion{Necesito los CSV de Colaboradores y Planes Recurrentes? 

Solo se requiere el CSV de Donaciones. Los CSV de Colaboradores y Planes Recurrentes son opcionales pero muy recomendables: el CSV de Colaboradores aporta datos m exttext>s ricos del perfil del donante, y el CSV de Planes Recurrentes asegura que se conserven tus registros hist exttext>ricos de donaciones recurrentes.

extquestion{Qu ext> versi exttext>n de Charitable Pro necesito? 

El Importador de Donorbox est exttext> disponible en Charitable Pro 1.8.14 y versiones posteriores. Tambi exttext>n necesitar exttext>s PHP 7.4 o superior en tu servidor.