# Manuel d'utilisation — Stock Transfer Pro (FR)

## 1) Presentation
Stock Transfer Pro aide a gerer les stocks multi-boutiques Shopify:
- creation et suivi de transferts de stock,
- recommandations de reapprovisionnement et transferts intelligents,
- objectifs de stock par location,
- previsions et alertes pour anticiper les ruptures,
- module **Achats** (plan Pro): fournisseurs, bons de commande, inventaires physiques et COGS pondere.

## 2) Prerequis
- Une boutique Shopify avec les droits Admin necessaires.
- L'application Stock Transfer Pro installee.
- Les locations Shopify configurees (boutiques/entrepots).
- Pour le module Achats: plan **Pro** ou **Pro+** actif (sauf acces partenaire).

## 3) Demarrage rapide
1. Ouvrir l'app depuis Shopify Admin.
2. Verifier la page **Tableau de bord**.
3. Aller dans **Transferts** pour creer un premier transfert.
4. Si necessaire, choisir un plan dans **Abonnement** (Pro pour les achats).
5. Configurer la langue et les options dans **Parametres**.
6. (Plan Pro) Configurer **Fournisseurs**, puis creer un **Bon de commande** ou un **Inventaire**.

## 4) Navigation de l'application
- **Tableau de bord**: vue globale (transferts, bons de commande en brouillon) et alertes de reception en attente.
- **Transferts**: creation, envoi, reception et historique des transferts.
- **Transferts intelligents**: suggestions automatiques basees sur les ventes/stock (plan Pro).
- **Stock cible**: niveau de stock cible par produit et location (plan Pro).
- **Reception POS**: validation de reception en boutique via l'extension Shopify POS.
- **Previsions stock**: analyses et projections (selon plan).
- **Achats fournisseurs** (plan Pro): suggestions de reapprovisionnement.
- **Fournisseurs** (plan Pro): referentiel fournisseurs, produits associes et couts unitaires.
- **Bons de commande** (plan Pro): creer, envoyer, receptionner et suivre le paiement.
- **Inventaires** (plan Pro): comptages physiques par emplacement.
- **Abonnement**: gestion du plan Starter / Pro / Pro+ (masque pour certaines boutiques partenaires).
- **Parametres**: langue, reglages previsions, IA, telechargement du manuel PDF.
- **Contact**: ouverture du courriel support via le bouton dedie.

## 5) Flux principal: creer un transfert
1. Ouvrir **Transferts**, puis **Nouveau transfert**.
2. Choisir la location source et la location destination.
3. Ajouter les produits/variantes (recherche ou **champ scan** pour douchette code-barres).
4. Verifier les quantites proposees.
5. Valider l'envoi.
6. Cote destination, confirmer dans **Reception POS** (extension Shopify POS) ou depuis l'admin.

Bonnes pratiques:
- Transferer en lots reguliers plutot qu'en urgence.
- Verifier la disponibilite source avant validation.
- Utiliser les recommandations intelligentes comme base de decision.

## 6) Transferts intelligents
Objectif: proposer des quantites plus pertinentes selon:
- ventes recentes,
- stock disponible,
- saisonnalite et anticipation (lead time),
- stock de securite.

Conseil: ajuster les propositions selon le contexte local (promotions, evenements, ruptures fournisseur).

## 7) Stock cible
La section **Stock cible** permet de fixer un objectif minimum/ideal par produit/location.

Utilisation recommandee:
1. Definir un niveau cible realiste pour les references critiques.
2. Revoir les cibles chaque mois (ou saison).
3. Croiser avec les previsions pour anticiper les hausses de demande.

## 8) Previsions stock
La section **Previsions stock** aide a:
- visualiser les tendances,
- identifier les risques de rupture,
- preparer les transferts en avance.

Pour de meilleurs resultats:
- renseigner un **lead time** pertinent,
- conserver un **stock de securite** coherent,
- verifier les donnees de ventes historiques.

## 9) Abonnements et limites
- **Starter**: transferts manuels, extension POS, interface multilingue (1-2 locations).
- **Pro**: tout Starter + stock cible, transferts intelligents, previsions 30 j, **module Achats** (fournisseurs, bons de commande, inventaires, COGS pondere).
- **Pro+**: tout Pro + previsions multi-horizons, alertes avancees, IA BYOK, Revenue-at-Risk detaille.

Regle importante:
- Si la boutique depasse 3 locations actives, le plan **Pro+** devient obligatoire.

Acces partenaire:
- Certaines boutiques beneficient d'un accès complet sans onglet **Abonnement** (partenariat ou offre commerciale).

Upgrade/downgrade:
- Changement possible depuis **Abonnement**.
- Essai gratuit de 14 jours sur l'abonnement Shopify lors de la souscription.

## 10) Parametres
Dans **Parametres**, vous pouvez:
- changer la langue (FR/EN/DE/IT/ES),
- regler l'anticipation previsions (lead time et stock securite),
- activer/desactiver l'assistance IA et choisir le fournisseur/modele (Pro+),
- telecharger le **manuel d'utilisation** en PDF (langue selectionnee),
- verifier les scopes API actifs.

## 11) Scan et reception en magasin

### Scan a la creation de transfert (admin)
Sur **Nouveau transfert**, un champ **Scan** accepte les codes-barres via **douchette** (clavier USB/Bluetooth). Placez le curseur dans le champ, scannez, puis validez.

### Mode scan transfert (admin)
Route dediee pour receptionner un transfert par scan:
- **Douchette**: champ actif, scan + Entree incremente la quantite recue.
- **Caméra**: bouton **Activer caméra** pour scanner via le navigateur (zone de preview, pas plein ecran).

### Reception POS (Shopify POS)
L'extension **Stock Transfer Pro** dans l'app **Shopify POS** permet:
- lister les transferts en attente a la location connectee,
- scanner par **caméra native** (viseur plein ecran) ou douchette,
- valider les quantites recues ligne par ligne.

Ideal pour la reception en boutique sur tablette ou telephone.

## 12) Contact et support
- Bouton **Contact** disponible dans la barre de l'app, la page Abonnement et les Parametres.
- Il ouvre votre client de messagerie avec une adresse de support et un sujet pre-remplis.

## 13) Resolution des problemes (FAQ)
**Je ne vois pas certaines pages (ex: Previsions stock, Achats).**  
Verifier le plan actif dans **Abonnement**. Le module Achats requiert le plan **Pro** minimum.

**Je suis redirige vers Abonnement.**  
Verifier que l'abonnement est actif et adapte au nombre de locations.

**Je n'ai pas d'onglet Abonnement.**  
Votre boutique peut avoir un acces partenaire. Rechargez l'app une fois apres installation.

**Les suggestions semblent trop faibles/fortes.**  
Ajuster lead time, stock de securite et cibles de stock.

**Le bouton Contact n'ouvre pas le mail.**  
Verifier le client de messagerie par defaut sur le poste.

**Je ne vois pas Bons de commande / Fournisseurs / Inventaires.**  
Passer au plan **Pro** ou **Pro+** dans **Abonnement**.

**Le bouton Modifier le brouillon ne reagit pas.**  
Recharger la page. Seuls les bons au statut **Brouillon** peuvent etre modifies.

**La reception d'un bon de commande ne met pas a jour le stock.**  
Verifier que le produit est bien suivi en inventaire a l'emplacement choisi.

**Mon inventaire affiche 0 article.**  
Verifier le **perimetre** a la creation: choisir **Tous les produits** (pas un filtre trop restrictif).

**Le coût Shopify ne change pas apres reception.**  
Verifier que l'option **Mettre a jour le coût produit Shopify a la reception** est activee sur la fiche du bon.

**La caméra ne fonctionne pas sur mobile (admin).**  
Autoriser l'acces caméra au navigateur. Pour une experience optimale en magasin, utiliser **Shopify POS**.

## 14) Checklist d'exploitation
- Verifier chaque jour les transferts en attente.
- Confirmer les receptions rapidement (POS ou admin).
- Revoir les previsions chaque semaine (plan Pro+).
- Ajuster stock cible et securite chaque mois.
- Verifier le plan apres ajout de nouvelles locations.
- Tenir a jour le referentiel **Fournisseurs** et les couts unitaires.
- Finaliser ou annuler les bons de commande en brouillon.
- Receptionner les bons de commande en attente et suivre le **paiement**.

## 15) Module Achats (plan Pro)

> **Acces:** **Achats fournisseurs**, **Fournisseurs**, **Bons de commande** et **Inventaires** sont disponibles avec le plan **Pro** ou **Pro+**. La reception met a jour le stock et, optionnellement, le **coût pondere (COGS)** dans Shopify.

### Tableau de bord enrichi
Le **Tableau de bord** affiche:
- compteurs de transferts (total, brouillon, envoyes, recus);
- **Bons de commande en brouillon**;
- alerte si des **transferts** attendent une reception;
- alerte si des **bons de commande** (Commande ou Recu partiellement) attendent une reception.

### Fournisseurs
1. Ouvrir **Fournisseurs**.
2. Creer un fournisseur (nom, e-mail, coordonnees).
3. **Associer des produits** avec un **coût unitaire** par variante.
4. Ces couts alimentent les bons de commande et le calcul COGS a la reception.

### Achats fournisseurs
Page de **suggestions de reapprovisionnement** basees sur le stock et la demande. Utilisez-la pour preparer des commandes fournisseur avant de creer un bon de commande.

### Creer un bon de commande
1. Ouvrir **Bons de commande**, puis creer un nouveau bon.
2. Choisir l'**emplacement** de reception, le **fournisseur** et les champs optionnels (reference, date prevue, notes).
3. **Rechercher des produits** en direct; les variantes deja ajoutees sont masquees.
4. Ajuster les **quantites commandees** et le **coût unitaire** par ligne (pre-rempli depuis le fournisseur si configure).
5. Valider: statut **Brouillon**.

### Modifier un brouillon
1. Ouvrir le bon, cliquer **Modifier le brouillon**.
2. Mettre a jour fournisseur, emplacement, lignes, couts, dates ou notes.
3. **Enregistrer en brouillon**.

Seuls les bons **Brouillon** sont modifiables.

### Envoyer le bon au fournisseur
1. Section **Envoyer au fournisseur** sur la fiche.
2. Verifier ou completer l'e-mail du fournisseur.
3. Option: **Me mettre en copie** pour recevoir le PDF.
4. Envoyer: e-mail avec PDF joint; statut **Commande**.

Le passage a **Commande** se fait uniquement via l'envoi reussi.

### Suivi du paiement
Sur la fiche d'un bon **Commande**, **Recu partiellement** ou **Recu**:
- renseigner le **statut de paiement** (non paye, partiel, paye),
- enregistrer les montants et dates de paiement.

### Telecharger le PDF
**Telecharger le PDF** sur la fiche pour une copie locale (meme contenu que l'e-mail fournisseur).

### Receptionner un bon de commande
Disponible lorsque le statut est **Commande** ou **Recu partiellement**:
1. Section **Reception**: quantites recues par ligne, ou **Tout recevoir**.
2. Optionnel: **frais de port** et **ajustements** (repartis sur les lignes recues).
3. Cocher **Mettre a jour le coût produit Shopify a la reception** pour appliquer le COGS pondere.
4. Valider la reception.

Effets:
- le stock augmente a l'emplacement choisi;
- le **coût moyen pondere** est recalcule (stock existant + reception + port + ajustements);
- un historique COGS est conserve sur la fiche;
- statut **Recu** ou **Recu partiellement**.

### Liste et filtres
- Liste avec statut, fournisseur, emplacement, paiement et nombre de lignes.
- Filtres et tri par statut, date, fournisseur.
- Lien tableau de bord **Voir les bons de commande en attente**.

### Statuts des bons de commande
- **Brouillon**: en preparation, modifiable.
- **Commande**: envoye au fournisseur, en attente de reception.
- **Recu partiellement**: reception partielle, reliquat restant.
- **Recu**: reception complete.
- **Annule**: bon annule.

### Inventaires physiques
1. Ouvrir **Inventaires**, creer un nouvel inventaire.
2. Choisir l'**emplacement** et le **perimetre** (**Tous les produits** recommande pour un comptage complet).
3. Les articles suivis a cet emplacement sont charges depuis Shopify.
4. Saisir les **quantites comptees** par ligne.
5. **Enregistrer les comptages**, puis **Appliquer les ajustements** pour synchroniser Shopify.

Statuts: **Brouillon** → **Comptage** → **Applique** (ou **Annule**).

Conseil: si l'inventaire affiche 0 article, recreer avec le perimetre **Tous les produits**.