Skip to the beginning of the images gallery

Kowal Shipping Rules - Magento 2 extensie voor verzendmethoden, leveringsrestricties en extra kosten.

€ 61,50 € 50,00

Instalacja COMPOSER

M2-SHIPPING-RULES

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

Verzending in een webshop is zelden eenvoudig. Standaardinstellingen van Magento werken goed bij eenvoudige scenario’s, maar worden al snel onvoldoende wanneer de winkel producten verkoopt met verschillende afmetingen, gewichten, transportvereisten of verwerkingskosten. In de praktijk betekent dit dat bepaalde verzendmethoden verborgen moeten worden, verpakkingskosten moeten worden toegevoegd, uitzonderingen voor specifieke producten moeten worden toegepast en regels moeten worden gemaakt op basis van land, winkelwagenwaarde of productattributen.

Kowal ShippingRules is ontwikkeld om dergelijke regels in één module te beheren. De extensie combineert drie gebieden die vaak over meerdere afzonderlijke add-ons verspreid zijn: verzendmethoden, restricties op leveringsmethoden en extra fee. Hierdoor kan de webshop de verzendlogica op een meer gestructureerde en voorspelbare manier beheren.

De module maakt het mogelijk om eigen verzendmethoden in Magento 2 aan te maken, tarieven eraan toe te wijzen, te bepalen wanneer een methode zichtbaar moet zijn, niet-beschikbare leveringsopties te blokkeren en extra kosten alleen toe te voegen wanneer deze gerechtvaardigd zijn door de bestelvoorwaarden. Regels kunnen gebaseerd zijn op winkelwagengegevens, het afleveradres, de gekozen verzendmethode en productattributen.

De grootste waarde van de module is controle. De webshopbeheerder kan regels definiëren die automatisch de beschikbare verzendmethoden en kosten aanpassen aan een specifieke bestelling. De klant ziet relevantere leveringsopties en de winkeloperatie beperkt het aantal handmatige correcties na het plaatsen van de bestelling.

Probleem dat de module oplost

In veel Magento 2 webshops hangen de kosten en beschikbaarheid van levering af van meer factoren dan alleen de winkelwagenwaarde. Producten kunnen verschillen in gewicht, formaat, verpakkingswijze, categorie, transporttype of risico op beschadiging. Daarnaast kan de webshop andere regels hanteren voor specifieke landen, regio’s, postcodes, klantgroepen of verzendmethoden.

Zonder speciale regels ontstaan typische problemen:

de klant kiest een pakketautomaat voor een product dat er niet in past,
de webshop betaalt mee aan de verzending van zware of volumineuze producten,
de klantenservice moet contact opnemen met de klant nadat de bestelling is geplaatst,
een deel van de regels wordt handmatig buiten Magento onderhouden,
logistieke kosten zijn niet zichtbaar in de winkelwagen vóór aankoop,
verzendmethoden zijn zichtbaar terwijl ze niet beschikbaar zouden moeten zijn,
leveringsregels zijn verspreid over meerdere modules en moeilijk te onderhouden.

Kowal ShippingRules brengt orde in deze situaties. Met de module kunnen logistieke regels naar het Magento-beheerpaneel worden verplaatst en automatisch worden toegepast tijdens de keuze van de levering.

Wat onderscheidt Kowal ShippingRules?

Eén module in plaats van meerdere losse extensies

Kowal ShippingRules combineert het beheer van verzendmethoden, restricties en extra kosten. Daardoor hoeft de webshop geen aparte module te onderhouden voor tarieftabellen, geen afzonderlijke module voor het blokkeren van leveringsmethoden en geen extra module voor extra fee.

Regels gebaseerd op bestelgegevens

Beslissingen kunnen afhangen van de inhoud van de winkelwagen, productattributen, bestelwaarde, gewicht, aantal producten, afleverlocatie en de gekozen verzendmethode. Hierdoor kunnen realistische logistieke scenario’s worden opgebouwd en niet alleen eenvoudige tarieven per land of gewicht.

Meer duidelijkheid voor de klant

De klant ziet verzendmethoden die op de bestelling zijn afgestemd. Als een methode niet beschikbaar is, kan de webshop deze verbergen of een melding tonen met de reden van onbeschikbaarheid. Dit vermindert het aantal misverstanden tijdens het afronden van de aankoop.

Betere controle over operationele kosten

Extra kosten kunnen alleen in geselecteerde gevallen in rekening worden gebracht: voor volumineuze, kwetsbare producten, producten die speciale verpakking vereisen of voor specifieke leveringsmethoden. Zo kan de webshop logistieke kosten terugverdienen die eerder in de marge verborgen waren.

Voorbereid op migratie vanuit Amasty

De module is ontworpen als een onafhankelijke oplossing, maar houdt rekening met het scenario van een overstap vanuit Amasty-modules die worden gebruikt voor verzending, restricties en extra fee. Daardoor kan ze worden ingezet als richting voor het consolideren van de verzendconfiguratie in één module.

Voor wie is deze module?

Kowal ShippingRules is bedoeld voor Magento 2 webshops die meer flexibiliteit nodig hebben in het beheer van levering dan de standaard Magento-configuratie biedt.

De module is vooral nuttig voor webshops die:

zware, kwetsbare, lange, breekbare of volumineuze producten verkopen,
verschillende leveringsregels hebben voor verschillende productcategorieën,
niet-beschikbare verzendmethoden moeten verbergen,
kosten rekenen voor verpakking, speciaal transport of logistieke afhandeling,
eigen leveringsmethoden willen aanmaken zonder telkens ontwikkelwerk,
regels gebruiken die afhangen van productattributen,
de handmatige afhandeling van uitzonderingen na het plaatsen van een bestelling willen beperken,
van plan zijn meerdere modules voor verzending te structureren of te vervangen.

Belangrijkste mogelijkheden

Eigen verzendmethoden aanmaken

Met de module kunnen verzendmethoden worden aangemaakt die rechtstreeks vanuit het Magento-beheerpaneel worden beheerd. Elke methode kan een eigen naam, code, beschrijving, sortering, activiteitsstatus en beschikbaarheidsvoorwaarden hebben.

Voorbeelden:

Palletlevering voor zware producten,
Speciaal transport voor producten die extra beveiliging vereisen,
Koerier voor grote goederen voor geselecteerde categorieën,
Lokale levering voor geselecteerde postcodes,
Logistieke afhaling voor niet-standaardbestellingen.

Verzendtarieven afhankelijk van voorwaarden

Aan methoden kunnen tarieven worden toegewezen die afhangen van bestelparameters. Tarieven kunnen onder meer worden gefilterd op land, regio, postcode, subtotaal, gewicht, aantal producten en verzendtype.

Voorbeelden:

een andere leveringsprijs voor bestellingen boven een bepaald gewicht,
een apart tarief voor geselecteerde landen,
een prijs afhankelijk van de winkelwagenwaarde,
verschillende tarieven voor standaard- en volumineuze producten,
prioriteit van tarieven wanneer meerdere regels tegelijk van toepassing zijn.

Restricties op leveringsmethoden

Kowal ShippingRules maakt het mogelijk de beschikbaarheid van verzendmethoden te beperken. Een regel kan een methode verbergen of de klant een melding tonen dat een bepaalde leveringsvorm niet beschikbaar is voor deze bestelling.

Voorbeelden:

het verbergen van een pakketautomaat voor te grote producten,
het blokkeren van internationale verzending voor geselecteerde producten,
het verbergen van een expresmethode voor bestellingen met producten die extra samenstelling vereisen,
het tonen van de melding: Deze leveringsmethode is niet beschikbaar voor volumineuze producten.

Extra Fee, oftewel extra kosten

De module maakt het mogelijk om extra kosten te berekenen op basis van regels. Extra fee kan worden berekend voor de hele winkelwagen, voor elk productstuk of voor producten die aan specifieke voorwaarden voldoen.

Voorbeelden:

kosten voor niet-standaardverpakking,
kosten voor volumetransport,
toeslag voor producten die extra beveiliging vereisen,
logistieke kosten voor een specifieke leveringsmethode,
toeslag voor bestellingen naar geselecteerde regio’s.

Voorwaarden vergelijkbaar met Magento-regels

Kowal ShippingRules gebruikt een voorwaardenbouwer die bekend is uit Magento. Voor winkelmedewerkers betekent dit een werkwijze die lijkt op de configuratie van winkelwagenpromoties: kies een voorwaarde, operator en waarde.

Voorwaarden kunnen betrekking hebben op:

SKU,
productcategorie,
producttype,
gewicht,
prijs,
geselecteerde productattributen,
winkelwagenwaarde,
aantal producten,
land van levering,
regio,
stad,
postcode,
couponcode,
gekozen verzendmethode.

Zakelijke voordelen

Beperking van verlies op verzending

Niet alle bestellingen kosten evenveel in logistieke afhandeling. Volumineuze, kwetsbare of speciaal te verpakken producten brengen vaak extra kosten met zich mee. Kowal ShippingRules maakt het mogelijk deze kosten gecontroleerd door te berekenen, in plaats van ze in de marge te verbergen of handmatig na de bestelling af te handelen.

Minder foutieve bestellingen

Als een klant een leveringsmethode kiest die niet bij het product past, moet de webshop het probleem later handmatig oplossen. De module beperkt zulke situaties omdat niet-beschikbare methoden al vóór het plaatsen van de bestelling kunnen worden verborgen.

Betere communicatie met de klant

In plaats van een methode zonder uitleg te verwijderen, kan de webshop de klant een melding tonen. Dit is vooral nuttig wanneer de beperking voortkomt uit productkenmerken, locatie of transportvereisten.

Snellere orderverwerking

Automatische regels verminderen het aantal uitzonderingen dat door verkoop of logistiek moet worden afgehandeld. Als de webshop de leveringsregels al in de winkelwagen duidelijk definieert, vereisen minder zaken correctie na aankoop.

Eén plek voor verzendbeheer

Methoden, restricties en extra kosten zijn met elkaar verbonden. Ze in één module onderhouden vermindert het risico op conflicten en maakt de configuratie eenvoudiger te controleren.

Voorbeeldscenario’s

Webshop met volumineuze producten

De webshop verkoopt producten die niet met een standaardkoerier of naar een pakketautomaat kunnen worden verzonden. De beheerder kan zulke producten markeren met een attribuut en vervolgens een regel voorbereiden die de pakketautomaat verbergt, palletlevering toont en een volumetoeslag toevoegt.

Effect: de klant ziet direct de juiste leveringsmethode en de webshop hoeft na aankoop geen contact op te nemen over een toeslag.

Webshop met kwetsbare producten

Producten die extra beveiliging vereisen kunnen verpakkingskosten genereren. Met de module kan een toeslag alleen worden toegevoegd wanneer er een product in de winkelwagen ligt dat aan de voorwaarde voldoet.

Effect: de webshop recupereert de verpakkingskosten en de klant kent de volledige prijs vóór het plaatsen van de bestelling.

Webshop met lokale levering

De webshop kan de methode Lokale levering alleen beschikbaar maken voor geselecteerde postcodes of regio’s. Voor andere locaties zal de methode niet zichtbaar zijn.

Effect: de klant kiest geen levering die de webshop niet kan uitvoeren.

B2B-webshop

In B2B-verkoop kunnen leveringskosten afhangen van klantgroepen, bestelwaarde, regio of producttype. Met de module kunnen regels worden voorbereid die beter aansluiten bij het commerciële beleid van de webshop.

Effect: de webshop kan verschillende regels toepassen voor verschillende klanttypen zonder meerdere aparte processen te onderhouden.

Webshop met internationale levering

Geselecteerde producten zijn mogelijk niet beschikbaar voor internationale verzending. Met de module kunnen leveringsmethoden worden beperkt voor specifieke landen of productvoorwaarden.

Effect: de webshop verkleint het risico op bestellingen die niet kunnen worden uitgevoerd volgens de voorwaarden of beperkingen van de vervoerder.

Toeslag voor een specifieke verzendmethode

Als de gekozen leveringsmethode extra verwerkingskosten met zich meebrengt, kan daaraan extra fee worden gekoppeld.

Effect: de toeslag verschijnt alleen wanneer de klant een specifieke verzendmethode kiest.

Voorbeelden van regels die kunnen worden geconfigureerd

Als het product het attribuut gabaryt heeft, verberg de pakketautomaat.
Als het gewicht van de winkelwagen de vastgestelde limiet overschrijdt, toon palletlevering.
Als het land van levering buiten Polen ligt, verberg geselecteerde methoden.
Als de winkelwagen een product uit de categorie delicate bevat, voeg verpakkingskosten toe.
Als de winkelwagenwaarde lager is dan het vastgestelde bedrag, bereken extra logistieke kosten.
Als de klant speciaal transport kiest, voeg extra fee toe.
Als de postcode niet tot het bediende gebied behoort, verberg lokale levering.
Als de bestelling een product van een bepaald type bevat, toon alleen geselecteerde leveringsmethoden.

Hoe werkt het werken met de module?

De webshopbeheerder werkt in het Magento-paneel. Eerst maakt hij een verzendmethode aan, vervolgens wijst hij tarieven en voorwaarden toe. Als er beperkingen nodig zijn, kan hij een restrictie toevoegen voor een specifieke methode of groep methoden. Als de bestelling extra kosten moet bevatten, maakt de beheerder een extra fee-regel aan.

Voorbeeldproces:

Maak de methode Palletlevering aan.
Voeg een tarief toe voor het land Polen en een gewicht boven een vastgestelde limiet.
Voeg de voorwaarde toe dat de methode van toepassing is op producten met het attribuut shipping_type = pallet.
Voeg een restrictie toe die de pakketautomaat verbergt voor dezelfde producten.
Voeg extra fee toe voor de afhandeling van speciaal transport.
Controleer een testwinkelwagen en bevestig dat de klant de juiste opties ziet.

Vergelijking van de aanpak

Standaard Magento-configuratie

Standaard Magento maakt het mogelijk om basisverzendmethoden te configureren, maar complexere scenario’s vereisen extra extensies of individuele aanpassingen.

Meerdere losse modules

De webshop kan een aparte module gebruiken voor tarieven, een aparte voor restricties en een aparte voor kosten. Het probleem is dan het behouden van consistentie tussen de configuraties.

Kowal ShippingRules

Kowal ShippingRules bundelt methoden, restricties en extra fee in één module. Daardoor zijn leveringsregels makkelijker te begrijpen, te onderhouden en te testen.

Elementen die de SEO van de webshop beïnvloeden

De module is niet direct een SEO-tool, maar kan indirect de winkelervaring ondersteunen, wat belangrijk is voor conversie en winkelkwaliteit:

de klant ziet sneller de werkelijke leveringskosten,
checkout is voorspelbaarder,
minder bestellingen vereisen correctie na aankoop,
de webshop kan logistieke beperkingen duidelijk communiceren,
leveringsregels sluiten beter aan op het productaanbod.

Betere afhandeling van levering kan het aantal verlaten winkelwagens verminderen dat voortkomt uit onduidelijke kosten of niet-beschikbare verzendmethoden.

Installatiehandleiding voor de module

Kowal ShippingRules — handleiding voor installatie, configuratie en gebruik

Doel van het document

Dit document beschrijft de praktische implementatie en het gebruik van de module Kowal_ShippingRules in Magento 2. Het is bedoeld voor personen die verantwoordelijk zijn voor de installatie van de module, de configuratie van de webshop, implementatietests en het dagelijkse beheer van verzendregels.

Het document omvat:

installatie van de module,
basisconfiguratie,
het aanmaken van verzendmethoden,
configuratie van tarieven,
beheer van restricties op leveringsmethoden,
beheer van extra kosten Extra Fee,
diagnostiek,
migratie vanuit Amasty-modules,
checklist van tests na implementatie.

Basisinformatie

Technische modulenaam:

Kowal_ShippingRules

Locatie van de module:

app/code/Kowal/ShippingRules

Carriercode:

kowal_shippingrules

De code van de verzendmethode in checkout heeft het formaat:

kowal_shippingrules_

Voorbeeld:

kowal_shippingrules_dostawa_paletowa

Vereisten vóór installatie

Vóór installatie moet worden bevestigd dat:

de webshop draait op Magento 2.4.x,
de omgeving PHP >=8.1 gebruikt,
de module Kowal_Base beschikbaar is,
een backup van bestanden en database is gemaakt,
de implementatie eerst op een test- of stagingomgeving wordt uitgevoerd,
na installatie setup:upgrade en setup:di:compile kunnen worden uitgevoerd,
de tester toegang heeft tot het beheerpaneel en checkout.

Installatie van de module

1. Upload de module

De module moet zich bevinden in de map:

app/code/Kowal/ShippingRules

2. Schakel de module in

bin/magento module:enable Kowal_ShippingRules

Als Kowal_Base nog niet is ingeschakeld, moet die eerder of samen met de module worden ingeschakeld:

bin/magento module:enable Kowal_Base Kowal_ShippingRules

3. Werk de database bij

bin/magento setup:upgrade

Deze opdracht maakt de moduletabellen aan en voegt kolommen toe die nodig zijn voor Extra Fee in quote, order, invoice en creditmemo.

4. Compileer DI

In productie:

bin/magento setup:di:compile

5. Leeg de cache

bin/magento cache:flush

6. Controleer de modulestatus

bin/magento module:status Kowal_ShippingRules

De module moet in de lijst met actieve modules staan.

Controle na installatie

Voer na installatie de diagnostiek uit:

bin/magento kowal:shippingrules:stabilization:check

Volledige variant in JSON:

bin/magento kowal:shippingrules:stabilization:check --json

De opdracht is read-only en wijzigt geen gegevens. Zij controleert onder meer:

de aanwezigheid van moduletabellen,
het aantal records,
onjuiste JSON van voorwaarden,
actieve methoden zonder actieve tarieven,
Extra Fee-regels met tax class bij uitgeschakelde belastingmodus.

Als de opdracht fouten retourneert, mag de module niet in productie worden genomen voordat deze zijn opgehelderd.

Basisconfiguratie

Carrier

Pad in het Magento-paneel:

Stores / Configuration / Sales / Delivery Methods / Shipping Methods & Rules

Velden:

Enabled — schakelt carrier kowal_shippingrules in of uit.
Title — naam van de methodengroep zichtbaar in checkout.
Test Method Name — naam van de testconfiguratiemethode.
Test Method Price — prijs van de testconfiguratiemethode.
Sort Order — volgorde van de carrier in de lijst met leveringsmethoden.
Show Method If Not Applicable — of een fout moet worden getoond als er geen beschikbare methoden zijn.
Displayed Error Message — melding wanneer de methode niet beschikbaar is.

Belangrijkste instelling:

carriers/kowal_shippingrules/active = 1

Als de carrier is uitgeschakeld, zijn methoden die in de module zijn aangemaakt niet beschikbaar in checkout.

Diagnostiek en noodfuncties

Pad in het Magento-paneel:

Stores / Configuration / Sales / Shipping Methods & Rules

Sectie General Diagnostics:

Enable Debug Logging — slaat details van beslissingen op in het logbestand.
Shadow Mode — modus bedoeld om gedrag tijdens migratie te vergelijken.

Sectie Restrictions:

Enable Restrictions — schakelt alleen restricties in of uit.

Sectie Extra Fees:

Enable Extra Fees — schakelt alleen extra kosten in of uit.
Fee Tax Mode — bepaalt hoe belasting voor Extra Fee wordt afgehandeld.

Beschikbare belastingmodi:

Do Not Calculate Tax — de module berekent geen belasting over Extra Fee.
Calculate by Fee Tax Class — de module berekent belasting volgens de belastingklasse die op de fee-regel is ingesteld.

Standaard, veilige instellingen:

kowal_shippingrules/general/debug = 0kowal_shippingrules/general/shadow_mode = 0kowal_shippingrules/restrictions/enabled = 1kowal_shippingrules/fees/enabled = 1kowal_shippingrules/fees/tax_mode = none

Pad:

Sales / Shipping Methods & Rules

Beschikbare secties:

Shipping Methods — verzendmethoden en tarieven,
Shipping Restrictions — restricties op leveringsmethoden,
Extra Fees — extra kosten.

Beheer van verzendmethoden

Wanneer een verzendmethode aanmaken?

Een verzendmethode moet worden aangemaakt wanneer de webshop een eigen leveringsoptie nodig heeft, bijvoorbeeld:

palletlevering,
speciaal transport,
lokale levering,
koerier voor volumineuze producten,
logistieke afhaling,
een methode die alleen beschikbaar is voor geselecteerde producten of regio’s.

Methode aanmaken

Ga naar:

Sales / Shipping Methods & Rules / Shipping Methods

Kies vervolgens Add New of bewerk een bestaande methode.

Typische methodevelden:

Is Active — of de methode actief is.
Code — technische code van de methode.
Name — naam die zichtbaar is voor de klant.
Description — beschrijving van de methode.
Sort Order — weergavevolgorde.
Store Views — zichtbaarheid per store view.
Customer Groups — zichtbaarheid per klantgroep.
Conditions — voorwaarden voor beschikbaarheid van de methode.

Aanbevelingen voor het veld Code:

gebruik kleine letters,
gebruik geen Poolse tekens,
gebruik geen spaties,
gebruik underscores in plaats van spaties.

Voorbeelden:

dostawa_paletowatransport_specjalnykurier_gabarytdostawa_lokalna

De volledige methodecode in checkout krijgt het carrierprefix:

kowal_shippingrules_dostawa_paletowa

Methodetarieven

Een actieve methode moet ten minste één actief tarief hebben. Als een methode geen passend tarief heeft, verschijnt deze niet in checkout.

Een tarief kan afhangen van:

land,
regio,
postcode,
winkelwagenwaarde,
gewicht,
aantal producten,
verzendtype,
prioriteit.

Prijsmodi:

fixed — vaste prijs,
percent_subtotal — percentage van het subtotaal.

Voorbeelden:

prijs 29 zł voor zendingen tot 30 kg,
prijs 149 zł voor palletlevering,
5% van de winkelwagenwaarde voor speciaal transport,
een apart tarief voor geselecteerde postcodes.

Methodevoorwaarden

Voorwaarden bepalen wanneer een methode beschikbaar moet zijn.

Voorbeelden:

methode alleen beschikbaar voor producten uit een geselecteerde categorie,
methode alleen beschikbaar bij een specifiek productattribuut,
methode alleen beschikbaar voor een winkelwagen boven een bepaalde waarde,
methode alleen beschikbaar voor een geselecteerd land van levering.

Als de voorwaarden leeg zijn, wordt de methode alleen beperkt door status, store view, customer group en een passend tarief.

Beheer van restricties op leveringsmethoden

Wanneer restricties gebruiken?

Restricties worden gebruikt om verzendmethoden te verbergen of te blokkeren die niet beschikbaar mogen zijn voor een specifieke bestelling.

Voorbeelden:

verberg de pakketautomaat voor volumineuze producten,
blokkeer internationale verzending voor een geselecteerde categorie,
toon een melding dat expresvervoer niet beschikbaar is voor op bestelling gemaakte producten,
verberg een leveringsmethode voor een geselecteerd land.

Restrictie aanmaken

Ga naar:

Sales / Shipping Methods & Rules / Shipping Restrictions

Kies vervolgens Add New of bewerk een bestaande restrictie.

Typische velden:

Is Active — of de restrictie actief is.
Name — interne naam.
Target Carrier — carrier waarop de restrictie betrekking heeft.
Target Method — methode waarop de restrictie betrekking heeft.
Action — werkwijze.
Message — melding voor de klant.
Priority — prioriteit.
Stop Processing — of verdere controle van regels moet worden gestopt.
Store Views — bereik van store view.
Customer Groups — bereik van klantgroepen.
Conditions — voorwaarden voor matching.

Restrictieacties

hide:

de methode wordt verborgen,
de klant ziet deze niet,
goed voor duidelijke beperkingen, bijvoorbeeld pakketautomaat voor volumineuze goederen.

error:

de methode wordt als niet beschikbaar getoond,
de klant ziet een melding,
goed wanneer het nuttig is de reden van onbeschikbaarheid uit te leggen.

Prioriteit en Stop Processing

Regels worden gecontroleerd volgens prioriteit. Hogere prioriteit betekent eerdere controle.

Stop Processing = Yes betekent dat de module na matching van deze restrictie geen verdere restricties voor deze methode controleert.

Aanbeveling:

gebruik hogere prioriteiten voor meer specifieke regels,
gebruik lagere prioriteiten voor algemene regels,
schakel Stop Processing in als de regel definitief de beschikbaarheid van de methode moet bepalen.

Beheer van Extra Fee

Wanneer Extra Fee gebruiken?

Extra Fee wordt gebruikt om extra kosten aan de bestelling toe te voegen.

Voorbeelden:

kosten voor niet-standaardverpakking,
toeslag voor volumetransport,
kosten voor kwetsbare producten,
logistieke kosten voor een specifieke leveringsmethode,
toeslag voor geselecteerde regio’s.

Extra Fee aanmaken

Ga naar:

Sales / Shipping Methods & Rules / Extra Fees

Kies vervolgens Add New of bewerk een bestaande toeslag.

Typische velden:

Is Active — of de fee actief is.
Name — interne naam.
Label — naam van de toeslag zichtbaar in totals.
Target Carrier — carrier waarop de fee betrekking heeft.
Target Method — methode waarop de fee betrekking heeft.
Price Type — prijstype.
Price — waarde van de toeslag.
Apply Mode — manier van berekenen.
Tax Class ID — belastingklasse als tax mode wordt gebruikt.
Priority — prioriteit.
Stop Processing — of verdere fee-berekening moet worden gestopt.
Store Views — bereik van store view.
Customer Groups — bereik van klantgroepen.
Conditions — voorwaarden voor berekening.

Prijsmodi

fixed:

vast bedrag,
bijvoorbeeld 19 zł voor verpakking.

percent_subtotal:

percentage van de winkelwagenwaarde,
bijvoorbeeld 3% van de bestelwaarde.

Berekeningsmodi

cart:

één toeslag voor de hele winkelwagen.

per_item:

toeslag vermenigvuldigd met het aantal producten.

per_matching_item:

toeslag alleen berekend voor producten die aan de voorwaarden voldoen.

Voorbeeld:

Als de toeslag voor speciale beveiliging 5 zł bedraagt en er 3 producten in de winkelwagen zitten die aan de voorwaarde voldoen, zal de modus per_matching_item 15 zł berekenen.

Belasting op Extra Fee

Standaard wordt er geen belasting op Extra Fee berekend:

kowal_shippingrules/fees/tax_mode = none

Om belasting te berekenen:

Stel Fee Tax Mode in op Calculate by Fee Tax Class.
Vul Tax Class ID in op de Extra Fee-regel.
Test winkelwagen, order, invoice en creditmemo.

Belasting op Extra Fee moet telkens worden gecontroleerd met de belastingconfiguratie van de betreffende webshop.

Beheer van voorwaarden

De module gebruikt een voorwaardenbouwer die vergelijkbaar is met Magento-regels.

Voorwaarden kunnen onder meer betrekking hebben op:

productattributen,
SKU,
categorieën,
producttype,
gewicht,
prijs,
winkelwagenwaarde,
aantal producten,
land van levering,
regio,
stad,
postcode,
coupon,
gekozen verzendmethode.

Voorbeeld van een voorwaarde voor een volumineus product

Uitgangspunt:

het product heeft het attribuut shipping_type,
de waarde voor volumegoed is pallet.

Regel:

Jeżeli produkt w koszyku ma shipping_type = pallet

Mogelijke acties:

toon de methode Dostawa paletowa,
verberg de pakketautomaat,
voeg fee Transport gabarytowy toe.

Aanbevelingen bij het werken met voorwaarden

maak eerst een eenvoudige regel en test deze in de winkelwagen,
vermijd te veel voorwaarden in één regel,
geef regels duidelijke namen,
gebruik voor belangrijke regels eenduidige productattributen,
test de winkelwagen opnieuw na wijziging van productattributen.

Diagnostiek en logging

Speciaal logbestand:

var/log/kowal_shipping_rules.log

Debug kan worden ingeschakeld in:

Stores / Configuration / Sales / Shipping Methods & Rules / General Diagnostics

Schakel in:

Enable Debug Logging = Yes

Aanbevelingen:

laat debug logging niet permanent ingeschakeld op productie,
schakel debug alleen in tijdens diagnose,
schakel debug uit na afronding van de tests,
analyseer logs samen met de testwinkelwagen en de configuratie van regels.

Noodfuncties

Als er na implementatie een probleem optreedt, kunnen onafhankelijk worden uitgeschakeld:

Volledige carrier

Stores / Configuration / Sales / Delivery Methods / Shipping Methods & Rules / Enabled = No

Effect:

methoden van carrier kowal_shippingrules zijn niet beschikbaar.

Alleen restricties

Stores / Configuration / Sales / Shipping Methods & Rules / Restrictions / Enable Restrictions = No

Effect:

methoden worden niet verborgen of geblokkeerd door restricties.

Alleen Extra Fee

Stores / Configuration / Sales / Shipping Methods & Rules / Extra Fees / Enable Extra Fees = No

Effect:

extra kosten worden niet berekend.

Migratie vanuit Amasty

Doel van de migratie

Migratie vanuit Amasty moet helpen om de configuratie van restricties en extra fee over te zetten naar Kowal_ShippingRules.

De Kowal-module vereist Amasty niet voor normaal gebruik. Amasty kan worden gebruikt als bron van migratiegegevens en als referentiepunt tijdens tests.

Ondersteunde gegevensbronnen

De migrator analyseert:

amasty_shiprestriction_ruleamasty_extrafeeamasty_extrafee_option

Doeltabellen:

kowal_shipping_restrictionkowal_shipping_fee

Veiligheidsregels voor migratie

De migratie is zorgvuldig ontworpen:

het rapport is read-only,
dry-run slaat geen gegevens op,
apply werkt standaard als preview,
opslaan vereist de expliciete optie --execute,
alleen records met status ready worden opgeslagen,
records manual_review en unsupported worden overgeslagen,
de migratie is idempotent dankzij de velden migration_source en migration_source_key,
de migratie schakelt Amasty niet uit,
de migratie schakelt verkeer niet automatisch om.

Stap 1 — basisrapport

Voer uit:

bin/magento kowal:shippingrules:amasty:report

Het rapport wordt opgeslagen in:

var/report/kowal_shippingrules_amasty_report.json

Het rapport toont de aanwezigheid en aantallen van Amasty-tabellen en Kowal-tabellen.

Stap 2 — dry-run van de transformatie

Voer uit:

bin/magento kowal:shippingrules:amasty:report --dry-run --limit=100

Dry-run bereidt het transformatieplan voor, maar slaat niets op.

Recordstatussen:

ready — record kan automatisch worden overgezet,
manual_review — record vereist handmatige analyse,
unsupported — record wordt niet ondersteund door de automatische migrator.

Als het rapport veel manual_review of unsupported bevat, moeten deze regels vóór apply worden geanalyseerd.

Stap 3 — preview apply

Voer uit:

bin/magento kowal:shippingrules:amasty:apply --limit=100

Ook dit slaat nog geen gegevens op. De opdracht toont hoeveel records zouden worden aangemaakt, overgeslagen of met een fout zouden eindigen.

Stap 4 — apply van restricties

Na goedkeuring van de preview:

bin/magento kowal:shippingrules:amasty:apply --type=restrictions --limit=100 --execute

De opdracht slaat alleen restricties op met status ready.

Stap 5 — apply van Extra Fee

Na goedkeuring van de preview:

bin/magento kowal:shippingrules:amasty:apply --type=fees --limit=100 --execute

De opdracht slaat alleen extra fees op met status ready.

Stap 6 — diagnostiek na migratie

Voer uit:

bin/magento kowal:shippingrules:stabilization:check

Controleer ook het paneel:

Sales / Shipping Methods & Rules / Shipping RestrictionsSales / Shipping Methods & Rules / Extra Fees

Stap 7 — vergelijkingstests met Amasty

Voordat de Amasty-configuratie wordt uitgeschakeld of vervangen, moeten de resultaten voor testwinkelwagens worden vergeleken.

Aanbevolen winkelwagens:

standaardproduct,
volumineus product,
kwetsbaar product,
meerdere producten met verschillende voorwaarden,
bestelling met verschillende landen van levering,
bestelling met verschillende postcodes,
bestelling met coupon,
bestelling met een geselecteerde methode waarop Extra Fee van toepassing is.

Controleer voor elke winkelwagen:

beschikbare verzendmethoden,
verborgen methoden,
foutmeldingen,
berekende extra fee,
bruto/netto bedragen als tax fee wordt gebruikt,
order,
invoice,
creditmemo.

Stap 8 — beslissing over omschakeling

Pas na goedkeuring van de resultaten kan de omschakeling van de productieconfiguratie worden gepland.

Aanbevelingen:

schakel Amasty niet uit zonder backup,
verwijder Amasty-gegevens niet direct na migratie,
schakel de werking eerst uit aan de configuratiekant,
behoud de mogelijkheid tot rollback,
maak een lijst van regels die handmatige correctie vereisen.

Rollback na migratie

Als er een probleem optreedt:

Schakel carrier Kowal ShippingRules uit.
Schakel Enable Restrictions uit.
Schakel Enable Extra Fees uit.
Herstel de bestaande Amasty-configuratie.
Controleer checkout.
Bewaar migratierapporten voor analyse.

Checklist na implementatie

Technisch

module:status toont Kowal_ShippingRules als actief,
setup:upgrade is zonder fouten voltooid,
setup:di:compile is zonder fouten voltooid,
cache:flush uitgevoerd,
stabilization:check retourneert geen fouten,
het beheerpaneel toont het menu Shipping Methods & Rules,
het logbestand wordt geschreven wanneer debug is ingeschakeld.

Configuratie

carrier is ingeschakeld,
er is ten minste één verzendmethode aangemaakt,
de actieve methode heeft een actief tarief,
store views zijn correct ingesteld,
customer groups zijn correct ingesteld,
restricties zijn ingeschakeld of bewust uitgeschakeld,
extra fees zijn ingeschakeld of bewust uitgeschakeld,
tax mode komt overeen met de belastingconfiguratie van de webshop.

Checkout

de methode verschijnt voor een winkelwagen die aan de voorwaarden voldoet,
de methode verschijnt niet wanneer er geen passend tarief is,
restrictie hide verbergt de methode,
restrictie error toont een melding,
extra fee verschijnt in totals na het kiezen van de methode,
wijziging van verzendmethode herberekent de fee,
order bevat fee-bedragen,
invoice bevat fee-bedragen,
creditmemo restitueert fee correct.

Meest voorkomende problemen

Methode verschijnt niet in checkout

Controleer:

of de carrier is ingeschakeld,
of de methode actief is,
of de methode een actief tarief heeft,
of het tarief past bij land, regio, postcode, gewicht en subtotaal,
of de store view correct is,
of de customer group correct is,
of aan de methodevoorwaarden is voldaan,
of een restrictie de methode niet verbergt.

Extra Fee wordt niet berekend

Controleer:

of Enable Extra Fees = Yes,
of de fee actief is,
of target carrier en target method correct zijn,
of aan de fee-voorwaarden is voldaan,
of een verzendmethode is gekozen,
of de fee-prijs groter is dan nul,
of Stop Processing van een eerdere regel verdere berekening niet heeft gestopt.

Restrictie werkt niet

Controleer:

of Enable Restrictions = Yes,
of de restrictie actief is,
of target carrier en target method correct zijn,
of aan de restrictievoorwaarden is voldaan,
of de prioriteit van de regel correct is,
of een andere regel met Stop Processing de verwerking niet eerder beëindigt.

Belasting op Extra Fee wordt niet berekend

Controleer:

of Fee Tax Mode = Calculate by Fee Tax Class,
of de fee-regel een ingestelde Tax Class ID heeft,
of de Magento-belastingconfiguratie een belastingtarief voor het adres retourneert,
of de winkelwagen een afleveradres heeft,
of de fee daadwerkelijk wordt berekend.

Best practices

Configureer eerst eenvoudige regels en voeg daarna extra voorwaarden toe.
Maak voor elke belangrijke regel een testwinkelwagen aan.
Gebruik duidelijke namen voor methoden, restricties en fee.
Vermijd meerdere zeer vergelijkbare regels met dezelfde prioriteit.
Documenteer de reden voor het aanmaken van een restrictie of fee in de naam.
Voer na wijziging van productattributen een checkouttest uit.
Schakel debug logging alleen in tijdens diagnose.
Voer migratie vanuit Amasty gefaseerd uit: rapport, dry-run, preview, execute, QA.

Gerelateerde documenten

README.md — technische beschrijving van de module voor ontwikkelaars.
docs/WDROZENIE.md — gedetailleerde implementatiedocumentatie en architectuur.
docs/OPIS_MARKETINGOWY.md — marketingbeschrijving van de module.

Vragen en antwoorden

Vraag

Co robi Kowal ShippingRules?

Antwoord

Kowal ShippingRules pozwala zarządzać metodami wysyłki, restrykcjami dostawy i dodatkowymi opłatami w Magento 2. Reguły mogą zależeć od koszyka, produktów, adresu dostawy i wybranej metody wysyłki.

Vraag

Czy moduł pozwala tworzyć własne metody wysyłki?

Antwoord

Tak. Moduł umożliwia tworzenie metod wysyłki w panelu Magento i przypisywanie do nich stawek oraz warunków dostępności.

Vraag

Czy można ukrywać metody dostawy?

Antwoord

Tak. Moduł może ukryć metodę dostawy, jeśli zamówienie nie spełnia określonych warunków. Może też pokazać komunikat, że metoda nie jest dostępna.

Vraag

Czy można doliczać extra fee?

Antwoord

Tak. Extra fee może być naliczane dla całego koszyka, każdej sztuki produktu albo tylko dla produktów spełniających warunki.

Vraag

Czy reguły restrykcji mogą działać na atrybutach produktów?

Antwoord

Tak. Reguły mogą uwzględniać atrybuty produktów, SKU, kategorię, typ produktu, wagę, cenę i inne dane dostępne w koszyku.

Vraag

Czy moduł obsługuje produkty gabarytowe?

Antwoord

Tak. To jeden z głównych scenariuszy użycia. Moduł może ukryć niedostępne metody dostawy i doliczyć opłatę za transport gabarytowy.

Vraag

Czy moduł nadaje się do sklepów B2B?

Antwoord

Tak. Sklepy B2B często potrzebują reguł zależnych od wartości koszyka, grup klientów, regionów dostawy lub typów produktów. Moduł wspiera takie scenariusze.

Vraag

Czy moduł zastępuje kilka osobnych rozszerzeń?

Antwoord

W wielu przypadkach tak. Kowal ShippingRules łączy funkcje metod wysyłki, restrykcji i dodatkowych opłat.

Vraag

Czy obsługa sklepu może pracować z modułem bez programisty?

Antwoord

Tak, bieżące reguły można konfigurować w panelu Magento. Programista jest potrzebny głównie przy wdrożeniu, testach technicznych i ewentualnych integracjach z niestandardowym checkoutem.