Shopify-toimitusalueiden tarkistus postinumero-API:lla

Hanki ilmainen API-avain Kokeile postinumerotarkistusta

Ongelma

Shopifyn omat toimitusalueet ovat karkeita — ne toimivat maan ja alueen tasolla, eivät suomalaisten postinumeroiden tarkkuudella. Jos toimitat vain tietyille postinumeroalueille, Shopifyn oletusasetukset joko sallivat liikaa (hyväksyen tilauksia, joita et voi toimittaa) tai vaativat monimutkaisia kiertoteitä.

Miten Delivery Zone ratkaisee sen

Kutsu Delivery Zone API:a Shopifyn taustajärjestelmästä (mukautettu sovellus, Shopify Functions tai checkout-laajennus) ennen kuin tilaus vahvistetaan. Rajapinta palauttaa selkeän toimituspäätöksen ja vyöhykekohtaisen hinnan, jonka voit näyttää kassan käyttöliittymässä.

Esimerkki API-pyynnöstä

# 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);

Esimerkkiviesti asiakkaalle

Emme valitettavasti toimita tälle postinumeroalueelle. Tarkista postinumero tai valitse toinen toimitusosoite. Tilaustasi ei ole veloitettu.

Kenelle tämä sopii

Shopify-kauppiaat Suomessa

Shopify-kehittäjät

Shopify-toimistot, jotka rakentavat räätälöityjä kassaprosesseja

Valmis ottamaan postinumerotarkistuksen käyttöön?

Ilmainen aloitus. Ei luottokorttia. Aito käyttöönottoapu.

Aloita ilmaiseksi Lue API-ohjeet

Liittyvät aiheet

Shopify-integraatio-opas Kassan tarkistuksen käyttökohde API-dokumentaatio