Tässä ohjeessa käydään käytännönläheisesti läpi, miten AI Commerce -järjestelmän pakkauspakkaaja (pakkauskoon laskenta) toimii, mistä se hakee mitat ja miten kauppias voi itse varmistaa, että laskenta antaa realistisen lopputuloksen. Kun mitat ovat kunnossa, voit luotettavammin rajata toimitustapoja, laskea toimituskuluja ja välittää oikeat tiedot integraatioihin.

Mitä pakkauspakkaaja tekee?

Pakkauspakkaaja laskee ostoskorille arvion tarvittavan paketin (lähetyksen) mitoista:

• pituus (length)
• leveys (width)
• korkeus (height)

Tätä pakkauskokoa käytetään tyypillisesti esimerkiksi:

• toimitustapojen rajaamiseen (esim. “max pituus 175 cm”)
• toimituskulujen laskentaan (erityisesti jos hinta riippuu mitoista tai tilavuudesta)
• integraatioihin (kuriirijärjestelmä, kuljetusliikkeen API, kassalla näkyvä “arvioitu pakkauskoko”)

Tärkeä periaate: pakkauspakkaaja ei ole “yksi staattinen taulukko”, vaan se laskee pakkauskoon automaattisesti joka kerta, kun ostoskoria päivitetään.

Mistä mitat tulevat?

Pakkauspakkaaja tarvitsee jokaiselle tuotteelle mitat. Tavoitelogiikka on:

1. Ensisijaisesti käytetään pakkausmittoja (tuotteen myyntipakkauksen mitat), jos ne ovat saatavilla.
2. Jos pakkausmittoja ei ole, käytetään tuotteen mittoja (tuotteen fyysiset mitat) varavaihtoehtona.

Kauppiaan kannalta tärkein käytännön huomio:

• Jos tuotteella on “tuotteen mitat” mutta se toimitetaan isommassa myyntipakkauksessa (esim. rulla, laatikko, suojapakkaus), pelkkä tuotteen koko voi johtaa liian pieneen laskettuun pakkauskokoon.
• Tämän vuoksi pakkausmitat ovat paras tieto toimituslaskentaan.

Missä pakkauskoko näkyy?

API-sanomassa JSON backendista

Pakkauskoko palautetaan backendista osana ostoskorin vastausta. Tämä tarkoittaa, että pakkauskoko on nähtävissä myös JSON-muodossa.

Käytännössä tämä mahdollistaa kaksi asiaa:

• Kauppias tai integraatiokumppani voi tarkistaa arvot suoraan API-vastauksesta.
• Tieto voidaan myös näyttää käyttöliittymässä (esim. kassalla tai ylläpidossa), jos halutaan.

Vaikka et olisi kehittäjä, JSON-vastauksen voi usein nähdä esimerkiksi integraatiokumppanin lokituksesta, selainpohjaisesta debug-näkymästä tai pyytämällä tukitiimiltä esimerkkivastauksen.

Miten pakkauspakkaaja laskee koon käytännössä?

Järjestelmässä on kaksi laskentatapaa, jotta tulos on sekä tarkka että nopea.

Edistyksellinen algoritmipohjainen pakkaus enintään 50 kpl

Kun ostoskorissa on enintään 50 tuoteyksikköä (kpl), käytetään edistyksellistä algoritmia, joka:

• kokeilee erittäin nopeasti erilaisia tapoja asetella tuotteet “pakettiin”
• huomioi, että jokainen tuote voidaan kääntää 6 eri asentoon (eri orientaatiot)
• rakentaa pakkauksen “kerroksittain/pinoamalla” ja etsii mahdollisimman kompaktin lopputuloksen

Tämä laskenta on käytännössä niin nopea, että se tapahtuu tyypillisesti noin 2 millisekunnissa (palvelinkuormasta riippuen).

Miksi tämä on hyödyllistä?

• Se tuottaa usein realistisen “minimipaketin” mitat, kun tuotteiden mitat ovat oikein.

Kevyt peruslaskentamalli yli 50 kpl

Kun ostoskorissa on yli 50 kappaletta, laskenta siirtyy kevyempään malliin, jotta järjestelmä ei tee liian raskasta optimointia suurille koreille.

Kevyt malli:

• on erittäin nopea (käytännössä mikrosekunteja)
• antaa turvallisen arvion yhdistämällä tuotteiden mittoja ja ottamalla käytännön “maksimeja” niin, ettei lopputulos ole liian pieni

Tärkeä kauppiastason tieto:

• 50 kappaletta on raja, jonka jälkeen laskenta muuttuu optimoinnista “perusmalliksi”.
• Jos kaupassa on tyypillisesti isoja kappalemääriä ostoskorissa, on hyvä huomioida tämä, kun vertaillaan laskettua pakkauskokoa “todelliseen pakkaukseen”.
• Isot myyntimäärät kannattaa niputtaa isompiin pakkauskokoihin ja antaa pakkauksen mitat pakkauskoon perusteella.

Näin varmistat, että pakkauskoko on realistinen

Alla oleva tarkistuslista auttaa paikallistamaan yleisimmät syyt epärealistiseen pakkauskokoon ja testaamaan laskentaa käytännössä.

1. Tarkista, että mitat ovat oikeasti toimitusmitat
   Varmista, ovatko mitat tallennettu tuotteen fyysisinä mittoina vai myyntipakkauksen mittoina.
   • Jos tuotteella on erillinen pakkaus (laatikko, rulla, suojapakkaus), pakkausmitat ovat lähes aina parempi tieto toimituslaskentaan.
   • Jos käytössä on vain tuotemitat, mutta toimitus tapahtuu isommassa myyntipakkauksessa, laskettu pakkauskoko voi jäädä liian pieneksi.
2. Tarkista yksiköt ja mittakaava
   Varmista, millä yksiköillä mitat on tallennettu.
   • Onko järjestelmässä mitat millimetreinä vai senttimetreinä?
   • Esimerkiksi “62 mm” vs “62 cm” -tyyppinen yksikkösekaannus tekee tuloksesta täysin epärealistisen.
3. Testaa tyypilliset ostoskorit
   Tee testikoreja, jotka vastaavat oikeita ostotilanteita.
   • Tee testikori, joka vastaa oikeaa ostotilannetta (esim. 1–5 tuotetta, “yleisin tilaus”).
   • Tee toinen testikori, jossa on paljon kappaleita (yli 50), jotta näet miten perusmalli käyttäytyy.
   • Muista, että ≤ 50 kpl ja > 50 kpl käyttävät eri laskentamallia.
4. Vertaile laskettua pakkauskokoa toteutuneeseen lähetykseen
   Kun ensimmäiset lähetykset on tehty, vertaa laskettua kokoa siihen, millaiseen pakettiin tavara oikeasti meni.
   • Jos toistuvasti tulee poikkeamaa, lähes aina syy löytyy tuotemitoista (tai puuttuvista pakkausmitoista).
5. Tarkista oikea totuuslähde debug-tilanteissa
   Jos näet useita arvoja (esim. API-vastaus vs session-kentät), varmista, että tulkitset oikein.
   • Luota ensisijaisesti uusimpaan API-vastauksen laskettuun pakkauskokoon.
   • Sessionin cartPackingSize voi sisältää legacy-arvoja pitkään samassa istunnossa.

Miten pakkauskokoa voi hyödyntää kassalla ja integraatioissa?

Koska pakkauskoko palautuu API:ssa, sitä voidaan hyödyntää esimerkiksi näin:

• Kassalla näkyvä arvio: “Arvioitu pakkauskoko: 62 × 62 × 51”
• Toimitustapojen tarkat rajoitteet: estetään toimitustapa, jos ylittää sallitut mitat
• Hintalaskenta mittojen mukaan: jos kuriiri tai integraatio tukee hinnoittelua mitoilla/tilavuudella
• Lähetetietojen rikastus: välitetään pakkauskoko kuljetusliikkeen järjestelmälle automaattisesti

Tämä on erityisen hyödyllistä, jos käytössä on toimitustapoja, joissa:

• maksimit mittojen mukaan ovat tiukat
• hinta muodostuu mittojen / tilavuuspainon perusteella
• halutaan automatisoida mahdollisimman paljon ilman manuaalista pakettikoon arviointia

Yhteenveto

• Pakkauspakkaaja laskee ostoskorin pakkauskoon automaattisesti jokaisella päivityksellä.
• Pakkauskoko näkyy backendin API-vastauksessa JSON-muodossa ja sitä voi hyödyntää myös käyttöliittymässä tai integraatioissa.
• Järjestelmä käyttää kahta mallia:
  
  • edistyksellinen optimointi, kun ostoskorissa on enintään 50 kpl, tyypillisesti noin 2 ms
  • kevyt perusmalli, kun ostoskorissa on yli 50 kpl, yleensä mikrosekunteja
• Realistinen lopputulos riippuu siitä, että tuotteilla (ja mielellään pakkausmitoilla) on oikeat, toimitusta vastaavat mitat.
• Vanhat sessiokentät voivat näkyä debugissa, mutta ne ovat legacyä eivätkä ole uuden laskennan totuuslähde.

Suositeltu seuraava toimenpide: tee kaksi testikoria (yksi ≤ 50 kpl ja yksi > 50 kpl), tarkista pakkauskoko API-vastauksesta ja vertaa tuloksia toteutuneisiin lähetyksiin.

FAQ – Pakkauspakkaaja

1) Mikä on pakkauspakkaaja?

Pakkauspakkaaja laskee ostoskorin tuotteista arvion paketin mitoista (pituus, leveys, korkeus), jotta toimitustapoja ja toimituskuluja voidaan ohjata mittojen perusteella.

2) Mistä pakkauspakkaaja saa mitat?

Mitat tulevat tuotteiden mitoista. Kun pakkausmitat ovat käytössä, niitä käytetään ensisijaisesti. Jos pakkausmittoja ei ole, käytetään tuotteen mittoja varavaihtoehtona.

3) Missä pakkauskoko näkyy?

Pakkauskoko palautuu backendista API-vastauksessa JSON-muodossa. Tarvittaessa integraatiokumppani voi näyttää sen myös käyttöliittymässä (esim. kassalla).

4) Miksi näen joskus vanhan cartPackingSize arvon sessiossa?

Tämä on legacyä: aiemmin pakkauskoko tallennettiin sessioon. Nykyään pakkauskoko lasketaan aina uudelleen, mutta vanha sessio voi silti sisältää aiempia arvoja.

5) Kuinka nopeasti pakkaus lasketaan?

Edistyksellinen algoritmi (≤ 50 kpl) toimii tyypillisesti noin 2 millisekunnissa. Kevyt perusmalli (> 50 kpl) toimii yleensä mikrosekunteissa.

6) Miksi 50 kappaletta on raja?

Edistyksellinen pakkaus tekee paljon optimointia (tuotteilla 6 asentoa ja useita pinoamisvaihtoehtoja). Yli 50 kappaleessa laskenta vaihtuu kevyeen malliin, jotta suorituskyky pysyy hyvänä myös isoilla koreilla.

7) Mitä tapahtuu, jos tuotteiden mitat ovat väärin tai puuttuvat?

Tulos voi olla epärealistinen. Tyypillisin syy poikkeamaan on, että tuotteella on vain “tuotteen fyysiset mitat”, vaikka toimitus tapahtuu isommassa myyntipakkauksessa. Siksi pakkausmitat ovat paras tieto.

8) Miten kauppias voi varmistaa, että tulos on realistinen?

Tee testikori tyypillisillä tuotteilla ja vertaa laskettua pakkauskokoa todelliseen pakkaukseen. Jos ero toistuu, tarkista erityisesti mittayksiköt ja se, ovatko mitat “tuotemitat” vai “pakkausmitat”.

Avainsanat

• pakkauspakkaaja
• pakkauskoko
• cartPackingSize
• ostoskori
• toimitusmitat
• pakkausmitat
• tuotemitat
• JSON API
• toimitustapojen rajoitteet
• toimituskulut ja mitat