LNK Stock et emplacements, le stock de chaque entrepôt et l'emplacement de chaque produit

Créez vos lieux (entrepôts, agences, dépôts) sur la page LNK Stock et emplacements, sous Catalogue. Puis, sur la fiche de chaque produit, répartissez son stock entre les lieux. Le stock de PrestaShop devient la somme des lieux : la boutique, le panier et les commandes continuent de le lire comme avant. Quand le module commence à suivre un produit, il fait d'abord recompter par PrestaShop ce que les commandes en cours réservent : le stock repris est le stock réel, et le journal ne montre aucun écart qui n'en est pas un.

Chaque lieu a son modèle d'adresse : vous choisissez et ordonnez les parties (zone, allée, travée, étage, position, case, ou une partie à votre nom), chacune en numéros ou en lettres, avec sa plage et son séparateur. Par exemple allées A à H, travées 01 à 20, étages 1 à 6 donnent A-01-1 à H-20-6. Tous les emplacements sont créés d'un coup, dans l'ordre de passage.

Oui : dans chaque lieu, un emplacement principal et autant de réserves que nécessaire, chacun avec sa quantité. La recherche « qu'est-ce qui est rangé en B-12 ? » liste le contenu des emplacements.

Non. L'ERP, ou PrestaShop, fait foi. Une quantité changée par le webservice, directement en base, sur la fiche produit ou sur la page Stocks de PrestaShop est reprise dans le lieu par défaut et notée au journal ; le module ne réécrit jamais le stock de PrestaShop pour la corriger. Si une fiche était ouverte avant ce changement, son enregistrement est refusé : il suffit de recharger.

Oui. Chaque changement fait depuis la fiche produit écrit un mouvement de stock natif, au motif « Ajustement LNK Stock », visible dans les mouvements de la page Stocks. Quand PrestaShop ne peut pas en écrire (import, tâche programmée), le journal du module fait foi : qui, quand, avant, après.

PrestaShop 1.6 avait une gestion avancée des stocks par entrepôt. Elle a disparu des écrans en 1.7, mais une boutique migrée peut l'avoir gardée active en base, et PrestaShop 1.7 la lit encore par endroits (découpage du panier par entrepôt). Le module ne répartit rien tant qu'elle est active. Le bouton « Désactiver la gestion avancée des stocks de PrestaShop 1.6 », sur la page du module, la désactive pour toutes les boutiques ; vos quantités ne changent pas. Rien n'est fait sans ce clic.

Chaque ligne est prise d'abord dans les lieux qui desservent la zone de livraison du client (le lieu par défaut en tête), puis, si ces lieux n'ont pas assez, complétée depuis les autres lieux. Vous déclarez les zones desservies sur chaque lieu ; sans zone déclarée, tous les lieux servent toutes les zones. La page de la commande montre de quel lieu part chaque ligne. La marchandise sort de ses lieux quand la commande passe à « Expédié », et y revient si la commande est annulée après expédition.

Oui, et elle reste une seule commande PrestaShop : un paiement, une facture. Sur la page de la commande, chaque colis a sa liste, son bouton « Marquer comme expédié » et son numéro de suivi. Le client reçoit un e-mail pour chaque colis et voit leur suivi dans son compte. La commande passe à « Expédiée en partie », puis à « Expédié » avec le dernier colis. Au moment de commander, le client peut demander « un seul colis, même si c'est plus long » : tout part alors d'un seul lieu. Les frais de port restent ceux de PrestaShop, une fois par commande.

Sur la page de la commande, « Colis retourné : remettre en stock » remet sa marchandise dans le lieu d'où il est parti et dans le stock de PrestaShop, avec un mouvement « Retour produit ». N'annulez pas ensuite la commande : PrestaShop remettrait la même marchandise en stock une seconde fois. Pour rembourser, faites un avoir.

Oui. Cochez « Les clients peuvent retirer leur commande ici » sur les lieux concernés, avec une note comme « Prêt demain dès 7 h ». Le transporteur « Retrait sur place », créé par le module et gratuit par défaut, propose alors ces lieux au moment de commander ; le client voit si tout est disponible dans le lieu choisi. La commande est prise d'abord dans ce lieu. Passez-la à « Prête à retirer » : le client reçoit un e-mail avec son code de retrait ; puis à « Retirée » quand il est passé.

Oui, avec le réglage « Supplément de port par colis en plus » : un montant HT ajouté au port pour chaque colis au-delà du premier, jamais sur le retrait. Il s'appuie sur un crochet de PrestaShop 1.7.7 et suivants : en 1.7.6, le port reste celui que calcule PrestaShop.

Oui, par le webservice de PrestaShop, avec une clé dont vous choisissez les droits. Le module y ajoute ses ressources : lieux, emplacements, stock par lieu et par emplacement, journal et colis. Chaque écriture passe par les mêmes contrôles qu'au back-office, et le journal la note au nom de la clé. Une écriture trop grosse, ou un ERP qui envoie trop d'appels par minute, est refusée sans rien écrire : la boutique reste disponible. Sur PrestaShop 9, l'Admin API offre aussi ces données, avec des portées de lecture et d'écriture ; elle demande HTTPS et n'est pas disponible en multiboutique (limite de PrestaShop 9). Le guide pour votre intégrateur est dans docs/API.md.

Oui, onglet « Import » : un fichier CSV avec une ligne par emplacement (référence, lieu, emplacement, quantité), dont le modèle se télécharge sur la même page. La référence peut être celle du produit, de la déclinaison ou l'EAN ; le lieu, son identifiant ou son nom. Le module lit d'abord le fichier et montre chaque ligne refusée avec sa raison ; rien n'est écrit avant que vous cliquiez sur « Écrire les lignes valides ». Pour un produit, les lignes d'un lieu remplacent ce que ce lieu contenait ; les autres lieux gardent les leurs.

Si votre ERP ou votre fournisseur dépose ce fichier à une adresse (http, https, ftp ou ftps), saisissez-la dans les réglages avancés : la tâche cron de votre hébergeur appelle l'adresse indiquée dans l'onglet « Import », par exemple toutes les heures, et les lignes valides sont écrites. Le dernier passage et son résultat s'affichent sur la page.

Oui. Dans l'onglet « Emplacements », la « Liste de préparation » d'un lieu donne ce que les commandes attendent encore, produit par produit, dans l'ordre de passage des emplacements, avec une case à cocher par ligne. Les « Étiquettes des emplacements affichés » s'impriment trois par ligne sur A4, avec un code-barres Code 128 lu par toutes les douchettes (désactivable dans les réglages).

Chaque lieu appartient à une boutique. Si vos boutiques partagent leur stock (groupe de boutiques), le stock partagé est la somme des lieux de toutes ces boutiques. Le stock s'écrit boutique par boutique : en contexte « Toutes les boutiques », le module n'écrit rien.

Le stock de PrestaShop garde la dernière somme écrite : rien n'est remis à zéro. Les lieux, les emplacements et le journal du module sont supprimés. Le transporteur « Retrait sur place » et les états de commande du module sont retirés des listes, mais restent lisibles dans les commandes passées ; ils reviennent tels quels si vous réinstallez le module.

Oui, là où c'est utile, avec les styles de votre thème et sans charger aucun fichier :

• sur la fiche produit, sous le bouton d'ajout au panier, la disponibilité dans chaque agence : « En stock », « Plus que 3 » ou « Indisponible ici ». Jamais de quantité au-delà du seuil (5 par défaut, réglable), jamais de prix. Elle suit la déclinaison choisie ;
• le client choisit « Mon agence » : elle passe en premier, reste gardée pour son compte, et elle est proposée d'office au retrait sur place ;
• le choix du lieu de retrait au tunnel, le message des colis quand une commande part de plusieurs lieux, les colis ou le retrait dans le compte client.

Votre thème peut aussi afficher une ligne de disponibilité dans les listes de produits et le choix de l'agence dans l'en-tête : le guide pour votre intégrateur est dans docs/THEME-CONTRACT.md. Un réglage coupe l'affichage sur la fiche.