> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taliuphq.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Bulk Import
> Chargez toute la liste de produits d'un marchand d'un coup à partir du gabarit Excel Taliup, et exportez le catalogue courant.
**Bulk Upload** charge la liste de produits d'un marchand depuis un chiffrier plutôt qu'un article à la fois. Téléchargez le gabarit Taliup, remplissez-le, téléversez-le.
## Comment y accéder
**Catalogs** (ou **Menus**) → **Products** (ou **Items**) → **Bulk Upload**.
## Importer des produits
Cliquez sur **Download Template**. Le fichier est un classeur Excel nommé `BulkUploadTemplate.xlsx`.
Complétez d'abord **Attributes** et **Tags** si vous prévoyez d'y faire référence, puis **Products**. Le détail des colonnes est plus bas.
Cliquez sur **Upload File** et choisissez votre classeur rempli. Le nom du fichier s'affiche une fois sélectionné.
Cliquez sur **Submit**. L'import s'exécute immédiatement et vous revenez à la liste des produits avec une confirmation.
L'import écrit directement dans le catalogue. Il n'y a ni étape de révision ni annulation — vérifiez le chiffrier avant de téléverser. Pour voir le résultat avant qu'il ne devienne actif, utilisez plutôt [Catalog Builder](/fr-CA/taliup-hq/admin/catalog-builder) depuis l'administration Taliup HQ.
## Contenu du gabarit
| Feuille | Rôle |
| -------------- | -------------------------------------------- |
| **Guidelines** | Notes sur le remplissage du classeur |
| **Products** | Une ligne par produit ou article |
| **Attributes** | Les groupes d'options et leurs valeurs |
| **Tags** | Les étiquettes de produits et leurs couleurs |
### Feuille Products
| Colonne | Notes |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Product Name** | Obligatoire. Une ligne sans nom est ignorée |
| **Product Supplier** | Créé s'il n'existe pas encore |
| **Product Cost** | Ce que le marchand paie |
| **Mark Up (%)** | Calculé à partir du coût et du prix si laissé vide |
| **Price** | Laissez vide pour un article à prix du marché — il devient à prix personnalisé. `0` signifie que l'article est gratuit, pas que le prix manque |
| **Product SKU** | |
| **Weighable** | `Yes` ou `No`. Exige une **Unit** et ne peut pas être utilisé avec un prix vide |
| **Unit** | `kg`, `g`, `lb` ou `oz` |
| **Product Description** | |
| **Type** | `Product` ou `Service`. Product par défaut |
| **Catalog** | Créé s'il n'existe pas encore |
| **Category** | Séparez-en plusieurs par des virgules pour placer un article dans plus d'une catégorie |
| **Tag** | Un nom d'étiquette, ou un identifiant de la feuille Tags |
| **Attribute** | Colonne répétée. Chaque valeur doit déjà exister, ou être définie sur la feuille Attributes |
| **Tax** | Colonne répétée. Doit correspondre à une taxe existante par son nom |
Les taxes sont appariées par nom et ne sont pas créées par l'import. Configurez-les d'abord sous **Taxes**, ou attachez-les au niveau du catalogue par la suite pour qu'elles se propagent à tous les articles.
Une **Image** doit être une adresse `https` publique. La photo est téléchargée et réhébergée par Taliup, stockée à 1 200 pixels de large au maximum, et récupérée en arrière-plan après l'import — laissez-lui une minute avant de vérifier le produit. Une adresse inutilisable est ignorée et le produit est tout de même importé.
### Feuille Attributes
| Colonne | Notes |
| ---------------------------------- | ---------------------------------------------------------------------- |
| **Attribute Name** | Obligatoire |
| **Is Required** | Si le client doit choisir une valeur |
| **Selection Type** | `Single` ou `Multiple` |
| **Minimum # of Values Selectable** | |
| **Maximum # of Values Selectable** | Fixe le maximum quand le type est Multiple |
| **Value** / **Price** | Paire répétée. Le prix est l'écart que cette valeur ajoute à l'article |
### Feuille Tags
| Colonne | Notes |
| -------------- | -------------------------------------------------------------------- |
| **Tag ID** | Facultatif. Sert à référencer l'étiquette depuis la feuille Products |
| **Tag Name** | Obligatoire |
| **Color Code** | Couleur hexadécimale, par exemple `#2E7D32` |
Un **Price** vide et un **Price** à `0` sont deux choses différentes. Vide signifie que la caissière saisit le prix à la caisse ; `0` crée un article réellement gratuit, comme un accompagnement offert. L'import marchand et [Catalog Builder](/fr-CA/taliup-hq/admin/catalog-builder) lisent la colonne de la même façon.
## Mettre à jour des produits existants
Exportez d'abord le catalogue, modifiez les lignes voulues, puis téléversez le fichier de nouveau. Les lignes qui portent un **Product ID** mettent ce produit à jour au lieu d'en créer un nouveau. Les lignes sans identifiant créent toujours.
C'est la façon d'ajouter des photos à un catalogue déjà construit : exportez, collez les URL d'images dans la colonne **Image**, réimportez. Une cellule que vous n'avez pas modifiée est ignorée — réimporter un export ne retélécharge donc pas toutes les photos — et une cellule modifiée remplace la photo actuelle du produit.
## Exporter le catalogue
Depuis la liste des produits, cliquez sur **Export Products**. L'export est préparé en arrière-plan et un lien de téléchargement apparaît lorsqu'il est prêt — vous pouvez quitter la page et revenir.
**Export Attributes** produit un CSV distinct des groupes d'options et de leurs valeurs.
## Si l'import échoue
Tout le téléversement est appliqué ensemble ou pas du tout : un échec laisse donc le catalogue intact. Les problèmes de validation sont retournés par numéro de ligne; un problème comme un attribut manquant signale la seule valeur introuvable. Les causes habituelles sont :
| Message | Cause |
| ------------------ | --------------------------------------------------------------------------- |
| Modifier not found | Une colonne **Attribute** nomme un groupe d'options qui n'existe pas encore |
| Tag not found | La colonne **Tag** nomme une étiquette qui n'existe pas |
| Product not found | Un **Product ID** n'appartient pas à ce marchand |
| A unit is required | **Weighable** est à `Yes` mais **Unit** est vide |
Corrigez le chiffrier et téléversez de nouveau.
Vous importez un gros catalogue ? Demandez à votre ISO de le lancer depuis l'administration Taliup HQ. L'import côté administration traite en arrière-plan par lots et fournit un fichier téléchargeable des seules lignes en échec, pour ne corriger et retéléverser que celles-là.
## Ordre des articles
Les articles importés dans une catégorie conservent l'ordre dans lequel ils apparaissent dans le chiffrier. Réordonner les lignes du fichier et réimporter ne réorganise pas les articles qui existent déjà.
## Voir aussi
* [Catalogues](/fr-CA/taliup-hq/merchant/catalogs/index)
* [Catalog Builder](/fr-CA/taliup-hq/admin/catalog-builder)
* [Produits / Articles sur le PDV](/fr-CA/taliup-pos/catalog/products)
* [Attributs / Modificateurs sur le PDV](/fr-CA/taliup-pos/catalog/attributes)