Il plugin Partial Delivery per Shopware 6 offre ai merchant, anche in Italia, un modo flessibile ed efficiente per gestire e tracciare le consegne parziali delle singole righe d’ordine. In molti scenari e-commerce non tutti i prodotti di un ordine sono disponibili nello stesso momento, ad esempio per carenze di magazzino, ritardi dei fornitori o sedi di magazzino diverse. Questo plugin consente di elaborare e spedire subito gli articoli disponibili, senza attendere la disponibilità completa dell’intero ordine.
Grazie alla possibilità di suddividere gli ordini in più spedizioni, il plugin aiuta le aziende a garantire processi logistici fluidi e tempi di consegna più rapidi, ad esempio con corrieri come Poste Italiane, BRT o GLS Italy. I clienti ricevono il prima possibile gli articoli disponibili e restano informati in modo trasparente sullo stato dei prodotti rimanenti. Questo livello di trasparenza e organizzazione migliora l’intera esperienza d’acquisto e riduce la frustrazione dovuta a lunghe attese.
1. Tracciare le consegne parziali
Consente di tracciare più colli per ogni riga d’ordine.
Ogni collo ha una propria quantità e un proprio numero di spedizione.
2. Scheda dedicata alle spedizioni nell’amministrazione
Aggiunge una nuova scheda “Spedizione” nella vista di dettaglio dell’ordine.
Visualizzazione e gestione di tutte le consegne parziali direttamente nell’area di amministrazione.
3. Più registrazioni per ogni riga articolo
Supporta la registrazione di più spedizioni per lo stesso articolo.
Ideale per casi come riordini o spedizioni da magazzini diversi.
Prerequisiti
Prima di installare e utilizzare il plugin Partial Delivery è importante tenere conto di un requisito di sistema essenziale. Il plugin è stato sviluppato specificamente per Shopware Commercial Edition e si basa su funzionalità disponibili esclusivamente in questa versione di Shopware. Shopware Commercial deve quindi essere installato e attivato correttamente nel Suo ambiente prima che il plugin Partial Delivery possa funzionare. Verificando in anticipo questo prerequisito si evitano problemi di compatibilità e si garantisce un’installazione e una configurazione senza intoppi.
1. Download
GIT
git clone https://github.com/solution25com/partial-delivery-shopware-6-solution25.git
composer require solution25/partial-delivery
2. Installare il plugin in Shopware 6
3. Attivare il plugin
4. Verificare l’installazione
Dopo l’installazione il plugin Partial Delivery non richiede alcuna configurazione particolare.
Una volta attivato, nella vista di dettaglio dell’ordine dell’amministrazione Shopware viene aggiunta automaticamente la scheda “Spedizione”.
1. Il cliente effettua un ordine
Quando un cliente effettua un ordine, la quantità completa di ogni prodotto viene registrata nella colonna Quantità.
2. L’amministratore crea una spedizione
Dalla scheda “Spedizioni” dell’ordine l’amministratore può creare manualmente una spedizione cliccando sul pulsante “Crea spedizione”.
3. Registrare una consegna parziale
Invece di spedire l’intera quantità, l’amministratore può inserire una quantità parziale da spedire (ad es. solo 5 unità su 20).
Ogni consegna parziale può contenere le seguenti informazioni:
4. I dettagli della spedizione vengono tracciati
In questo modo più colli possono essere collegati a un singolo ordine.
5. Gestione dello stato d’ordine e dell’evasione
Questo documento descrive gli endpoint Admin API personalizzati messi a disposizione dal plugin Partial Delivery per Shopware 6.
Questi endpoint consentono agli utenti autorizzati di creare e recuperare i dati delle consegne parziali relativi alle righe d’ordine.
Endpoint
POST /api/_action/partial-shipment-delivery
Descrizione:
Crea una o più registrazioni di consegna parziale per specifici
orderLineItemIds
.
Ogni registrazione deve contenere:
Il sistema verifica che:
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"
}
]
}
Risposta corretta
{
"insertedIds": [
"0195a178f96b7345ad27051c34609e52",
"0195a3aea0447296bc5377d49ab95c1e"
],
"skippedItems": []
}
Recupera tutte le consegne parziali di un determinato ordine, raggruppate per riga d’ordine.
Ogni risultato contiene:
Esempio di richiesta
GET /api/_action/shipment/5b6a139e54e54ed7b7997c71f6f56f9e
Esempio di risposta
[
{
"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"
}
]
}
]
🔐Tutti gli endpoint richiedono un bearer token Admin API valido.
Il token si ottiene tramite il processo di autenticazione standard della Shopware Admin API.
La scheda Spedizioni non è visibile nell’amministrazione?
Verifichi che il plugin Partial Delivery sia installato e attivato.
Controlli che l’estensione Shopware Commercial sia installata e attiva, poiché è una dipendenza obbligatoria.
Ricompili l’interfaccia di amministrazione con il seguente comando:
bin/build-administration.sh
Il plugin non compare tra le estensioni?
Svuoti la cache e aggiorni l’elenco dei plugin:
bin/console cache:clear bin/console plugin:refresh
Errori nella creazione delle spedizioni?
Verifichi che tutti i campi obbligatori siano compilati correttamente:
1. Posso creare più spedizioni per lo stesso articolo?
Sì. Ogni registrazione di spedizione può avere una propria quantità e propri dati di tracciamento.
2. Esiste un limite al numero di spedizioni per ordine?
No, il plugin non impone un limite fisso. Può aggiungere tutte le registrazioni di spedizione necessarie per articolo o per ordine.
3. Devo installare altri plugin per usare le funzioni di spedizione?
Per sfruttare tutte le funzionalità devono essere installate e attivate tutte le dipendenze richieste, in particolare l’estensione Shopware Commercial. Per un supporto all’installazione nel Suo shop in Italia, solution25 è a disposizione.
Link a: WIKI