La spedizione in un negozio online raramente è semplice. Le impostazioni standard di Magento funzionano bene in scenari semplici, ma diventano rapidamente insufficienti quando il negozio vende prodotti con dimensioni, pesi, requisiti di trasporto o costi di gestione differenti. In pratica, questo significa dover nascondere determinati metodi di consegna, aggiungere costi per l imballaggio, applicare eccezioni per prodotti specifici e creare regole in base al paese, al valore del carrello o agli attributi del prodotto.
Kowal ShippingRules è stato creato per gestire queste regole in un unico modulo. L estensione unisce tre aree che spesso sono distribuite tra diversi componenti aggiuntivi separati: metodi di spedizione, restrizioni dei metodi di consegna ed extra fee. In questo modo il negozio può gestire la logica di consegna in modo più ordinato e prevedibile.
Il modulo consente di creare metodi di spedizione personalizzati in Magento 2, assegnare loro tariffe, definire quando un metodo deve essere visibile, bloccare le opzioni di consegna non disponibili e aggiungere costi extra solo quando sono giustificati dalle condizioni dell ordine. Le regole possono basarsi sui dati del carrello, sull indirizzo di consegna, sul metodo di spedizione selezionato e sugli attributi dei prodotti.
Il valore principale del modulo è il controllo. L amministratore del negozio può definire regole che adattano automaticamente i metodi di consegna disponibili e i costi al singolo ordine. Il cliente vede opzioni di consegna più pertinenti e il personale del negozio riduce il numero di correzioni manuali dopo l invio dell ordine.
In molti negozi Magento 2 il costo e la disponibilità della consegna dipendono da più fattori rispetto al solo valore del carrello. I prodotti possono differire per peso, dimensioni, modalità di imballaggio, categoria, tipo di trasporto o rischio di danneggiamento. Inoltre il negozio può avere regole diverse per paesi specifici, regioni, CAP, gruppi di clienti o metodi di spedizione.
Senza regole dedicate compaiono problemi tipici:
Kowal ShippingRules mette ordine in queste situazioni. Il modulo consente di trasferire le regole logistiche nel pannello di Magento e applicarle automaticamente durante la selezione della consegna.
Kowal ShippingRules combina la gestione dei metodi di spedizione, delle restrizioni e dei costi aggiuntivi. In questo modo il negozio non deve mantenere un modulo separato per le tabelle tariffarie, un altro per bloccare i metodi di consegna e un ulteriore modulo per extra fee.
Le decisioni possono dipendere dal contenuto del carrello, dagli attributi dei prodotti, dal valore dell ordine, dal peso, dalla quantità di prodotti, dalla località di consegna e dal metodo di spedizione selezionato. Questo consente di costruire scenari logistici reali, non solo semplici tariffe per paese o peso.
Il cliente vede metodi di consegna adatti all ordine. Se un metodo non è disponibile, il negozio può nasconderlo oppure mostrare un messaggio con il motivo dell indisponibilità. Questo riduce il numero di malintesi nella fase finale dell acquisto.
I costi aggiuntivi possono essere applicati solo in casi selezionati: per prodotti voluminosi, delicati, che richiedono un imballaggio speciale o per metodi di consegna specifici. In questo modo il negozio può recuperare i costi logistici che prima erano nascosti nel margine.
Il modulo è stato progettato come soluzione indipendente, ma tiene conto dello scenario di transizione dai moduli Amasty utilizzati per spedizione, restrizioni ed extra fee. Per questo può essere utilizzato come direzione di consolidamento della configurazione di consegna in un unico modulo.
Kowal ShippingRules è destinato ai negozi Magento 2 che hanno bisogno di una maggiore flessibilità nella gestione della consegna rispetto a quella offerta dalla configurazione standard di Magento.
Il modulo sarà particolarmente utile per i negozi che:
Il modulo consente di creare metodi di spedizione gestiti direttamente dal pannello di Magento. Ogni metodo può avere un proprio nome, codice, descrizione, ordinamento, stato di attivazione e condizioni di disponibilità.
Esempi:
Ai metodi possono essere assegnate tariffe dipendenti dai parametri dell ordine. Le tariffe possono essere filtrate tra l altro per paese, regione, CAP, subtotale, peso, quantità di prodotti e tipo di spedizione.
Esempi:
Kowal ShippingRules consente di limitare la disponibilità dei metodi di spedizione. La regola può nascondere un metodo oppure mostrare al cliente un messaggio che indica che una determinata forma di consegna non è disponibile per quell ordine.
Esempi:
Il modulo consente di applicare costi aggiuntivi in base a regole. Extra fee può essere applicato all intero carrello, a ogni singola unità di prodotto oppure ai prodotti che soddisfano condizioni specifiche.
Esempi:
Kowal ShippingRules utilizza il generatore di condizioni noto in Magento. Per chi gestisce il negozio, questo significa un metodo di lavoro simile alla configurazione delle promozioni del carrello: scegli la condizione, l operatore e il valore.
Le condizioni possono riguardare:
Non tutti gli ordini hanno lo stesso costo di gestione logistica. I prodotti voluminosi, delicati o che richiedono un imballaggio speciale generano spesso costi aggiuntivi. Kowal ShippingRules consente di aggiungere questi costi in modo controllato, invece di nasconderli nel margine o gestirli manualmente dopo l ordine.
Se il cliente sceglie un metodo di consegna che non è adatto al prodotto, il negozio deve poi risolvere manualmente il problema. Il modulo limita queste situazioni perché può nascondere i metodi non disponibili già prima dell invio dell ordine.
Invece di rimuovere un metodo senza spiegazioni, il negozio può mostrare un messaggio al cliente. Questo è particolarmente utile quando la limitazione deriva dalle caratteristiche del prodotto, dalla località o dai requisiti di trasporto.
Le regole automatiche riducono il numero di eccezioni gestite dal reparto vendite o dalla logistica. Se il negozio definisce chiaramente le regole di consegna nella fase del carrello, meno casi richiedono correzioni dopo l acquisto.
Metodi, restrizioni e costi aggiuntivi sono collegati tra loro. Gestirli in un unico modulo riduce il rischio di conflitti e facilita il controllo della configurazione.
Il negozio vende prodotti che non possono essere spediti con corriere standard o a un locker. L amministratore può contrassegnare tali prodotti con un attributo e quindi preparare una regola che nasconde il locker, mostra la consegna su pallet e aggiunge un costo per ingombro.
Effetto: il cliente vede subito il metodo di consegna corretto e il negozio non deve contattarlo dopo l acquisto per richiedere un supplemento.
I prodotti che richiedono protezione aggiuntiva possono generare un costo di imballaggio. Il modulo consente di aggiungere il costo solo quando nel carrello è presente un prodotto che soddisfa la condizione.
Effetto: il negozio recupera il costo dell imballaggio e il cliente conosce il prezzo completo prima di inviare l ordine.
Il negozio può rendere disponibile il metodo Dostawa lokalna solo per CAP o regioni selezionati. Per le altre località il metodo non sarà visibile.
Effetto: il cliente non sceglierà una consegna che il negozio non è in grado di effettuare.
Nelle vendite B2B il costo della consegna può dipendere dal gruppo di clienti, dal valore dell ordine, dalla regione o dal tipo di prodotti. Il modulo consente di preparare regole che rispondono meglio alla politica commerciale del negozio.
Effetto: il negozio può applicare regole diverse per diversi tipi di clienti senza mantenere più processi separati.
Alcuni prodotti selezionati potrebbero non essere disponibili per la spedizione all estero. Il modulo consente di limitare i metodi di consegna per paesi specifici o condizioni di prodotto.
Effetto: il negozio riduce il rischio di ordini che non può evadere in conformità al regolamento o alle limitazioni del vettore.
Se il metodo di consegna selezionato genera un costo di gestione aggiuntivo, è possibile collegargli un extra fee.
Effetto: il costo compare solo quando il cliente seleziona un metodo di spedizione specifico.
gabaryt, nascondi il locker.L amministratore del negozio lavora nel pannello di Magento. Prima crea un metodo di spedizione, quindi assegna tariffe e condizioni. Se sono necessarie limitazioni, può aggiungere una restrizione per un metodo specifico o per un gruppo di metodi. Se l ordine deve includere un costo aggiuntivo, l amministratore crea una regola extra fee.
Processo di esempio:
shipping_type = pallet.Magento standard consente di configurare i metodi di consegna di base, ma scenari più complessi richiedono estensioni aggiuntive o modifiche personalizzate.
Il negozio può utilizzare un modulo separato per le tariffe, uno separato per le restrizioni e uno separato per i costi. Il problema è mantenere la coerenza tra le configurazioni.
Kowal ShippingRules concentra metodi, restrizioni ed extra fee in un unico modulo. In questo modo le regole di consegna sono più facili da comprendere, mantenere e testare.
Il modulo non è direttamente uno strumento SEO, ma può supportare indirettamente l esperienza di acquisto, importante per la conversione e la qualità del negozio:
Una migliore gestione della consegna può ridurre il numero di carrelli abbandonati dovuti a costi poco chiari o a metodi di spedizione non disponibili.
| Conformità al modello | Luma / Vuoto, Fabbro |
|---|
Questo documento descrive l’implementazione pratica e l’utilizzo del modulo Kowal_ShippingRules in Magento 2. È destinato alle persone responsabili dell’installazione del modulo, della configurazione del negozio, dei test di implementazione e della gestione quotidiana delle regole di spedizione.
Il documento comprende:
Nome tecnico del modulo:
Kowal_ShippingRulesPosizione del modulo:
vendor/kowal/module-shipping-rulesCodice del carrier:
kowal_shippingrulesIl codice del metodo di spedizione nel checkout ha il formato:
kowal_shippingrules_Esempio:
kowal_shippingrules_dostawa_paletowaPrima dell’installazione è necessario confermare che:
>=8.1,Kowal_Base è disponibile,setup:upgrade e setup:di:compile,Riceverai via e-mail, dopo l’acquisto, i dati di accesso al repository Composer, ovvero l’indirizzo e-mail del cliente e il token di licenza. Sono disponibili anche nell’area cliente dopo l’accesso a kowal.store. Sostituisci TWOJ_EMAIL_KLIENTA con l’indirizzo e-mail del tuo account e TWOJ_TOKEN con il token ricevuto. Esegui i comandi nella directory principale di Magento.
composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/module-shipping-rulesbin/magento module:enable Kowal_ShippingRulesSe Kowal_Base non è ancora abilitato, deve essere abilitato prima oppure insieme al modulo:
bin/magento module:enable Kowal_Base Kowal_ShippingRulesbin/magento setup:upgradeQuesto comando crea le tabelle del modulo e aggiunge le colonne necessarie per gestire Extra Fee in quote, order, invoice e creditmemo.
In produzione:
bin/magento setup:di:compilebin/magento cache:flushbin/magento module:status Kowal_ShippingRulesIl modulo dovrebbe comparire nell’elenco dei moduli attivi.
Dopo l’installazione esegui la diagnostica:
bin/magento kowal:shippingrules:stabilization:checkVariante completa in JSON:
bin/magento kowal:shippingrules:stabilization:check --jsonIl comando è read-only e non modifica i dati. Controlla, tra le altre cose:
Se il comando restituisce errori, non bisogna passare all’utilizzo del modulo in produzione prima di averli chiariti.
Percorso nel pannello Magento:
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & RulesCampi:
Enabled — abilita o disabilita il carrier kowal_shippingrules.Title — nome del gruppo di metodi visibile nel checkout.Test Method Name — nome del metodo di configurazione di test.Test Method Price — prezzo del metodo di configurazione di test.Sort Order — ordine del carrier nell’elenco dei metodi di consegna.Show Method If Not Applicable — indica se mostrare un errore quando non sono disponibili metodi.Displayed Error Message — messaggio quando il metodo non è disponibile.Impostazione più importante:
carriers/kowal_shippingrules/active = 1Se il carrier è disabilitato, i metodi creati nel modulo non saranno disponibili nel checkout.
Percorso nel pannello Magento:
Stores / Configuration / Sales / Shipping Methods & RulesSezione General Diagnostics:
Enable Debug Logging — registra nel log i dettagli delle decisioni.Shadow Mode — modalità predisposta per confrontare il comportamento durante la migrazione.Sezione Restrictions:
Enable Restrictions — abilita o disabilita solo le restrizioni.Sezione Extra Fees:
Enable Extra Fees — abilita o disabilita solo i costi aggiuntivi.Fee Tax Mode — definisce il modo di gestione dell’imposta per Extra Fee.Modalità fiscali disponibili:
Do Not Calculate Tax — il modulo non calcola l’imposta su Extra Fee.Calculate by Fee Tax Class — il modulo calcola l’imposta in base alla classe fiscale impostata sulla regola fee.Impostazioni predefinite e sicure:
kowal_shippingrules/general/debug = 0kowal_shippingrules/general/shadow_mode = 0kowal_shippingrules/restrictions/enabled = 1kowal_shippingrules/fees/enabled = 1kowal_shippingrules/fees/tax_mode = nonePercorso:
Sales / Shipping Methods & RulesSezioni disponibili:
Shipping Methods — metodi di spedizione e tariffe,Shipping Restrictions — restrizioni dei metodi di consegna,Extra Fees — costi aggiuntivi.Un metodo di spedizione deve essere creato quando il negozio necessita di una propria opzione di consegna, ad esempio:
Vai a:
Sales / Shipping Methods & Rules / Shipping MethodsQuindi scegli Add New oppure modifica un metodo esistente.
Campi tipici del metodo:
Is Active — indica se il metodo è attivo.Code — codice tecnico del metodo.Name — nome visibile al cliente.Description — descrizione del metodo.Sort Order — ordine di visualizzazione.Store Views — visibilità per store view.Customer Groups — visibilità per gruppi clienti.Conditions — condizioni di disponibilità del metodo.Raccomandazioni per il campo Code:
Esempi:
dostawa_paletowatransport_specjalnykurier_gabarytdostawa_lokalnaIl codice completo del metodo nel checkout avrà il prefisso del carrier:
kowal_shippingrules_dostawa_paletowaUn metodo attivo dovrebbe avere almeno una tariffa attiva. Se il metodo non ha una tariffa corrispondente, non comparirà nel checkout.
La tariffa può dipendere da:
Modalità prezzo:
fixed — prezzo fisso,percent_subtotal — percentuale sul subtotal.Esempi:
Le condizioni definiscono quando il metodo deve essere disponibile.
Esempi:
Se le condizioni sono vuote, il metodo è limitato solo dallo stato, dalla store view, dal customer group e da una tariffa corrispondente.
Le restrizioni servono a nascondere o bloccare i metodi di spedizione che non dovrebbero essere disponibili per uno specifico ordine.
Esempi:
Vai a:
Sales / Shipping Methods & Rules / Shipping RestrictionsQuindi scegli Add New oppure modifica una restrizione esistente.
Campi tipici:
Is Active — indica se la restrizione è operativa.Name — nome interno.Target Carrier — carrier interessato dalla restrizione.Target Method — metodo interessato dalla restrizione.Action — modalità di azione.Message — messaggio per il cliente.Priority — priorità.Stop Processing — indica se interrompere l’ulteriore verifica delle regole.Store Views — ambito store view.Customer Groups — ambito dei gruppi clienti.Conditions — condizioni di corrispondenza.hide:
error:
Le regole vengono controllate in base alla priorità. Una priorità più alta significa una verifica anticipata.
Stop Processing = Yes significa che, dopo la corrispondenza di questa restrizione, il modulo non controlla ulteriori restrizioni per questo metodo.
Raccomandazione:
Stop Processing se la regola deve determinare definitivamente la disponibilità del metodo.Extra Fee serve ad aggiungere costi supplementari all’ordine.
Esempi:
Vai a:
Sales / Shipping Methods & Rules / Extra FeesQuindi scegli Add New oppure modifica un costo esistente.
Campi tipici:
Is Active — indica se il fee è operativo.Name — nome interno.Label — nome del costo visibile nei totals.Target Carrier — carrier interessato dal fee.Target Method — metodo interessato dal fee.Price Type — tipo di prezzo.Price — valore del costo.Apply Mode — modalità di calcolo.Tax Class ID — classe fiscale, se viene usato tax mode.Priority — priorità.Stop Processing — indica se interrompere l’ulteriore calcolo dei fee.Store Views — ambito store view.Customer Groups — ambito dei gruppi clienti.Conditions — condizioni di applicazione.fixed:
percent_subtotal:
cart:
per_item:
per_matching_item:
Esempio:
Se il costo per una protezione speciale è pari a 5 zł e nel carrello ci sono 3 prodotti che soddisfano la condizione, la modalità per_matching_item calcolerà 15 zł.
Per impostazione predefinita, l’imposta su Extra Fee non viene calcolata:
kowal_shippingrules/fees/tax_mode = nonePer calcolare l’imposta:
Fee Tax Mode su Calculate by Fee Tax Class.Tax Class ID nella regola Extra Fee.L’imposta su Extra Fee dovrebbe essere sempre verificata con la configurazione fiscale dello specifico negozio.
Il modulo utilizza un generatore di condizioni simile alle regole Magento.
Le condizioni possono riguardare, tra l’altro:
Premessa:
shipping_type,pallet.Regola:
Jeżeli produkt w koszyku ma shipping_type = palletAzioni possibili:
Dostawa paletowa,Transport gabarytowy.File di log dedicato:
var/log/kowal_shipping_rules.logIl debug può essere abilitato in:
Stores / Configuration / Sales / Shipping Methods & Rules / General DiagnosticsAbilita:
Enable Debug Logging = YesRaccomandazioni:
Se dopo l’implementazione si verifica un problema, è possibile disabilitare in modo indipendente:
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & Rules / Enabled = NoEffetto:
kowal_shippingrules non saranno disponibili.Stores / Configuration / Sales / Shipping Methods & Rules / Restrictions / Enable Restrictions = NoEffetto:
Stores / Configuration / Sales / Shipping Methods & Rules / Extra Fees / Enable Extra Fees = NoEffetto:
La migrazione da Amasty ha lo scopo di aiutare a trasferire la configurazione delle restrizioni e degli extra fee in Kowal_ShippingRules.
Il modulo Kowal non richiede Amasty per il normale funzionamento. Amasty può essere usato come fonte dei dati di migrazione e come punto di riferimento durante i test.
Il migrator analizza:
amasty_shiprestriction_ruleamasty_extrafeeamasty_extrafee_optionTabelle di destinazione:
kowal_shipping_restrictionkowal_shipping_feeLa migrazione è stata progettata con cautela:
--execute,ready,manual_review e unsupported vengono ignorati,migration_source e migration_source_key,Esegui:
bin/magento kowal:shippingrules:amasty:reportIl report verrà salvato in:
var/report/kowal_shippingrules_amasty_report.jsonIl report mostra la presenza e il numero di record delle tabelle Amasty e delle tabelle Kowal.
Esegui:
bin/magento kowal:shippingrules:amasty:report --dry-run --limit=100Il dry-run prepara il piano di trasformazione, ma non salva nulla.
Stati dei record:
ready — il record può essere trasferito automaticamente,manual_review — il record richiede un’analisi manuale,unsupported — il record non è supportato dal migrator automatico.Se il report contiene molti manual_review o unsupported, queste regole devono essere analizzate prima di apply.
Esegui:
bin/magento kowal:shippingrules:amasty:apply --limit=100Questo comando continua a non salvare dati. Mostra quanti record verrebbero creati, ignorati o conclusi con errore.
Dopo l’approvazione della preview:
bin/magento kowal:shippingrules:amasty:apply --type=restrictions --limit=100 --executeIl comando salverà solo le restrizioni con stato ready.
Dopo l’approvazione della preview:
bin/magento kowal:shippingrules:amasty:apply --type=fees --limit=100 --executeIl comando salverà solo gli extra fees con stato ready.
Esegui:
bin/magento kowal:shippingrules:stabilization:checkControlla anche il pannello:
Sales / Shipping Methods & Rules / Shipping RestrictionsSales / Shipping Methods & Rules / Extra FeesPrima di disabilitare o sostituire la configurazione Amasty, è necessario confrontare i risultati per i carrelli di test.
Carrelli consigliati:
Per ogni carrello verifica:
Solo dopo l’approvazione dei risultati è possibile pianificare il passaggio alla configurazione di produzione.
Raccomandazioni:
Se si verifica un problema:
Kowal ShippingRules.Enable Restrictions.Enable Extra Fees.module:status mostra Kowal_ShippingRules come attivo,setup:upgrade è terminato senza errori,setup:di:compile è terminato senza errori,cache:flush eseguito,stabilization:check non restituisce errori,Shipping Methods & Rules,hide nasconde il metodo,error mostra un messaggio,Controlla:
Controlla:
Enable Extra Fees = Yes,Stop Processing di una regola precedente non ha interrotto l’ulteriore calcolo.Controlla:
Enable Restrictions = Yes,Stop Processing non termina l’elaborazione prima.Controlla:
Fee Tax Mode = Calculate by Fee Tax Class,Tax Class ID impostato,README.md — descrizione tecnica del modulo per sviluppatori.docs/WDROZENIE.md — documentazione dettagliata di implementazione e architettura.docs/OPIS_MARKETINGOWY.md — descrizione marketing del modulo.