Debug-näkymän tarkoitus ja käyttö

Debug-näkymä on ylläpitäjälle tarkoitettu lisänäkymä, joka näyttää hinnoittelun, toimitustapojen ja ostoskorin laskennan taustatietoja suoraan siinä kaupan käyttöliittymässä, jossa ongelma näkyy. Sen avulla voit jäljittää, miksi hinta tai toimitustapa käyttäytyy tietyllä tavalla.

Rajaa ongelma debug-näkymässä

Debug-näkymää käytetään tällä hetkellä tuotesivulla ja kassalla. Tuotesivun Admin Debug näyttää tuotteen hinnoitteluun liittyviä tietoja. Kassan Admin Debug näyttää toimitustapojen sääntöjä sekä ostoskorin paino-, koko- ja rivitietoja. Debug-tiedot näytetään vain admin-istunnossa; tavallinen asiakas ei saa sivudatan mukana erillistä debug-osiota.

Toista aina sama tilanne, jossa ongelma havaittiin. Hinta-, toimitus- ja maksutapalaskenta voi muuttua tuotteiden, määrien, asiakkaan tyypin, maan, postinumeron, asiakasryhmän ja ostoskorin arvon perusteella. Eri ostoskorilla saatu debug-tieto ei selitä alkuperäistä tapausta.

Selvitä tuotteen hinta ja alennus

Tuotesivun Admin Debug auttaa selvittämään tuotteen hinnan ja alennuksen taustaa. Osio Discount Types näyttää tuotteelle aktiiviset alennustyypit, ja osio History näyttää tuotteen hintahistorian. Vertaa näitä tietoja asiakkaalle näkyvään hintaan samassa tuote- ja asiakastilanteessa.

Discount Types kertoo, mitkä alennuslähteet osallistuvat hinnan muodostumiseen. History auttaa erottamaan nykyisen hinnan aiemmista hintamuutoksista. Jos hinta näyttää väärältä, kirjaa tuotteen ID tai SKU, näkyvä hinta, odotettu hinta, aktiiviset alennustyypit ja olennaiset hintahistorian rivit. Älä muuta hintaa pelkän debug-näkymän perusteella ennen kuin olet tunnistanut hinnan tuottavan säännön.

Selvitä toimitustavan lähtötila

Kassan Admin Debug -taulukon Shipment setEnable näyttää, mitkä toimitustapamoduulit olivat aluksi käytössä ja mitkä jäivät pois lähtötilanteessa. Rivillä näkyvät moduulin nimi ja moduulikoodi, joten voit tunnistaa täsmällisen toimitustavan myös silloin, kun usealla tavalla on samankaltainen näkyvä nimi.

Tarkista tämä rivi ennen paino- ja kokorajoja. Jos moduuli on jo setEnable-vaiheessa poissa käytöstä, syy voi olla esimerkiksi moduulin käyttötila, alue tai asiakkaalle estetty toimitustapa. Paino- ja kokorivit eivät silloin yksin selitä puuttumista. Koodi muodostaa lähtötilan moduulin käyttötilasta, maantieteellisestä alueesta ja asiakkaan estolistasta.

Tarkista paino- ja kokorajat

Kassan toimitustapojen debug-tiedoissa seuraavat rivit kuvaavat paino- ja kokorajojen tulosta:

• Shipment shippingDetails.isUnderWeight: ostoskorin paino alittaa toimitustavan vähimmäispainon.
• Shipment shippingDetails.isOverWeight: ostoskorin paino ylittää toimitustavan enimmäispainon.
• Shipment shippingDetails.isOverSized: laskettu pakettikoko ylittää toimitustavan sallitun rajan.
• Shipment weightLimitSource: painoperuste, jota enimmäispainon vertailussa käytetään.

Arvo true merkitsee, että kyseinen raja estää toimitustavan. Tarkista samalta riviltä moduuli, ostoskorin laskettu arvo ja raja. Vähimmäispainon vertailu käyttää ostoskorin suurinta painoperustetta, kun taas enimmäispaino käyttää toimitustavalle määritettyä weightLimitSource-arvoa.

Vertaa ostoskorin laskentaan

Kassan Admin Debug näyttää ostoskorin laskentatiedot kolmessa ryhmässä. Cart weight sisältää ostoskorin todellisen painon, tilavuuspainon ja suurimman painoperusteen. Cart size sisältää pituuden, leveyden, korkeuden ja lasketun pakettikoon. Siinä voi näkyä myös pakkauslaskennan tapa ja käytetyt pakkaussäännöt.

Cart items näyttää rivikohtaisen määrän, koon ja lasketun painoperusteen. Jos vain tietty tuote tai määrä poistaa toimitustavan, avaa tämä ryhmä ja vertaa tuoterivin arvoja koko ostoskorin Cart weight- ja Cart size-arvoihin. Näin erotat tuotetiedon virheen ostoskorin yhteislaskennasta ja toimitustavan rajasta.

Käytä kassan debug-näkymää vaiheittain

Kassan debug-näkymän luotettava käyttö edellyttää saman ostotilanteen toistamista:

1. Kirjaudu kauppaan admin-oikeuksilla ja avaa kassa.
2. Lisää ostoskoriin samat tuotteet ja määrät kuin ongelmatilanteessa.
3. Käytä samaa asiakastyyppiä, maata ja postinumeroa.
4. Tarkista ensin Shipment setEnable.
5. Tarkista sitten isUnderWeight, isOverWeight ja isOverSized.
6. Vertaa Cart weight- ja Cart size -arvoja toimitustavan rajoihin.
7. Avaa Cart items, jos ongelma liittyy yksittäiseen tuotteeseen.

Admin-istunnon kassasivun data sisältää erilliset debug.shipment- ja debug.cart-osiot, joista käyttöliittymä rakentaa taulukon. Ne eivät sisälly tavallisen asiakkaan kassadataan.

Tulkitse maksutavan näkyvyyttä

Kassan debug-näkymässä ei ole erillistä Payment-osiota, joka listaisi maksutapojen hylkäyssyyt samalla tarkkuudella kuin toimitustavoilla. Maksutapa voi näkyä mutta olla estettynä, tai se voi puuttua kokonaan, jos moduuli ei ole käytössä, maantieteellinen alue ei täsmää, maksutapa on estetty asiakkaalta, asiakastyyppi ei täsmää tai ostoskorin arvo jää maksutavan rajojen ulkopuolelle.

Maksutapa voi myös estää tietyn toimitustavan, jolloin kassa näyttää yhdistelmästä erillisen virheilmoituksen. Lisäksi maksutavalla voi olla omaa lisälogiikkaa. Jos yleiset ehdot eivät selitä tapausta, kirjaa maksutavan moduulikoodi, toimitustapa, asiakkaan tyyppi, maa, postinumero ja ostoskorin arvo. Yhtä yksityiskohtainen syyluettelo vaatii erillisen maksutapojen debug-laajennuksen.

Kerää tiedot jatkoselvitykseen

Debug-näkymän jatkoselvitystä varten ota kuvakaappaus koko Admin Debug -osiosta ja kirjaa ostoskorin tuotteet sekä määrät, asiakastyyppi, maa ja postinumero. Nimeä puuttuva tai estetty toimitus- tai maksutapa ja lisää sen moduulikoodi, jos se näkyy.

Toimitustapaongelmassa kirjaa Cart weight, Cart size, olennaiset Cart items -rivit ja se moduuli, jonka kohdalla debug näyttää estävän säännön. Tuotteen hintaongelmassa kirjaa tuotteen ID tai SKU, näkyvä ja odotettu hinta, Discount Types ja olennaiset History-rivit. Näillä tiedoilla ongelma voidaan toistaa ilman arvailua.

Milloin debug-näkymää kannattaa laajentaa

Debug-näkymän laajennus on hyödyllinen, kun sama selittämätön ongelma toistuu eri asiakkailla tai eri toimitus- ja maksutapayhdistelmillä. Tuotesivulla lisätieto voi auttaa avaamaan hinnan, alennuksen tai hintahistorian yksittäisen laskentapäätöksen. Kassalla lisätieto voi nimetä puuttuvan toimitus- tai maksutavan hylkäyssyyn.

Uusi debug-tieto kannattaa näyttää ylläpitäjälle siinä näkymässä, jossa päätös syntyy, ja pitää poissa tavallisen asiakkaan sivudatasta. Laajennuksen tulee nimetä sääntö, syötearvo, vertailuraja, tulos ja moduulikoodi niin, että sama tapaus voidaan todentaa myöhemmin.