Kowal Shipping Rules - estensione Magento 2 per metodi di spedizione, restrizioni di consegna e costi aggiuntivi.
- Compatibilità
- 2.4.9, 2.4.8, 2.4.7, 2.4.6, 2.4.5, 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.7, 2.3.6, 2.3.5, 2.3.4
Descrizione / Kowal Shipping Rules - estensione Magento 2 per metodi di spedizione, restrizioni di consegna e costi aggiuntivi.
MAGENTO 2 · METODI DI CONSEGNA · RESTRIZIONI · EXTRA FEE
Adatta metodi e costi di consegna alla logistica reale.
Kowal Shipping Rules
Crea metodi di spedizione personalizzati, tariffe condizionali e restrizioni. Aggiungi costi per il carrello o per i prodotti corrispondenti e mantieni la loro contabilizzazione in ordine, fattura e nota di credito.
Condizioni Magento Rule UI · Tipi di spedizione dei prodotti · Migrazione Amasty
COME FUNZIONA IN PRATICA
01 · Definisci metodo e tariffe
Selezioni indirizzo, peso, quantità e intervallo del carrello.
02 · Aggiungi restrizioni o un costo
Nascondi il metodo, mostri un errore oppure addebiti una fee.
03 · Verifichi il processo d’ordine
Controlli checkout, fattura e nota di credito.
Cosa ottiene il tuo negozio?
Scopri funzioni, utilizzo e impostazioni del modulo.
Regole di spedizione avanzate per Magento 2
Kowal Shipping Rules permette di riprodurre in Magento 2 la logistica reale del negozio: metodi di consegna personalizzati, tariffe condizionali, limitazioni di disponibilità e costi aggiuntivi.
Invece di correggere manualmente gli ordini dopo l’acquisto, mostra al cliente il metodo e il costo di consegna corretti già durante l’inserimento dell’ordine.
Metodi di consegna personalizzati
Gestisci consegna su pallet, locale, per colli ingombranti, specialistica o altri processi caratteristici della tua attività.
Tariffe condizionali
Crea regole basate su paese, regione, codice postale, valore del carrello, peso e numero di prodotti.
Restrizioni ed Extra Fee
Nascondi le opzioni non disponibili e addebita costi per ingombro, imballaggio, gestione speciale o un metodo specifico.
Un unico punto per la logica di consegna
Unisci metodi, condizioni, restrizioni e costi in un processo coerente. È particolarmente utile per prodotti pesanti o non standard, zone di consegna e negozi con una logistica più complessa.
Come implementare una regola?
- Crea un metodo di consegna.
- Definisci la tariffa e le condizioni di applicazione.
- Aggiungi restrizioni o un costo aggiuntivo, se necessari.
- Testa gli scenari del carrello e gli indirizzi di consegna.
FAQ
Posso creare metodi di spedizione personalizzati?
Sì. Il modulo è progettato per costruire metodi corrispondenti agli scenari logistici reali del negozio.
Le regole possono dipendere dall’indirizzo?
Sì, possono considerare tra l’altro paese, regione e codice postale.
È possibile aggiungere un costo aggiuntivo?
Sì. Extra Fee può riflettere ad esempio il costo di imballaggio, ingombro o gestione speciale.
È possibile nascondere un metodo in determinate condizioni?
Sì. Le restrizioni consentono di limitare la disponibilità dei metodi in base alla configurazione della regola.
Pannello di metodi, restrizioni e costi
Sales → Shipping Methods & Rules rende disponibili Shipping Methods, Shipping Restrictions ed Extra Fees. Attivi il carrier kowal_shippingrules in Sales → Delivery Methods, mentre configuri restrizioni, costi e debug in Sales → Shipping Methods & Rules.
I metodi possono essere limitati per Store View, gruppi clienti e condizioni. L’attributo kowal_shipping_type consente di differenziare la modalità di consegna dei prodotti e l’abbinamento delle tariffe in un carrello misto.
Modalità di costi e restrizioni
Una restrizione può nascondere il metodo o sostituirlo con un errore e un messaggio. Le regole hanno una priorità e un’opzione per interrompere l’ulteriore elaborazione.
Extra Fee supporta fixed e percent_subtotal, oltre all’addebito una volta per carrello, per_item o per_matching_item. L’imposta sul costo dipende da tax_mode e tax_class_id; gli importi passano attraverso quote, order, invoice e creditmemo.
Diagnostica e implementazione del checkout
Il comando kowal:shippingrules:stabilization:check è un controllo senza modifica dei dati. Il log dedicato si trova in var/log/kowal_shipping_rules.log, mentre interruttori separati consentono di disattivare restrizioni o fee.
Il modulo aggiunge il segmento totals kowal_shipping_fee nel checkout standard. Con Hyvä Checkout e un riepilogo personalizzato è necessario collegarne la presentazione e verificare gli importi finali.
Migrazione da Amasty
Il normale funzionamento non richiede Amasty. Gli strumenti amasty:report e amasty:apply gestiscono la migrazione di restrizioni ed Extra Fee tramite report, dry-run e anteprima.
Il salvataggio con --execute include i record ready; manual_review e unsupported restano da analizzare. La migrazione non disattiva i moduli sorgente e non instrada il traffico. Dopo la migrazione verifica la coerenza delle regole e dei risultati del carrello.
Installazione tramite Composer
Pacchetto kowal/module-shipping-rules, modulo Kowal_ShippingRules. Dopo aver configurato l’accesso al repository Kowal, installa il pacchetto, abilita il modulo, aggiorna Magento e svuota la cache. In produzione considera la compilazione e la distribuzione dei contenuti statici secondo il processo del negozio.
Dalla configurazione al risultato
1. Definisci metodo e tariffe
Selezioni indirizzo, peso, quantità e intervallo del carrello.
2. Aggiungi restrizioni o un costo
Nascondi il metodo, mostri un errore oppure addebiti una fee.
3. Verifichi il processo d’ordine
Controlli checkout, fattura e nota di credito.
Consegna per carrelli con ingombri diversi
Contrassegni i prodotti con un tipo di spedizione e prepari le tariffe per i singoli tipi. Il metodo può combinare il risultato come costo più alto, somma o tariffa più bassa.
Un costo condizionale può riflettere un imballaggio aggiuntivo. Verifichi l’importo finale per indirizzo, carrello e metodo selezionato.
Riproduci le regole di consegna del tuo negozio
Vuoi adattare il modulo al tuo negozio? Richiedi l’implementazione di Kowal Shipping Rules e discuti la configurazione o le estensioni necessarie.
Maggiori Informazioni
| Conformità al modello | Luma / Vuoto, Fabbro |
|---|
Istruzioni per l'installazione del modulo
Kowal ShippingRules — istruzioni di installazione, configurazione e utilizzo
Scopo del documento
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 include:
- installazione del modulo,
- configurazione di base,
- creazione dei metodi di spedizione,
- configurazione delle tariffe,
- gestione delle restrizioni dei metodi di consegna,
- gestione dei costi aggiuntivi Extra Fee,
- diagnostica,
- migrazione dai moduli Amasty,
- checklist dei test post-implementazione.
Informazioni di base
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_paletowaRequisiti prima dell’installazione
Prima dell’installazione è necessario confermare che:
- il negozio funziona su Magento 2.4.x,
- l’ambiente utilizza PHP
>=8.1, - il modulo
Kowal_Baseè disponibile, - è stato eseguito un backup di file e database,
- l’implementazione viene eseguita prima in ambiente di test o staging,
- dopo l’installazione sarà possibile eseguire
setup:upgradeesetup:di:compile, - la persona che effettua i test ha accesso al pannello di amministrazione e al checkout.
Installazione del modulo
Installazione tramite Composer
I dati di accesso al repository Composer, ovvero indirizzo e-mail del cliente e token di licenza, vengono inviati via e-mail dopo l’acquisto. Sono disponibili anche nel pannello cliente dopo l’accesso su 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-rules2. Abilita il modulo
bin/magento module:enable Kowal_ShippingRulesSe Kowal_Base non è ancora abilitato, occorre abilitarlo prima o insieme al modulo:
bin/magento module:enable Kowal_Base Kowal_ShippingRules3. Aggiorna il database
bin/magento setup:upgradeQuesto comando crea le tabelle del modulo e aggiunge le colonne necessarie per gestire Extra Fee in quote, order, invoice e creditmemo.
4. Compila DI
In produzione:
bin/magento setup:di:compile5. Svuota la cache
bin/magento cache:flush6. Verifica lo stato del modulo
bin/magento module:status Kowal_ShippingRulesIl modulo dovrebbe trovarsi nell’elenco dei moduli attivi.
Controllo dopo l’installazione
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 l’altro:
- presenza delle tabelle del modulo,
- numero di record,
- JSON delle condizioni non valido,
- metodi attivi senza tariffe attive,
- regole Extra Fee con tax class quando la modalità imposta è disattivata.
Se il comando restituisce errori, il modulo non deve essere passato all’uso in produzione prima che siano chiariti.
Configurazione di base
Carrier
Percorso nel pannello Magento:
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & RulesCampi:
Enabled— abilita o disabilita il carrierkowal_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.
Diagnostica e funzioni di emergenza
Percorso nel pannello Magento:
Stores / Configuration / Sales / Shipping Methods & RulesSezione General Diagnostics:
Enable Debug Logging— salva i dettagli delle decisioni nel log.Shadow Mode— modalità preparata 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à imposta 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 = noneMenu del modulo nel pannello
Percorso:
Sales / Shipping Methods & RulesSezioni disponibili:
Shipping Methods— metodi di spedizione e tariffe,Shipping Restrictions— restrizioni dei metodi di consegna,Extra Fees— costi aggiuntivi.
Gestione dei metodi di spedizione
Quando creare un metodo di spedizione?
È necessario creare un metodo di spedizione quando il negozio ha bisogno di una propria opzione di consegna, ad esempio:
- consegna su pallet,
- trasporto speciale,
- consegna locale,
- corriere per prodotti ingombranti,
- ritiro logistico,
- metodo disponibile solo per prodotti o regioni selezionati.
Creazione del metodo
Vai a:
Sales / Shipping Methods & Rules / Shipping MethodsQuindi seleziona 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:
- usa lettere minuscole,
- non usare caratteri polacchi,
- non usare spazi,
- usa trattini bassi al posto degli spazi.
Esempi:
dostawa_paletowatransport_specjalnykurier_gabarytdostawa_lokalnaIl codice completo del metodo nel checkout avrà il prefisso del carrier:
kowal_shippingrules_dostawa_paletowaTariffe del metodo
Un metodo attivo dovrebbe avere almeno una tariffa attiva. Se il metodo non ha una tariffa corrispondente, non apparirà nel checkout.
La tariffa può dipendere da:
- paese,
- regione,
- codice postale,
- valore del carrello,
- peso,
- quantità di prodotti,
- tipo di spedizione,
- priorità.
Modalità prezzo:
fixed— prezzo fisso,percent_subtotal— percentuale del subtotale.
Esempi:
- prezzo 29 zł per spedizioni fino a 30 kg,
- prezzo 149 zł per consegna su pallet,
- 5% del valore del carrello per trasporto speciale,
- tariffa separata per codici postali selezionati.
Condizioni del metodo
Le condizioni definiscono quando il metodo deve essere disponibile.
Esempi:
- metodo disponibile solo per prodotti di una categoria selezionata,
- metodo disponibile solo con uno specifico attributo prodotto,
- metodo disponibile solo per un carrello superiore a un valore definito,
- metodo disponibile solo per un paese di consegna selezionato.
Se le condizioni sono vuote, il metodo è limitato solo da stato, store view, customer group e tariffa corrispondente.
Gestione delle restrizioni dei metodi di consegna
Quando usare le restrizioni?
Le restrizioni servono a nascondere o bloccare metodi di spedizione che non dovrebbero essere disponibili per uno specifico ordine.
Esempi:
- nascondi il punto di ritiro automatico per prodotti ingombranti,
- blocca la spedizione internazionale per una categoria selezionata,
- mostra un messaggio che il trasporto espresso non è disponibile per prodotti su ordinazione,
- nascondi il metodo di consegna per un paese selezionato.
Creazione di una restrizione
Vai a:
Sales / Shipping Methods & Rules / Shipping RestrictionsQuindi seleziona Add New oppure modifica una restrizione esistente.
Campi tipici:
Is Active— indica se la restrizione è operativa.Name— nome interno.Target Carrier— carrier a cui si applica la restrizione.Target Method— metodo a cui si applica la restrizione.Action— modalità di funzionamento.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 gruppi clienti.Conditions— condizioni di corrispondenza.
Azioni delle restrizioni
hide:
- il metodo verrà nascosto,
- il cliente non lo vedrà,
- adatto per limitazioni evidenti, ad esempio punto di ritiro automatico per colli ingombranti.
error:
- il metodo verrà mostrato come non disponibile,
- il cliente vedrà un messaggio,
- adatto quando vale la pena spiegare il motivo dell’indisponibilità.
Priorità e Stop Processing
Le regole vengono verificate in base alla priorità. Una priorità più alta significa verifica anticipata.
Stop Processing = Yes significa che, dopo la corrispondenza di questa restrizione, il modulo non verifica ulteriori restrizioni per questo metodo.
Raccomandazione:
- usa priorità più alte per regole più specifiche,
- usa priorità più basse per regole generali,
- abilita
Stop Processingse la regola deve decidere definitivamente la disponibilità del metodo.
Gestione di Extra Fee
Quando usare Extra Fee?
Extra Fee serve ad aggiungere costi aggiuntivi all’ordine.
Esempi:
- costo per imballaggio non standard,
- supplemento per trasporto di colli ingombranti,
- costo per prodotti fragili,
- costo logistico per uno specifico metodo di consegna,
- supplemento per regioni selezionate.
Creazione di Extra Fee
Vai a:
Sales / Shipping Methods & Rules / Extra FeesQuindi seleziona Add New oppure modifica un costo esistente.
Campi tipici:
Is Active— indica se la fee è operativa.Name— nome interno.Label— nome del costo visibile nei totals.Target Carrier— carrier a cui si applica la fee.Target Method— metodo a cui si applica la fee.Price Type— tipo di prezzo.Price— valore del costo.Apply Mode— modalità di addebito.Tax Class ID— classe fiscale, se viene utilizzato tax mode.Priority— priorità.Stop Processing— indica se interrompere l’ulteriore addebito delle fee.Store Views— ambito store view.Customer Groups— ambito gruppi clienti.Conditions— condizioni di addebito.
Modalità prezzo
fixed:
- importo fisso,
- ad esempio 19 zł per imballaggio.
percent_subtotal:
- percentuale del valore del carrello,
- ad esempio 3% del valore dell’ordine.
Modalità di addebito
cart:
- un costo per l’intero carrello.
per_item:
- costo moltiplicato per la quantità di prodotti.
per_matching_item:
- costo addebitato solo per i prodotti che soddisfano le condizioni.
Esempio:
Se il costo per una protezione speciale è 5 zł e nel carrello ci sono 3 prodotti che soddisfano la condizione, la modalità per_matching_item addebiterà 15 zł.
Imposta su Extra Fee
Per impostazione predefinita l’imposta su Extra Fee non viene calcolata:
kowal_shippingrules/fees/tax_mode = nonePer calcolare l’imposta:
- Imposta
Fee Tax ModesuCalculate by Fee Tax Class. - Completa
Tax Class IDnella regola Extra Fee. - Testa carrello, order, invoice e creditmemo.
L’imposta su Extra Fee deve essere sempre verificata con la configurazione fiscale dello specifico negozio.
Gestione delle condizioni
Il modulo utilizza un generatore di condizioni simile alle regole Magento.
Le condizioni possono riguardare tra l’altro:
- attributi dei prodotti,
- SKU,
- categorie,
- tipo di prodotto,
- peso,
- prezzo,
- valore del carrello,
- quantità di prodotti,
- paese di consegna,
- regione,
- città,
- codice postale,
- coupon,
- metodo di spedizione selezionato.
Esempio di condizione per un prodotto ingombrante
Presupposto:
- il prodotto ha l’attributo
shipping_type, - il valore per l’ingombro è
pallet.
Regola:
Jeżeli produkt w koszyku ma shipping_type = palletAzioni possibili:
- mostra il metodo
Dostawa paletowa, - nascondi il punto di ritiro automatico,
- aggiungi la fee
Transport gabarytowy.
Raccomandazioni per lavorare con le condizioni
- crea prima una regola semplice e testala nel carrello,
- evita troppe condizioni in una sola regola,
- descrivi le regole con nomi chiari,
- per le regole importanti usa attributi prodotto univoci,
- dopo la modifica degli attributi prodotto testa nuovamente il carrello.
Diagnostica e logging
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:
- non lasciare debug logging sempre attivo in produzione,
- abilita debug solo per il periodo della diagnosi,
- al termine dei test disabilita debug,
- analizza i log insieme al carrello di test e alla configurazione delle regole.
Funzioni di emergenza
Se dopo l’implementazione si verifica un problema, è possibile disabilitare separatamente:
L’intero carrier
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & Rules / Enabled = NoEffetto:
- i metodi del carrier
kowal_shippingrulesnon saranno disponibili.
Solo restrizioni
Stores / Configuration / Sales / Shipping Methods & Rules / Restrictions / Enable Restrictions = NoEffetto:
- i metodi non verranno nascosti o bloccati dalle restrizioni.
Solo Extra Fee
Stores / Configuration / Sales / Shipping Methods & Rules / Extra Fees / Enable Extra Fees = NoEffetto:
- i costi aggiuntivi non verranno addebitati.
Migrazione da Amasty
Scopo della migrazione
La migrazione da Amasty aiuta a trasferire la configurazione di restrizioni ed 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 punto di riferimento durante i test.
Fonti dati supportate
Il migratore analizza:
amasty_shiprestriction_ruleamasty_extrafeeamasty_extrafee_optionTabelle di destinazione:
kowal_shipping_restrictionkowal_shipping_feeRegole di sicurezza della migrazione
La migrazione è stata progettata con cautela:
- il report è read-only,
- dry-run non salva dati,
- apply funziona di default come preview,
- il salvataggio richiede l’opzione esplicita
--execute, - vengono salvati solo i record con stato
ready, - i record
manual_revieweunsupportedvengono ignorati, - la migrazione è idempotente grazie ai campi
migration_sourceemigration_source_key, - la migrazione non disattiva Amasty,
- la migrazione non instrada automaticamente il traffico.
Passaggio 1 — report di base
Esegui:
bin/magento kowal:shippingrules:amasty:reportIl report verrà salvato in:
var/report/kowal_shippingrules_amasty_report.jsonIl report mostra la presenza e la numerosità delle tabelle Amasty e delle tabelle Kowal.
Passaggio 2 — dry-run della trasformazione
Esegui:
bin/magento kowal:shippingrules:amasty:report --dry-run --limit=100Dry-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 analisi manuale,unsupported— il record non è supportato dal migratore automatico.
Se il report contiene molti manual_review o unsupported, queste regole devono essere analizzate prima di apply.
Passaggio 3 — preview apply
Esegui:
bin/magento kowal:shippingrules:amasty:apply --limit=100Questo non salva ancora dati. Il comando mostra quanti record verrebbero creati, ignorati o terminati con errore.
Passaggio 4 — apply delle restrizioni
Dopo l’accettazione della preview:
bin/magento kowal:shippingrules:amasty:apply --type=restrictions --limit=100 --executeIl comando salverà solo le restrizioni con stato ready.
Passaggio 5 — apply di Extra Fee
Dopo l’accettazione della preview:
bin/magento kowal:shippingrules:amasty:apply --type=fees --limit=100 --executeIl comando salverà solo extra fees con stato ready.
Passaggio 6 — diagnostica dopo la migrazione
Esegui:
bin/magento kowal:shippingrules:stabilization:checkControlla anche il pannello:
Sales / Shipping Methods & Rules / Shipping RestrictionsSales / Shipping Methods & Rules / Extra FeesPassaggio 7 — test comparativi con Amasty
Prima di disattivare o sostituire la configurazione Amasty, confronta i risultati per i carrelli di test.
Carrelli consigliati:
- prodotto standard,
- prodotto ingombrante,
- prodotto fragile,
- più prodotti con condizioni diverse,
- ordine con paesi di consegna diversi,
- ordine con codici postali diversi,
- ordine con coupon,
- ordine con metodo selezionato soggetto a Extra Fee.
Per ogni carrello verifica:
- metodi di consegna disponibili,
- metodi nascosti,
- messaggi di errore,
- extra fee addebitata,
- importi lordi/netti, se viene usata tax fee,
- order,
- invoice,
- creditmemo.
Passaggio 8 — decisione di passaggio
Solo dopo l’accettazione dei risultati è possibile pianificare il passaggio della configurazione di produzione.
Raccomandazioni:
- non disattivare Amasty senza backup,
- non eliminare i dati Amasty subito dopo la migrazione,
- prima disattiva il funzionamento lato configurazione,
- mantieni la possibilità di rollback,
- prepara un elenco delle regole che richiedono correzione manuale.
Rollback dopo la migrazione
Se si verifica un problema:
- Disabilita il carrier
Kowal ShippingRules. - Disabilita
Enable Restrictions. - Disabilita
Enable Extra Fees. - Ripristina la configurazione Amasty precedente.
- Verifica il checkout.
- Conserva i report di migrazione per l’analisi.
Checklist post-implementazione
Tecnica
module:statusmostraKowal_ShippingRulescome attivo,setup:upgradeè terminato senza errori,setup:di:compileè terminato senza errori,cache:flusheseguito,stabilization:checknon restituisce errori,- il pannello di amministrazione mostra il menu
Shipping Methods & Rules, - il file di log viene scritto quando debug è attivo.
Configurazione
- il carrier è abilitato,
- è stato creato almeno un metodo di spedizione,
- il metodo attivo ha una tariffa attiva,
- gli store views sono impostati correttamente,
- i customer groups sono impostati correttamente,
- le restrizioni sono abilitate oppure disabilitate consapevolmente,
- extra fees sono abilitate oppure disabilitate consapevolmente,
- tax mode è coerente con la configurazione fiscale del negozio.
Checkout
- il metodo appare per un carrello che soddisfa le condizioni,
- il metodo non appare quando manca una tariffa corrispondente,
- la restrizione
hidenasconde il metodo, - la restrizione
errormostra il messaggio, - extra fee appare nei totals dopo la scelta del metodo,
- la modifica del metodo di spedizione ricalcola la fee,
- order contiene gli importi fee,
- invoice contiene gli importi fee,
- creditmemo rimborsa correttamente la fee.
Problemi più comuni
Il metodo non appare nel checkout
Verifica:
- se il carrier è abilitato,
- se il metodo è attivo,
- se il metodo ha una tariffa attiva,
- se la tariffa corrisponde a paese, regione, codice postale, peso e subtotale,
- se lo store view è corretto,
- se il customer group è corretto,
- se le condizioni del metodo sono soddisfatte,
- se una restrizione non nasconde il metodo.
Extra Fee non viene addebitata
Verifica:
- se
Enable Extra Fees = Yes, - se la fee è attiva,
- se target carrier e target method sono corretti,
- se le condizioni della fee sono soddisfatte,
- se è stato selezionato un metodo di spedizione,
- se il prezzo della fee è maggiore di zero,
- se
Stop Processingdi una regola precedente non ha interrotto l’ulteriore addebito.
La restrizione non funziona
Verifica:
- se
Enable Restrictions = Yes, - se la restrizione è attiva,
- se target carrier e target method sono corretti,
- se le condizioni della restrizione sono soddisfatte,
- se la priorità della regola è corretta,
- se un’altra regola con
Stop Processingnon termina prima l’elaborazione.
L’imposta su Extra Fee non viene calcolata
Verifica:
- se
Fee Tax Mode = Calculate by Fee Tax Class, - se la regola fee ha impostato
Tax Class ID, - se la configurazione fiscale Magento restituisce un’aliquota per l’indirizzo,
- se il carrello ha un indirizzo di consegna,
- se la fee è effettivamente addebitata.
Buone pratiche
- Configura prima regole semplici, poi aggiungi ulteriori condizioni.
- Prepara un carrello di test per ogni regola importante.
- Usa nomi chiari per metodi, restrizioni e fee.
- Evita più regole molto simili con la stessa priorità.
- Documenta nel nome il motivo della creazione della restrizione o della fee.
- Dopo la modifica degli attributi prodotto esegui un test del checkout.
- Abilita debug logging solo durante la diagnosi.
- Esegui la migrazione da Amasty per fasi: report, dry-run, preview, execute, QA.
Documenti correlati
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.