Distance Shipping Problemen Oplossen in Magento 2

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

Klik Test Credentials in configuratie
Voer CLI selftest uit: bin/magento distancebasedshipping:selftest
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

Schakel Debug Mode in via configuratie
Plaats een testorder
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:

Ga naar Shipping Method → Address Not Found
Kies Hide shipping method of Show with message
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:

Ga naar Magmodules → Shipping Costs Based on Distance → Debug & Logging
Zet Debug Mode op Yes
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:

Alle Help Artikelen - Compleet documentatie overzicht

Support:

Contact Opnemen - Hulp van ons team

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