Cómo importar tus clientes y sus saldos desde un CSV

Disponible en: 🏬 Tienda física

Puedes traer tu lista de clientes y su saldo de cashback actual a Perkss subiendo un archivo CSV desde el panel. El sistema identifica a cada cliente por su teléfono, valida el archivo antes de tocar nada y solo después de tu confirmación crea los clientes y les asigna su saldo.

TL;DR — Prepara tu CSV con las columnas correctas → súbelo y revisa la vista previa → confirma la importación → tus clientes aparecen en Miembros con su saldo.

Antes de empezar

• Necesitas el rol de propietario (OWNER) o administrador (ADMIN) de tu cuenta. Con el rol Empleado no puedes acceder a esta función.
• Tu programa de fidelización debe ser de tipo cashback: la importación solo admite programas cashback y se rechaza con un aviso de tipo de programa no soportado si tu programa activo es de sellos.
• El archivo CSV no puede superar los 10 MB.
• Entra en Miembros desde el menú lateral — ahí encontrarás el botón “Importar saldos”. Si vienes de otro sistema y aún no tienes clientes en Perkss, revisa antes “Migrar desde otra plataforma”.

Pasos

1

Prepara tu archivo con las columnas correctas

El CSV usa un esquema fijo de 12 columnas. Solo 3 son obligatorias: phone, availableCashbackCents y unavailableCashbackCents. El resto son opcionales:

Columna	Obligatoria	Qué guarda
phone	Sí	Identidad única del cliente
availableCashbackCents	Sí	Saldo ya disponible para canjear (en céntimos)
unavailableCashbackCents	Sí	Saldo pendiente de desbloquear (en céntimos)
email	No	Ficha del cliente
firstName	No	Ficha del cliente
lastName	No	Ficha del cliente
birthday	No	Ficha del cliente
gender	No	Ficha del cliente
city	No	Dato adicional del cliente
country	No	Dato adicional del cliente
programEnrollmentDate	No	Fecha de alta al programa (formato YYYY-MM-DD)
lastTransactionDate	No	Fecha de la última compra conocida (formato YYYY-MM-DD)

Puedes descargar la plantilla exacta desde el propio botón de importación: phone,availableCashbackCents,unavailableCashbackCents,email,firstName,lastName,birthday,gender,city,country,programEnrollmentDate,lastTransactionDate.

Si tu programa usa “modo abierto” (sin gasto mínimo para canjear), el importe de availableCashbackCents y unavailableCashbackCents se suma directamente al saldo disponible del cliente. Si tu programa exige un gasto mínimo para canjear, unavailableCashbackCents se convierte en progreso hacia ese gasto mínimo, siguiendo la fórmula inversa de tu porcentaje de cashback.

Si tu archivo incluye una columna que no está en esta lista, la importación se rechaza entera antes de procesar ninguna fila.

2

Sube el archivo y mapea las columnas

Sube tu CSV en la pantalla de importación. Perkss valida la cabecera del archivo y te muestra una vista previa de lo que va a importar, sin crear todavía ningún cliente ni mover ningún saldo.

3

Confirma la importación

Al confirmar, Perkss crea o localiza cada cliente por su teléfono y aplica el saldo indicado. El proceso corre como un solo bloque: si algo falla a mitad, no se queda nada a medias.

¿No lleva el CSV listo? → revisa la plantilla descargable del paso 1 antes de confirmar.

¿Algo salió mal?

Si el archivo tiene una fila con un teléfono repetido, o una columna que no reconoce, la importación se rechaza completa con un aviso — corrige el archivo y vuelve a subirlo. No hay una función para deshacer una importación ya confirmada: si necesitas corregir un saldo después, hazlo cliente a cliente desde su ficha con “Registrar venta” o “Aplicar canjeo”.

Volver a subir el mismo CSV dos veces suma los saldos otra vez — no es una operación que se pueda repetir sin duplicar, así que confirma solo una vez por archivo.

Preguntas frecuentes

Relacionados: Migrar desde otra plataforma - Clientes e identidad - Exportar tus datos