Getting Started

Cómo importar clientes desde un archivo CSV

Trae tus clientes y sus suscripciones desde una hoja de cálculo. Descubre cómo se comprueban los IDs de línea del panel y cómo vincular las líneas sin vincular.

5 min read
Published 25 de octubre de 2026
Last checked 25 de octubre de 2026
import
csv
migration
customers
panel

La importación CSV añade a tu tienda tus clientes actuales y sus suscripciones desde una hoja de cálculo. Nunca crea, cambia ni extiende una línea en tu panel. Solo registra los clientes que ya tienes.

La pestaña CSV Import aparece cuando tu tienda tiene el módulo CSV Import.

1Step 1 of 7Prepara tu archivo

Ve a Customers → Import customers y abre la pestaña CSV Import. En CSV Template & Column Reference, haz clic en Download Template (.csv) y rellena una fila por suscripción.

  • name y status (ACTIVE, EXPIRED o SUSPENDED) son obligatorios en todas las filas. email es opcional: un cliente sin correo se añade como cliente manual.
  • Una suscripción activa también necesita product_name y expiry_date (YYYY-MM-DD).
  • username (el login de la línea en tu panel) es lo que nos permite encontrar la línea en tu panel. Rellénalo siempre que lo tengas.
  • panel_user_id es opcional: el ID de la línea en tu panel. Déjalo vacío si los números vienen de tu sistema anterior (1, 2, 3 …) y no son los IDs de línea que muestra tu panel.

Una fila que no está activa, que no tiene producto o que ya ha caducado importa solo el perfil del cliente: sin suscripción ni factura.

2Step 2 of 7Sube el archivo

Arrastra el archivo al recuadro de carga o haz clic en Choose File. La vista previa muestra cuántas filas se leyeron y los errores que debes corregir.

Los clientes con dirección de correo se añaden a tu lista de clientes en cuanto se lee el archivo. No se añaden dos veces al importar.

3Step 3 of 7Lee los avisos

Lee Before you import, encima de los errores. Te indica, por ejemplo, cuántas filas tienen un ID de línea del panel pero no un usuario, y cuántas filas serán solo un perfil. Si tus IDs de línea del panel van 1, 2, 3 … casi sin huecos, la vista previa te avisa de que parecen números de fila de tu sistema anterior. Si es así, corrige la columna, o vacíala y rellena los usuarios en su lugar, y vuelve a subir el archivo.

4Step 4 of 7Asigna tus productos y elige el panel

Haz clic en Continue to Mapping. Elige la tienda y, en Panel Integration (Optional), elige el panel en el que están tus líneas, o No panel. En Map Products, elige uno de tus productos para cada nombre de producto del archivo, o Skip para dejar fuera esas filas.

Deja marcado Import as manual subscriptions si cobras tú mismo los pagos. En ese caso, la renovación automática queda desactivada para las suscripciones importadas.

5Step 5 of 7Ejecuta la importación

Haz clic en Review & Import, revisa el resumen y haz clic en Start Import.

6Step 6 of 7Revisa los resultados

Cuando una fila tiene un ID de línea del panel y elegiste un panel, la línea se comprueba en ese panel antes de vincularla. Solo se vincula cuando tu panel muestra exactamente una línea con el usuario de la fila y ninguna otra suscripción está vinculada a esa línea. En ese caso se usa el ID de línea del propio panel, aunque tu archivo indicara otro número. Panel line check muestra qué pasó con esas filas:

  • linked: las renovaciones extenderán esa línea.
  • not found on panel: no hay ninguna línea con ese usuario en tu panel.
  • ambiguous: más de una línea tiene ese usuario, o dos filas de tu archivo apuntan a la misma línea.
  • no username – not linked: la fila tenía un ID de línea pero no un usuario, así que no se pudo comprobar.
  • not checked: no se pudo consultar el panel a tiempo, o el panel no permite buscar líneas.

Las filas que no se vincularon se importan igualmente, sin vínculo con el panel.

La forma de comprobarlo depende del panel. Un panel con una API que lista tus líneas (XUI con clave de API) comprueba todas las filas en una sola lectura. A los paneles NXT y V12 / MaxOTT se les consulta línea por línea, mientras la importación lo permita. En un panel en el que iniciamos sesión a través del navegador se comprueban hasta 20 líneas por importación. Los demás tipos de panel no se comprueban.

7Step 7 of 7Vincula las líneas que quedaron sin vincular

Cada suscripción que no se vinculó aparece en Subscriptions → Needs manual set-up. Para vincular una, busca al cliente en Customers → All customers y haz clic en la suscripción. Abre la pestaña Panel Sync, introduce el Panel line ID de la línea tal como lo muestra tu panel en su lista de líneas y haz clic en Save. A partir de ahí, las renovaciones extienden esa línea.

Consejo: Estas suscripciones nunca se reintentan como pedidos nuevos en tu panel, así que no se crea una segunda línea ni se gasta ningún crédito mientras las vinculas.

Ready to try it yourself?

Spin up your own IPTVbp store and connect a panel. It's gratis hasta que tengas 25 clientes que pagan, no card needed.

Start free trial