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ä toiminnolla Add reservation tai kutsulla POST /articles/:id/scheduled-events.
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 Out of use -statuksen sijaan, kun saatavuuskatkolla on tiedossa oleva päättymispäivä. Varaukset päättyvät automaattisesti; Out of use 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 käyttää ensin vapaan kapasiteetin, järjestää sitten olemassa olevat pidot muihin vapaisiin väleihin mikäli mahdollista, ja vasta viimeisenä keinona vapauttaa 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.
”I understand the impact” -valintaruudun, joka avaa vahvistuspainikkeen.

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ä toiminnolla Add note 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.

Tilaustapahtumat (tapahtumaloki)

Kun artikkeli kohdistetaan asiakastilaukselle, TWICE kirjaa tapahtumavirran tapahtumalokiin. Nämä tapahtumat ovat järjestelmän luomia eikä niitä voi muokata. Järjestelmän tapahtumatyypit kokonaisuudessaan:

`eventType`	Milloin se laukeaa	Mukana kulkevat tiedot
`assigned_to_order`	Artikkeli lisätään tilaukselle	`orderId`, `orderNumber`, `orderProductId`, `price`, `shopperId`
`freed_from_order`	Artikkeli poistetaan tilaukselta tai tilaus peruutetaan	Sama kuin yllä
`handed_out`	Työntekijä merkitsee rivin noudetuksi; tila vaihtuu arvoon Out	`orderId`, `orderNumber`, `shopperId`
`returned`	Työntekijä merkitsee rivin palautetuksi; tila vaihtuu arvoon In	`orderId`, `orderNumber`, `price`, `shopperId`, `orderProductId`
`allocation_changed`	Artikkelin jako vuokraukseen ja myyntiin muuttui	`attributeChanges.from.allocation`, `attributeChanges.to.allocation`
`status_changed`	Status muuttui (esim. In use → Out of use)	`attributeChanges.from.status`, `attributeChanges.to.status`
`sku_changed`	SKU-linkki muuttui	`attributeChanges.from.sku`, `attributeChanges.to.sku`
`location_changed`	Palvelusijainti muuttui	`attributeChanges.from.storeId`, `attributeChanges.to.storeId`
`identifiers_changed`	`codes`-taulukkoa päivitettiin	`attributeChanges.from.itemCodes`, `attributeChanges.to.itemCodes`
`specifications_changed`	Attribuutit tai kiinteiden kenttien arvot muuttuivat	`attributeChanges.from`, `attributeChanges.to`

Tilaustapahtumat näkyvät samalla tapahtuma-aikajanalla, joten näet sitoumukset (varaukset, muistiinpanot) ja historiakirjaukset yhdessä.

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 handed_out → käynnistä ajastin; merkitse tilaus myöhästyneeksi, jos returned ei laukea N päivän kuluessa.
Tapahtumasta returned → luo huoltovaraus, jos tilausrivi merkittiin vaurioituneeksi.
Kun status_changed vaihtuu arvoon Lost → ilmoita operatiiviselle tiimille ja avaa tiketti tukijärjestelmääsi.
Varauksen päättyessä → aseta status automaattisesti takaisin arvoon In use, kun korjausjakso päättyy.
Tapahtumasta assigned_to_order → lähetä webhook varastojärjestelmääsi artikkelin valmistelua varten.

Lue lisää: Työnkulut.

Elinkaari

Luonti

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

Miten tilaustapahtumat luodaan?

Automaattisesti, kun artikkeli kohdistetaan asiakastilaukselle. Tyypillinen tapahtumajärjestys on: assigned_to_order → handed_out → returned. Peruutukset kirjaavat tapahtuman freed_from_order.

Miten luon varauksen?

Avaa varastoartikkeli, siirry välilehdelle Tapahtumat, napsauta Add reservation ja aseta alku- ja päättymispäivä sekä valinnainen nimi tai kommentti. 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 Add note. API: POST /articles/:id/scheduled-events parametrilla type: 'note'.

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. Tapahtumalokin tapahtumista: aikaleima, tapahtumatyyppi, arvot ennen ja jälkeen (attributeChanges) tai tilauksen tiedot (eventContext).

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. Taustalla olevan tilauksen peruuttaminen kirjaa tapahtuman freed_from_order (ja tarvittaessa returned), mutta alkuperäinen assigned_to_order -tapahtuma 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?

Jos vapaata kapasiteettia on, varaus käyttää sen eikä tilaukseen kohdistu vaikutuksia. Jos vapaata väliä ei ole, TWICE yrittää siirtää olemassa olevat pidot vapaisiin väleihin ilman menetyksiä. Vain kun tilaa todella ei ole, 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 käsitteet

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

Tilaustapahtumat (tapahtumaloki)

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 käsitteet

Varastoartikkelit

Varastoartikkelin tila

Varastoartikkelin status

Työnkulut

​Määritelmä

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

​Ajastetut tapahtumat

​Varaukset

​Varausten etusija

​Muistiinpanot

​Tilaustapahtumat (tapahtumaloki)

​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 käsitteet

Varastoartikkelit

Varastoartikkelin tila

Varastoartikkelin status

Työnkulut

Määritelmä

Missä sitä käytetään?

Ajastetut tapahtumat

Varaukset

Varausten etusija

Muistiinpanot

Tilaustapahtumat (tapahtumaloki)

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 käsitteet