Getting Started

Comment importer des clients depuis un fichier CSV

Transférez vos clients et leurs abonnements depuis un tableur. Découvrez comment les ID de ligne du panel sont vérifiés et comment lier les lignes non liées.

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

L'import CSV ajoute à votre boutique vos clients existants et leurs abonnements à partir d'un tableur. Il ne crée, ne modifie et ne prolonge jamais aucune ligne sur votre panel. Il enregistre seulement les clients que vous avez déjà.

L'onglet CSV Import est disponible lorsque votre boutique dispose du module CSV Import.

1Step 1 of 7Préparer votre fichier

Allez dans Customers → Import customers et ouvrez l'onglet CSV Import. Sous CSV Template & Column Reference, cliquez sur Download Template (.csv) et remplissez une ligne du fichier par abonnement.

  • name et status (ACTIVE, EXPIRED ou SUSPENDED) sont obligatoires sur chaque ligne du fichier. email est facultatif : un client sans e-mail est ajouté comme client manuel.
  • Un abonnement actif nécessite aussi product_name et expiry_date (YYYY-MM-DD).
  • username (l'identifiant de la ligne sur votre panel) est ce qui nous permet de retrouver la ligne sur votre panel. Renseignez-le partout où vous l'avez.
  • panel_user_id est facultatif : c'est l'ID de la ligne sur votre panel. Laissez-le vide si les numéros viennent de votre ancien système (1, 2, 3 …) et ne sont pas les ID de ligne affichés par votre panel.

Une ligne du fichier qui n'est pas active, n'a pas de produit ou a déjà expiré n'importe que le profil du client : ni abonnement, ni facture.

2Step 2 of 7Envoyer le fichier

Déposez le fichier dans la zone d'envoi ou cliquez sur Choose File. L'aperçu indique combien de lignes ont été lues et les éventuelles erreurs à corriger.

Les clients qui ont une adresse e-mail sont ajoutés à votre liste de clients dès la lecture du fichier. Ils ne sont pas ajoutés une seconde fois lors de l'import.

3Step 3 of 7Lire les avertissements

Lisez Before you import au-dessus des erreurs. Cette section vous indique par exemple combien de lignes du fichier ont un ID de ligne du panel mais pas de username, et combien ne donneront qu'un profil. Si vos ID de ligne du panel se suivent (1, 2, 3 …) presque sans trou, l'aperçu signale qu'ils ressemblent à des numéros de ligne de votre ancien système. Si c'est le cas, corrigez la colonne, ou videz-la et renseignez plutôt les usernames, puis envoyez de nouveau le fichier.

4Step 4 of 7Associer vos produits et choisir le panel

Cliquez sur Continue to Mapping. Choisissez la boutique, puis sous Panel Integration (Optional), choisissez le panel sur lequel se trouvent vos lignes, ou No panel. Sous Map Products, choisissez l'un de vos produits pour chaque nom de produit du fichier, ou Skip pour écarter les lignes correspondantes.

Laissez Import as manual subscriptions coché si vous encaissez vous-même les paiements. Le renouvellement automatique est alors désactivé pour les abonnements importés.

5Step 5 of 7Lancer l'import

Cliquez sur Review & Import, vérifiez le récapitulatif, puis cliquez sur Start Import.

6Step 6 of 7Vérifier les résultats

Lorsqu'une ligne du fichier a un ID de ligne du panel et que vous avez choisi un panel, la ligne est vérifiée sur ce panel avant d'être liée. Elle n'est liée que si votre panel affiche exactement une ligne avec ce username, et qu'aucun autre abonnement n'est lié à cette ligne. C'est alors l'ID de ligne propre au panel qui est utilisé, même si votre fichier indiquait un autre numéro. Panel line check montre ce qu'il est advenu de ces lignes :

  • linked (liée) : les renouvellements prolongeront cette ligne.
  • not found on panel (introuvable sur le panel) : aucune ligne avec ce username n'existe sur votre panel.
  • ambiguous (ambiguë) : plusieurs lignes ont ce username, ou deux lignes de votre fichier pointent vers la même ligne du panel.
  • no username – not linked (pas de username, non liée) : la ligne du fichier avait un ID de ligne mais pas de username, elle n'a donc pas pu être vérifiée.
  • not checked (non vérifiée) : le panel n'a pas pu être interrogé à temps, ou il ne permet pas de rechercher des lignes.

Les lignes du fichier qui n'ont pas été liées sont tout de même importées, sans lien avec le panel.

Le fonctionnement de la vérification dépend du panel. Un panel dont l'API liste vos lignes (XUI avec une clé API) vérifie toutes les lignes du fichier en une seule lecture. Les panels NXT et V12 / MaxOTT sont interrogés une ligne à la fois, aussi longtemps que l'import le permet. Un panel auquel nous nous connectons via le navigateur est vérifié pour 20 lignes au maximum par import. Les autres types de panels ne sont pas vérifiés.

7Step 7 of 7Lier les lignes qui n'ont pas été liées

Chaque abonnement non lié est listé sous Subscriptions → Needs manual set-up. Pour en lier un, trouvez le client dans Customers → All customers et cliquez sur l'abonnement. Ouvrez l'onglet Panel Sync, saisissez le Panel line ID de la ligne tel que votre panel l'affiche dans sa liste de lignes, puis cliquez sur Save. Les renouvellements prolongeront alors cette ligne.

Astuce : ces abonnements ne sont jamais relancés comme nouvelles commandes sur votre panel : aucune deuxième ligne n'est créée et aucun crédit n'est dépensé pendant que vous les liez.

Ready to try it yourself?

Spin up your own IPTVbp store and connect a panel. It's gratuit jusqu'à ce que vous ayez 25 clients payants, no card needed.

Start free trial