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

# Gestion des commandes

> Créer, suivre et gérer les commandes de matériel médical.

# Gestion des commandes

Le module **Commandes** centralise toutes les commandes de matériel médical. Il permet aux administrateurs et commerciaux de gérer le cycle de vie complet des commandes, tandis que les clients peuvent suivre leurs propres commandes.

## Accéder au module

Cliquez sur **Commandes** dans le menu latéral. Un badge rouge indique le nombre de commandes avec le statut **Nouvelle** (non traitées).

## La liste des commandes

### Colonnes affichées

Le tableau affiche par défaut les informations suivantes :

| Colonne               | Visible | Description                                        | Rôle             |
| --------------------- | ------- | -------------------------------------------------- | ---------------- |
| Référence             | Oui     | Numéro unique de la commande                       | Tous             |
| Date                  | Oui     | Date de création de la commande                    | Tous             |
| Prescripteur / Aidant | Oui     | Nom du client                                      | Admin/Commercial |
| Statut                | Oui     | État actuel de la commande                         | Tous             |
| Total HT              | Oui     | Montant hors taxes                                 | Tous             |
| Total TTC             | Oui     | Montant toutes taxes comprises                     | Tous             |
| Must G5               | Non     | Statut de synchronisation avec le logiciel Must G5 | Admin/Commercial |

### Personnaliser les colonnes

Cliquez sur l'icône **Paramètres** en haut à droite du tableau pour afficher/masquer les colonnes. Vos préférences sont automatiquement sauvegardées.

### Ligne étendue (détails inline)

Cliquez sur une ligne pour afficher les détails de la commande :

* **Commentaire** : Si un commentaire a été ajouté lors de la création
* **Tableau produits** : Affiche pour chaque article :
  * Référence produit
  * Désignation complète
  * Quantité commandée
  * Prix unitaire HT
  * Montant total HT
* **Totaux** :
  * Total HT
  * Frais de livraison
  * Frais d'urgence
  * Total TTC

## Filtrer et rechercher

### Filtres disponibles

| Filtre                | Type                     | Disponible pour  |
| --------------------- | ------------------------ | ---------------- |
| Prescripteur / Aidant | Dropdown                 | Admin/Commercial |
| Référence             | Texte libre              | Tous             |
| Statut                | Dropdown multi-sélection | Tous             |
| Du                    | Date                     | Tous             |
| Au                    | Date                     | Tous             |

### Utiliser les filtres

<Steps>
  <Step title="Sélectionner les filtres">
    Les filtres s'affichent dans un encart avec bordure au-dessus du tableau.
  </Step>

  <Step title="Appliquer automatiquement">
    Les filtres s'appliquent immédiatement sans bouton de validation.
  </Step>

  <Step title="Réinitialiser">
    Cliquez sur le bouton **Réinitialiser les filtres** pour retrouver toutes les commandes.
  </Step>
</Steps>

### Pagination

Le tableau affiche **15 commandes par page**. La pagination fonctionne via l'URL pour permettre de partager ou bookmarker une page spécifique.

* **Mobile** : Affiche "X / Y" (exemple : "2 / 5")
* **Desktop** : Affiche les numéros de page avec ellipsis (...) si nécessaire

## Actions par rôle

### Pour les administrateurs et commerciaux

| Action                                 | Description                                                         |
| -------------------------------------- | ------------------------------------------------------------------- |
| **Scinder**                            | Diviser la commande en deux (articles disponibles vs indisponibles) |
| **Modifier le statut**                 | Changer le statut de la commande                                    |
| **Voir PDF**                           | Télécharger le reçu/facture de la commande                          |
| **Supprimer**                          | Supprimer définitivement la commande                                |
| **Synchroniser avec logiciel externe** | Envoyer/mettre à jour dans votre système externe (si actif)         |

### Pour les clients

| Action                       | Disponibilité                                     | Description                             |
| ---------------------------- | ------------------------------------------------- | --------------------------------------- |
| **Voir PDF**                 | Si statut ≠ Annulée et articles présents          | Télécharger le document                 |
| **Dupliquer vers le panier** | Si le catalogue est actif et correspond au client | Copier dans le panier pour modification |
| **Supprimer**                | Si statut = Nouvelle uniquement                   | Supprimer la commande avant traitement  |

## Scinder une commande

La division d'une commande est utile lorsque certains articles ne sont pas disponibles immédiatement.

<Steps>
  <Step title="Cliquer sur Scinder">
    Depuis le menu d'actions d'une commande, sélectionnez **Scinder la commande**.
  </Step>

  <Step title="Remplir le tableau de division">
    Pour chaque article, indiquez :

    * **Quantité disponible** : articles à livrer immédiatement
    * **Quantité indisponible** : articles bloqués

    Les colonnes affichent : Réf, Désignation, Total commandé, Champs de quantité.
  </Step>

  <Step title="Ajouter un commentaire (optionnel)">
    Saisissez un commentaire pour expliquer la division (ex : "Rupture de stock temporaire").
  </Step>

  <Step title="Confirmer la division">
    Cliquez sur **Scinder**. La division se fait de la manière suivante :

    * Nouvelle commande 1 : statut = **En préparation**, contient articles disponibles
    * Nouvelle commande 2 : statut = **En reliquat**, contient articles indisponibles
    * La commande originale est supprimée
  </Step>
</Steps>

### Notifications après scission

Le client reçoit automatiquement :

* **Notification dans l'app** : "Votre commande a été divisée."
* **Email** : Si cette option est activée pour ce client dans les paramètres

<Note>
  La division crée deux commandes complètement indépendantes. Modifiez les statuts séparément selon l'avancement.
</Note>

## Synchronisation avec votre logiciel externe

Si votre entreprise utilise un logiciel externe pour gérer les commandes, la synchronisation automatique est disponible.

### Bouton de synchronisation

Un bouton **Synchroniser avec logiciel externe** s'affiche en haut à droite du tableau si :

* La synchronisation est activée dans Configuration
* Il existe des commandes à synchroniser
* Vous êtes administrateur ou commercial

Le libellé affiche le nombre : "Synchroniser (5)"

### Fonctionnalité de synchronisation

Cliquez sur le bouton pour :

1. **Envoyer les nouvelles commandes** vers votre logiciel externe
2. **Récupérer les mises à jour de statut** depuis ce logiciel

### Statut de synchronisation

La colonne **Must G5** affiche :

* **Vide** : Commande locale, non synchronisée
* **Synchronisée** : Envoyée vers Must G5
* **Erreur** : La synchronisation a échoué
* **Auto** : Statut géré automatiquement par Must G5 (lecture seule)

Consultez [la page Configuration](/mad/configuration) pour plus de détails sur la synchronisation.

<Warning>
  Si le statut est en mode **Auto**, vous ne pouvez pas le modifier manuellement. Modifiez-le directement dans votre logiciel externe.
</Warning>

### Toast de confirmation

Après la synchronisation, un message affiche :
"X/Y commandes envoyées • Z statuts mis à jour"

## Statuts des commandes

Consultez [la page dédiée aux statuts](/mad/commandes/statuts) pour comprendre le cycle de vie complet d'une commande.

## Recherche avancée

### Rechercher par référence

Utilisez le filtre **Référence** pour chercher une commande spécifique. La recherche supporte les caractères spéciaux (tirets, etc.).

### Filtrer par période

Utilisez les filtres **Du** et **Au** pour afficher les commandes d'une plage de dates précise. Laissez vide pour ignorer un filtre.

### Combiner les filtres

Tous les filtres se combinent (tous doivent être vrais). Par exemple :

* Prescripteur = "Pharmacie Martin" ET Statut = "En préparation" ET Période = "Janvier 2025"

## Accès pour les clients

Les clients voient uniquement leurs propres commandes. Ils peuvent :

* Consulter l'historique de leurs commandes
* Télécharger les documents
* Dupliquer une commande vers le panier
* Supprimer les commandes en statut "Nouvelle"

## Badge de notification

Un badge rouge dans le menu latéral indique le nombre de **commandes dans le statut "Nouvelle"** (nécessitant un traitement). Ce badge est visible uniquement pour les administrateurs et commerciaux.

Cliquez sur le badge pour filtrer automatiquement les commandes avec le statut "Nouvelle".

## Conseils pratiques

<AccordionGroup>
  <Accordion title="Créer une commande pour un client">
    Allez dans le module Catalogue, sélectionnez les articles, et passez la commande directement depuis le panier. Vous devez spécifier le client et le patient concernés.
  </Accordion>

  <Accordion title="Dupliquer une commande existante">
    Les clients peuvent dupliquer leurs propres commandes vers le panier pour les modifier. Les administrateurs créent des copies manuellement en consultant le détail et en créant une nouvelle commande identique.
  </Accordion>

  <Accordion title="Exporter en PDF">
    Cliquez sur l'action **Voir PDF** pour afficher ou télécharger le document de la commande. Ce document inclut tous les articles, les totaux et les frais associés.
  </Accordion>

  <Accordion title="Gérer les erreurs de synchronisation">
    Si une commande affiche l'état "Erreur" de synchronisation, cliquez sur le symbole d'erreur pour voir le message détaillé. Corrigez le problème dans l'app et relancez la synchronisation.
  </Accordion>
</AccordionGroup>
