Verzendkosten op basis van afstand

Versie v1.8.2
Platform Magento 2
Uitgebracht 4 November 2025

Probleemoplossing Verzendkosten Extensie

Oplossingen voor veelvoorkomende problemen met de Verzendkosten op basis van afstand extensie.

Verzendmethode Wordt Niet Getoond

Controleer Basis Configuratie

  • Module Ingeschakeld: Magmodules → Shipping Costs Based on Distance → General → Enabled = Yes
  • Verzendmethode Ingeschakeld: Shipping Method → Name and Position → Enabled = Yes
  • API Key Ingesteld: General → API and Location Details → API Key is ingevuld
  • Winkeladres Ingesteld: General → API and Location Details → Store Address is ingevuld

Controleer Limiet Regels

  • Land: Staat het land van de klant in de toegestane landenlijst?
  • Afstand: Is de klant binnen de maximale afstandslimiet?
  • Orderbedrag: Voldoet de order aan de minimale orderbedrag vereiste?

Controleer Product Condities

Als condities zijn ingeschakeld:

  • Zijn alle winkelwagen producten geschikt voor afstand-gebaseerde verzending?
  • Als je "Toon alleen voor geschikte producten" gebruikt, zorg dat producten voldoen aan criteria
  • Check het productattribuut gebruikt voor geschiktheid

Test de API Verbinding

  1. Klik Test Credentials in configuratie
  2. Voer CLI selftest uit: bin/magento distancebasedshipping:selftest
  3. Check of API key geldig is en juiste rechten heeft

Verkeerde Verzendprijs Berekend

Verifieer Prijstabel

  • Check dat afstandsbereiken geen gaten hebben
  • Zorg dat de afstand van de klant binnen een gedefinieerd bereik valt
  • Review vaste prijs en per-km tarief instellingen

Controleer Afrond Instellingen

  • Round Distance: Beïnvloedt de afstand gebruikt in berekeningen
  • Round Total Price: Beïnvloedt de uiteindelijke getoonde prijs

Review Prijslimieten

  • Minimal Price: Wordt de berekende prijs verhoogd naar minimum?
  • Maximum Price: Wordt de berekende prijs begrensd?

Controleer Gratis Verzending

  • Is gratis verzending ingeschakeld?
  • Voldoet de order aan de gratis verzending drempel?

Debug de Berekening

  1. Schakel Debug Mode in via configuratie
  2. Plaats een testorder
  3. Check logs in var/log/ voor berekeningsdetails

API Fouten

"API key not valid"

  • Verifieer dat de key correct is gekopieerd zonder extra spaties
  • Check dat de key bestaat in Google Cloud Console
  • Zorg dat de key niet is verwijderd of opnieuw gegenereerd

"Distance Matrix API has not been used"

  • Schakel Distance Matrix API in voor je Google Cloud project
  • Wacht enkele minuten na inschakelen
  • Verifieer dat je het juiste project gebruikt

"REQUEST_DENIED"

  • Check API key restricties in Google Cloud Console
  • Verifieer dat facturering is ingesteld op het project
  • Zorg dat server IP is gewhitelist (als IP restrictie is ingeschakeld)

"OVER_QUERY_LIMIT"

  • Je hebt je API quota overschreden
  • Wacht tot quota reset (dagelijks/maandelijks)
  • Overweeg je Google Cloud plan te upgraden

"ZERO_RESULTS"

  • Google kan geen route vinden tussen adressen
  • Verifieer dat winkeladres geldig en vindbaar is
  • Klantadres kan incompleet of ongeldig zijn

"INVALID_REQUEST"

  • Winkel- of klantadres is verkeerd geformatteerd
  • Check adresformaat in configuratie
  • Zorg dat adres alle vereiste componenten bevat

Adres Niet Gevonden Problemen

Winkeladres Problemen

  • Test je winkeladres direct in Google Maps
  • Gebruik volledig adresformaat: straat, stad, postcode, land
  • Vermijd postbusadressen
  • Gebruik geen speciale karakters

Klantadres Problemen

Configureer fallback gedrag:

  1. Ga naar Shipping Method → Address Not Found
  2. Kies Hide shipping method of Show with message
  3. Stel een helpvolle foutmelding in voor klanten

Verzendschatting op Productpagina

Wordt Niet Getoond

  • Check dat Add Shipping Estimation to Product Page is ingeschakeld
  • Flush cache na inschakelen
  • Verifieer dat het productpagina template het schatting blok ondersteunt

Toont Verkeerde Prijs

  • Productpagina schatting gebruikt alleen ingevoerde postcode
  • Volledig adres bij checkout kan andere afstand opleveren
  • Dit is verwacht gedrag

Performance Problemen

Trage Checkout

  • Afstandsberekening voegt API latency toe
  • Schakel caching in indien beschikbaar
  • Overweeg een dichtstbijzijnde Google Cloud regio

Hoge API Kosten

  • Monitor gebruik in Google Cloud Console
  • Stel budget alerts in
  • Review of onnodige API calls worden gemaakt

Cache Problemen

Na configuratie wijzigingen:

bin/magento cache:flush

Voor hardnekkige problemen:

bin/magento cache:clean
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Debug Modus

Schakel gedetailleerde logging in:

  1. Ga naar Magmodules → Shipping Costs Based on Distance → Debug & Logging
  2. Zet Debug Mode op Yes
  3. Klik Save Config

Logs worden geschreven naar var/log/. Zoek naar:

  • API request/response details
  • Afstandsberekening stappen
  • Prijsberekening uitsplitsing
  • Eventuele fouten of waarschuwingen

Let op: Schakel debug modus uit in productie om loggrootte te beperken.

Selftest

Voer de ingebouwde diagnose uit:

bin/magento distancebasedshipping:selftest

De selftest controleert:

  • Module configuratie
  • API connectiviteit
  • Vereiste instellingen
  • Veelvoorkomende misconfiguraties

Veelvoorkomende Scenario's

Verzending Toont voor Sommige Klanten, Niet Anderen

  • Check afstandslimieten - sommige klanten kunnen te ver zijn
  • Verifieer land restricties
  • Check of klantadres vindbaar is door Google

Prijs Anders Dan Verwacht

  • Review de prijstabel en berekeningsmethode
  • Check welk afstandsbereik van toepassing is
  • Verifieer afrond instellingen
  • Zoek naar min/max prijslimieten

Methode Verdwenen Na Werken

  • API key kan zijn verlopen of verwijderd
  • Facturering kan zijn uitgeschakeld op Google Cloud
  • Configuratie kan zijn gewijzigd
  • Voer selftest uit om te diagnosticeren

Meer Hulp Nodig?

Documentatie:

Support:

Bij contact met support, inclusief:

  • Magento en extensie versie
  • Selftest resultaten
  • Debug log fragmenten (indien van toepassing)
  • Screenshots van configuratie
  • Stappen om het probleem te reproduceren
Aangemaakt:
Bijgewerkt:
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025
star star star star star
star star star star star
R. U.
Erg goed team, reageren snel en duidelijk en hebben met toegang tot onze database erg goed geholpen (eigenlijk een gratis customization).
Google 18 Jun 2025
star star star star star
star star star star star
Hugo de Groot
Uitstekende support! Wij gebruiken o.a. de Rich Snippets Suite extensie voor onze Magento 2 webshop (Hyvä) en hadden een specifieke vraag over structured data op PLP-pagina’s. Binnen no-time kregen we een inhoudelijk en duidelijk antwoord. Zeer prettig contact en goed onderbouwde uitleg. Absoluut een betrouwbare partner voor Magento-extensies!
Google 13 Jun 2025