Skip to content

Importaciones

Usa Importaciones para traer una lista de clientes existente a Zellbox de una sola vez. Soporta CSV y Excel (.xlsx). El mapeo de campos es interactivo — el importador adivina, tú confirmas.

Página de importaciones

Importar una lista de clientes

  1. Abre Importaciones desde la barra lateral.
  2. Haz clic en + Nueva importación.
  3. Elige el archivo (CSV o Excel).
  4. El asistente se abre con cuatro pasos:
    • Elegir campos — el importador mapea automáticamente los encabezados de tus columnas a los campos de cliente de Zellbox (predefinidos + personalizados). Confirma o elige otro campo para cada columna. Las columnas sin mapear se ignoran. Columnas reconocidas: nombre/apellido/nombre completo, correo, teléfono, fecha de nacimiento, género, idioma, etiquetas, dirección (o sus piezas individuales), país, origen, correo del responsable (se resuelve al responsable asignado) y notas (se convierten en una nota de cliente creada justo después de la fila).
    • Formato — formato de fecha (MDY / DMY / YMD / ISO) y formato de número (US / EU). Se detectan automáticamente a partir de los datos, cámbialo si la suposición está mal.
    • Predeterminados — controles tri-estado por campo (Saltar / Respaldo / Override) para los valores a aplicar en todas las filas cuando una columna falta o está vacía. Tres slots relacionados con el locale se prehidratan desde fuentes razonables, así que normalmente no los tocas:
      • Idioma predeterminado: arranca desde tu última importación (recordada en el navegador) o, en la primera importación, desde el idioma predeterminado del cliente del espacio de trabajo. Red de seguridad del backend: incluso si saltas este paso, el worker cae al predeterminado del espacio de trabajo por fila para que los clientes nunca aterricen con el campo de idioma vacío.
      • País predeterminado: recordado entre importaciones.
      • Orden del nombre (nombre primero / apellido primero): recordado entre importaciones.
    • Confirmar — mira los cálculos contra el límite del plan, filas resueltas de muestra y un Iniciar de un clic. Arranca la importación en segundo plano.
  5. El importador procesa filas en lotes y reporta progreso en vivo. Al final recibes un resumen: creados / saltados / con error, con un CSV descargable de las filas que fallaron.

Para listas muy grandes, divide en varios archivos — cada importación es un trabajo.

Cómo se resuelve el idioma por fila

El customer.language de cada fila se resuelve por esta cascada, en orden:

  1. Celda del CSV — si la fila tiene una columna "Idioma" y no está vacía.
  2. Respaldo del asistente — el valor de Idioma predeterminado del paso Predeterminados (cuando está en modo Respaldo).
  3. Predeterminado del espacio de trabajo — la red de último recurso del worker, tomada de Cuenta → General → Idioma predeterminado del cliente.
  4. Override del asistente — cuando está en modo Override, este gana sobre todo lo anterior. Elígelo cuando "cada fila de este archivo lleva idioma = es" sin importar los datos de origen.

Es la misma cascada que sigue el formulario de crear cliente individual, así que una fila importada aquí queda indistinguible de una escrita a mano en el formulario.

Errores

Modos comunes de falla que dan error en una sola fila (el resto de la importación sigue):

  • Correo inválido — la fila se marca con error y no se crea.
  • Error de parseo de fecha — la fecha no coincide con el paso de Formato. Corrige el dato o cambia el formato elegido.
  • El correo del responsable no coincide con un miembro del espacio de trabajo — la fila queda con error. Invita primero al miembro y vuelve a importar las filas fallidas.

Las filas con error se devuelven como un CSV que puedes corregir y volver a importar.

Zellbox documentation