Integrationsguide för WooCommerce

När API:et ska anropas

Anropa API:et inuti filtret woocommerce_package_rates eller woocommerce_cart_shipping_packages — innan fraktpriserna visas för kunden.

Kodexempel

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

Felhantering

När canDeliver är false (eller null) innehåller svaret ett reasonCode-fält. Visa detta för kunden:

• NOT_DELIVERABLE — postnumret ligger utanför dina leveranszoner eller känns inte igen (API:et använder avsiktligt en generell kod för båda för att skydda zongränser)
• MINIMUM_ORDER_NOT_MET — varukorgens värde understiger zonens minsta ordervärde
• BASKET_VALUE_REQUIRED — ett varukorgsvärde krävs för att utvärdera denna destinations regel för minsta order eller fri frakt

Hantera alltid HTTP-fel (5xx, timeout) kontrollerat. Om API:et inte kan nås, använd felsäkert läge — avvisa antingen ordern eller tillåt manuell granskning.

Checklista för implementation

• Spara API-nyckeln i WordPress-inställningar (options), inte i temafiler
• Testa mot en icke-produktionszon innan du lanserar
• Hantera wp_remote_post-fel och timeouts kontrollerat
• Logga oväntade svar för felsökning
• Verifiera beteendet för postnummer utanför zonen före lansering

Relaterat