Comment ça fonctionne
L'importeur de commandes Shopify lit un CSV de commandes Shopify standard, fait correspondre le client de chaque commande par e-mail, fait correspondre chaque ligne d'article à un fichier ou pack mappé en cherchant d'abord par SKU puis par titre de produit, et crée des lignes Customer et Purchase dans Alva pour chaque correspondance éligible. Il n'envoie pas d'e-mails, ne met pas de contrôles anti-fraude en file d'attente et n'attribue pas de clés de licence — ces effets de bord sont réservés aux commandes en direct qui arrivent via le webhook Shopify habituel.
Avant de commencer
Mappez chaque produit Shopify ayant déjà vendu un fichier numérique à un fichier ou un pack dans Alva avant de lancer l'import. Les produits non mappés sont ignorés ligne par ligne et apparaissent dans un résumé, mais l'approche la plus propre est de mapper d'abord et d'importer une seule fois.
- Fichiers mappés aux produits. Ouvrez Fichiers dans Alva et confirmez que chaque produit numérique a au moins un fichier ou un pack attaché. Les mappages au niveau des variantes fonctionnent aussi.
- Décidez de la plage de dates. Choix courants : les 90 derniers jours pour une boutique active, ou tout l'historique pour une migration depuis une autre application de livraison.
- Ayez un petit CSV de test prêt. Exportez d'abord une seule semaine récente pour valider le mappage, puis ré-exportez la plage complète une fois que le test à blanc semble correct.
Exporter le CSV de commandes depuis l'admin Shopify
Shopify expose l'export de commandes sous Commandes → Exporter. L'importeur attend les noms de colonnes standard du CSV — ne renommez pas les colonnes et ne modifiez pas le fichier à la main.
- Ouvrez l'admin Shopify → Commandes. Utilisez les filtres pour restreindre à la plage de dates que vous voulez reprendre.
- Cliquez sur Exporter. Choisissez Fichier CSV brut (et non Pour Excel, Numbers ou d'autres tableurs) et sélectionnez Commandes, transactions et remboursements.
- Choisissez la bonne portée. « Page actuelle », « Commandes sélectionnées », « Toutes les commandes » ou « Commandes correspondant à votre recherche » fonctionnent toutes. L'importeur n'agit que sur les lignes dont le statut financier est
paid. - Téléchargez le fichier que Shopify envoie par e-mail. Pour les gros exports, Shopify envoie le lien CSV par e-mail à l'adresse du propriétaire de la boutique. Enregistrez-le localement — ne le décompressez pas pour le re-zipper.
Lancer l'importeur
L'importeur se trouve dans Commandes → Importer les commandes historiques dans la barre latérale de l'admin Alva. Il découpe automatiquement les gros CSV — il n'y a pas de limite de nombre de lignes à craindre.
- Ouvrez Commandes dans Alva, puis cliquez sur l'action secondaire Importer les commandes historiques dans l'en-tête de la page.
- Déposez le CSV sur la zone de téléversement. Alva valide immédiatement les en-têtes de colonnes et rejette le fichier si une colonne requise est manquante.
- Attendez l'aperçu. Alva résout les clients par e-mail, fait correspondre les produits par SKU puis par titre, et affiche les compteurs : commandes totales, commandes éligibles, ignorées (annulées / impayées / sans e-mail), clients trouvés vs manquants, produits correspondants vs non mappés, et commandes déjà importées lors d'un précédent passage.
- Examinez les produits non mappés. Si l'aperçu fait remonter des titres de produits non mappés, annulez l'import, mappez-les dans Fichiers → Produits, et téléversez à nouveau le même CSV. Les commandes déjà importées seront automatiquement ignorées.
- Confirmez et démarrez. Cliquez sur Démarrer l'import. La progression est diffusée dans l'interface au fur et à mesure que chaque morceau est traité. Fermer l'onglet du navigateur n'interrompt pas l'import — il s'exécute jusqu'au bout côté serveur et vous pouvez rouvrir la page pour voir le résultat.
Écran d'aperçu de l'importeur de commandes Shopify Alva avec la carte de résumé de résolution affichant les compteurs éligibles / ignorées / non mappées et le bouton Démarrer l'import. Aucune donnée client réelle visible.
Ce que fait l'importeur (et ce qu'il ignore)
L'importeur est délibérément minimal. Il écrit le plus petit ensemble de lignes nécessaires pour qu'un client puisse renvoyer lui-même ses liens de téléchargement, et ignore tout effet de bord qui surprendrait un client qui revient.
Effets de bord de l'importeur de commandes Shopify comparés à un webhook ORDERS_PAID en direct.
| Effet de bord | Commande en direct (webhook) | Commande importée |
|---|---|---|
| Lignes Customer + Purchase créées | Oui | Oui |
| Accès au téléchargement activé | Oui | Oui |
| E-mail de livraison envoyé | Oui (si activé) | Non — jamais |
| Contrôle anti-fraude mis en file d'attente | Oui (si activé) | Non — jamais |
| Clés de licence attribuées automatiquement | Oui (si mappées) | Non — jamais |
| Déclencheurs POS / Flow lancés | Oui | Non — jamais |
Sous le capot, chaque ligne Purchase importée est créée avec fraudCheckEnabled: false, fraudCheckPassed: false et accessEnabled: true. C'est ce qui fait que la page compte client affiche le fichier immédiatement sans jamais déclencher d'e-mail de téléchargement ni d'attribution de clé de licence.
Limitations honnêtes
- Les clients doivent déjà exister dans Shopify. L'importeur fait la correspondance par e-mail avec votre liste de clients Shopify. Les checkouts en mode invité n'ayant jamais créé de fiche client ne peuvent pas être appariés, et ces lignes apparaissent dans le résumé des ignorées.
- Les clients ayant changé d'e-mail sont ignorés. Le CSV contient l'e-mail capturé sur la commande d'origine. Si un client a depuis changé son e-mail Shopify, la recherche échoue et la commande est signalée comme non appariée.
- Les produits personnalisés ne sont pas importés. Les fichiers sur commande appartiennent à un Purchase spécifique via la table de fichiers par achat et doivent être téléversés à la main. L'importeur restaure uniquement l'accès aux fichiers standard mappés au produit.
- Les compteurs de téléchargement repartent à zéro. Les lignes Purchase importées n'ont aucun historique de compteur de téléchargement. Si vous appliquiez auparavant une limite de téléchargements par achat, les clients récupèrent un quota neuf après l'import.
- Aucune notification automatique. L'importeur ne dit jamais aux clients que leur accès est restauré. Annoncez-le par e-mail marketing en dehors d'Alva, ou attendez les demandes de renvoi individuelles.
Un import de commandes historiques qui enverrait un e-mail à chaque ancien client déclencherait, sur une boutique de 50 000 commandes, 50 000 e-mails de livraison à l'instant où vous cliquez sur Démarrer — un signal spam garanti auprès des fournisseurs de boîtes de réception. Alva livre l'importeur avec les effets de bord e-mail, fraude et clés de licence désactivés en dur, pour que le chemin sûr soit le seul chemin.
FAQ
L'importeur enverra-t-il un e-mail aux anciens clients quand je le lancerai ?
Non. L'importeur de commandes Shopify n'envoie jamais d'e-mails. Les anciens clients reçoivent de nouveaux liens de téléchargement uniquement lorsqu'ils demandent un renvoi ou visitent la page compte client Shopify.
L'importeur lance-t-il un contrôle anti-fraude sur les commandes importées ?
Non. Les contrôles anti-fraude n'ont de sens que pour les nouvelles commandes pour lesquelles les données Shopify Risk sont à jour. Les lignes Purchase importées sont créées avec fraudCheckEnabled à false et accessEnabled à true.
L'importeur attribuera-t-il des clés de licence aux commandes importées ?
Non. Les clés de licence ne sont jamais attribuées lors d'un import historique. Si une ancienne commande a besoin d'une clé après l'import, attachez-en une manuellement depuis la page de détail de la commande dans Alva.
Est-il sûr de lancer l'import deux fois ?
Oui. L'importeur est idempotent — un nouveau passage avec le même CSV détecte les commandes déjà importées et les ignore. Le résumé indique combien de commandes et de lignes d'articles ont été ignorées au second passage.
Que se passe-t-il pour les commandes de produits que je n'ai pas encore mappés ?
L'importeur ignore les lignes d'articles dont le produit Shopify ne peut pas être apparié à un fichier ou un pack dans Alva. L'aperçu liste chaque titre non mappé avec un compteur de commandes pour que vous puissiez les mapper et relancer.
Et les commandes annulées ou impayées dans le CSV ?
Alva n'importe que les lignes dont le statut financier Shopify est paid et dont la commande n'est pas annulée. Les commandes impayées, annulées et remboursées sont comptées dans le résumé des ignorées et ne sont pas importées.
Voir aussi
Cet article vous a-t-il été utile ?
Dernière mise à jour 2026-05-08