Käyttökohde

Varauslomakkeiden toimialuetarkistus postinumerolla

Hanki ilmainen API-avain Kokeile postinumerotarkistusta

Ongelma

Palveluyritykset — siivoojat, putkimiehet, muuttofirmat, ikkunanpesijät — vastaanottavat varauksia tietyllä toiminta-alueella. Kun asiakas alueen ulkopuolelta varaa palvelun kaikesta huolimatta, työntekijän täytyy soittaa takaisin peruuttaakseen varauksen. Jokainen peruutus tuhlaa varatun ajan, vie henkilöstön resursseja ja aiheuttaa asiakkaalle pettymyksen.

Miten Delivery Zone ratkaisee sen

Lisää postinumerokenttä varauslomakkeesi alkuun. Kutsu /api/v1/delivery/check ennen varausaikojen tarjoamista. Jos postinumero on toiminta-alueesi ulkopuolella, kerro se asiakkaalle heti — ennen kuin hän valitsee ajan, ennen kuin kalenteriaika varataan ja ennen kuin kenenkään aikaa kuluu hukkaan.

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

Kotipalveluyritykset

Kenttäoperaatioiden tiimit

Siivous-, LVI- ja huoltopalvelut

Toimitus- ja palvelualueisiin perustuvat varausjärjestelmät

Valmis ottamaan postinumerotarkistuksen käyttöön?

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

Aloita ilmaiseksi Lue API-ohjeet

Liittyvät aiheet

JavaScript-integraatio Esimerkki: virheilmoitus asiakkaalle Räätälöidyn kassan opas