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

# Varastoartikkelin tila (status)

> Ymmärrä varastoartikkelin kolme tilaa: Aktiivinen, Ei aktiivinen ja Luonnos.

export const stockItemStatusDefinition = "Varastoartikkelin operatiivinen käytettävyys. Aktiiviset artikkelit ovat käytettävissä tilauksissa, vuokrauksissa ja varastotoiminnoissa. Ei-aktiiviset artikkelit on rajattu pois kohdennuksista toistaiseksi (esimerkiksi poistettu käytöstä, korjattavana tai karanteenissa). Jos artikkeli on tilapäisesti pois käytöstä, käytä sen sijaan varausta.";

<Frame caption="Inventaario > Varastoartikkelit > [Artikkeli] > Yleiset">
  <img src="https://mintcdn.com/twicecommerce/lZhc_tO8u1u_bL0Q/images/stock-item-general-tab.webp?fit=max&auto=format&n=lZhc_tO8u1u_bL0Q&q=85&s=e0a29bba3d2126e9149d978d008e2a62" alt="Varastoartikkelin tila Yleiset-välilehdellä" width="1920" height="1080" data-path="images/stock-item-general-tab.webp" />
</Frame>

## Määritelmä

<Tooltip tip={stockItemStatusDefinition}>Varastoartikkelin tila (status)</Tooltip> kertoo, missä kohtaa **operatiivista elinkaartaan** artikkeli on. Se määrää, lasketaanko artikkeli mukaan saatavuuteen ja voidaanko se liittää tilauksiin.

**Kolme tila-arvoa:**

| UI-nimi           | API-arvo   | Merkitys                                                                                                                              |
| ----------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Aktiivinen**    | `active`   | Artikkeli on käytössä — se lasketaan mukaan saatavuuteen ja voidaan liittää tilauksiin.                                               |
| **Ei aktiivinen** | `inactive` | Artikkeli on suljettu pois toiminnasta (esim. korjattavana, poistettu käytöstä, kadonnut tai myyty). Tietue ja sen historia säilyvät. |
| **Luonnos**       | `draft`    | Rekisteröinti on kesken. Artikkeli ei ole vielä käytössä.                                                                             |

Article-resurssin `status`-kenttä saa täsmälleen nämä kolme arvoa. Muita tiloja ei ole — esimerkiksi kadonnut tai myyty artikkeli käsitellään tilalla **Ei aktiivinen** (katso alla).

Tila (status) on riippumaton [fyysisestä tilasta (state)](/docs/fi/concepts/inventory/stock-item-state) (Sisällä / Ulkona — fyysinen sijainti).

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

Näet ja muokkaat tilaa kunkin varastoartikkelin **Yleiset**-välilehdellä sekä varastoartikkelitaulukon sarakkeena ja suodattimena. Tila näkyy myös merkkinä artikkelin otsikossa: **Aktiivinen** (vihreä), **Luonnos** (oranssi), **Ei aktiivinen** (punainen).

Tila vaikuttaa seuraaviin:

* **Saatavuuslaskenta** — vain **Aktiiviset** artikkelit lasketaan mukaan myytävissä olevaan määrään (ATS). Saatavuuskyselyt liittävät varastoartikkelit ehdolla `status = 'active'`.
* **Tilausten keräily** — vain **Aktiivisia** artikkeleita voidaan liittää uusiin tilauksiin.
* **Raportit** — suodata tilan perusteella, niin erotat operatiivisen varaston käytöstä poistetusta.
* **Listaukset** — SKU:sta lukevat listaukset laskevat mukaan vain aktiiviset varastoartikkelit.

Lue lisää: [Varastoartikkelit — Yleiset-välilehti](/docs/fi/inventory/stock-items/general).

## Keskeiset ominaisuudet

| Ominaisuus                                             | Aktiivinen       | Ei aktiivinen | Luonnos                      |
| ------------------------------------------------------ | ---------------- | ------------- | ---------------------------- |
| Käytettävissä uusiin tilauksiin                        | Kyllä            | Ei            | Ei                           |
| Lasketaan ATS:ään                                      | Kyllä            | Ei            | Ei                           |
| Säilyttää historian (kirjanpito, tapahtumat, liitteet) | Kyllä            | Kyllä         | Kyllä                        |
| Voi siirtyä tilaan                                     | Ei aktiivinen    | Aktiivinen    | Aktiivinen tai Ei aktiivinen |
| Tyypillinen asettaja                                   | Oletus luonnissa | Käyttäjä      | Rekisteröinti                |

## Milloin kutakin tilaa käytetään

### Aktiivinen

Oletus kaikille artikkeleille, jotka ovat valmiita käyttöön. Uudet varastoartikkelit luodaan arvolla `status: 'active'`, ellet määritä toisin.

* Vuokraukset tai myynnit, jotka ovat saatavilla nyt.
* Toimintakuntoiset artikkelit.
* Hyllyssä tai kalustokierrossa olevat artikkelit.

### Ei aktiivinen

Käytä tilaa **Ei aktiivinen**, kun artikkeli halutaan sulkea pois toiminnasta toistaiseksi.

* Pitkäaikaisessa korjauksessa tai kunnostuksessa.
* Poistettu käytöstä mutta säilytetään tietueena.
* Karanteenissa tarkastusta odottamassa.
* Kadonnut, varastettu tai poistettu kirjanpidosta.
* Myyty eikä enää seurannassa.
* Esittely- tai testiyksiköt, jotka eivät ole asiakaskäytössä.

<Warning>
  Kun kyse on **tilapäisestä** poissaolosta, jonka päättymisajankohta tiedetään (viikon huoltoikkuna, valokuvaus, artikkelin pitäminen varattuna tiettyä päivää varten), käytä sen sijaan tyypin `reservation` **ajoitettua tapahtumaa**. Varaukset vanhenevat automaattisesti — **Ei aktiivinen** vaatii manuaalisen uudelleenaktivoinnin. Katso [Varastoartikkelin tapahtumat](/docs/fi/concepts/inventory/events).
</Warning>

### Luonnos

**Luonnos** merkitsee artikkelia, jonka rekisteröinti on kesken. Rekisteröinti luo luonnostietueita sitä mukaa kuin täytät tietoja ja viimeistelee ne rekisteröinnin valmistuessa. Esimerkiksi tekoälyavusteinen rekisteröintidialogi luo luonnoksen, johon ladatut kuvat liitetään.

Kun artikkeli on rekisteröity, hallintapaneelin tilavalikko tarjoaa vain vaihtoehdot **Aktiivinen** ja **Ei aktiivinen** — käyttöliittymä ei palauta rekisteröityä artikkelia takaisin **Luonnokseksi**.

## Artikkelin poistaminen käytöstä

Erillistä ”poistettu”, ”kadonnut” tai ”myyty” -tilaa ei ole. Poista artikkeli käytöstä asettamalla sen tilaksi **Ei aktiivinen**:

* Artikkelin **Yleiset**-välilehdeltä tai taulukon massatoiminnolla.
* Kutsulla `PUT /articles/:id` ja rungolla `{"status": "inactive"}`.
* Kutsulla `POST /articles/:id/inactivate`. Tämä päätepiste käy lisäksi läpi artikkelin tulevat varaukset ja yrittää siirtää jokaisen toiselle saatavilla olevalle varastoartikkelille. Näin yksikään tilaus ei jää huomaamatta ilman artikkelia.

Kaikki historia — kirjanpito, tapahtumat, media, dokumentit — säilyy tietueella. Artikkeli poistuu ATS-laskennasta, eikä sitä voi enää liittää uusiin tilauksiin.

<Tip>
  Käytöstä poisto tilamuutoksella poiston sijaan säilyttää artikkelin koko historian — ostotiedot, vuokraushistorian, kirjanpitomerkinnät — pitämättä sitä mukana saatavuuslaskennassa. Jos haluat kirjata *miksi* artikkeli meni Ei-aktiiviseksi (kadonnut, myyty, vaurioitunut), lisää muistiinpanotapahtuma tai kirjanpitomerkintä.
</Tip>

## Tilasiirtymät

```mermaid theme={null}
stateDiagram-v2
    direction LR
    Luonnos --> Aktiivinen: rekisteröinti valmistuu
    Luonnos --> Ei_aktiivinen: rekisteröity ei-operatiivisena
    Aktiivinen --> Ei_aktiivinen: poisto käytöstä / korjaus / kadonnut / myyty
    Ei_aktiivinen --> Aktiivinen: takaisin käyttöön
```

* **Luonnos → Aktiivinen** — rekisteröinnin normaali lopputulos.
* **Aktiivinen ↔ Ei aktiivinen** — siirtymä toimii vapaasti kumpaankin suuntaan. Uudelleenaktivointi palauttaa artikkelin ATS-laskentaan kaikilla ajanjaksoilla, joille sitä ei ole jo sidottu. Historiaa ei menetetä kumpaankaan suuntaan.
* **→ Luonnos** — ei tarjolla hallintapaneelissa rekisteröinnin jälkeen.

Jokainen tilamuutos kirjataan artikkelin toimintalokiin päivitystapahtumana, joka sisältää muuttuneen arvon ja muutoksen tehneen käyttäjän. Voit siis selvittää jälkikäteen, milloin kukin muutos tapahtui.

### Mikä muuttuu heti

Kun asetat **Aktiivisen** artikkelin tilaan **Ei aktiivinen**:

* Artikkeli poistuu ATS-laskennasta seuraavaan saatavuuslukuun mennessä.
* Artikkeli suljetaan pois uusien tilausten kohdennuksesta.
* Olemassa olevia tilauksia, joissa artikkeli jo on, **ei** muuteta — siirrä tai käsittele ne manuaalisesti. Voit myös käyttää kutsua `POST /articles/:id/inactivate`, joka yrittää siirron puolestasi.
* Kirjanpito, tapahtumat, media ja dokumentit säilyvät ennallaan.

Kun asetat **Ei-aktiivisen** artikkelin tilaan **Aktiivinen**:

* Artikkeli lasketaan jälleen mukaan ATS:ään kaikilla ajanjaksoilla, joille sitä ei ole jo sidottu.
* Artikkeli on jälleen käytettävissä uusiin tilauksiin.
* Historiaa ei menetetä.

## Elinkaari

### Luonti

Uusien varastoartikkelien oletus on `status: 'active'`. Voit ohittaa oletuksen luonnin yhteydessä:

* Aseta `status: 'inactive'`, kun tuot artikkeleita, jotka vaativat vielä tarkastuksen — ne pysyvät poissa saatavuudesta, kunnes muutat tilan.
* Arvon `status: 'draft'` asettaa yleensä rekisteröinti, ei käyttäjä.

### Muokkaus

Muuta tilaa artikkelin Yleiset-välilehdeltä, taulukon massatoiminnolla tai API:n kautta — katso `articles`-päätepisteet [API-viitteestä](https://server.twicecommerce.com/api/internal). Listapäätepisteen suodattimien `status`-kenttä hyväksyy yhden kolmesta arvosta.

Massadeaktivointiin (esim. kauden lopun käytöstä poisto) käytä massamuokkauksen käyttöliittymää.

### Poisto

Suosi tilan asettamista arvoon **Ei aktiivinen** poiston sijaan. Poisto on peruuttamaton — `DELETE /articles/:id` poistaa artikkelitietueen ja siihen liittyvät tiedot.

## UKK

<AccordionGroup>
  <Accordion title="Mikä ero on tilalla (status) ja fyysisellä tilalla (state)?">
    * **Tila (status)** (Aktiivinen / Ei aktiivinen / Luonnos) — operatiivinen elinkaari, asetetaan manuaalisesti.
    * **Fyysinen tila (state)** (Sisällä / Ulkona) — fyysinen sijainti, asettuu automaattisesti keräilyn mukaan.

    **Aktiivinen** artikkeli voi olla **Ulkona** (asiakkaalla). **Ei aktiivinen** artikkeli voi olla **Sisällä** (varastossasi, poissa käytöstä). Nämä kaksi ovat toisistaan riippumattomia. Lue lisää: [Varastoartikkelin fyysinen tila](/docs/fi/concepts/inventory/stock-item-state).
  </Accordion>

  <Accordion title="Miten kirjaan kadonneen tai myydyn artikkelin?">
    Aseta tilaksi **Ei aktiivinen**. Erillistä Kadonnut- tai Myyty-tilaa ei ole. Jos haluat säilyttää syyn tietueella, lisää muistiinpano artikkelin aikajanalle tai kirjaa kirjanpitomerkintä. Artikkelin koko historia jää käytettäväksi jatkotoimia, kirjanpitoa ja raportointia varten.
  </Accordion>

  <Accordion title="Käytänkö Ei-aktiivista vai varausta tilapäiseen poissaoloon?">
    Käytä **varausta**, kun tiedät, milloin artikkeli on taas saatavilla — varaukset vanhenevat automaattisesti. Käytä tilaa **Ei aktiivinen**, kun ajankohta on avoin tai toistaiseksi voimassa.
  </Accordion>

  <Accordion title="Miten löydän kaikki Ei-aktiiviset artikkelit?">
    Avaa **Inventaario > Varastoartikkelit** ja suodata tilasarake arvoon **Ei aktiivinen**. Sama suodatin on käytettävissä API:ssa `status`-kentällä.
  </Accordion>

  <Accordion title="Voiko Ei-aktiivisella artikkelilla olla avoimia tilauksia?">
    Kyllä. Artikkelin asettaminen Ei-aktiiviseksi ei peruuta takautuvasti tilauksia, joissa artikkeli jo on. Käsittele ne manuaalisesti — hyvitä rivi, siirrä toiselle varastoartikkelille tai peruuta. Päätepiste `POST /articles/:id/inactivate` yrittää siirron automaattisesti.
  </Accordion>

  <Accordion title="Voinko palauttaa Ei-aktiivisen artikkelin käyttöön?">
    Kyllä. Vaihda tila takaisin arvoon **Aktiivinen**. Kaikki historiatiedot säilyvät. Tämä on hyödyllistä korjauksesta palanneille, löytyneille tai palautetuille artikkeleille.
  </Accordion>

  <Accordion title="Näkyykö Luonnos käyttöliittymässä?">
    Kyllä — luonnosartikkelin otsikossa näkyy oranssi **Luonnos**-merkki. Luonnokset syntyvät keskeneräisistä rekisteröinneistä. Rekisteröinnin jälkeen hallintapaneeli ei tarjoa artikkelin palauttamista Luonnokseksi.
  </Accordion>
</AccordionGroup>

## Kehittäjän viite

Varastoartikkelin tila luetaan ja päivitetään `articles`-päätepisteiden kautta.

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

## Aiheeseen liittyvät käsitteet

<CardGroup cols={2}>
  <Card title="Varastoartikkelit" icon="box" href="/docs/fi/concepts/inventory/stock-items">
    Varastoartikkelin koko malli ja elinkaari
  </Card>

  <Card title="Varastoartikkelin fyysinen tila" icon="arrows-rotate" href="/docs/fi/concepts/inventory/stock-item-state">
    Sisällä vai Ulkona — fyysisen sijainnin ulottuvuus
  </Card>

  <Card title="Varastoartikkelin tapahtumat" icon="clock-rotate-left" href="/docs/fi/concepts/inventory/events">
    Varaukset, muistiinpanot, toimintaloki
  </Card>

  <Card title="Työnkulut" icon="diagram-project" href="/docs/fi/workflows">
    Automatisoi varastotoiminnot
  </Card>
</CardGroup>