Asiakkaan tilausperuutuksen toimintaperiaate

Tilauksen peruutustoiminto antaa kirjautuneelle asiakkaalle mahdollisuuden peruuttaa oma tilauksensa verkkokaupassa, jos tilauksen nykyinen tila on merkitty asiakkaan peruutettavaksi. Palvelu tarkistaa luvan uudelleen peruutushetkellä, vaihtaa tilan Peruutetuksi ja kirjaa tapahtuman tilaushistoriaan.

Tarkista käyttöönoton tila ensin

Tilauksen peruutustoiminto perustuu tilan tietokantakenttään is_cancellable. Peruutus on käytettävissä vain niissä tiloissa, joille arvo on määritetty käyttöön.

Hallintapaneelin Tilausten tilat -näkymä osoitteessa /orders/statuses ei tarjoa kenttää tämän arvon muuttamiseen. Näkymässä voi muokata nimeä, koodia, väriä, oletustilaa ja maksu- tai laskunumerovaatimusta, mutta ei asiakkaan peruutuslupaa.

Älä oleta, että toiminto on käytössä oletuksena. Varmista kaupan tilakohtaiset arvot tekniseltä ylläpidolta ennen kuin julkaiset asiakkaalle peruutusohjeen. Hallintapaneelista toimintoa ei voi ottaa käyttöön.

Milloin asiakas voi peruuttaa

Asiakkaan tilaus voidaan peruuttaa vain, kun tilauksen nykyisen statuksen is_cancellable-arvo on käytössä. Omat tilaukset -näkymän tilausdata sisältää tätä vastaavan canCancel-arvon, jota kaupan käyttöliittymä voi käyttää peruutustoiminnon näyttämiseen.

Peruutuspalvelu lukitsee tilausrivin ja tarkistaa nykyisen tilan uudelleen. Jos tila on muuttunut eikä enää salli peruutusta, palvelu ei muuta tilausta vaan palauttaa Tilausta ei voi enää peruuttaa -tyyppisen virheen. Näin aiemmin avattu näkymä ei ohita myöhempää tilamuutosta.

Mitä onnistunut peruutus tekee

Tilauksen peruutus hakee nykyisen tilan, etsii kielikohtaisen statuksen, jonka pysyvä koodi on cancelled, ja vaihtaa tilauksen siihen. Samassa tietokantatapahtumassa tilaushistoriaan lisätään asiakkaan tekemää peruutusta kuvaava kommentti ja asiakkaalle ilmoittamisen merkintä.

Tietokantamuutos vahvistetaan ennen sähköpostin lähettämistä. Sen jälkeen palvelu yrittää lähettää asiakkaalle kielikohtaisen tilamuutosviestin ja lisää kaupan omistajan sähköpostiosoitteen vastaanottajaksi. Vastauksessa palautetaan, onnistuiko sähköposti.

Sähköpostivirhe ei peru jo tallennettua tilanmuutosta. Tarkista siksi aina tilauksen tila Hallintapaneelista ja hoida asiakkaan ilmoitus erikseen, jos viesti ei lähtenyt.

Jos peruutustoimintoa ei näy

Tilauksen peruutustoiminto ei näy tai ei onnistu, jos tilauksen nykyinen tila ei salli asiakkaan peruutusta. Tarkista ensin tilauksen nykyinen tila ja varmista tekniseltä ylläpidolta juuri sen tilan is_cancellable-arvo.

Toiminto epäonnistuu myös, jos tilaus-ID puuttuu, tilausta ei löydy tai kaupalta puuttuu kielikohtainen cancelled-tila. Jälkimmäinen on määritysongelma: peruutusta ei saa ohjata satunnaiseen korvaavaan tilaan.

Jos toiminto näkyi ennen sivun avaamista mutta tilaus ehti käsittelyyn, palvelun 409-vastaus on odotettu samanaikaisuussuoja. Päivitä Omat tilaukset -näkymä ja ota tarvittaessa yhteys asiakaspalveluun.

Valmistele asiakasohje ja ehdot

Tilauksen peruutustoiminto ei korvaa kaupan muita lakisääteisiä tai sopimusehtojen mukaisia peruutuskanavia. Kerro asiakkaalle selkeästi, mistä toiminto löytyy, missä tiloissa sitä voi käyttää ja miten toimitaan, kun painiketta ei enää näy.

Ohjeessa mainittu sääntelypäivä on 19.6.2026 ja KKV:n tiedotteen päivä 10.4.2026. Koska oikeudellinen tulkinta ja velvoitteen soveltamisala eivät selviä sovelluskoodista, varmista ajantasainen vaatimus KKV:n aineistosta tai oikeudelliselta asiantuntijalta ennen käyttöönottoa.

Varmista lisäksi kaupan omistajan sähköpostiosoite, Peruutettu-tilan nimi jokaisella käytössä olevalla kielellä ja peruutusviestin käännökset. Testaa peruutus vain erillisellä testitilauksella kaupassa, jossa peruutuslupa on nimenomaisesti määritetty.

Hyvä tietää

Asiakkaan peruutus muuttaa tilauksen tilaa ja historiaa, mutta palvelu ei tässä yhteydessä todista maksun palautusta, varaston palautusta tai ulkoisen ERP-tilauksen peruutusta. Ne voivat vaatia erilliset prosessit.

Kaupan omistajalle lähetettävä kopio käyttää kaupan STORE_OWNER_EMAIL_ADDRESS-asetusta. Palvelun vastaus käyttää asiakkaan ja ylläpitäjän viestille samaa onnistumistulosta, joten se ei erottele kahden vastaanottajan toimitusta.

Tilausstatuksen nimen muuttaminen ei ratkaise peruutuslupaa. Ratkaiseva arvo on tilakohtainen is_cancellable, ja peruutuksen lopputila tunnistetaan pysyvällä cancelled-koodilla.