> ## 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.

# Tilauksen elinkaari

> Tilauksen koko matka luonnista keräilyyn, valmistumiseen ja tilauksen jälkeisiin prosesseihin.

<Frame caption="Tilaukset">
  <img src="https://mintcdn.com/twicecommerce/Ab7tx7ih94KQsi0k/images/orders-overview.webp?fit=max&auto=format&n=Ab7tx7ih94KQsi0k&q=85&s=6f206eb724a02d819e1171bb92f2c94c" alt="Tilaustaulukko, jossa näkyvät tila- ja keräilymerkinnät" width="1920" height="1080" data-path="images/orders-overview.webp" />
</Frame>

## Määritelmä

Tilauksen elinkaari kuvaa tilauksen matkan luonnista keräilyyn, valmistumiseen ja tilauksen jälkeiseen toimintaan. Jokainen tilaus etenee kolmella toisistaan riippumattomalla ulottuvuudella: tilauksen tila, maksun tila ja keräilytila. Näiden kolmen yhdistelmä määrittää, mitä tilaukselle voi kullakin hetkellä tehdä.

## Missä tätä käytetään?

* Tilausten suodatus ja ryhmittely Tilaukset-taulukossa
* Työnkulkujen käynnistäminen, kun tilaus siirtyy tiettyyn tilaan
* Sen ratkaiseminen, voiko tilausta vielä muokata, peruuttaa tai hyvittää
* Raportointi myynnistä, keräilyjen tehokkuudesta ja aktiivisista vuokrauksista
* API-integraatiot, joiden on reagoitava tilauksen tilamuutoksiin

## Tilauksen tila, maksu ja keräily

Tilauksia seurataan hallintapaneelissa kolmella toisistaan riippumattomalla ulottuvuudella:

* **Tilauksen tila** — tilauksen kokonaisetenemä (Avoin / Käynnissä / Suljettu)
* **Maksun tila** — onko tilaus kokonaan maksettu (Maksettu / Ei maksettu)
* **Keräilytila** — rivitietojen fyysinen keräily (Keräämättä / Valmisteltu / Osittain luovutettu / Luovutettu)

Kukin näkyy omana merkintänään tilaustaulukossa ja tilauksen tietosivulla. Ulottuvuudet ovat toisistaan riippumattomia: tilaus voi olla **Suljettu**, vaikka osa rivitiedoista olisi hyvitetty, ja **Avoin**-tilaukset voivat olla jo **Osittain luovutettu**.

## Keskeiset ominaisuudet

### Tilauksen tila

Jokaisella tilauksella on käyttäjälle näkyvä tila:

| Tila          | Kuvaus                                                                                     |
| :------------ | :----------------------------------------------------------------------------------------- |
| **Avoin**     | Tilaus on luotu ja odottaa toimenpidettä — vahvistusta, maksua tai valmistelua.            |
| **Käynnissä** | Artikkelit ovat asiakkaalla, tai vuokra-aika on käynnissä.                                 |
| **Suljettu**  | Kaikki artikkelit on palautettu (vuokraus) tai toimitettu (myynti). Lisätoimia ei tarvita. |

TWICE seuraa tarkempia sisäisiä tiloja varausten, maksulinkkien ja vuokraussiirtymien osalta, mutta niiden kanssa ei yleensä tarvitse toimia suoraan. Käyttäjälle näkyvä tila **Avoin / Käynnissä / Suljettu** on projektio näistä tiloista.

### Maksun tila

Maksun etenemistä seurataan erillään tilauksen tilasta. Tilaustasolla koonti on binäärinen:

| Maksun tila     | Kuvaus                                                                               |
| :-------------- | :----------------------------------------------------------------------------------- |
| **Ei maksettu** | Tilauksella on avoin saldo — mitään ei ole veloitettu tai vain osa kokonaissummasta. |
| **Maksettu**    | Maksu on veloitettu kokonaan.                                                        |

API:ssa tämä on `paymentStatus`, arvoina `PAID` ja `UNPAID`. Tilauksen taustalla olevilla yksittäisillä maksuilla ja laskuilla on tarkempia tiloja — pending, succeeded, partially refunded, refunded, cancelled, expired ja muita. Katso [Maksut](/docs/fi/concepts/orders/payments), jossa kerrotaan, miten maksun eteneminen esitetään.

### Keräilytila

Tilauksen keräilymerkintä tiivistää sen rivitietojen tilan:

| Keräilytila             | Kuvaus                                                         |
| :---------------------- | :------------------------------------------------------------- |
| **Keräämättä**          | Yhtään artikkelia ei ole noudettu, lähetetty tai toimitettu.   |
| **Valmisteltu**         | Artikkelit on valmisteltu ja ne ovat valmiina luovutettaviksi. |
| **Osittain luovutettu** | Osa artikkeleista on toimitettu, osaa ei.                      |
| **Luovutettu**          | Kaikki artikkelit on toimitettu asiakkaalle.                   |

Vuokrauksissa palautukset eivät siirrä merkintää taaksepäin. Palautettu artikkeli lasketaan koonnissa toimitetuksi, joten tilaus, jossa osa artikkeleista on palautettu ja osa vielä ulkona, pysyy tilassa **Luovutettu**.

## Suhteet

* **Tilauksen tila** on projektio taustajärjestelmän ylläpitämistä tarkemmista sisäisistä tiloista.
* **Maksun tila** johdetaan liitetyistä [maksuista ja tapahtumista](/docs/fi/concepts/orders/payments), ja sitä seurataan rivitietokohtaisesti.
* **Keräilytila** kootaan kunkin rivitiedon [varastoartikkeli](/docs/fi/concepts/inventory/stock-item-state)varauksista.
* Työnkulun voi määrittää käynnistymään minkä tahansa kolmen ulottuvuuden siirtymästä — katso [Automaattinen keräily](/docs/fi/concepts/orders/auto-fulfillment).

## Elinkaari

### Tilasiirtymät

<Tabs>
  <Tab title="Avoin → Käynnissä" icon="arrow-right">
    **Milloin**: Artikkelit noudetaan, lähetetään tai vuokra-aika alkaa.

    **Mitä tapahtuu**:

    * Varastoartikkelit sidotaan tilaukseen ja merkitään ulkona oleviksi
    * Keräilymerkintä siirtyy kohti tilaa **Valmisteltu** tai **Luovutettu**
    * Maksu veloitetaan, jos kanava käyttää katevarausta (varattu summa veloitetaan tällöin)

    **Esimerkkejä käynnistäjistä**:

    * Henkilökunta merkitsee kaikki rivitiedot noudetuiksi myymälässä
    * Toimitustarra luodaan ja kuljetusliike vahvistaa noudon
    * Työnkulku tapahtumasta **Pickup completed** käynnistyy
  </Tab>

  <Tab title="Käynnissä → Suljettu" icon="check">
    **Milloin**: Kaikki artikkelit on palautettu (vuokraus) tai keräily on valmis (myynti).

    **Mitä tapahtuu**:

    * Varastoartikkelit vapautetaan takaisin varastoon
    * Tilaus siirtyy pois aktiivisesta toiminnasta historiaan
    * Mahdolliset pantit vapautetaan tai hyvitetään
    * Tietueet pysyvät saatavilla raportointia ja hakua varten
  </Tab>

  <Tab title="Avoin → Suljettu" icon="xmark">
    **Milloin**: Tilaus peruutetaan ennen kuin mitään on toimitettu.

    **Mitä tapahtuu**:

    * Varastositoumuksia ei tehdä
    * Pantin pidätykset perutaan; veloitetut maksut hyvitetään
    * Tilaus näkyy historiassa peruutettuna
  </Tab>
</Tabs>

### Peruutuksen vaikutus eri vaiheissa

| Vaihe                              | Mitä peruutus tekee                                                                                                              |
| :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |
| **Avoin, Keräämättä**              | Peruu mahdollisen pantin pidätyksen, vapauttaa varastovarauksen, hyvitystä ei tarvita.                                           |
| **Avoin, Valmisteltu**             | Vapauttaa valmistellut varastoartikkelit. Jos maksu on veloitettu, se hyvitetään.                                                |
| **Käynnissä, Osittain luovutettu** | Toimittamattomat artikkelit vapautetaan; toimitetut on palautettava käsin. Yleensä tarvitaan osittainen hyvitys.                 |
| **Käynnissä, Luovutettu**          | Peruutus vastaa käytännössä kaikkien artikkelien palauttamista etuajassa. Tilauksen peruutusehdot määrittävät hyvityksen määrän. |
| **Suljettu**                       | Peruutus ei ole enää mahdollinen. Käytä sen sijaan hyvitystä — katso [Maksut](/docs/fi/concepts/orders/payments).                     |

### Muokkaussäännöt eri vaiheissa

| Vaihe                  | Muokattavissa | Huomioita                                                                                            |
| :--------------------- | :------------ | :--------------------------------------------------------------------------------------------------- |
| **Avoin, Keräämättä**  | Kyllä         | Lisää tai poista artikkeleita, muuta päivämääriä, muuta hinnoittelua.                                |
| **Avoin, Valmisteltu** | Rajoitetusti  | Artikkeleita voi vaihtaa, mutta varastositoumukset voi joutua kohdistamaan uudelleen.                |
| **Käynnissä**          | Rajoitetusti  | Voit pidentää vuokra-aikaa ja lisätä lisiä, mutta et poistaa toimitettuja artikkeleita.              |
| **Suljettu**           | Ei            | Muokkaus on lukittu. Hyvitykset ovat yhä mahdollisia — katso [Maksut](/docs/fi/concepts/orders/payments). |

Muokkausoikeudet riippuvat myös työntekijän roolista. Katso [Käyttäjät ja roolit](/docs/fi/settings/users-roles).

### Vuokrausesimerkki käytännöstä

Asiakas varaa 3 artikkelia kolmen päivän vuokraukseen perjantaiksi — maastopyörän, kypärän ja lukon. Hän maksaa verkossa kassalla 30 %:n ennakon. Loppusumma peritään noudon yhteydessä.

| Aika         | Tapahtuma                                                  | Tilauksen tila | Maksu                         | Keräily             |
| :----------- | :--------------------------------------------------------- | :------------- | :---------------------------- | :------------------ |
| **Ke**       | Verkkokassa lähetetään                                     | Avoin          | Ei maksettu                   | Keräämättä          |
| **Ke**       | Ennakkomaksu veloitetaan                                   | Avoin          | Ei maksettu (saldoa jäljellä) | Keräämättä          |
| **To**       | Henkilökunta merkitsee kypärän ja lukon tilaan Valmisteltu | Avoin          | Ei maksettu                   | Osittain luovutettu |
| **Pe 09:00** | Asiakas saapuu ja maksaa loppusumman                       | Avoin          | Maksettu                      | Osittain luovutettu |
| **Pe 09:05** | Pyörä luovutetaan                                          | **Käynnissä**  | Maksettu                      | **Luovutettu**      |
| **Su 18:00** | Kaikki artikkelit palautetaan                              | **Suljettu**   | Maksettu                      | Luovutettu          |

## Usein kysytyt kysymykset

<AccordionGroup>
  <Accordion title="Voiko tilaus olla Suljettu, vaikka sillä on maksamatonta saldoa?">
    Kyllä. Tilauksen tila ja maksun tila ovat toisistaan riippumattomia. Työntekijä voi sulkea tilauksen käsin (esimerkiksi saldon alaskirjauksen jälkeen). Tarkista avoimet summat maksumerkinnästä ennen sulkemista.
  </Accordion>

  <Accordion title="Mitä eroa on tiloilla Valmisteltu ja Luovutettu?">
    **Valmisteltu** tarkoittaa, että varastoartikkelit on valmisteltu ja kohdistettu mutta niitä ei ole vielä luovutettu asiakkaalle. **Luovutettu** tarkoittaa, että asiakkaalla on ne. Valmisteltu-vaiheen voi hyvin ohittaa — moni kauppias käyttää vain siirtymää **Keräämättä** → **Luovutettu**.
  </Accordion>

  <Accordion title="Palaako vuokratilaus tilaan Osittain luovutettu, kun artikkeleita palautetaan?">
    Ei. Toimitettu, palautettu ja peruutettu lasketaan kaikki keräilykoonnissa lopullisiksi tiloiksi. Kun kaikki artikkelit ovat kerran ulkona, artikkelien palauttaminen yksi kerrallaan pitää tilauksen tilassa **Luovutettu** — merkintä ei koskaan palaa tilaan **Osittain luovutettu**.
  </Accordion>

  <Accordion title="Voinko avata suljetun tilauksen uudelleen?">
    Et. Suljetut tilaukset ovat muuttumattomia. Jos samat artikkelit pitää vuokrata uudelleen samalle asiakkaalle, luo uusi tilaus.
  </Accordion>

  <Accordion title="Miten löydän kaikki aktiiviset vuokraukset?">
    Suodata Tilaukset-taulukkoa arvolla **Tilauksen tila = Käynnissä**. API-integraatiossa hae tilaukset parametrilla `state=active` — katso esimerkki alta.
  </Accordion>
</AccordionGroup>

## Kehittäjäviite

Tilaukset ovat API:ssa resurssina `orders`.

<Card title="API: Orders" icon="code" href="https://server.twicecommerce.com/api/internal">
  Avaa päätepiste API-referenssissä.
</Card>

## Aiheeseen liittyvää

<CardGroup cols={2}>
  <Card title="Maksut" icon="receipt" href="/docs/fi/concepts/orders/payments">
    Maksujen hierarkia, tapahtumat ja hyvitykset.
  </Card>

  <Card title="Tilaustyypit" icon="tags" href="/docs/fi/concepts/orders/order-types">
    Vuokraukset, myynnit, kestotilaukset ja takaisinostot.
  </Card>

  <Card title="Varastoartikkelin tila" icon="box" href="/docs/fi/concepts/inventory/stock-item-state">
    Miten tilaukset sitovat ja vapauttavat varastoartikkeleita.
  </Card>

  <Card title="Automaattinen keräily" icon="bolt" href="/docs/fi/concepts/orders/auto-fulfillment">
    Varastoartikkelien automaattinen kohdistus saapuviin tilauksiin.
  </Card>
</CardGroup>
