Validering av serviceområde i bokningsformulär med postnummer

Få min gratis API-nyckel Testa postnummerkontroll

Problemet

Tjänsteföretag — städfirmor, rörmokare, flyttfirmor, fönsterputsare — tar emot bokningar inom ett avgränsat verksamhetsområde. När en kund utanför området ändå bokar måste en medarbetare ringa upp och avboka. Varje avbokning slösar bort en tid, tar upp arbetstid och gör kunden besviken.

Hur Delivery Zone löser det

Lägg till ett postnummerfält i början av ditt bokningsformulär. Anropa /api/v1/delivery/check innan lediga tider erbjuds. Om postnumret ligger utanför ditt område, informera kunden direkt — innan hen väljer tid, innan en lucka blockeras och innan någons tid slösas bort.

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

Hemtjänst- och hantverksföretag

Fältorganisationer

Städ-, VVS- och serviceföretag

Bokningssystem med geografiska verksamhetsområden

Redo att lägga till postnummervalidering?

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

Börja gratis Läs API-dokumentationen

Relaterat

JavaScript-integration Exempel: visa felmeddelande för kunden Guide för anpassad kassa