Leveranszonsvalidering för WooCommerce med postnummer-API

Få min gratis API-nyckel Testa postnummerkontroll

Problemet

WooCommerces inbyggda fraktzoner bygger på manuellt underhållna postnummerlistor som snabbt blir inaktuella. När du börjar leverera till ett nytt område eller slutar leverera till ett annat krävs utvecklartid för att uppdatera listorna. Och när en beställning slinker igenom till ett område du inte täcker, står du för återbetalning och supportkostnad.

Hur Delivery Zone löser det

Koppla Delivery Zone API till WooCommerces fraktprisberäkning. Dina zoner hanteras i en gemensam instrumentpanel, API:et returnerar rätt pris eller avvisningsorsak och WooCommerce visar resultatet i kassan — helt utan manuell redigering av postnummerlistor.

Exempel på API-anrop

# Server-side: check whether a postcode can be delivered to
curl -X POST https://api.deliveryzone.fi/api/v1/delivery/check \
  -H "X-Api-Key: dz_live_..." \
  -H "Content-Type: application/json" \
  -d '{"destinationPostcode":"00100","basketValueCents":4500}'

# Response: in zone
{
  "canDeliver": true,
  "matchedZoneName": "Helsinki Center",
  "priceCents": 590,
  "currency": "EUR",
  "estimatedDeliveryMinutes": 45,
  "reasonCode": "DELIVERABLE"
}

// Server-side only — never expose your API key in browser code
async function checkDelivery(postcode, basketValueCents) {
  const res = await fetch("https://api.deliveryzone.fi/api/v1/delivery/check", {
    method: "POST",
    headers: {
      "X-Api-Key": process.env.DZ_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ destinationPostcode: postcode, basketValueCents }),
  });
  return res.json();
}

// PHP — server-side, keep API key out of frontend
$response = wp_remote_post('https://api.deliveryzone.fi/api/v1/delivery/check', [
  'headers' => [
    'X-Api-Key'      => get_option('dz_api_key'),
    'Content-Type' => 'application/json',
  ],
  'body' => wp_json_encode([
    'destinationPostcode' => $postcode,
    'basketValueCents'    => $basket_cents,
  ]),
]);
$data = json_decode(wp_remote_retrieve_body($response), true);

Exempel på kundmeddelande

Vi levererar tyvärr inte till detta postnummer. Kontrollera postnumret eller välj en annan leveransadress. Ingen debitering har gjorts.

Vem detta är för

WooCommerce-butiksägare

WooCommerce-utvecklare

WordPress-byråer som bygger leveransbutiker

Redo att lägga till postnummervalidering?

Gratis plan. Inget kreditkort. Riktig hjälp med start.

Börja gratis Läs API-dokumentationen

Relaterat

WooCommerce-integrationsguide PHP-integration Användningsfall för kassavalidering