Free 15 min initial consultation directly with our experts.
Le plugin Partial Delivery pour Shopware 6 offre aux marchands une solution souple et efficace pour gérer et suivre les livraisons partielles au niveau de chaque ligne de commande. Dans de nombreux cas en e-commerce, tous les produits d’une commande ne sont pas disponibles en même temps, par exemple en raison d’une rupture de stock, d’un retard fournisseur ou d’entrepôts différents. Ce plugin permet de traiter et d’expédier immédiatement les articles disponibles, sans attendre que la commande soit complète.
En répartissant une commande sur plusieurs envois, le plugin aide les entreprises à fluidifier leur logistique et à raccourcir les délais de livraison. Les clients reçoivent au plus vite les articles en stock et restent informés en toute transparence du statut des produits restants. Pour les boutiques en ligne en France qui expédient avec plusieurs transporteurs, comme Colissimo, Chronopost ou DPD, chaque colis conserve son propre numéro de suivi. Cette transparence et cette organisation améliorent l’expérience d’achat et évitent la frustration liée aux longues attentes.
1. Suivi des livraisons partielles
Permet de suivre plusieurs colis par ligne de commande.
Chaque colis dispose de sa propre quantité et de son propre numéro de suivi.
2. Onglet dédié aux expéditions dans l’administration
Ajoute un nouvel onglet « Expédition » dans le détail de la commande.
Affichage et gestion de toutes les livraisons partielles directement dans l’administration.
3. Plusieurs entrées par ligne d’article
Permet d’enregistrer plusieurs livraisons pour le même article.
Idéal pour les réassorts ou les expéditions depuis différents entrepôts.
Prérequis
Avant d’installer et d’utiliser le plugin Partial Delivery, une exigence système essentielle doit être respectée. Le plugin a été conçu spécifiquement pour Shopware Commercial et s’appuie sur des fonctionnalités disponibles uniquement dans cette édition de Shopware. Shopware Commercial doit donc être correctement installé et activé dans votre environnement avant que le plugin Partial Delivery puisse fonctionner normalement. En vérifiant ce prérequis en amont, vous évitez les problèmes de compatibilité et garantissez une installation et une configuration sans accroc.
1. Téléchargement
GIT
git clone https://github.com/solution25com/partial-delivery-shopware-6-solution25.git
composer require solution25/partial-delivery
2. Installer le plugin dans Shopware 6
3. Activer le plugin
4. Vérifier l’installation
Le plugin Partial Delivery ne nécessite aucune configuration particulière après l’installation.
Une fois activé, un onglet « Expédition » est ajouté automatiquement au détail de la commande dans l’administration Shopware.
1. Le client passe une commande
Lorsqu’un client passe une commande, la quantité totale de chaque produit est enregistrée dans la colonne Quantité.
2. L’administrateur crée une expédition
Dans l’onglet « Expéditions » de la commande, l’administrateur peut créer manuellement une expédition en cliquant sur le bouton « Créer une expédition ».
3. Saisir une livraison partielle
Au lieu d’expédier la quantité totale, l’administrateur peut saisir une quantité partielle à expédier (par exemple 5 unités sur 20).
Chaque livraison partielle peut contenir les informations suivantes :
4. Les détails d’expédition sont suivis
Plusieurs colis peuvent ainsi être rattachés à une même commande.
5. Gestion du statut de commande et du fulfillment
Ce document décrit les endpoints personnalisés de l’API Admin fournis par le plugin Partial Delivery pour Shopware 6.
Ces endpoints permettent aux utilisateurs autorisés de créer et de consulter les données de livraison partielle des lignes de commande.
Endpoint
POST /api/_action/partial-shipment-delivery
Description :
Crée une ou plusieurs entrées de livraison partielle pour des
orderLineItemIds
.
Chaque entrée doit contenir :
Le système vérifie que :
Authorization: Bearer
Content-Type: application/json
{
"partialDeliveries": [
{
"orderLineItemId": "0195a178f96b7345ad27051c34609e52",
"quantity": 4,
"package": "Package 6",
"trackingCode": "DHL12sad31e279"
},
{
"orderLineItemId": "0195a3aea0447296bc5377d49ab95c1e",
"quantity": 1,
"package": "Package 2",
"trackingCode": "1234ABCD789"
}
]
}
Réponse en cas de succès
{
"insertedIds": [
"0195a178f96b7345ad27051c34609e52",
"0195a3aea0447296bc5377d49ab95c1e"
],
"skippedItems": []
}
Récupère toutes les livraisons partielles d’une commande donnée, regroupées par ligne de commande.
Chaque résultat contient :
Exemple de requête
GET /api/_action/shipment/5b6a139e54e54ed7b7997c71f6f56f9e
Exemple de réponse
[
{
"lineItemId": "0195a3aea0447296bc5377d49ab95c1e",
"quantityOrdered": 3,
"shipments": [
{
"quantity": 1,
"package": "Package 2",
"trackingCode": "12334ASDAD9",
"createdAt": "2025-05-22T14:36:12+00:00"
}
]
},
{
"lineItemId": "0195a178f96b7345ad27051c34609e52",
"quantityOrdered": 4,
"shipments": [
{
"quantity": 4,
"package": "Package 6",
"trackingCode": "DHL12sad31e279",
"createdAt": "2025-05-22T14:36:12+00:00"
}
]
}
]
🔐Tous les endpoints nécessitent un jeton Bearer valide pour l’API Admin.
Ce jeton s’obtient via le processus d’authentification standard de l’API Admin de Shopware.
L’onglet Expéditions n’apparaît pas dans l’administration ?
Vérifiez que le plugin Partial Delivery est installé et activé.
Vérifiez que l’extension Shopware Commercial est installée et active, car il s’agit d’une dépendance obligatoire.
Recompilez l’interface d’administration avec la commande suivante :
bin/build-administration.sh
Le plugin n’apparaît pas dans les extensions ?
Videz le cache et actualisez la liste des plugins :
bin/console cache:clear bin/console plugin:refresh
Erreur lors de la création d’expéditions ?
Vérifiez que tous les champs obligatoires sont correctement renseignés :
1. Puis-je créer plusieurs expéditions pour le même article ?
Oui. Chaque expédition peut contenir sa propre quantité et ses propres données de suivi.
2. Le nombre d’expéditions par commande est-il limité ?
Non, le plugin n’impose aucune limite fixe. Vous pouvez ajouter autant d’expéditions que nécessaire par article ou par commande.
3. Dois-je installer d’autres plugins pour utiliser les fonctions d’expédition ?
Pour profiter de toutes les fonctionnalités, toutes les dépendances requises, en particulier l’extension Shopware Commercial, doivent être installées et activées.
Lien vers : WIKI