> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide de mappage des PLU

> Bonnes pratiques pour mapper les produits entre storekit et votre POS à l'aide de codes PLU. Évitez les pièges courants et assurez-vous que les commandes arrivent avec précision en cuisine.

Les codes PLU (Price Look-Up) sont des identifiants uniques qui relient les produits entre storekit et votre système POS. Un mappage PLU correct garantit que les commandes arrivent avec précision à votre cuisine.

## Comprendre les codes PLU

Un code PLU est un numéro ou un code alphanumérique qui identifie de manière unique un produit dans votre POS. Lorsque storekit envoie une commande à votre POS, il inclut le code PLU afin que le POS sache exactement quel article a été commandé.

### Exemple de mappage PLU

| Produit storekit                      | PLU POS | Nom POS    |
| ------------------------------------- | ------- | ---------- |
| Pizza Margherita                      | 1001    | MARG-12    |
| Pizza Pepperoni                       | 1002    | PEPP-12    |
| Fromage supplémentaire (modificateur) | 2001    | MOD-CHEESE |
| Base sans gluten (modificateur)       | 2002    | MOD-GF     |

## Quand le mappage PLU est-il requis ?

Le mappage PLU est requis pour les **intégrations à liaison manuelle** où les menus ne sont pas synchronisés automatiquement :

* TISSL
* Comtrex
* Centegra
* Autres intégrations basées sur PLU

Pour les **intégrations à synchronisation automatique** (Zonal, Lightspeed), le mappage PLU se produit automatiquement lors de la synchronisation du menu.

## Configuration du mappage PLU

### Étape 1 : Exporter la liste PLU depuis le POS

Obtenez une liste complète des codes PLU depuis votre POS :

1. Connectez-vous à votre back office POS
2. Exportez ou imprimez votre liste de produits avec les codes PLU
3. Incluez les modificateurs et variantes

<Tip>
  Créez un tableur avec des colonnes pour : PLU POS, Nom POS, Nom du produit storekit, Catégorie. Cela devient votre document de référence.
</Tip>

### Étape 2 : Ajouter les PLU aux produits storekit

Pour chaque produit :

1. Allez dans **Menu** dans votre tableau de bord storekit
2. Cliquez sur un produit pour le modifier
3. Trouvez le champ **PLU** ou **Paramètres POS**
4. Saisissez le code PLU exact
5. Enregistrez le produit

### Étape 3 : Mapper les modificateurs

Les modificateurs ont aussi besoin de PLU :

1. Allez dans vos groupes de modificateurs
2. Modifiez chaque option de modificateur
3. Saisissez le code PLU pour chaque option
4. Enregistrez les modifications

### Étape 4 : Vérifier les mappages

Avant la mise en production :

1. Consultez votre tableur PLU
2. Vérifiez que chaque produit storekit a un PLU
3. Vérifiez que les PLU correspondent exactement (sensible à la casse pour certains systèmes)
4. Testez avec des commandes exemples

## Bonnes pratiques de mappage PLU

### Conservez une référence maître

Maintenez un tableur qui mappe :

* ID/nom du produit storekit
* Code PLU POS
* Nom du produit POS
* Date de dernière mise à jour
* Notes

Mettez à jour ce document chaque fois que vous apportez des modifications.

### Utilisez une nomenclature cohérente

Lorsque vous créez des produits dans storekit, utilisez une nomenclature qui facilite la correspondance PLU :

| Au lieu de             | Utilisez                  |
| ---------------------- | ------------------------- |
| « The Classic Burger » | « Classic Burger (1001) » |
| « Large Fries »        | « Fries - Large (2050) »  |

Inclure le PLU dans le nom interne aide lors des audits.

### Gérer correctement les variantes

Les produits avec options de taille ou variantes ont souvent des PLU différents :

| Produit | Variante | PLU  |
| ------- | -------- | ---- |
| Latte   | Petit    | 3001 |
| Latte   | Moyen    | 3002 |
| Latte   | Grand    | 3003 |

Dans storekit, vous pouvez soit :

* Créer des produits distincts pour chaque taille
* Utiliser des modificateurs avec des PLU individuels

### Planifiez pour les modificateurs

Les modificateurs se rangent généralement dans des catégories :

| Type                                     | Stratégie PLU                                                           |
| ---------------------------------------- | ----------------------------------------------------------------------- |
| **Ajouts** (fromage supplémentaire)      | PLU unique par ajout                                                    |
| **Retraits** (sans oignons)              | Peut ne pas nécessiter de PLU, ou utiliser un PLU de retrait spécifique |
| **Substitutions** (frites contre salade) | PLU pour l'article de substitution                                      |

<Info>
  Certains systèmes POS gèrent les retraits différemment. Vérifiez avec votre fournisseur POS comment configurer les modificateurs « sans X ».
</Info>

### Documentez les cas particuliers

Notez tous les mappages inhabituels :

* Produits avec plusieurs PLU (combos)
* PLU basés sur l'heure (prix déjeuner vs dîner)
* PLU spécifiques à l'emplacement (configurations multi-établissements)

## Problèmes courants de mappage PLU

### PLU incorrects

**Problème :** La commande affiche le mauvais article dans le POS

**Cause :** Le PLU dans storekit ne correspond pas au POS

**Solution :**

1. Vérifiez le PLU sur le produit storekit
2. Vérifiez par rapport à votre liste de produits POS
3. Corrigez les incohérences
4. Testez avec une nouvelle commande

### PLU manquants

**Problème :** La commande échoue ou des articles sont manquants

**Cause :** Le produit dans storekit n'a pas de PLU attribué

**Solution :**

1. Identifiez les produits sans PLU
2. Recherchez le PLU correct dans le POS
3. Ajoutez le PLU au produit storekit
4. Enregistrez et testez

### PLU introuvable dans le POS

**Problème :** L'erreur indique que le PLU n'existe pas

**Cause :**

* Le PLU a été supprimé du POS
* Faute de frappe dans le code PLU
* Le PLU existe dans un autre emplacement/menu

**Solution :**

1. Vérifiez que le PLU existe dans le POS
2. Recherchez les fautes de frappe (espaces supplémentaires, mauvais caractères)
3. Confirmez que le PLU est actif et visible
4. Mettez à jour storekit si le PLU a changé

### Les PLU des modificateurs échouent

**Problème :** Le produit de base fonctionne mais les modificateurs échouent

**Cause :** PLU des modificateurs manquants ou incorrects

**Solution :**

1. Vérifiez que toutes les options de modificateur ont des PLU
2. Vérifiez que les PLU des modificateurs existent dans le POS
3. Testez chaque modificateur individuellement

## Gestion PLU multi-établissements

Si vous avez plusieurs établissements :

### Même POS, même menu

* Les PLU sont généralement cohérents
* Utilisez le même mappage PLU entre les établissements

### Même POS, menus différents

* Les PLU peuvent différer selon l'établissement
* Maintenez des mappages PLU distincts par établissement
* Documentez les codes spécifiques à l'établissement

### Systèmes POS différents

* Chaque établissement a besoin de sa propre configuration PLU
* Maintenez des documents de référence distincts
* Envisagez la standardisation lorsque c'est possible

## Liste de vérification d'audit PLU

Effectuez cet audit avant la mise en production et périodiquement ensuite :

* [ ] Tous les produits ont des PLU attribués
* [ ] Tous les modificateurs ont des PLU attribués
* [ ] Les PLU correspondent exactement au POS (sans fautes)
* [ ] Le document de référence PLU est à jour
* [ ] Les commandes de test fonctionnent correctement
* [ ] Les prix sont exacts
* [ ] Les modificateurs apparaissent correctement sur les tickets
* [ ] Les nouveaux articles ajoutés depuis le dernier audit sont mappés

## Maintenir les mappages PLU

### Lors de l'ajout de nouveaux articles

1. Créez d'abord le produit dans le POS
2. Notez le PLU attribué
3. Créez le produit dans storekit avec le PLU
4. Mettez à jour votre document de référence
5. Testez le nouvel article

### Lors du retrait d'articles

1. Retirez de storekit (ou marquez comme indisponible)
2. Mettez à jour votre document de référence
3. Retirez éventuellement du POS

### Lorsque les PLU changent

1. Mettez à jour le produit storekit avec le nouveau PLU
2. Mettez à jour le document de référence
3. Testez les produits concernés
4. Notez la date du changement pour le dépannage

Pour toute assistance supplémentaire, [contactez le support](/docs/fr/getting-started/contact-support).


## Related topics

- [Centegra](/docs/fr/guides/integrations/pos/centegra.md)
- [Dépannage POS](/docs/fr/guides/integrations/pos/advanced/troubleshooting.md)
- [Pré-remplissage du panier via URL](/docs/fr/developers/basket-prefill.md)
- [TISSL](/docs/fr/guides/integrations/pos/tissl.md)
- [Injection de commande](/docs/fr/guides/integrations/pos/order-injection.md)