📦 Guida all'Integrazione dei Magazzini Personalizzati

Questa guida ti mostrerà come integrare il tuo sistema di magazzini e stock con il modulo Estimated Delivery in PrestaShop. Non è necessaria esperienza di programmazione: spiegheremo tutto chiaramente in modo che chiunque possa seguire.

---

📝 Cosa Sono i Magazzini Personalizzati?

In alcuni negozi, i prodotti possono essere spediti da diverse posizioni (magazzini). Ogni magazzino può avere diversi livelli di stock e tempi di spedizione.

Il modulo Estimated Delivery ti consente di collegare il tuo sistema di magazzini utilizzando due semplici hook.

---

🔧 Cosa Devi Fare

Devi creare un piccolo modulo (o utilizzare il nostro esempio) che:

1. Comunichi a Estimated Delivery quali magazzini esistono.
2. Fornisca la quantità di stock di ogni prodotto in ogni magazzino.

---

📌 I Due Hook Che Devi Usare

1. actionEDGetWarehousesList

Questo hook invia un elenco dei tuoi magazzini.

2. actionEDGetWarehouseQuantities

Questo hook invia la quantità di stock di un prodotto, suddivisa per magazzino.

---

📂 Esempio di Output per Ogni Hook

Hook 1: Elenco dei Magazzini

Il tuo modulo deve restituire dati come questi:

[
  [
    'id_warehouse' => 1,
    'name' => 'Magazzino Principale',
    'priority' => 0, // Più basso = priorità più alta
    'default_warehouse' => true, // Solo un magazzino può essere true
    'location' => 'Barcellona'
  ],
  [
    'id_warehouse' => 2,
    'name' => 'Magazzino di Backup',
    'priority' => 1,
    'default_warehouse' => false,
    'location' => 'Madrid'
  ]
];

Nota: Solo un magazzino può avere default_warehouse => true.

---

Hook 2: Quantità di Prodotto per Magazzino

Quando Estimated Delivery richiede lo stock, il tuo modulo deve restituire qualcosa come:

[
  1 => 25,  // Il Magazzino ID 1 ha 25 unità
  2 => 10   // Il Magazzino ID 2 ha 10 unità
];

Cosa Ricevi in $params

Quando questo hook viene chiamato, riceverai:

Chiave	Descrizione
id_product	L'ID del prodotto che PrestaShop sta verificando
id_product_attribute	L'ID della combinazione (0 se il prodotto non ne ha)

---

🚀 Usa il Nostro Modulo di Esempio

Abbiamo creato un modulo pronto all'uso chiamato edcustomwarehouses. Mostra esattamente come utilizzare gli hook con dati di esempio.

Puoi iniziare con questo e sostituire i dati statici con informazioni reali sui magazzini.

Vuoi il modulo? Scarica Qui (Link a ZIP o repository)

---

✅ Lista di Controllo Finale

• Crea o utilizza il modulo di esempio (edcustomwarehouses).
• Registra i due hook richiesti nel tuo modulo:
  • actionEDGetWarehousesList
  • actionEDGetWarehouseQuantities
• Restituisci un elenco di magazzini valido con la struttura corretta:
  • Solo un magazzino deve avere 'default_warehouse' => true.
  • Tutti i magazzini devono avere un id_warehouse univoco.
• Restituisci lo stock corretto del prodotto per magazzino.
• Sostituisci i dati di esempio statici con i tuoi dati dinamici di magazzino e stock.
• Testa e verifica che le stime di consegna vengano visualizzate correttamente nelle pagine prodotto e carrello.

---

Moduli Correlati

Estimated Delivery

Consultalo su 🌐smart-modules.com Consultalo su 🌐PrestaShop Addons

Devo scrivere un modulo completo per usare i magazzini personalizzati?

Hai bisogno di un piccolo modulo PrestaShop che registri i due hook e restituisca i dati corretti. Il modulo di esempio edcustomwarehouses e fornito come punto di partenza pronto all'uso: sostituisci semplicemente i dati statici con le informazioni reali sui tuoi magazzini e stock.

Posso avere piu di due magazzini?

Si. Il hook actionEDGetWarehousesList puo restituire tutti i magazzini necessari. Ognuno deve avere un id_warehouse univoco e un valore di priorita. Solo un magazzino puo avere default_warehouse impostato a true.

Cosa controlla il campo priorita?

La priorita determina quale magazzino il modulo controlla per primo nel calcolo delle stime di consegna. I numeri piu bassi significano priorita piu alta: un magazzino con priorita 0 viene controllato prima di quello con priorita 1. Quando il magazzino con priorita piu alta ha stock sufficiente, il modulo usa le sue impostazioni di consegna.

Cosa succede se un prodotto non ha stock in nessun magazzino?

Se tutti i magazzini restituiscono zero stock per un prodotto e gli ordini in backorder sono abilitati in PrestaShop, il modulo applica le regole di ritardo per prodotti esauriti configurate. Se il backorder non e abilitato, non viene mostrata nessuna stima di consegna.

Magazzini diversi possono avere giorni di preparazione o orari di cutoff diversi?

Si. Ogni magazzino nel tuo elenco puo avere le proprie impostazioni di consegna configurate nel modulo. Il modulo utilizza le impostazioni del magazzino da cui verra spedito il prodotto, determinato dallo stock e dalla priorita.

💬 Hai Bisogno di Aiuto?

Contatta il supporto di Smart Modules - saremo felici di aiutarti!

🌐 Supporto per Acquisti su smart-modules.com 🌐 Supporto per Acquisti sul Marketplace Addons