Expéditions Lots/Séries – Export des expéditions avec leurs lots et numéros de série

Logo du module Expéditions Lots/Séries

Expéditions Lots/Séries – Export des expéditions avec leurs lots et numéros de série

Documentation du module · version 23.0.0 · éditeur NSINFO

1. Présentation

Expéditions Lots/Séries ajoute à l’assistant d’export de Dolibarr un profil prêt à l’emploi qui exporte vos expéditions avec leurs lots et leurs numéros de série. Le fichier obtenu contient une ligne par produit expédié : le lot ou le numéro de série, la quantité, le client, l’adresse de livraison, le suivi du colis, les poids et les volumes.

Il sert à la traçabilité (qui a reçu quel lot), aux déclarations, aux échanges avec un transporteur ou un logiciel de gestion. Le module ne modifie pas le cœur de Dolibarr et n’ajoute aucune page : il s’utilise depuis l’export standard.

2. Prérequis et installation

2.1 Prérequis

  • Dolibarr 20 à 24, PHP 7.4 à 8.3.
  • Le framework NSINFO (gratuit), version 23.9.10 ou supérieure, installé et activé.
  • Les modules Expéditions et Commandes clients de Dolibarr activés ; la gestion des lots / séries activée sur les produits concernés.

2.2 Installation

  1. Installez et activez le framework NSINFO (gratuit).
  2. Installez le module « Expéditions Lots/Séries » dans le dossier des modules externes de Dolibarr, comme décrit sur la page Installer un module.
  3. Activez-le dans Accueil > Configuration > Modules. L’activation est refusée si le framework NSINFO est absent, inactif ou trop ancien.
Module Expéditions Lots/Séries activé dans la liste des modules
Le module activé dans la liste des modules (version 23.0.0).

3. Configuration

Le module n’a aucun réglage propre : il suffit de l’activer. Sa page de configuration affiche seulement les onglets habituels des modules NSINFO : Réglages, Traduction (si votre Dolibarr est multilingue), Sauvegarde des paramètres, ChangeLog et À propos.

Si l’option de Dolibarr permettant d’ajouter les contacts des expéditions à l’export est active, les champs du contact (identifiant, nom, prénom, note) sont proposés en plus dans l’assistant.

4. Droits d’accès

Le module utilise le droit d’export des expéditions de Dolibarr : un utilisateur doit pouvoir exporter les expéditions pour voir et lancer ce profil.

5. Utilisation

5.1 Lancer l’export

  1. Ouvrez le menu « Outils » puis « Exports ».
  2. Dans l’assistant, choisissez le lot de données Expéditions et Lots/Séries.
  3. Cochez les champs voulus et choisissez leur ordre ; vous pouvez enregistrer ce choix comme profil d’export.
  4. Ajoutez au besoin des filtres, choisissez le format du fichier, puis lancez la génération.
Lot de données Expéditions et Lots/Séries dans l'assistant d'export
Le lot de données « Expéditions et Lots/Séries » proposé dans l’assistant d’export.

Une ligne est produite par ligne d’expédition. Si une ligne a plusieurs lots ou numéros de série, chacun donne sa propre ligne avec sa quantité.

5.2 Champs proposés

FamilleChamps
TiersIdentifiant, nom, adresse, code postal, ville, département, pays et code pays, téléphone, identifiants professionnels (SIREN, SIRET, APE et les suivants)
ExpéditionIdentifiant, référence, référence client, date de création, date prévue de livraison, numéro de suivi, hauteur, largeur, profondeur, unité de taille, poids, unité de poids, statut, note publique
Ligne d’expéditionIdentifiant de ligne, description, quantité expédiée
ProduitIdentifiant, référence, libellé, poids, unité de poids, volume, unité de volume
Lot / sérieNuméro de lot ou de série
Contact (si l’option est active)Identifiant, nom, prénom, note publique
Attributs supplémentairesCeux de l’expédition, de la ligne d’expédition et du produit, proposés automatiquement
Liste des champs exportables
Extrait de la liste des champs exportables (produit, lot / série).

5.3 Filtres et formats

Les filtres de l’assistant s’appliquent sur le nom du client, l’adresse, le code postal, la ville, le pays, la référence, les dates de création et de livraison, le statut, la quantité et le numéro de lot ou de série. Les formats disponibles sont ceux de l’export standard de Dolibarr (CSV, Excel, etc.).

6. Limites connues et FAQ

  • Le lot du produit est vide. Le produit n’a pas la gestion par lots / séries, ou aucun lot n’a été choisi à l’expédition.
  • Le profil n’apparaît pas dans l’assistant. Vérifiez que le module est activé et que vous avez le droit d’exporter les expéditions.
  • Une expédition apparaît plusieurs fois. C’est normal : une ligne est produite par ligne d’expédition et par lot.
  • L’activation du module est refusée. Le framework NSINFO doit être installé, activé et à jour.
  • Les données sont-elles envoyées à l’extérieur ? Non, tout reste dans votre Dolibarr.

Un projet Dolibarr ? Parlons-en.

Développement d’un module, paramétrage, migration ou simple question : nous vous répondons rapidement.

Powered by Joinchat