size-advisor

Storleksradgivare for svensk e-handel. Modulen sitter inbaddad i produktsidans storleksvaljare (PDP-widget) eller anropas fran kundtjanstchatten. Den tar emot kundens matt, eventuella tidigare kop hos handlaren och produktens size_chart, och returnerar en strukturerad rekommendation pa svenska som frontend kan rendera utan ytterligare bearbetning.

Modul-ID ar size-advisor. Version 1.0.0. Voice-profil kapaciti. Default modell claude-haiku-4-5. Modulen extender BaseModule och deltar i samma signerade audit-kedja som ovriga compliance-moduler i kapaciti-modules.

Affarsfall

Storleksrelaterade returer star for narmare halften av all retur i svensk e-handel inom mode och konfektion. En genomsnittlig retur kostar handlaren mellan 250 och 400 kronor inklusive frakt, ompaketering och hantering. Utover det belastar varje retur miljon med transport och emballage.

Pilotinforanden visar att en rekommendationsmotor med tillrackligt mycket indata, framfor allt kundens historik hos den specifika handlaren, kan sanka storleksreturerna med 25 till 30 procent. Det innebar for en mellanstor handlare med 100 000 ordrar per ar och 15 procent retur en arsbesparing pa omkring 1,5 till 2 miljoner kronor.

Modulens designprincip ar att hellre under-lova passform an over-lova. En kund som blir positivt overraskad behaller plagget. En kund som blir besviken returnerar och tappar fortroende for handlaren.

Indata

Inputen ar ett strukturerat objekt med fyra delar.

{
  session_id: "sess-2026-05-19-7af2",
  product: {
    sku: "JNS-SLIM-DARK-32",
    name: "Slim-fit jeans, mork indigo",
    category: "jeans",
    brand: "NordWear",
    size_chart: [
      { size: "30", measurements: { waist_cm: 78, length_cm: 80 } },
      { size: "32", measurements: { waist_cm: 82, length_cm: 82 } },
      { size: "34", measurements: { waist_cm: 86, length_cm: 84 } }
    ],
    fit: "slim"
  },
  customer: {
    measurements: { height_cm: 182, weight_kg: 78, waist_cm: 84 },
    prior_purchases: [
      { brand: "NordWear", size: "32", kept: false, reason_returned: "for trang i midjan" },
      { brand: "Acne Studios", size: "33", kept: true }
    ]
  },
  customer_locale: "sv-SE"
}

product.size_chart maste innehalla minst en rad. Varje rad behover ett storleksnamn och nagot relevant matt. customer.measurements maste innehalla minst ett av height_cm, weight_kg, chest_cm, waist_cm. prior_purchases ar valfritt men hojer rekommendationskvaliteten markant nar det finns historik mot samma varumarke.

Validering sker innan modellen anropas. Saknas obligatoriska falt kastas ett tydligt felmeddelande utan att kostnaden for ett LLM-anrop dras.

Utdata

Utdatat ar en strikt textmall som kan parsas av frontend eller analytics pipeline. Modellen instrueras att aldrig avvika fran formatet och att aldrig skriva nagot utanfor de definierade falten.

REKOMMENDERAD_STORLEK: 34
PASSFORM_KONFIDENS: medel
ALTERNATIVA_STORLEKAR: 32
PASSFORM_NOTERING:
Din midja ar 84 cm, vilket ligger over storlek 32 (82 cm) och precis under storlek 34 (86 cm).
Din tidigare retur av storlek 32 fran samma varumarke bekraftar att 32 ar for trang for dig.
RISK_FAKTORER:
- Slim fit i denna kategori sitter typiskt 2-3 cm tightare an regular fit.
RETUR_SANNOLIKHET: lag

PASSFORM_KONFIDENS ar en av hog, medel, lag. RETUR_SANNOLIKHET likasa. Konfidensen sanks automatiskt vid gles data. Om kundens historik saknas eller om size_chart inte har midjematt for jeans flaggas det explicit istallet for att gissa.

SizeAdvisorModule.parse(output) ar en statisk hjalpmetod som omvandlar textsvaret till ett strukturerat objekt for widgeten. Returnerar null om obligatoriska falt saknas, vilket later kallaren falla tillbaka pa raden text vid behov.

Audit och spårbarhet

Varje korning producerar en signerad audit-bundle med samma format som ovriga moduler. Bundle innehaller blocken input_received, context_loaded, agent_call, output_generated, voice_validated, output_validated och audit_sealed. Hash-kedjan signeras med Ed25519-nyckeln for kapaciti-modules, vilket gor det mojligt att i efterhand bevisa exakt vilken rekommendation som lamnades till en kund och pa vilken indata.

Bundle skrivs valfritt till disk via run(input, { writeBundle: path }). For retur-analys lagras bundle-referensen tillsammans med ordern. Nar en retur registreras kan operationsteamet jamfora den faktiska returraten mot modulens prognostiserade RETUR_SANNOLIKHET och iterera pa modellen.

Integration

Den enklaste integrationen ar pa serversidan i checkout-API:t eller PDP- backend.

import { SizeAdvisorModule } from "kapaciti-modules/modules/size-advisor.mjs";

const advisor = new SizeAdvisorModule();
const result = await advisor.run(input, {
  writeBundle: `./audit/${input.session_id}.bundle.json`,
});

if (result.error) {
  // Fall tillbaka pa "valj din vanliga storlek"
  return { recommended_size: null, reason: result.error };
}

const parsed = SizeAdvisorModule.parse(result.output);
return parsed;

For PDP-widgeten skickas parsed.recommended_size, parsed.confidence och parsed.noting till frontend. parsed.risk_factors kan visas i en infoboll, och parsed.return_likelihood anvands internt for att A/B- testa olika prompts utan att paverka UI:t.

Begränsningar

Modulen ar inte en ersattning for fysiska passformsfoton eller AR-try-on. Den ar ett komplement som okar trafsakerheten nar kunden inte har historik. Kategorier dar passform ar starkt kroppstyps-beroende (badklader, formklader, kavajer) bor kombineras med tydlig retur-policy och fler matt an bara midja och langd.

Modulen lagrar inte personuppgifter sjalv. Audit-bundle innehaller kundens matt och eventuella tidigare returanledningar i klartext eftersom det ar materialet som rekommendationen vilar pa. Det innebar att bundle maste klassificeras enligt handlarens GDPR-policy och raderas eller pseudonymiseras enligt den retention-period som galler for ordrar.

Roadmap

Version 1.0 levererar grundscenariot: en kund, en produkt, ett anrop. Version 1.1 planeras innehalla batch-rekommendationer for hela kundvagnar, kategorispecifika matt-tips (jeans behover hoftmatt utover midja for slim fit) samt en stretch-faktor per material som justerar storleks- kartan vid stickade plagg.