Varastoartikkeli

Varastoartikkelitaulukko hallinnassa — Inventaario > Varastoartikkelit

Määritelmä

Varastoartikkeli (API:ssa article) on se varaston yksikkö, jonka todella omistat. Se sisältää koodit, sijainnin, kunnon, attribuutit, mediat, dokumentit, täyden tapahtuma-aikajanan sekä tulojen ja kulujen reskontran. Jokainen varastoartikkeli kuuluu tenantille ja sijaitsee palvelusijainnissa. Se voidaan myös linkittää SKU:hun, jolta se oletuksena perii tuotetason kentät.

Vertauskuva: Varastoartikkeli on fyysisen tuotteen passi. Kuten passi seuraa henkilön matkaa yksilöivällä tunnuksella, varastoartikkeli seuraa tuotteen koko elinkaarta omalla artikkelikoodillaan — missä se on ollut, mitä sille on tapahtunut ja missä se on nyt.

Erityistä TWICEssä: Varastoartikkelit ovat oletuksena sarjanumeroituja — rekisteröinti seuraa jokaista kappaletta erikseen, ellet poista Track individually -valintaa. Yksi fyysinen esine = yksi varastoartikkeli. Näin saat käyttöösi kappalekohtaisen kannattavuuden, kunnon seurannan ja huoltohistorian. Sama jako on myös artikkelireskontran perusta, joka kuvataan seuraavassa osiossa.

Missä sitä käytetään?

Varastoartikkelit ovat TWICEn varastojärjestelmän perusta. Käytät varastoartikkeleita, kun:

Rekisteröit uutta varastoa — kirjaat kalustoosi, myymälääsi tai varastoosi saapuvat kappaleet
Seuraat artikkelin elinkaarta — käyttö, vuokraukset, myynnit, huolto, arvonalennukset, hävittäminen
Hallitset saatavuutta — tiedät, mikä on käsillä, mikä asiakkaalla ja mikä korjattavana
Analysoit kannattavuutta — luet artikkelikohtaiset tulot ja kulut reskontrasta
Toimitat tilauksia — kohdistat tiettyjä artikkeleita asiakastilauksille ja skannaat niitä ulos ja sisään

Sarjanumeroituina varastoartikkeleita voi seurata tarkasti vuokraustoiminnassa, takaisinosto-ohjelmissa, kunnostusprosesseissa ja huoltopainotteisessa liiketoiminnassa.

Artikkelireskontra

Jokaisella varastoartikkelilla on oma reskontransa — aikajärjestyksessä oleva loki rahamääräisistä merkinnöistä, jotka ryhmitellään joko tuloiksi tai kuluiksi. Yhdessä ne muodostavat artikkelin kannattavuuden. Hallinnassa tämä näkyy artikkelin Tulot ja kulut -välilehtenä; API-resurssi on articleLedgers.

Kenttä	Mitä se sisältää
`itemIncome`	Kaikkien `group: 'income'` -merkintöjen summa (vuokrat, myynnit, myöhästymismaksut, lisäosat)
`itemCosts`	Kaikkien `group: 'cost'` -merkintöjen summa (ostohinta, korjaukset, arvonalennukset)
`profitability`	`itemIncome - itemCosts` tälle varastoartikkelille
`changeType`	`initial` (ostomerkintä), `update` (käsin) tai `depreciation` (järjestelmä)

Reskontramerkinnät voidaan sitoa orderId-arvoon (kirjataan automaattisesti, kun artikkeli tuottaa tilauksesta) tai scheduledEventId-arvoon (esim. kulua aiheuttanut huoltovaraus). Ne voivat myös olla itsenäisiä, kuten käsin tehdyt oikaisut.

Kappalekohtainen kannattavuus edellyttää sarjanumeroitua seurantaa. Yhteisvaraston varastoartikkeleilla (yksi tietue kattaa useita kappaleita) reskontran summat koskevat koko joukkoa — niitä ei voi kohdistaa yksittäiseen kappaleeseen. Katso Varastonseuranta.

Määrän käsittely: sarjanumeroitu vs. yhteisvarasto

Varastoartikkelin seurantatapa päätetään rekisteröinnissä Track individually -valintaruudulla (trackIndividually luontipyynnössä, oletus true) ja Quantity-kentällä.

Tapa	Luodut tietueet	Toiminta
Sarjanumeroitu	Yksi fyysistä kappaletta kohden	Täysi elinkaarihistoria ja oma reskontra kappaletta kohden
Yhteisvarasto	Yksi koko joukolle	N identtistä kappaletta yhtenä tietueena, koottu historia ja reskontra

Kun Track individually on päällä, määrän N rekisteröinti luo yhden varastoartikkelin kappaletta kohden. Kun se on pois päältä, luot yhden tietueen, joka kattaa N kappaletta. trackIndividually on vain luontivaiheen syöte — sitä ei tallenneta Article-resurssille. Vastauksissa quantity-objekti kertoo tietueen kappalemäärän total ja sen sijainneittaisen byLocation-erittelyn. Milloin kumpaakin kannattaa käyttää:

Sarjanumeroitu — pyörät, sukset, kamerat, nostimet, kajakit, sähköpotkulaudat, kaikki vuokrattavat tai arvokkaat käyttöomaisuuserät.
Yhteisvarasto — kypärät, lukot, kaulanauhat, hissiliput (kun ne eivät ole RFID-pohjaisia) ja pienet kulutustavarat, joita ei tarvitse jäljittää yksitellen.

Tapa asetetaan luonnissa. Jos haluat vaihtaa sitä myöhemmin, luo uusi tietue ja siirrä historia; muunnosta paikallaan ei tueta. Lue lisää: Varastonseuranta.

Keskeiset ominaisuudet

Varastoartikkelia edustaa Article-tyyppi. Tärkeimmät kentät:

Ominaisuus	Tyyppi	Kuvaus
`id`	UUID	Varastoartikkelin yksilöivä tunnus.
`codes`	string[]	Yksi tai useampi artikkelikoodi. Jokainen koodi on yksilöllinen tenantin sisällä. Katso Varastokoodit.
`name`	string	Hallinnassa näytettävä nimi.
`status`	`active` / `inactive` / `draft`	Operatiivinen elinkaari. Näkyy käyttöliittymässä arvoina Aktiivinen, Ei aktiivinen ja Luonnos. Katso Varastoartikkelin status.
`skuId`	UUID, nullable	Valinnainen linkki ylätason SKU:hun. Kun se on asetettu, artikkeli perii SKU-tason kentät.
`sku`	object	Upotettu SKU-yhteenveto (`id`, `name`, `code`), kun linkitys on olemassa.
`binLocation`	string, nullable	Tarkempi paikkamerkintä, esimerkiksi `Rack 3 / Bay B`.
`binLocationOrigin`	`article` / `sku`	Tuleeko hyllypaikka artikkelilta itseltään vai peritäänkö se SKU:lta.
`taxonomyCategoryId`	string, nullable	Taksonomiakategoria, johon artikkeli kuuluu.
`purchasePrice`	number, nullable	Hankintahinta (pienimmissä yksiköissä). Kirjautuu reskontraan `initial`-kulumerkintänä.
`purchasePriceOrigin`	`article` / `sku`	Ostohinnan lähde.
`description`	rich text JSON, nullable	Pitkä kuvaus.
`descriptionOrigin`	`article` / `sku`	Kuvauksen lähde.
`condition`	string, nullable	Vapaamuotoinen kuntomerkintä (esim. `New`, `Good`, `Fair`).
`attributes`	array	Tähän artikkeliin liitetyt resurssiattribuutit (peritään SKU:lta, ohitettavissa artikkelikohtaisesti).
`tags`	array	Tunnisteviittaukset.
`media`	array	Järjestetty lista kuva- ja videotiedostoja.
`documents`	array	Järjestetty lista tiedostoja, joissa valinnainen tiedostokohtainen kommentti.
`itemIncome`	number	Laskettu reskontran `income`-merkintöjen summa.
`itemCosts`	number	Laskettu reskontran `cost`-merkintöjen summa.
`profitability`	number	`itemIncome - itemCosts`.
`parentId` / `path`	string	Valinnainen hierarkiatuki ryhmitellyille artikkeleille.
`createdAt`	ISO datetime	Luonnin aikaleima.

Artikkelikohtainen tila lasketaan kyselyhetkellä, ja se on saatavilla saatavuustietoja sisältävässä vastauksessa:

Kenttä	Kuvaus
`unavailability`	Taulukko saatavuuskatkojaksoja (tilaukset, ajastetut tapahtumat). Ohjaa fyysistä Out-tilaa ja ATS-laskentaa.
`scheduledEvents`	Tähän artikkeliin liitetyt varaukset ja muistiinpanot. Katso Varastoartikkelin tapahtumat.
`articleLocations`	Aikaväleihin sidotut sijaintimääritykset. Nykyinen määrittää artikkelin tämänhetkisen sijainnin.
`quantity` / `availability`	Objektit, joissa `total`-lukumäärä ja `byLocation`-erittely — tietueen kappalemäärä yhteensä ja parhaillaan saatavilla olevat kappaleet.
`temporalStock`	Aikajaksoihin jaetut `stockBalance`, `stockAvailableToSell`, `stockCommitted` ja `stockUtilisation`.
`conflicts`	Ennakkonäkymä keräilyristiriidoista, jos vähennät määrää tai vaihdat sijaintia.

Ominaisuuksien perintä SKU:lta. purchasePrice, description, binLocation, attribuutit ja kategoria voidaan määrittää SKU:lle. Varastoartikkeli lukee arvot SKU:lta, ellei sillä ole omaa arvoa. API:n *Origin-kentät kertovat, mistä kukin arvo tuli (article vai sku). Arvon asettaminen artikkelille ohittaa SKU:n oletuksen; arvon tyhjentäminen palauttaa perinnän.

Status

Status kuvaa, missä kohtaa operatiivista elinkaartaan artikkeli on. Arvoja on kolme:

Aktiivinen — toiminnassa, voidaan kohdistaa tilauksille. (status: 'active' API:ssa.)
Ei aktiivinen — poissa toiminnasta (esim. korjattavana, poistettu käytöstä, kadonnut tai myyty). Säilyy järjestelmässä. (status: 'inactive'.)
Luonnos — rekisteröinti kesken. Ei vielä toiminnassa. (status: 'draft'.)

Vain Aktiiviset artikkelit lasketaan ATS:ään ja voidaan kohdistaa uusiin tilauksiin. Ei-aktiiviset artikkelit säilyttävät koko historiansa (reskontra, tapahtumat, liitteet). Lue lisää: Varastoartikkelin status.

Tila (In / Out)

Tila kuvaa artikkelin fyysistä sijaintia suhteessa toimintaasi. Se on automaattinen — sitä ei voi asettaa käsin.

In — käsillä varastossasi. Voi silti olla sidottu tulevaan tilaukseen.
Out — parhaillaan asiakkaalla (vuokraus käynnissä) tai muuten poissa.

Tilasiirtymät tapahtuvat keräilytapahtumissa:

Nouto / luovutus → Out
Palautus → In

Lue lisää: Varastoartikkelin tila.

Sijainnin seuranta

Varastoartikkeli on aina sidottu palvelusijaintiin. articleLocations-taulukko tallentaa määrityksen aikaväleinä:

{
  "id": "loc_abc123",
  "articleId": "art_xyz789",
  "serviceLocationId": "loc_helsinki",
  "slotId": "slot_42",
  "range": { "start": "2025-01-01T00:00:00Z", "end": null }
}

Nykyinen sijainti on se määritys, jonka aikaväli kattaa nykyhetken.
Voit ajastaa tulevia siirtoja lisäämällä uuden aikavälin, jonka alku on tulevaisuudessa.
Kaikki sijaintimuutokset kirjataan tapahtumalokiin location_changed-tapahtumina.
Hyllypaikka (binLocation) on vapaamuotoinen tarkempi paikka palvelusijainnin sisällä — esim. Rack 3 / Bay B.

Kun vaihdat sijaintia API:n kautta (PUT /articles/:id uudella serviceLocationId-arvolla), TWICE tarkistaa ristiriidat: tilaukset tai ajastetut tapahtumat, jotka jäisivät siirron takia orvoiksi. Artikkelivastauksen conflicts-kenttä nostaa nämä esiin ennakolta.

Media ja dokumentit

Kaksi järjestettyä tiedostokokoelmaa artikkelia kohden:

Media (media) — artikkelin tiedoissa näytettävät kuvat ja videot. Ensimmäistä mediaa käytetään pikkukuvana listoissa. Järjestettävissä uudelleen.
Dokumentit (documents) — mitä tahansa tiedostoja (PDF-tiedostoja, taulukoita, valokuvia). Jokaisella dokumentilla on orderIndex ja valinnainen comment.

Dokumentteja voi liittää myös tiettyihin ajastettuihin tapahtumiin (esim. tarkastusmerkinnät huoltovaraukseen) — katso Varastoartikkelin tapahtumat.

Tapahtumaloki ja tapahtumat

Jokaisella varastoartikkelilla on kaksi historiavirtaa:

Tapahtumaloki — järjestelmän kirjaamat muutokset itse artikkeliin. Esimerkkejä kirjatuista tapahtumatyypeistä:
- assigned_to_order / freed_from_order
- handed_out / returned
- status_changed
- allocation_changed
- sku_changed
- location_changed
- identifiers_changed
- specifications_changed
Ajastetut tapahtumat — käyttäjän luomat varaukset ja muistiinpanot, jotka voivat estää saatavuuden ja joihin voi liittyä dokumentteja. Tyypit: reservation, note.

Molemmat näkyvät artikkelin tietojen Aikajana / Tapahtumat -välilehdellä. Lue lisää: Varastoartikkelin tapahtumat.

Suhteet

Kuuluu SKU:hun (valinnainen)

Varastoartikkelit voidaan linkittää SKU:hun skuId-kentällä. SKU toimii tuotetason mallina: purchasePrice, description, binLocation, attribuutit ja kategoria periytyvät alaspäin, ellei niitä ohiteta. Ilman SKU:ta oleva varastoartikkeli on täysin itsenäinen.

Sisältää reskontran

Sisältää monta -merkintää, jotka muodostavat arvot itemIncome, itemCosts ja profitability.

Sisältää tapahtumia

Sisältää monta ja . Katso Tapahtumat.

Viittaa tilauksiin ja asiakkaisiin

Linkitetty tilauksiin, jotka varaavat artikkelin. Tilaa ja saatavuuskatkoja ohjaavat ne tilaukset, jotka sisältävät artikkelin. Elinkaaritapahtumat kuten handed_out ja returned tulevat tilausten keräilystä.

Sijaitsee sijainnissa

Kuuluu palvelusijaintiin. Sijainti on aikaväleihin sidottu (articleLocations), joten sekä siirrot että tulevat muutot ovat osa mallia.

Elinkaari

Luonti

Varastoartikkelit tulevat järjestelmään, kun rekisteröit uutta varastoa.

Miten luon varastoartikkelin?

Napsauta kohdassa Inventaario > Varastoartikkelit painiketta Register stock item. Anna nimi, valitse käytetäänkö Track individually -seurantaa, aseta määrä, valitse saapumissijainti ja linkitä halutessasi SKU:hun.

Mitä tietoja vaaditaan?

Vähintään: name ja serviceLocationId. Suositeltavat: skuId (perintää varten), taxonomyCategoryId, purchasePrice ja yksi tai useampi codes-arvo (luodaan automaattisesti, jos jätetään pois).

Mikä on alkutila?

Uudet artikkelit saavat oletuksena arvon status: 'active' (Aktiivinen) ja tilan In. Ne näkyvät heti saatavuuslaskennassa. Jos artikkelit on tarkastettava ennen käyttöönottoa, aseta statukseksi inactive (Ei aktiivinen) luonnissa.

Voinko luoda monta kerralla?

Kyllä. Käytä hallinnan joukkorekisteröintiä (luo koodit automaattisesti N artikkelille), CSV-tuontia tai API-tuontia kutsulla POST /articles/create-many.

Käyttö

Aktiiviset varastoartikkelit ovat mukana tilauksissa, listauksissa ja raporteissa.

Missä näen varastoartikkelit?

Taulukossa Inventaario > Varastoartikkelit, artikkelin tarkastelusivulla (välilehdet Yleiset / Attribuutit / Tulot ja kulut / Keräily / Dokumentit / Tapahtumat / Tapahtumaloki), keräilynäkymissä, saatavuuskalentereissa ja SKU:n tarkastelusivuilla.

Mitä toimintoja voin tehdä?

Muokata mitä tahansa kenttää, siirtää sijaintia, vaihtaa statusta, lisätä mediaa tai dokumentteja, lisätä ajastettuja tapahtumia (varauksia / muistiinpanoja), kirjata tulo- ja kulumerkintöjä, lisätä tunnisteita sekä linkittää tai irrottaa SKU:n.

Miten se vaikuttaa listauksiin?

Vain artikkelit, joilla on status: active ja tila In (eivätkä ole sidottuja päällekkäiseen varaukseen), kasvattavat listauksen ATS:ää. Katso Varastoartikkelin tila.

Muokkaus

Päivitä kenttiä koko elinkaaren ajan.

Miten muokkaan varastoartikkelia?

Avaa artikkelin tiedot ja muokkaa suoraan tai valitse useita rivejä taulukosta ja käytä joukkomuokkausta. API-päätepiste on PUT /articles/:id.

Mitä voi muuttaa?

Lähes kaiken: nimen, SKU-linkin, koodit, statuksen, sijainnin, attribuutit, kunnon, ostohinnan, kuvauksen, mediat, dokumentit ja tunnisteet. Itse id on muuttumaton. Koodeja voi lisätä tai poistaa, mutta niiden on pysyttävä yksilöllisinä tenantin sisällä.

Entä määrä?

Yhteisvaraston artikkeleille käytä kutsuja POST /articles/:id/increase-quantity tai POST /articles/:id/decrease-quantity. Kutsu ennen vähentämistä GET /articles/:id/plan-quantity-change, niin näet vaikutukset (blockingUnavailabilities, moves, removedSlotIds).

Käytöstä poisto tai poistaminen

Suosi statusmuutoksia poistamisen sijaan, jotta historia säilyy.

Miten poistan artikkelin käytöstä?

Aseta statukseksi Ei aktiivinen. Koko historia — reskontra, tapahtumat, liitteet — säilyy ja artikkeli poistuu saatavuudesta välittömästi. POST /articles/:id/inactivate yrittää myös kohdistaa artikkelin tulevat varaukset toiselle saatavilla olevalle varastoartikkelille.

Miten poistan artikkelin?

DELETE /articles/:id tai rivin toiminnoista Delete. Artikkeleita, jotka on kohdistettu aktiivisiin tilauksiin, ei voi poistaa ennen kuin nuo tilaukset on päätetty tai peruutettu.

Mitä historialle tapahtuu poistettaessa?

Tilaushistoriaan jää viittaus poistetun artikkelin tunnukseen, mutta siihen liitetyt tiedot (reskontramerkinnät, tapahtumat, mediat) poistetaan. Käytä statusmuutosta, jos tarvitset historian.

Usein kysytyt kysymykset

Milloin varastoartikkelin määrän kannattaa olla > 1?

Käytä yhteisvarastoa identtisille, edullisille ja keskenään vaihdettaville artikkeleille, joissa kappalekohtainen seuranta ei tuo lisäarvoa (kypärät, lukot, kaulanauhat). Käytä sarjanumeroitua (määrä = 1, Track individually) kaikelle, mitä haluat seurata kappaleittain: arvokkaat välineet, eri tahtiin arvoaan menettävät kohteet ja kaikki vuokrattava.

Voinko muuttaa varastoartikkelin SKU-linkkiä?

Kyllä. Aseta skuId uuteen arvoon tai arvoon null, jolloin linkki irtoaa. Muutos kirjataan sku_changed-tapahtumana. Olemassa oleva reskontra- ja tapahtumahistoria pysyy artikkelilla.

Mitä eroa on artikkelikoodilla ja SKU-koodilla?

codes kuuluu varastoartikkelille — se tunnistaa fyysisen esineen. SKU:n code tunnistaa tuotetyypin. Yhdellä SKU:lla voi olla monta varastoartikkelia, joilla kullakin on omat artikkelikoodinsa.

Mitkä ominaisuudet peritään SKU:lta?

purchasePrice, description, binLocation, attribuutit ja taxonomyCategoryId. API palauttaa *Origin-kentät, jotka kertovat, tuliko arvo artikkelilta vai SKU:lta. Arvon asettaminen artikkelille ohittaa perinnän; arvon tyhjentäminen palauttaa sen.

Miten tila eroaa statuksesta?

Status on sinun päätöksesi (Active / Inactive / Draft). Tilan asettaa keräily (In / Out). Ne ovat toisistaan riippumattomia — Active / Out -artikkeli on kunnossa olevaa varastoa, joka on parhaillaan asiakkaalla.

Mitä jos artikkeli katoaa tai myydään pois?

Aseta sen statukseksi Ei aktiivinen — erillistä Lost- tai Sold-statusta ei ole. Muutos ei muuta takautuvasti artikkelin sisältäviä tilauksia; hoida ne käsin (hyvitys, uudelleenkohdistus). Kirjaa syy muistiinpanona tai reskontramerkintänä.

Kehittäjän viitetiedot

Varastoartikkelit ovat API:ssa articles-resurssi.

API: Articles

Avaa päätepiste API-viitteessä.

Aiheeseen liittyvät käsitteet

SKU:t

Varastoartikkelien tuotetason malli