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

# Tilaustyypit

> TWICEn eri tapahtumatyypit: vuokra-, myynti-, kesto- ja takaisinostotilaukset.

<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äkyy eri tilaustyyppejä" width="1920" height="1080" data-path="images/orders-overview.webp" />
</Frame>

## Määritelmä

<Snippet file="definitions/fi/order-types-definition.mdx" />

Tilauksen tyyppi määräytyy sen rivitietojen **ostotyypin** perusteella. Jokaisella tilausrivillä on `purchaseType`-kenttä, ja sama tilaus voi sisältää erityyppisiä rivitietoja — esimerkiksi vuokrapyörän ja suoraan myytävän lisävarusteen. Ostotyyppi ohjaa sitä, miten hinnoittelu lasketaan, mitkä keräilysäännöt pätevät ja mitkä elinkaarisiirtymät ovat sallittuja.

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

* [Automaattisen keräilyn](/docs/fi/concepts/orders/auto-fulfillment) sääntöjen määrittäminen ostotyypeittäin
* [Listausten](/docs/fi/concepts/catalog/listings) määrittäminen varattaviksi, ostettaviksi tai molemmiksi
* Raporttien suodattaminen ostotyypin mukaan
* Työnkulkujen rakentaminen, jotka haarautuvat tilaustyypin mukaan
* API-integraatiot, joiden on toimittava eri tavalla vuokrauksissa ja myynneissä

## Keskeiset ominaisuudet

Tuetut ostotyypit määritellään kentässä `OrderItem.purchaseType`:

| Ostotyyppi           | Sisäinen arvo  | Mitä se tarkoittaa                                         |
| :------------------- | :------------- | :--------------------------------------------------------- |
| **Rental / Booking** | `booking`      | Väliaikainen käyttö, palautus odotetaan päivänä `endDate`. |
| **Sale**             | `sale`         | Kertaluonteinen omistajuuden siirto. Ei palautusta.        |
| **Subscription**     | `subscription` | Toistuva laskutus jatkuvasta käyttöoikeudesta.             |
| **Buyback**          | `buyback`      | Hankit artikkelin asiakkaalta.                             |

Jokaisella rivitiedolla on:

* `startDate` ja `endDate` — määrittävät vuokrauksissa vuokra-ajan; myynneissä valinnaiset
* `duration` ja `durationLabel` — vuokra-ajan pituus ja sen näyttöteksti
* `pricing` — laskettu [hintataulukosta](/docs/fi/concepts/catalog/price-tables), joka vastaa rivitiedon `purchaseType`-arvoa ja päivämääriä
* `capturedTotal` ja `refundedTotal` — rivikohtainen maksujen koonti
* `depositAuthorisedTotal`, `depositCapturedTotal`, `depositRefundedTotal`, `depositCancelledTotal` — rivikohtaiset panttisummat, tavallisia vuokrauksissa
* `fulfillmentState` — rivin oma keräilytila; riviin sidotuilla varastoartikkeleilla on kullakin omansa

## Suhteet

* Jokainen [tilausrivi](/docs/fi/concepts/orders/order-lifecycle) viittaa [listaukseen](/docs/fi/concepts/catalog/listings) ja perii sen sallitut ostotyypit.
* Täsmäävä [hintataulukko](/docs/fi/concepts/catalog/price-tables) määrittää rivitiedon hinnoittelun (päiväkohtainen, kiinteä, takaisinostoissa arvonalenemisen huomioiva jne.).
* [Palvelusijainnit](/docs/fi/concepts/admin/locations) määrittävät erilliset keräily- ja palautussäännöt ostotyypeittäin — katso [Automaattinen keräily](/docs/fi/concepts/orders/auto-fulfillment).
* Vuokrariviin sidotut [varastoartikkelit](/docs/fi/concepts/inventory/stock-item-state) lähtevät ulos noudossa ja palaavat vuokra-ajan päättyessä; myyntirivit eivät palaudu.

## Elinkaari

### Vuokratilaukset

Kiertotalouden oletuskäyttötapaus. Asiakas ottaa artikkelit haltuunsa määritellyksi ajaksi ja palauttaa ne sitten.

* **Hinnoittelu**: ajanjaksokohtaiset hinnat listauksen vuokrahintataulukosta (tunti-, päivä-, viikko- tai mukautettu hinta).
* **Keräily**: nouto (myymälästä, keräilynä tai paikallisena keräilynä) päivänä `startDate`, palautus päivänä `endDate`.
* **Pantit**: yleensä vaaditaan. Varataan erillisenä pantin pidätyksenä tai veloituksena ja vapautetaan tai hyvitetään palautuksessa.
* **Elinkaari**: Avoin → Käynnissä → Suljettu.
* **Peruutus**: määräytyy tilauksen [peruutusehtojen](/docs/fi/concepts/orders/order-lifecycle) mukaan.
* **Muokkaukset**: vuokra-aikaa voi yleensä pidentää tilan ollessa Käynnissä.

### Myyntitilaukset

Pysyvä omistajuuden siirto — tyypillistä lisävarusteille, käytettyjen tuotteiden jälleenmyynnille tai uusien tuotteiden myynnille vuokrakatalogin rinnalla.

* **Hinnoittelu**: kiinteä myyntihinta listauksen myyntihintataulukosta.
* **Keräily**: yksi keräilytapahtuma. Palautusta ei odoteta.
* **Pantit**: ei sovellu.
* **Elinkaari**: Avoin → Käynnissä (luovutettu / lähetetty) → Suljettu. Vuokrauksen luovutus- ja palautusvaihetta ei ole.
* **Peruutus**: keräilyn jälkeen on käytettävä hyvitysprosessia — katso [Maksut](/docs/fi/concepts/orders/payments).
* **Muokkaukset**: artikkeleita voi lisätä tai poistaa tilan ollessa Avoin, ei keräilyn jälkeen.

### Kestotilaukset

Toistuva laskutus jatkuvasta tuotteen tai palvelun käyttöoikeudesta — käytetään jäsenyyksissä, leasing-tyyppisissä vuokrauksissa ja gear-as-a-service-malleissa.

* **Hinnoittelu**: jaksokohtainen hinta listauksen kestotilaus[hintataulukosta](/docs/fi/concepts/catalog/price-tables). Jokainen suunnitelma määrittää maksujakson (esim. kuukausittain), sitoutumisajan ja valinnaisen uusintahinnan.
* **Keräily**: tyypillisesti yksi alkukeräily, ja tilauskautta seurataan tilauksella.
* **Laskutus**: edellyttää toistuvia maksuja tukevaa maksupalveluntarjoajaa (Stripen tai Adyenin korttimaksut).
* **Elinkaari**: pysyy tilassa Käynnissä kestotilauksen ajan. Sulkeutuu, kun kestotilaus päättyy tai se peruutetaan.
* **Peruutus**: päättää kestotilauksen ja lopettaa tulevan laskutuksen. Artikkelit voi olla tarpeen palauttaa sopimuksesta riippuen.
* **Asiakasportaali**: asiakkaat hallitsevat kestotilauksiaan itsepalveluna [kestotilausportaalissa](/docs/fi/concepts/orders/subscription-portal) — pääsy tapahtuu kestotilaussähköpostien turvallisen linkin kautta.

### Takaisinostotilaukset

Kauppias hankkii artikkelin asiakkaalta — keskeinen osa kiertotaloutta. Käytetään, kun asiakkaat vaihtavat tai myyvät käytettyjä artikkeleita takaisin.

* **Hinnoittelu**: kauppias maksaa asiakkaalle. Usein laskettu arvonalenemisprosentista tai kuntoon perustuvasta kaavasta.
* **Keräily**: asiakas luovuttaa artikkelin; kauppias vastaanottaa sen varastoon uutena [varastoartikkelina](/docs/fi/concepts/inventory/stock-item-state).
* **Maksun suunta**: käänteinen — kauppias on velkaa asiakkaalle. Maksut suoritetaan määritetyllä maksutavalla.
* **Elinkaari**: Avoin (tarjous odottaa) → Käynnissä (artikkeli vastaanotettu) → Suljettu (maksu suoritettu).
* **Missä näkyy**: [Palvelusijainneilla](/docs/fi/concepts/admin/locations) on oma **Buyback**-välilehti keräily- ja palautussäännöissään.

### Sekatilaukset

Yksittäinen tilaus voi sisältää eri ostotyyppien rivitietoja — esimerkiksi viikon suksivuokrauksen (`booking`) ja parin sukkia (`sale`). Jokaisella rivitiedolla on oma `purchaseType`, omat päivämäärät ja oma hinnoittelu, ja se toimitetaan kyseisen tyypin sääntöjen mukaan.

## Usein kysytyt kysymykset

<AccordionGroup>
  <Accordion title="Miten TWICE päättää, voiko listauksen vuokrata vai ostaa?">
    Jokaisella listauksella on yksi tai useampi hintataulukko. Näiden taulukoiden `purchaseType`-arvojen joukko määrittää, mitä listaus tukee. Myyntihintataulukon lisääminen vuokralistaukseen tekee siitä ostettavan; kaikkien vuokrataulukoiden poistaminen tekee siitä pelkän myyntikohteen.
  </Accordion>

  <Accordion title="Voiko saman varastoartikkelin sekä vuokrata että myydä?">
    Kyllä — se on kiertotalouden ydin. Varastoartikkeli kulkee vuokrauskiertojen läpi, ja jossain vaiheessa kauppias voi muuttaa sen myynniksi (tai takaisinostotarjoukseksi asiakkaalle). Varastoartikkelin historia kirjaa jokaisen tilauksen, jossa se on ollut mukana.
  </Accordion>

  <Accordion title="Toimivatko kestotilaukset ja vuokraukset yhdessä?">
    Kestotilaukset sopivat parhaiten jatkuvaan käyttöoikeuteen ilman kiinteää palautuspäivää. Vuokraukset sopivat parhaiten määrämittaisiin varauksiin, joissa on selkeä palautustapahtuma. Käytä sitä, mikä vastaa asiakassopimusta — tietomalli tukee molempia, tarvittaessa samalla listauksella.
  </Accordion>

  <Accordion title="Onko vuokrauksen ostotyypin nimi `rental` vai `booking`?">
    `booking`. Tilausrivien sisäinen enum-arvo on `booking` — arvoa `rental` ei ole. Hallintapaneeli nimeää saman käsitteen joko **Booking** tai **Rental** asiayhteydestä riippuen; [palvelusijaintien](/docs/fi/concepts/admin/locations) keräilysäännöt käyttävät nimeä **Booking**. Käsittele nimiä vastaavina, mutta lähetä API:iin aina `booking`.
  </Accordion>

  <Accordion title="Miten takaisinostot hinnoitellaan?">
    Hinnoittelu perustuu tyypillisesti listauksen arvonalenemissääntöön tai henkilökunnan syöttämään manuaaliseen tarjoukseen. Tulos tallennetaan tilausriville kuten minkä tahansa muun ostotyypin kohdalla.
  </Accordion>
</AccordionGroup>

## Kehittäjäviite

Tilaustyyppi asetetaan `purchaseType`-kentällä `orders`-päätepisteissä.

<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="Tilauksen elinkaari" icon="rotate" href="/docs/fi/concepts/orders/order-lifecycle">
    Tilauksen, maksun ja keräilyn tilat.
  </Card>

  <Card title="Maksut" icon="receipt" href="/docs/fi/concepts/orders/payments">
    Hierarkia, pantit, hyvitykset ja maksujen suoritukset.
  </Card>

  <Card title="Hintataulukot" icon="table" href="/docs/fi/concepts/catalog/price-tables">
    Tyyppikohtainen hinnoittelu listausta kohti.
  </Card>

  <Card title="Automaattinen keräily" icon="bolt" href="/docs/fi/concepts/orders/auto-fulfillment">
    Tyyppikohtaiset keräilysäännöt.
  </Card>

  <Card title="Kestotilausportaali" icon="user" href="/docs/fi/concepts/orders/subscription-portal">
    Asiakkaan itsepalvelu kestotilauksille.
  </Card>
</CardGroup>