Tapahtumat - TWICE Commerce

Varastoartikkelin tapahtumien aikajana — Inventaario > Varastoartikkelit > [Artikkeli] > Tapahtumat

Määritelmä

Varastoartikkelin tapahtumat muodostavat aikajanan kaikesta, mitä artikkelille on tapahtunut. TWICE erottaa kaksi tasoa:

Ajastetut tapahtumat — aikavälille sijoittuvat lohkot (varaukset ja muistiinpanot), jotka luot itse tai jotka automaatio luo. Ne voivat estää saatavuuden, ja niihin voi liittyä liitteitä.
Tapahtumalokin tapahtumat — järjestelmän kirjaama historia artikkelin muutoksista (tilaukselle kohdistus, keräily, status, sijainti, attribuutit).

Yhdessä ne vastaavat kysymyksiin: mitä tämä artikkeli tekee juuri nyt? ja mitä sille on tapahtunut?

Vertauskuva: Varastoartikkelin tapahtumat ovat sen kalenteri ja päiväkirja. Kalenteri (ajastetut tapahtumat) on eteenpäin katsova näkymä siitä, mihin artikkeli on sidottu; päiväkirja (tapahtumaloki) on jäljitettävä kirjaus kaikesta tapahtuneesta.

Missä sitä käytetään?

Tapahtumat näkyvät kunkin varastoartikkelin Tapahtumat-välilehdellä. Käytät tapahtumia, kun:

Seuraat artikkelin saatavuutta — näet, mikä estää saatavuuden ja milloin artikkelit vapautuvat.
Kirjaat asiakastilauksia — tilaustapahtumat kirjataan automaattisesti, kun artikkeleita kohdistetaan tilauksiin.
Hallitset sisäisiä varauksia — varaat artikkeleita huoltoon, varastointiin tai sisäiseen käyttöön.
Lisäät dokumentaatiota — kirjaat tarkastuksia, kuntomerkintöjä, korjauslokeja tai tärkeitä havaintoja.
Tarkastat artikkelin historiaa — selvität tarkalleen, milloin ja miksi artikkelin tila, status, sijainti tai SKU muuttui.
Raportoit — katsot kaikki varastosi tapahtumat yhdestä taulukosta.

Ajastetut tapahtumat

Ajastetut tapahtumat ovat käyttäjän hallinnassa ja sijaitsevat artikkelilla scheduledEvents-kentässä. Tyyppejä on kaksi:

Tyyppi	Estää saatavuuden	Näkyy asiakkaalle	Luoja
`reservation`	Kyllä	Ei	Työntekijä (käsin) tai työnkulku
`note`	Ei	Ei	Työntekijä (käsin)

Molemmilla tyypeillä on sama rakenne:

{
  "id": "evt_abc123",
  "articleId": "art_xyz789",
  "type": "reservation",
  "name": "Yearly service",
  "comment": "Annual safety inspection",
  "startDate": "2025-06-01T08:00:00Z",
  "endDate": "2025-06-03T17:00:00Z",
  "serviceLocationId": "loc_helsinki",
  "tenantId": "tnt_001",
  "createdAt": "2025-05-15T12:00:00Z"
}

endDate voi olla null avoimissa tapahtumissa. Varaukset, joilla ei ole päättymispäivää, pitävät artikkelin saatavuuden ulkopuolella, kunnes varaus suljetaan.

Varaukset

Varaukset luovat artikkelille unavailability-jakson. Niillä otetaan varastoartikkeli pois saatavilla olevasta joukosta sisäisestä syystä — ei asiakastilauksen vuoksi — esimerkiksi huoltoa, kuvauksia, koulutusta tai tiedossa olevaa tapahtumaa varten.

Luodaan käsin varastoartikkelin Tapahtumat-välilehdeltä valinnalla Lisää → Varaus, joka avaa ikkunan Aikatauluta varaus, tai kutsulla POST /articles/:id/scheduled-events. Artikkeli, jolla ei vielä ole tapahtumia, tarjoaa tyhjässä tilassa painikkeen Varaa kohde.
Varausjakson ajan artikkeli poistuu ATS-saatavuudesta eikä sitä voi kohdistaa uusiin tilauksiin.
Kun päättymispäivä on ohitettu, saatavuus palautuu automaattisesti. Varaukset päättyvät itsestään — käsin siivoamista ei tarvita.
Varaukseen voi liittää liitteen artikkelireskontran kautta (reskontramerkinnän scheduledEventId) — kirjaa esimerkiksi korjauskulun sille varaukselle, joka ajoitti työn.

Suosi varausta Ei aktiivinen -statuksen sijaan, kun saatavuuskatkolla on tiedossa oleva päättymispäivä. Varaukset päättyvät automaattisesti; Ei aktiivinen vaatii käsin tehtävän aktivoinnin. Katso Varastoartikkelin status.

Varausten etusija

Käsin luotu varaus ohittaa olemassa olevat pidot (tilaukset ja muut varaukset), kun varastoartikkelilla ei ole vapaata kapasiteettia. TWICE ratkaisee tilanteen tässä järjestyksessä:

Käyttää ensin vapaan kapasiteetin.
Järjestää sitten olemassa olevat pidot muihin vapaisiin väleihin, mikäli mahdollista.
Vapauttaa vasta viimeisenä keinona mahdollisimman vähän olemassa olevia pitoja tilan tekemiseksi.

Kyseisiä tilauksia ja varauksia ei peruuteta — vain niiden pito tähän tiettyyn varastoartikkeliin päällekkäisiltä päiviltä vapautuu.

Pidon vapauttaminen tarkoittaa, ettei kyseinen tilaus tai varaus enää varaa tuota varastoartikkelia päällekkäiseltä jaksolta. Tilaus itsessään pysyy aktiivisena, mutta varastoartikkeli jää kohdistamatta kyseiselle ajanjaksolle. Sinun voi olla tarpeen kohdistaa korvaava varastoartikkeli kyseiselle tilaukselle.

Vahvistusdialogi, joka näyttää ristiriitaisen varauksen luonnissa vaikutuksen kohteena olevat tilaukset — Varauksen ristiriidan vahvistusdialogi

Kun järjestelmä toteaa, että pitoja on vapautettava, näyttöön tulee vahvistusdialogi ennen kuin mitään muuttuu. Dialogi näyttää:

Lisättävän varauksen (nimi, päivät, sijainti).
Vieritettävän listan kaikista tilauksista ja varauksista, jotka menettävät pitonsa varastoartikkeliin.
Rivin voi laajentaa, jolloin näkyviin tulevat tiedot — tilausnumero, asiakas, status ja päivät tilauksista; nimi ja kommentti varauksista.
”Vahvista, että ymmärrät vaikutuksen” -valintaruudun, joka avaa vahvistuspainikkeen Lisää varaus.

Jos vaikutuksen kohteena olevat pidot muuttuvat dialogin avaamisen ja vahvistamisen välillä (esimerkiksi toinen työntekijä lisää uuden tilauksen sillä välin), TWICE pyytää sinua tarkistamaan päivitetyn listan uudelleen ennen kuin mitään vapautetaan.

Vaikutus kohdistuu vain pitoihin, jotka ovat samassa palvelusijainnissa kuin varaus. Saman varastoartikkelin pidot muissa sijainneissa säilyvät ennallaan.

Muistiinpanot

Muistiinpanot ovat aikaleimattuja merkintöjä, jotka eivät estä saatavuutta. Käytä niitä dokumentoimaan mitä tahansa toiminnallista tietoa, joka kuuluu artikkelin tietueeseen mutta ei ole reaaliaikainen sitoumus.

Luodaan käsin varastoartikkelin Tapahtumat-välilehdeltä valinnalla Lisää → Muistio, joka avaa ikkunan Lisää huomautus, tai kutsulla POST /articles/:id/scheduled-events parametrilla type: 'note'.
Näkyvät työntekijöille, joilla on pääsy artikkeliin; ei koskaan asiakkaille.
Voivat sisältää endDate-arvon, jos havainto kattaa jakson (esim. ”kunto havaittu 10.–15.1.”) tai null, jos kyseessä on yksittäinen aikaleima.
Hyödyllinen pohja poikkeamaraporteille, kuntohistorialle ja työvuorojen välisille tiedonsiirroille.

Toimintatapahtumat

Kaikki varastoartikkelille tapahtuva kirjataan tapahtumalokiin. Nämä tapahtumat syntyvät järjestelmästä eikä niitä voi muokata, ja ne näkyvät samalla tapahtuma-aikajanalla kuin varaukset ja muistiinpanot, joten luet sitoumukset ja historiakirjaukset yhdessä. Jokaisella rivillä on eventType, context-objekti mukana olevine tunnisteineen ja changes-objekti, joka kertoo mikä muuttui mistä mihin. Hallintanäkymä näyttää tapahtuman nimen, ei sen avainta.

`eventType`	Näkyy muodossa	Milloin se laukeaa
`ARTICLE_CREATED`	Article created	Yksikkö rekisteröidään
`ARTICLE_UPDATED`	Article updated	Yksikön kenttä muuttuu
`ARTICLE_QUANTITY_CHANGED`	Quantity changed	Määränä seurattavan yksikön määrä muuttuu
`ARTICLE_ASSIGNED_TO_ORDER`	Assigned to order	Yksikkö asetetaan tilausrivin taakse
`ARTICLE_UNASSIGNED_FROM_ORDER`	Unassigned from order	Yksikkö poistetaan riviltä
`ARTICLE_LOCATION_CHANGED`	Location changed	Yksikön sijaintikenttää muokataan
`ARTICLE_LOCATION_TRANSFERRED`	Location transferred	Yksikkö siirtyy sijaintien välillä
`ARTICLE_OVERBOOKING`	Overbooking detected	Yksikkö on varattu yli vapaana olevan
`SCHEDULED_EVENT_CREATED`	Reservation created	Varaus tai muistiinpano lisätään
`SCHEDULED_EVENT_UPDATED`	Reservation updated	Varausta tai muistiinpanoa muokataan
`SCHEDULED_EVENT_DELETED`	Reservation deleted	Varaus tai muistiinpano poistetaan
`USER_UPLOADED_ARTICLE_IMAGE`	Image uploaded	Joku lisää yksikölle valokuvan
`CUSTOM_USER_LOG`	Custom log	Vapaa tekstimerkintä, jonka joku on kirjoittanut

Tilaus, jolla yksikkö lähti, on kentässä context.references, joten aikajanalta pääsee takaisin siihen.

Yksikön luovutus ja takaisinotto eivät ole yksikön tapahtumia. Ne ovat tuotteen tilan siirtymiä käsittelyryhmien välillä tilausrivillä, ja tilauksen oma historia kirjaa ne. Lue yksikön nykyinen sitoumus kohdasta Varastoartikkelin tila, ja määritä tilat kohdassa Käsittelyn elinkaari.

Vertailu

Ominaisuus	Tilaustapahtuma	Varaus	Muistiinpano
Lähde	Järjestelmä	Käyttäjä tai työnkulku	Käyttäjä
Missä hallitaan	Tilaukset-osiossa	Varastoartikkelin Tapahtumat-välilehdellä	Varastoartikkelin Tapahtumat-välilehdellä
Estää saatavuuden	Kyllä (rivin ollessa aktiivinen)	Kyllä	Ei
Näkyy asiakkaalle	Kyllä	Ei	Ei
Aikaan sidottu	Kyllä (vuokra-aika tai tilausjakso)	Kyllä (varausjakso)	Valinnainen (aikaleima)
Päättyy automaattisesti	Kyllä (palautuksessa / peruutuksessa)	Kyllä (kohdassa `endDate`)	Ei sovellu
Voi sisältää liitteitä	Tilauksen kautta	Artikkelireskontran viittauksella	Artikkelireskontran viittauksella
Tyypilliset käyttötapaukset	Asiakasvuokraukset ja -myynnit	Huolto, sisäinen pito	Kuntomerkinnät, poikkeamalokit

Missä tapahtumia hallitaan

Asiakastilaukset

Hallitse tilauksia. Tilaukset kirjaavat tapahtumat automaattisesti kohdistetuille varastoartikkeleille.

Sisäiset varaukset ja muistiinpanot

Lisää ja hallitse varauksia ja muistiinpanoja varastoartikkelin Tapahtumat-välilehdeltä.

Tapahtumat-välilehti näyttää ajastetut tapahtumat ja tapahtumalokin yhdessä aikajärjestyksessä, jolloin saat kokonaiskuvan artikkelin elinkaaresta.

Sisäiset varaukset vs. pidot

Varaukset ovat ainoa tapa ”pitää” varastoa TWICEssä tilauksen ulkopuolella. Yleisiä käyttötapoja:

Huoltojakso. Varaa artikkeli sovitun huollon ajaksi. Liitä varaukseen reskontran kulumerkintä korjauslaskua varten.
Kuvaukset tai koulutus. Varaa artikkeli ilman tilausjärjestelmää.
Työntekijän pito. Asiakas on tulossa noutamaan — luo lyhyt varaus, jotta kukaan muu ei voi varata artikkelia.
Vaurioarvio. Varaa artikkeli, kunnes olet tarkastanut sen ja päättänyt, palautetaanko se käyttöön.

Varauksia ei voi muuntaa tilauksiksi — ne ovat erillinen prosessi. Jos asiakas haluaa varaamasi artikkelin, poista tai lyhennä varausta ja luo oikea tilaus.

Tapahtumiin liitetyt dokumentit

Tiedostoja voi liittää tapahtumiin kahdella tavalla:

Varastoartikkelin dokumentit (artikkelin documents) — koskevat koko artikkelia.
Artikkelireskontran merkinnät, joissa on scheduledEventId — tiettyyn varaukseen sidotut talousmerkinnät. Reskontramerkintä voi viitata tiedostoliitteeseen osana value-hyötykuormaansa.

Esimerkki: Yearly service -varaus tuottaa cost-reskontramerkinnän 150 € ja siihen liitetyn PDF-kuitin. Sekä varaus että reskontramerkintä pysyvät linkitettyinä, jolloin artikkelin jäljitysketju on aukoton.

Työnkulkujen laukaisimet tapahtumista

Tapahtumat ovat luontevia automaation kiinnityskohtia. Yleisiä käyttötapoja:

Tapahtumasta ARTICLE_ASSIGNED_TO_ORDER → kerro varastojärjestelmällesi, että yksikkö valmistellaan.
Tapahtumasta ARTICLE_OVERBOOKING → hälytä konfliktien ratkaisijalle ennen kuin asiakas saapuu.
Tapahtumasta ARTICLE_LOCATION_TRANSFERRED → täsmäytä vastaanottavan toimipisteen lukumäärä.

Tilauksen omat tapahtumat, eivät yksikön, kertovat yksikön lähteneen tai palanneen. Tilaa order.updated webhookilla lukeaksesi ne.

Elinkaari

Luonti

Tapahtumat luodaan automaattisesti (tapahtumaloki) tai käsin (varaukset, muistiinpanot).

Miten tilaustapahtumat luodaan?

Automaattisesti, kun yksikkö rekisteröidään, sitä muokataan, se siirretään tai se asetetaan tilausten taakse. Tilaukselle liittyminen kirjaa tapahtuman ARTICLE_ASSIGNED_TO_ORDER ja siltä poistuminen tapahtuman ARTICLE_UNASSIGNED_FROM_ORDER. Niiden välissä tapahtuva on tuotteen tila tilausrivillä, ja tilaus kirjaa sen.

Käsin luonti

Varaukset ja muistiinpanot lisätään käsin Tapahtumat-välilehdeltä.

Miten luon varauksen?

Avaa varastoartikkeli, siirry välilehdelle Tapahtumat, valitse Lisää → Varaus ja aseta alku- ja päättymispäivä sekä valinnainen nimi tai kommentti ikkunassa Aikatauluta varaus. Jos artikkelin kapasiteetti on täynnä pyydetyllä jaksolla, vahvistusdialogi näyttää, mitkä olemassa olevat pidot vapautetaan ennen varauksen luontia. API: POST /articles/:id/scheduled-events parametrilla type: 'reservation'.

Miten luon muistiinpanon?

Sama kulku kuin varauksessa, mutta valitse Lisää → Muistio ja täytä ikkuna Lisää huomautus. API: POST /articles/:id/scheduled-events parametrilla type: 'note'.

Automatisoitu luonti

Voiko tapahtumien luonnin automatisoida?

Kyllä. Käytä API:a suoraan tai laukaise työnkulkujen kautta asiakastilausten tapahtumista, attribuuttimuutoksista tai ulkoisista laukaisimista.

Näyttäminen

Tapahtumat näkyvät aikajärjestyksessä Tapahtumat-välilehdellä.

Missä näen tapahtumat?

Artikkelikohtaisesti: Inventaario → Varastoartikkelit → [Artikkeli] → Tapahtumat. Kaikkien artikkelien osalta: Inventaario → Tapahtumat.

Miten tapahtumat on järjestetty?

Aikajärjestyksessä, uusin ensin. Käyttöliittymässä voit suodattaa tapahtumatyypin ja aikavälin mukaan.

Mitä kustakin tapahtumasta näytetään?

Ajastetuista tapahtumista: alkupäivä, päättymispäivä, tyyppi, nimi, kommentti, sijainti. Toimintatapahtumista: aikaleima, tapahtuman nimi, arvot ennen ja jälkeen (changes) ja mukana olevat tunnisteet (context).

Muokkaus

Ajastettuja tapahtumia voi muokata; tapahtumalokin merkintöjä ei.

Voinko muokata tilaustapahtumia?

Et suoraan. Ne ovat järjestelmän jäljitysloki. Muokkaa taustalla olevaa tilausta — tapahtumaloki kirjaa uudet siirtymät.

Voinko muokata varausta?

Kyllä. PUT /articles/:id/scheduled-events/:eventId uusilla kentillä. Tai napsauta varausta aikajanalla ja muokkaa. Saatavuus lasketaan uudelleen välittömästi.

Voinko muokata muistiinpanoa?

Kyllä. Sama päätepiste kuin varauksilla.

Poistaminen

Ajastettuja tapahtumia voi poistaa; tapahtumalokia ei.

Miten poistan varauksen?

Napsauta varausta ja valitse Delete tai kutsu DELETE /articles/:id/scheduled-events/:eventId. Estetty saatavuus vapautuu välittömästi.

Miten poistan muistiinpanon?

Samoin kuin varauksen.

Voinko poistaa tilaustapahtumia?

Et. Ne ovat jäljitettävä historia. Yksikön poistaminen tilaukselta kirjaa tapahtuman ARTICLE_UNASSIGNED_FROM_ORDER, ja alkuperäinen ARTICLE_ASSIGNED_TO_ORDER jää lokiin.

Joukkopoisto?

POST /articles/:id/scheduled-events/delete-many hyväksyy joko eksplisiittiset ids-arvot tai deleteAllExcept-semantiikan.

Usein kysytyt kysymykset

Miksi käyttäisin varausta tilauksen sijaan?

Varaukset ovat sisäisiä varauksia (huolto, pidot, kuvaukset) ilman asiakkaita, maksuja tai tilauksen tilaa. Tilaukset ovat asiakkaalle näkyviä liiketapahtumia.

Voinko muuntaa varauksen tilaukseksi?

Et. Ne ovat erillisiä käsitteitä. Jos asiakas haluaa varaamasi artikkelin, poista varaus ja luo oikea tilaus.

Näkyvätkö muistiinpanot asiakkaille?

Eivät. Muistiinpanot ovat vain sisäiseen käyttöön eikä niitä koskaan näytetä asiakkaille.

Voinko liittää dokumentteja tapahtumiin?

Kyllä. Varastoartikkelin dokumentit ovat aina saatavilla mistä tahansa tapahtumanäkymästä. Artikkelireskontran merkinnät voivat viitata tiettyyn scheduledEventId-arvoon, jolloin talousliitteet (laskut, kuitit) pysyvät sidottuina ne aiheuttaneeseen varaukseen.

Miten tapahtumat vaikuttavat saatavuuslaskentaan?

Sekä varaukset että tilaukset estävät saatavuuden kattamaltaan aikaväliltä. Muistiinpanot eivät. Tapahtumalokin tapahtumat eivät suoraan ohjaa saatavuutta — ne kirjaavat jo tapahtuneen.

Voinko nähdä kaikki tapahtumat kaikista varastoartikkeleista?

Kyllä — Inventaario → Tapahtumat tarjoaa yhtenäisen taulukon. Suodata tapahtumatyypin mukaan, luo omia näkymiä, ryhmittele varastoartikkeleittain ja vie tiedot raportointia varten. Yksittäisen artikkelin historia löytyy varastoartikkelin Tapahtumat-välilehdeltä.

Mitä tapahtuu, jos varaus menee päällekkäin tilauksen kanssa?

Tilanne	Mitä tapahtuu
Vapaata kapasiteettia on saatavilla	Varaus käyttää sen eikä tilaukseen kohdistu vaikutuksia
Vapaata väliä ei ole	TWICE yrittää siirtää olemassa olevat pidot vapaisiin väleihin ilman menetyksiä
Tilaa ei todella ole edes uudelleenjärjestelyn jälkeen	Järjestelmä pyytää vahvistamaan mahdollisimman pienen joukon olemassa olevien pitojen vapauttamista

Kyseisiä tilauksia ei peruuteta — vain niiden pito kyseiseen varastoartikkeliin vapautuu. Koko algoritmi on kuvattu yllä kohdassa Varausten etusija.

Mitä ovat varastoartikkelien ristiriidat tilauksilla?

Kun varaus vapauttaa pidon tilaukselta, kyseinen varastoartikkeli näkyy tilauksella unavailable-tilassa. Tilauslista näyttää varoituspalkin, joka kertoo ristiriitaisten tilausten määrän, ja tilauksen Varastoartikkelit-välilehti korostaa ristiriidan punaisella laskurilla. Ratkaise ristiriita kohdistamalla korvaava varastoartikkeli.

Kehittäjän viitetiedot

Ajastetut tapahtumat (varaukset ja muistiinpanot) ovat API:ssa unavailabilities. Tapahtumalokin merkinnät tulevat audit-logs-resurssista.

API: Unavailability

Avaa päätepiste API-viitteessä.

Aiheeseen liittyvät artikkelit

Varastoartikkelit

Varastoartikkelin koko malli ja elinkaari

Varastoartikkelin tila

Miten tilaustapahtumat ohjaavat In/Out-tilaa

Varastoartikkelin status

Miksi statusmuutokset kirjataan tapahtumina

Työnkulut

Automatisoi toimintaa tapahtumien perusteella

Tervetuloa TWICE-dokumentaatioon

Liikkuminen TWICEssä

Järjestelmän ymmärtäminen

Varastoartikkelin tapahtumat

Määritelmä

Missä sitä käytetään?

Ajastetut tapahtumat

Varaukset

Varausten etusija

Muistiinpanot

Toimintatapahtumat

Vertailu

Missä tapahtumia hallitaan

Asiakastilaukset

Sisäiset varaukset ja muistiinpanot

Sisäiset varaukset vs. pidot

Tapahtumiin liitetyt dokumentit

Työnkulkujen laukaisimet tapahtumista

Elinkaari

Usein kysytyt kysymykset

Kehittäjän viitetiedot

API: Unavailability

Aiheeseen liittyvät artikkelit

Varastoartikkelit

Varastoartikkelin tila

Varastoartikkelin status

Työnkulut

​Määritelmä

​Missä sitä käytetään?

​Ajastetut tapahtumat

​Varaukset

​Varausten etusija

​Muistiinpanot

​Toimintatapahtumat

​Vertailu

​Missä tapahtumia hallitaan

Asiakastilaukset

Sisäiset varaukset ja muistiinpanot

​Sisäiset varaukset vs. pidot

​Tapahtumiin liitetyt dokumentit

​Työnkulkujen laukaisimet tapahtumista

​Elinkaari

​Usein kysytyt kysymykset

​Kehittäjän viitetiedot

API: Unavailability

​Aiheeseen liittyvät artikkelit

Varastoartikkelit

Varastoartikkelin tila

Varastoartikkelin status

Työnkulut

Määritelmä

Missä sitä käytetään?

Ajastetut tapahtumat

Varaukset

Varausten etusija

Muistiinpanot

Toimintatapahtumat

Vertailu

Missä tapahtumia hallitaan

Sisäiset varaukset vs. pidot

Tapahtumiin liitetyt dokumentit

Työnkulkujen laukaisimet tapahtumista

Elinkaari

Usein kysytyt kysymykset

Kehittäjän viitetiedot

Aiheeseen liittyvät artikkelit