> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kestotilaukset

> Toistuva laskutus jatkuvasta tuotteiden ja palveluiden käytöstä — hinnoittelun määritys, laskutuksen elinkaari, laskutus ja asiakkuuden hallinta.

Kestotilauksilla myyt jatkuvaa käyttöoikeutta tuotteeseen tai palveluun toistuvalla laskutuksella. Asiakkaat ostavat kestotilaussuunnitelman kassalla, ja TWICE hoitaa laskutusjakson — muodostaa laskut, perii maksut ilman asiakkaan läsnäoloa, yrittää epäonnistuneita maksuja uudelleen ja lähettää elinkaaren sähköpostit.

<Note>Kestotilaukset kuuluvat kaikkiin TWICE Commerce -suunnitelmiin. Ne eivät ole käytettävissä Wix-integroiduissa verkkokaupoissa.</Note>

## Miten se toimii

Kestotilaus alkaa, kun asiakas ostaa listauksen, jolla on kestotilaushinnoittelu. Elinkaaressa on neljä vaihetta:

1. **Määritys** — määrität kestotilaussuunnitelmat listauksen hintataulukkoon (sitoutumisen pituus, maksujakso, uusimisen toiminta, peruutusehdot).
2. **Osto** — asiakas valitsee suunnitelman verkkokaupassa, valitsee alkamispäivän ja siirtyy kassalle. TWICE veloittaa ensimmäisen maksun ja tallentaa kortin tulevaa laskutusta varten.
3. **Laskutus** — päivittäiset automaattiset työt muodostavat laskut kunakin laskutusjaksona, perivät maksun ilman asiakkaan läsnäoloa ja yrittävät epäonnistuneita uudelleen. Kestotilaus pysyy aktiivisena niin kauan kuin maksut onnistuvat.
4. **Päättyminen** — kestotilaus päättyy peruutukseen (asiakas tai kauppias), sitoutumisen täyttymiseen (ei uusimista) tai maksun epäonnistumiseen kaikkien uudelleenyritysten jälkeen.

### Kestotilausten tilat

| Tila          | Merkitys                                                                                                                 |
| :------------ | :----------------------------------------------------------------------------------------------------------------------- |
| **Active**    | Laskutus toimii normaalisti. Jos peruutus on ajastettu, Admin näyttää ”Cancels {päivämäärä}” tilan pysyessä aktiivisena. |
| **Past due**  | Veloitus epäonnistui, mutta automaattisia uudelleenyrityksiä on vielä ajastettuna.                                       |
| **Failed**    | Kaikki uudelleenyritykset on käytetty. Automaattista perintää ei enää tehdä. Voit yrittää uudelleen käsin Adminissa.     |
| **Completed** | Sitoutumisjakso päättyi eikä uusimista ole määritetty. Lopullinen tila.                                                  |
| **Cancelled** | Asiakas tai kauppias peruutti. Lopullinen tila.                                                                          |

## Hinnoittelun määritys

Kestotilaushinnoittelu määritetään [hintataulukon](/docs/fi/concepts/catalog/price-tables) hintariveinä. Ota hintataulukossa käyttöön **Subscriptions**-kytkin ja lisää sitten yksi tai useampi kestotilaussuunnitelma.

Jokainen kestotilaushintarivi määrittää suunnitelman seuraavilla kentillä:

| Kenttä                     | Kuvaus                                                                                                                                                                             |
| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Label**                  | Asiakkaalle näkyvä suunnitelman nimi (esimerkiksi ”Kuukausittain”, ”Vuosittain”).                                                                                                  |
| **Price**                  | Jaksokohtainen hinta kauppasi valuutassa.                                                                                                                                          |
| **Payment cycle**          | Kuinka usein asiakasta laskutetaan — yksikkö (`days`, `weeks`, `months`, `years`) ja määrä. Esimerkki: 1 kuukauden välein.                                                         |
| **Commitment cycles**      | Maksujaksojen määrä, joihin asiakas sitoutuu. Kolmen jakson sitoutuminen kuukausisuunnitelmassa tarkoittaa vähintään 3 kuukautta. Enintään 24 jaksoa.                              |
| **Initial charge type**    | Milloin ensimmäinen lasku erääntyy: **tilauksen luonnissa** (veloitetaan heti kassalla) vai **kestotilauksen alkaessa** (veloitetaan alkamispäivänä).                              |
| **Renewal type**           | Mitä tapahtuu sitoutumisen päätyttyä: **Auto-renew** jatkaa laskutusta jaksoittain, kunnes se perutaan; **None** päättää kestotilauksen sitoutumisen täytyttyä.                    |
| **Renewal price**          | Jaksokohtainen hinta sitoutumisjakson jälkeen (vain automaattisessa uusimisessa). Jätä tyhjäksi, jos haluat jatkaa alkuperäisellä hinnalla.                                        |
| **Collection method**      | **Charge automatically** (oletus) perii maksun tallennetulta kortilta. **Send invoice** muodostaa laskun veloittamatta — asiakas maksaa itse.                                      |
| **Cancellation lead time** | Kuinka paljon etukäteen peruutus on pyydettävä (esimerkiksi 1 kuukausi). Peruutus astuu voimaan myöhempänä ajankohdista: irtisanomisajan päättyminen tai sitoutumisen päättyminen. |

### Varianttikohtainen hinnoittelu

Jos listauksella on [variantteja](/docs/fi/concepts/catalog/variants), kestotilaussuunnitelmat käyttävät kaikille varianteille samaa perusmäärittelyä. Kukin varianttiarvo voi soveltaa perushintaan **kerrointa**. Kerroin `1.0` vastaa perustasoa; `1.2` lisää 20 %; `0.8` antaa 20 % alennuksen.

### Useita suunnitelmia

Hintataulukossa voi olla useita kestotilausrivejä. Verkkokauppa näyttää ne pudotusvalikkona, josta asiakas voi valita suunnitelman (esimerkiksi ”Kuukausittain” vs. ”Vuosittain”). Jos suunnitelmia on vain yksi, se näytetään suoraan ilman valitsinta.

## Ostoprosessi verkkokaupassa

Listaussivun varaustyökalu näyttää **kestotilauksen tiedot** -osion, kun listauksella on kestotilaushinnoittelu:

1. **Suunnitelman valinta** — jos suunnitelmia on useita, pudotusvalikko näyttää kunkin suunnitelman hintanimikkeineen (esimerkiksi ”10,00 €/kk”). Yhden suunnitelman listaukset näyttävät hinnan suoraan.
2. **Alkamispäivä** — kalenterista asiakas valitsee, milloin kestotilaus alkaa. Päivät, joille ei ole varastoa, ovat pois käytöstä.
3. **Kestotilauksen yhteenveto** — yhteenvetokortti näyttää tuotteen, jaksokohtaisen hinnan, nyt maksettavan summan ja seuraavan laskutuspäivän.
4. **Aikataulun esikatselu** — aikajana esittää laskutusaikataulun: nyt maksettava veloitus, sitä seuraavat laskutuspäivät summineen ja lopuksi joko ”kunnes peruutetaan” (automaattinen uusiminen) tai viimeisen jakson päivämäärä.
5. **Lisää ostoskoriin** — asiakas lisää suunnitelman ostoskoriin painikkeella ”Buy subscription”. Kestotilauksen ehdot lukitaan tässä vaiheessa ja siirtyvät kassalle.

Kassalla asiakkaan kortti tallennetaan tulevaa laskutusta varten (Stripe-valtuutuksella tai Adyen-tokenoinnilla).

## Laskutuksen elinkaari

### Päivittäiset laskutustyöt

Kolme automaattista työtä hoitaa kestotilausten laskutusta päivittäin:

| Työ                             | Aikataulu                 | Mitä se tekee                                                                                                                                                                                    |
| :------------------------------ | :------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Laskujen muodostus**          | 06.00 (tilin aikavyöhyke) | Viimeistelee erääntyneet peruutukset ja muodostaa sitten laskut niille kestotilauksille, joiden seuraava laskutuspäivä on koittanut. Automaattisesti perittävät laskut veloitetaan välittömästi. |
| **Maksujen uudelleenyritykset** | 06.30 (tilin aikavyöhyke) | Yrittää maksua uudelleen avoimille laskuille, joiden uudelleenyrityspäivä on koittanut.                                                                                                          |
| **Ilmoitukset**                 | 07.00 (tilin aikavyöhyke) | Lähettää ”uusiminen lähestyy”- ja ”päättyy pian” -sähköpostit kestotilauksille, jotka erääntyvät tai päättyvät 7 päivän kuluessa.                                                                |

### Laskujen muodostus

Jokainen laskutusjakso muodostaa tilaukseen liittyvän laskun. Lasku tallentaa laskutusjakson (alku- ja loppupäivän), rivitiedot ja summat. Kestotilauksen ja jakson alkupäivän yksilöivä rajoite estää kaksinkertaisen laskutuksen.

Jokaisella laskulla on asiakirjan status. Se kuvaa itse asiakirjan elinkaarta eikä kerro, onko lasku maksettu.

| Asiakirjan status | Merkitys                                                                                                                                          |
| :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------ |
| `draft`           | Juuri luotu, ei vielä viimeistelty.                                                                                                               |
| `open`            | Viimeistelty ja odottaa maksua.                                                                                                                   |
| `cancelled`       | Peruttu — ei enää maksettavana.                                                                                                                   |
| `uncollectible`   | Kauppias on kirjannut luottotappioksi.                                                                                                            |
| `scheduled`       | Esikatselu tulevasta laskutusjaksosta. TWICE laskee sen tarvittaessa eikä tallenna sitä koskaan, joten sillä ei ole laskunumeroa eikä antopäivää. |

Se, onko lasku maksettu, määräytyy siihen liitetyistä maksuista, ei tilakentästä. Avointa laskua, jolla on onnistunut maksu, pidetään maksettuna.

Laskutaulukko näyttää jokaisesta laskusta yhden merkinnän, joka yhdistää asiakirjan statuksen ja maksun tilan. Asiakirjan status `scheduled`, `cancelled` tai `uncollectible` ohittaa maksun tilan; jos status on `draft` tai `open`, merkinnässä näkyy sen sijaan maksun tila. Draft ja Open eivät siis koskaan esiinny merkintänä.

| Merkintä               | Milloin näytetään                           |
| :--------------------- | :------------------------------------------ |
| **Aikataulutettu**     | Asiakirjan status on `scheduled`.           |
| **Peruutettu**         | Asiakirjan status on `cancelled`.           |
| **Poistettu taseesta** | Asiakirjan status on `uncollectible`.       |
| **Maksamaton**         | Mitään ei ole veloitettu.                   |
| **Osittain maksettu**  | Veloitettu vähemmän kuin laskun loppusumma. |
| **Maksettu**           | Veloitettu kokonaan, ei hyvityksiä.         |
| **Osittain hyvitetty** | Veloitettu kokonaan, osa hyvitetty.         |
| **Hyvitetty**          | Veloitettu kokonaan, kaikki hyvitetty.      |

<Note>
  `uncollectible` on enum-arvo ja sen asettavan `mark-uncollectible`-toiminnon nimi. Hallintapaneelissa tuo sana ei näy koskaan — merkinnässä lukee **Poistettu taseesta** ja rivin toiminnossa **Poista taseesta**.
</Note>

Perinnästä luopuminen ei ole asiakirjan status. Lasku, jonka perimisestä TWICE luopuu, pysyy statuksessa `open` ja maksamattomana; luopuminen kirjataan kestotilaukselle, joka siirtyy tilaan **Epäonnistui**.

### Maksun periminen ilman asiakkaan läsnäoloa

TWICE perii kestotilausten maksut automaattisesti sillä kortilla, jonka asiakas antoi kassalla:

* **Stripe**: käyttää `off_session`-PaymentIntent-pyyntöjä tallennetulla valtuutuksella
* **Adyen**: käyttää `ContAuth`-asiakasvuorovaikutusta ja `UnscheduledCardOnFile`-toistomallia

Jos maksu vaatii 3D Secure -vahvistuksen (SCA), veloitus epäonnistuu, koska paikalla ei ole asiakasta suorittamassa todennusta. Kestotilaus siirtyy uudelleenyritysprosessiin.

### Maksujen uudelleenyritysaikataulu

Kun veloitus epäonnistuu, TWICE yrittää uudelleen porrastetulla aikataululla laskun eräpäivästä laskettuna:

| Yritys          | Päivää eräpäivän jälkeen |
| :-------------- | :----------------------- |
| 1 (ensimmäinen) | 0 (eräpäivä)             |
| 2               | +1 päivä                 |
| 3               | +3 päivää                |
| 4               | +5 päivää                |
| 5               | +7 päivää                |

Viiden epäonnistuneen yrityksen jälkeen automaattinen perintä lakkaa ja kestotilauksen tilaksi tulee **Failed**. Voit silti yrittää uudelleen käsin Adminissa.

Uudelleenyritysten aikana kestotilauksen tila on **Past due**. Asiakas saa maksun epäonnistumisesta kertovan sähköpostin jokaisen epäonnistuneen yrityksen jälkeen.

## Peruutus

Peruutuksessa huomioidaan sekä sitoutumisjakso että irtisanomisaika:

* Peruutus astuu voimaan **myöhempänä** ajankohdista: irtisanomisajan päättyminen tai sitoutumisen päättyminen. Asiakas, jolla on 6 kuukauden sitoutuminen ja 1 kuukauden irtisanomisaika ja joka peruuttaa 2. kuukautena, saa kestotilauksensa päättymään 6. kuukauden jälkeen (sitoutuminen menee edelle).
* Peruutuksen ollessa vireillä kestotilaus pysyy tilassa **Active** ja laskuttaa edelleen ikkunaan osuvat jaksot. Admin näyttää tilamerkinnässä ”Cancels {päivämäärä}”.
* Peruutuksen voimaantulopäivänä päivittäinen tarkistus vaihtaa tilaksi **Cancelled**.

Asiakkaat voivat peruuttaa itsepalveluportaalissa (jos se on käytössä). Kauppiaat voivat peruuttaa Adminin tilausnäkymästä.

## Sähköposti-ilmoitukset

TWICE lähettää elinkaaren sähköpostit kestotilausten tapahtumista. Hallitset pohjia kohdassa **Asetukset → Sähköpostit**.

| Sähköposti            | Milloin lähetetään                                   | Oletustila                  |
| :-------------------- | :--------------------------------------------------- | :-------------------------- |
| **Payment upcoming**  | 7 päivää ennen uusimisveloitusta                     | Luonnos (otettava käyttöön) |
| **Payment confirmed** | Onnistuneen veloituksen jälkeen                      | Käytössä                    |
| **Payment failed**    | Epäonnistuneen veloitusyrityksen jälkeen             | Käytössä                    |
| **Cancelled**         | Kun peruutus on vahvistettu                          | Käytössä                    |
| **Ending soon**       | 7 päivää ennen kuin uusiutumaton suunnitelma päättyy | Luonnos (otettava käyttöön) |

Luonnostilaisia pohjia ei lähetetä ennen kuin otat ne käyttöön. Muokkaa sähköpostien sisältöä kohdassa **Asetukset → Sähköpostit** brändisi äänensävyyn sopivaksi.

## Kestotilausten alennukset

[Alennuskoodit](/docs/fi/concepts/catalog/discount-codes) tukevat kestotilauskohtaisia kestoasetuksia, jotka määrittävät, kuinka kauan alennus on voimassa:

| Kesto         | Toiminta                                                                       |
| :------------ | :----------------------------------------------------------------------------- |
| **Once**      | Koskee vain ensimmäistä laskutusjaksoa.                                        |
| **Repeating** | Koskee määrättyä määrää laskutusjaksoja (esimerkiksi 3 ensimmäistä kuukautta). |
| **Forever**   | Koskee jokaista laskutusjaksoa kestotilauksen koko keston ajan.                |

Kun luot alennuskoodin, rajaa se ostotyyppiin **Subscription** ja valitse kesto. Alennuksen kohdistus tallentaa, mistä jaksosta alkaen sitä sovelletaan.

## Hallinta Adminissa

### Tilauksen yhteenveto

Tilauksen yhteenvetovälilehti näyttää kestotilauskohtaiset tiedot jokaiselle kestotilausrivitiedolle:

* **Tilamerkintä** — kestotilauksen nykyinen tila värikoodattuna (vihreä aktiiviselle, keltainen erääntyneelle, punainen epäonnistuneelle)
* **Laskutettu tähän mennessä** — kaikkien jaksojen laskutettu kokonaissumma
* **Maksettu** — peritty kokonaissumma
* **Sitoutuminen päättyy** — sitoutumisjakson päättymispäivä
* **Uusiminen** — ”Auto-renew at {hinta}” tai ”No renewal”
* **Irtisanomisilmoitus** — vaadittu irtisanomisaika ja aikaisin mahdollinen peruutuspäivä

### Laskutaulukko

Maksut-välilehti sisältää laskutaulukon, jonka sarakkeissa ovat laskun numero, tila, laskutusjakso, loppusumma ja lähetyspäivä. Avoimille laskuille käytettävissä olevat toiminnot:

* **Mark as paid** — kirjaa alustan ulkopuolinen maksu
* **Retry** — yritä maksun perimistä uudelleen
* **Write off** — merkitse luottotappioksi
* **Cancel** — peruuta lasku (vain jos maksuja ei ole veloitettu)

Jokaisen laskun voi ladata tai tulostaa PDF-muodossa.

## Aiheeseen liittyvää

<CardGroup cols={2}>
  <Card title="Hintataulukot" icon="table" href="/docs/fi/concepts/catalog/price-tables">
    Määritä kestotilausten hintarivit hintataulukoihin.
  </Card>

  <Card title="Tilaustyypit" icon="shopping-cart" href="/docs/fi/concepts/orders/order-types">
    Kestotilaus ostotyyppinä vuokrauksen ja myynnin rinnalla.
  </Card>

  <Card title="Alennuskoodit" icon="tag" href="/docs/fi/concepts/catalog/discount-codes">
    Kestotilauskohtaiset alennusten kestot.
  </Card>

  <Card title="Maksut" icon="receipt" href="/docs/fi/concepts/orders/payments">
    Maksujen periminen ja hyvitykset.
  </Card>
</CardGroup>
