Widget

«Levert i morgen»-badge

Én linje kode — vis automatisk leveringsstatus for Helthjem og Bring direkte på produktsidene dine.

Forhåndsvisning

Norsk (standard)
Engelsk

Kom i gang på 3 minutter

  1. Opprett en Fraktklar-konto og registrer merchant slug

    Logg inn og send en POST-forespørsel til /api/delivery-sla/setup med ønsket slug for butikken din:

    curl -X POST https://fraktklar.com/api/delivery-sla/setup \
      -H "Authorization: Bearer <din-jwt-token>" \
      -H "Content-Type: application/json" \
      -d '{
        "merchant_slug": "din-butikk",
        "brand_color": "#1a1a2e",
        "carrier": "helthjem"
      }'
  2. Legg til script-taggen på produktsiden

    Lim inn følgende linje der du vil at leveringsbadgen skal vises:

    HTML
    <script src="https://fraktklar.com/widgets/levert-i-morgen.js"
            data-merchant="din-butikk"></script>
    Tips: Badgen vises automatisk etter script-taggen. Vil du velge nøyaktig plassering, legg til data-fk-badge på et valgfritt element — widgeten monteres der i stedet.
  3. Det er alt!

    Widgeten laster leveringsstatus fra Fraktklar og skjuler seg automatisk dersom tilgjengeligheten er ukjent. Ingen feilmeldinger vises til sluttkunder.

Data-attributter

Attributt Påkrevd Beskrivelse
data-merchant Ja Merchant slug registrert via /api/delivery-sla/setup (kun a–z, 0–9, bindestrek).
data-lang Nei no (standard) viser «Levert i morgen». en viser «Delivered tomorrow».
data-color Nei Hex-farge (#rrggbb) som overstyrer brand_color fra API-et. Eks: #0B1A2E.
data-api-base Nei Alternativ API-base-URL. Standard: https://fraktklar.com. Nyttig for testing lokalt.

Postnummer-basert status

Legg til ?postal_code=XXXX på SLA-endepunktet for sonebasert leveringsstatus. Widgeten sender ikke postnummer automatisk — du kan hente det fra et skjemafelt og kalle API-et direkte fra din egen frontend:

fetch('https://fraktklar.com/api/delivery-sla/din-butikk?postal_code=0158')
  .then(r => r.json())
  .then(data => console.log(data.status)); // "TOMORROW"

API-responsformat

Endepunktet GET /api/delivery-sla/:merchant_slug returnerer alltid HTTP 200 for kjente merchants:

{
  "merchant_slug": "din-butikk",
  "merchant_name": "Din Butikk AS",
  "status":        "TOMORROW",       // eller "N_DAYS:2" eller "N_A"
  "cutoff_time":   "22:00",
  "carrier":       "helthjem",
  "brand_color":   "#1a1a2e"
}

Ukjente slugs returnerer HTTP 404 med {"status":"N_A"} — widgeten skjuler seg uten feil.

English quick reference

Drop the badge onto any page with a single script tag. Use data-lang="en" for English text. The widget self-hides on N_A status or network errors — no error is shown to shoppers.

<script src="https://fraktklar.com/widgets/levert-i-morgen.js"
        data-merchant="your-store"
        data-lang="en"
        data-color="#0B1A2E"></script>

Statusverdier

StatusNorsk tekstEngelsk tekst
TOMORROW Levert i morgen Delivered tomorrow
N_DAYS:2 Levert innen 2 virkedager Delivered within 2 working days
N_A Badge skjules — ingenting vises til kunden