Skip to main content

​
Määritelmä

Saatavuus vastaa yhteen kysymykseen, mitkä listaukset asiakas voi saada tässä myyntikanavassa?, ja sitä voi tarkentaa lisätiedoilla:
  • …tietyllä keräilytavalla
  • …tietyssä sijainnissa
  • …varattavaksi kahden päivämäärän välillä
Sama saatavuuspalvelu ohjaa TWICEn omia myyntikanavia (verkkokauppa, POS, Admin), ja se on ulkoisten integraatioiden käytettävissä API:n kautta.

​
Miten se toimii

Saatavuus ei ole binäärinen. Listauksen saatavuus riippuu useista tekijöistä, jotka kerrostuvat sitä mukaa kuin lähtötietoja karttuu:
  • Listaus: listaus on aktiivinen, näkyvissä kanavassa ja sillä on vähintään yksi kelvollinen ostotyyppi.
  • Varasto: vähintään yhdessä sijainnissa on varastoa (varastoa seuraavilla tuotteilla).
  • Keräily: jokin keräilytapa voi palvella asiakasta. Noudossa toimipisteestä listaus on kelpoinen sijainnissa vain, kun sitä myydään siellä ja kyseisen sijainnin keräilysäännöt tarjoavat noudon toimipisteestä listauksen ostotyypille (vuokraus tai myynti).
  • Päivämäärät: varauksissa pyydetty ajanjakso osuu listauksen ajanjaksoihin, sen aloitus- ja päättymisaika on sallittu, ja jakso on kalenterissa vapaa.
Asiakas valitsee sijainnin ja päivämäärät yleensä vasta myöhään, joten saatavuus vastaa niillä tiedoilla, jotka sillä kulloinkin on, ja tarkentuu tietojen karttuessa:

​
Kelpoisuus vs. saatavuus

Kaksi näistä tekijöistä vastaa eri kysymyksiin, ja verkkokauppa ratkaisee ne järjestyksessä:
  • Kelpoisuus on määritysasia: voidaanko tämä listaus ylipäätään toimittaa tästä sijainnista? Sijainti on listaukselle kelpoinen, kun listausta myydään siellä ja sijainti tarjoaa keräilytavan listauksen ostotyypille. Se ei riipu varastotasoista tai päivämääristä, joten sen voi laskea etukäteen, näyttämään ”saatavilla noudettavaksi näistä sijainneista” ja suodattamaan sijaintivalitsinta.
  • Saatavuus lisää päälle varaston ja päivämäärät: onko kelpoisissa sijainneissa tosiasiassa pyydettyjä tuotteita vapaana valitulle ajanjaksolle? Sijainti voi olla kelpoinen mutta silti loppuunvarattu tietyllä aikavälillä tai määrällä.
Verkkokauppa rajaa ensin kelpoisiin sijainteihin ja ratkaisee sitten todellisen varaston ja päivämäärät asiakkaan valitsemalle sijainnille. Tuote, joka näkyy ”saatavilla noudettavaksi”, voi siis silti osoittautua loppuunvaratuksi, kun konkreettiset päivämäärät ja määrät otetaan huomioon. Kelpoisuus kertoo missä se voitaisiin toimittaa, ja saatavuus vahvistaa voidaanko se toimittaa juuri nyt. Usean toimipisteen verkkokaupoissa toimipistevalitsin määrittää, minkä sijainnin varaston asiakas näkee. Ostoskorisivu täydentää tätä toimipistekohtaisella saatavuustarkistuksella, ja jokainen toimipiste merkitään joko ”Ostoskori saatavilla” tai ”Ostoskori ei saatavilla” sen mukaan, voiko se toimittaa kaikki korin tuotteet valituille päiville.

​
Saatavuussignaali vs. tarkka varastotaso

Selausnäkymässä saatavuus on signaali (saatavilla jossakin) eikä lukumäärä. Se kertoo asiakkaalle, voiko tuotteen ostaa ja kuinka monessa sijainnissa, paljastamatta tarkkoja määriä: Tarkat sijaintikohtaiset määrät palautetaan vasta kun tietty sijainti on valittu, ja vain jos kauppias haluaa näyttää ne. Osa kauppiaista haluaa ”vain 2 jäljellä” -tyyppisen niukkuusvihjeen, toiset pitävät tarkkaa varastotasoa yksityisenä tietona. Varattavissa olevilla tuotteilla saatavuus on luonteeltaan päivämääräsidonnaista: mitään merkityksellistä signaalia ei ole ennen kuin asiakas valitsee päivät.
Saatavuus heijastaa varastoartikkelin tilaa ja kaikkia ajastettuja tapahtumia (varauksia ja muita pidätyksiä), jotka estävät tuotteen käytön tietyksi ajaksi. Tuote, joka on sidottu tilaukseen, varattu tai jonka tila ei ole käytössä, ei lasketa saatavuuteen kyseisellä aikavälillä.Myös puskuriaika laajentaa ei-saatavilla olevaa aikaikkunaa molempiin suuntiin. Varausta edeltävä puskuri estää tuotteen käytön ennen varauksen alkua (ja toimii verkkokaupassa vähimmäisvarausaikana), kun taas varauksen jälkeinen puskuri estää sen käytön varauksen päätyttyä. Molemmat puskurijaksot lasketaan sidotuiksi, ja ne estävät tuotteen varaamisen kyseisinä aikoina.

​
Varauspäätös

Se, saako asiakas listauksen, on JA-ehto useiden kerrosten yli. Jokaisen on täytyttävä, ja ensimmäinen epäonnistuva kerros on syy siihen, ettei tuotetta tarjota. Verkkokauppa arvioi ne kevyimmästä (pelkkä määritys) tarkimpaan (elävä varasto ja päivämäärät):
1

Listaus on myytävissä

  • Tila on aktiivinen: luonnos- ja pohjatilassa olevia listauksia ei koskaan tarjota.
  • Käytössä asiakkaan myyntikanavassa (salesChannelOnline verkkokaupassa).
  • Vähintään yhdellä ostotyypillä on rivi liitetyssä hintataulukossa: käytössä oleva, voimassa oleva varausrivi vuokrauksille tai myyntirivi ostoille.
2

Jokin sijainti voi toimittaa sen (kelpoisuus)

  • Listausta myydään kyseisessä sijainnissa (liitetty), ja sijainti on aktiivinen ja kanava käytössä.
  • Sijainnin keräilysäännöt tarjoavat pyydetyn keräilytavan (esimerkiksi noudon toimipisteestä) kyseiselle ostotyypille. Toimipiste, joka tarjoaa noudon myynneille mutta ei vuokrauksille, tekee vuokrauksesta siellä kelpaamattoman, vaikka varastoa olisi.
Tämä kerros on pelkkää määritystä: varastoa tai päivämääriä ei vielä katsota, joten sen voi ratkaista etukäteen sijaintivalitsimen suodattamiseksi.
3

Varastoa on (saatavuus)

Varastoa seuraavilla tuotteilla kelpoisessa sijainnissa on oltava vähintään yksi käyttökelpoinen varastoartikkeli: tilassa käytössä eikä sidottuna tilaukseen, varattuna tai muuten pidätettynä. Listaukset, joilla on rajoittamaton saatavuus, ohittavat tämän kerroksen.
4

Päivämäärät sopivat hintariviin ja sijainnin aikoihin (varaukset)

Kun asiakas on valinnut ajanjakson:
  • Varausrivin on katettava kesto ja noudatettava sen weekdays- ja timeOfDayRange-arvoja, taulukon päivämääräväliä sekä listauksen vähimmäis- ja enimmäisvarauskestoa. Muuten hintaa ei ole, joten varattavaa vaihtoehtoa ei ole.
  • Sijainnin keräilyaikojen on sallittava valitut nouto- ja palautusajat. Noutoajat rajaavat varauksen alkua, palautusajat sen loppua. Sijainnit, joilla ei ole mukautettuja keräilyaikoja, käyttävät aukioloaikoja.
5

Päivät osuvat saatavuusjaksoon (varaukset)

Listaus, jolla on ajanjaksoja Rajoitukset-välilehdellään, on varattavissa vain niinä kalenteripäivinä, noutosijainnin kellon mukaan luettuna. Listaus ilman jaksoja on saatavilla kaikkina päivinä.Jaksot, jotka menevät päällekkäin tai koskettavat toisiaan, sulautuvat yhdeksi lohkoksi, joten kesäkuu ja heinäkuu rajaavat yhtenä kesä-heinäkuun kautena.Yksi kortin valinta ratkaisee, kuinka pitkälle rajaus ulottuu:
  • Varauksen on myös päätyttävä ajanjakson sisällä vaatii varauksen alkamaan ja päättymään samassa sulautetussa lohkossa. Se on oletuksena valittuna. Poista valinta, ja vain alku rajataan, kuten tilausmääräajassa, joten varaus saa jatkua kautensa ohi.
6

Jokainen kappale on vapaa koko aikavälin (varaukset)

Jokaisen tarvittavan kappaleen on oltava vapaa päällekkäisyyksistä koko aikavälin ajan, eikä pyydetty määrä voi ylittää kyseisenä aikana käytettävissä olevien kappaleiden määrää.Puskuriaika laajentaa päällekkäisyysikkunaa molempiin suuntiin. Alkupuskuri estää tuotteen käytön ennen varauksen alkua ja loppupuskuri sen jälkeen. Tuote, jolla on 1 tunnin alkupuskuri ja 2 tunnin loppupuskuri, ei ole saatavilla tunti ennen noutoa eikä kahteen tuntiin palautuksen jälkeen.Yksi varaus jätetään tästä tarkistuksesta pois: se, jonka muokkaamasi rivitieto pitää hallussaan. Katso muokattavan rivitiedon käsittely jäljempänä.
7

Alkupuskurin vähimmäisvarausaika on täyttynyt (varaukset)

Varastoartikkelin alkupuskuri asettaa verkkokaupassa myös vähimmäisvarausajan: varaus, joka alkaa aikaisemmin kuin puskuri sallii, näytetään ei-saatavilla olevana. Admin-henkilökuntaa rajoitus ei koske.
8

Aloitus- ja päättymisaika ovat sinä viikonpäivänä sallittuja (varaukset)

Listaus voi nimetä ajat, joina varaus saa alkaa, ja ajat, joina se saa päättyä, viikonpäivittäin Rajoitukset-välilehdellään. Jokainen viikonpäivä kantaa kummallakin rajalla yhtä neljästä tilasta: ruudukkoa, tiettyjä aikoja, tiettyjä aikavälejä tai ei aikoja lainkaan.Ohitettu viikonpäivä vastaa kysymykseen itse, eikä varausväli kiristä sitä edelleen, joten luetteloitu alku klo 10.07 tarjotaan ja hyväksytään. Viikonpäivä, jota ei ole ohitettu, kulkee ruudukolla.Viikonpäivä, joka ei salli alkua, sulkee alkamiset eikä läpikulkua: monen päivän varaus saa kulkea lävitse. Päättymisajoille ei ole ruudukkoa, jonka varaan jäädä.
9

Alku osuu varausvälin ruudukkoon (varaukset)

Varaus voi alkaa N minuutin välein palvelusijainnin paikallisesta keskiyöstä laskettuna. Tili asettaa varausvälin kohdassa Asetukset → Toiminnot → Varaukset, ja listaus voi ohittaa sen Rajoitukset-välilehdellään.Valitsimet tuottavat aloitusaikansa tässä ruudukossa, joten ruudukon ulkopuolinen aika on harvoin valittavissa. Verkkokaupan ostoskori tarkistaa sen myös: ruudukon ulkopuolinen rivi merkitään off_booking_interval-ilmoituksella, ja kassa hylkää alkamisajan tilausta luotaessa.Käsittele varausväliä valitsimen ruudukkona eikä saatavuuden vastauksena. Saatavuuden päätepisteet eivät hylkää ruudukon ulkopuolista alkua, ja hallintanäkymä varaa ruudukon ulkopuolelle tarkoituksella.
10

Tilausmääräaika ei ole umpeutunut (varaukset ja kestotilaukset)

Jos listauksella on tilausmääräaika, asiakkaan on tehtävä tilaus ennen rajaa:
  • Tietty aika ennen: alkamisaika miinus kiinteä aikaväli (esimerkiksi 2 tuntia ennen alkua).
  • Kellonajan mukaan: kellonaikaan sidottu raja aiempana päivänä, palvelusijainnin aikavyöhykkeen mukaan (esimerkiksi klo 18.00 mennessä, päivää ennen alkua).
Määräajan ylittäneet alkamisajat näkyvät verkkokaupan kalenterissa ei-saatavilla olevina. Jos asiakkaalla on tuote ostoskorissa ja määräaika umpeutuu ennen kassalle siirtymistä, ostoskori merkitsee tuotteen order_deadline-ilmoituksella. Admin-käyttäjiä rajoitus ei koske, joten henkilökunta voi luoda tilauksia määräajan jälkeen.
Asiakkaalle näkyvä vastaus heijastaa syvintä saavutettua kerrosta: ”Saatavilla 3 sijainnissa” ennen sijainnin valintaa, ”Ei saatavilla tästä sijainnista”, kun kelpoisuus ei täyty, ”Ei vapaita päiviä”, kun mikään päivä ei kelpaa, ja kappalemäärä kuten ”Vain 1 jäljellä”, kun määrä on esteenä.

​
Mikä voittaa, kun listauksella on useita rajoitteita

Mikään ei kumoa mitään. Kerrokset yhdistetään JA-ehdolla, joten tiukin ratkaisee eivätkä muut voi väljentää sitä. Ajanjakso ei avaa päivää, jona sijainti on suljettu, eivätkä aukioloajat avaa päivää, joka on kaikkien jaksojen ulkopuolella. Vastaus koostuu kahdenlaisista säännöistä, ja niiden ero selittää, mitä päätepisteet raportoivat: Viikonpäivittäiset aloitus- ja päättymisajat kuuluvat saatavuusvastaukseen, joten kalenteri sulkee viikonpäivän, joka ei salli yhtään alkua. Varausväli ei kuulu: käsittele sitä ruudukkona, josta valitsin ammentaa, sillä saatavuuden päätepisteet hyväksyvät ruudukon ulkopuolisen hetken ja hallintanäkymä varaa ruudukon ulkopuolelle tarkoituksella. Kaikkien näiden takana olevat kirjoitusvaiheen tarkistukset koskevat vain verkkokaupan ja kassan polkuja. Hallintanäkymässä luotua tilausta eivät rajaa ajanjaksot, aloitus- ja päättymisajat, varausväli eikä tilausmääräaika, joten henkilökunta voi ottaa puhelimessa varauksen, jonka verkkokauppa hylkää. Jokainen tarkistus rajaa luotavaa varausta, joten tänään muutettu sääntö jättää eilisen tilaukset voimassa ja muokattaviksi.

​
Olemassa olevan rivitiedon muokkaus

Kun saatavuus lasketaan muokattavana olevalle rivitiedolle, kyseisen rivitiedon oma varaus jätetään tarkistuksen ulkopuolelle yhdessä siihen liitettyjen lisäosien varausten kanssa. Poikkeus kattaa koko varatun jalanjäljen, puskuri-ikkunat mukaan lukien, jottei rivitieto koskaan estä omaa muokkaustaan. Ilman tätä tuotteen oma puskuri kääntyisi sitä vastaan: varastoartikkeli, jolla on 2 tunnin loppupuskuri, kieltäytyisi sen vuokra-ajan tunnin pidennyksestä, joka puskurin alun perin loi. Myydyn varastoartikkelin jättäminen tarkistuksen ulkopuolelle vapauttaa myynnin kuluttaman kapasiteetin samalla tavalla, joten myynnin uudelleenpäivääminen näkee oman kappaleensa jälleen saatavilla olevana. Sääntö pätee kaikkialla, missä olemassa olevaa rivitietoa päivätään tai valitaan uudelleen: Adminin rivitietojen editorissa ja verkkokaupan ostoskorin muokkauksessa. Se ei ulotu saman tilauksen muihin rivitietoihin: ne pitävät varauksensa normaalisti, ja niiden kanssa törmäävä muokkaus raportoidaan ei-saatavilla olevaksi.

​
Ostoskorissa jo olevat tuotteet

Ostoskorin tuotteet tarkistetaan ikään kuin ne olisi jo varattu, puskureineen kaikkineen. Saman varastoartikkelin toista vuokrausta, joka alkaa ensimmäisen loppupuskurin sisällä, ei tarjota, vaikka itse vuokra-ajat eivät menisi päällekkäin. Sama koskee ostoskorisivun toimipistekohtaista tarkistusta: toimipiste lasketaan ”Ostoskori saatavilla” -tilaan vain, kun se pystyy pitämään hallussaan kaikki korin tuotteet puskuri-ikkunoineen yhtä aikaa.

​
Esimerkkejä

Listaus on aktiivinen ja varastossa toimipisteessä, mutta toimipisteen keräilysäännöt sallivat noudon toimipisteestä vain myynneille. Vuokraus on siellä kelpaamaton, joten verkkokauppa näyttää ”Ei saatavilla tästä sijainnista”, vaikka kappaleita on. Se voi silti olla varattavissa toisessa toimipisteessä, joka tarjoaa vuokrausnoudon.
Tuote on kelpoinen ja kappaleita on, mutta jokainen valitun sijainnin kappale on jo sidottu osaksi pyydettyä ajanjaksoa. Selaussignaalissa se näkyy saatavilla olevana, mutta kalenteri ei palauta yhtään varattavaa aikaväliä juuri noille päiville. Toiset päivät tai toinen sijainti ratkaisevat asian.
Varastoartikkelilla on 2 tunnin loppupuskuri, ja asiakas soittaa pidentääkseen vuokraustaan tunnilla. Ylimääräinen tunti osuu puskuriin, jonka vuokraus itse loi.Koska muokattava rivitieto jätetään tarkistuksen ulkopuolelle, tunti näkyy vapaana ja uudet päivämäärät tallentuvat. Toisen asiakkaan varaus samassa ikkunassa estäisi sen edelleen.
Ainoa varausrivi on rajattu ma–pe (weekdays) kahden päivän vähimmäiskestolla. Lauantain alku tai yhden päivän varaus ei vastaa yhtäkään riviä, joten hintaa ei ole eikä valintaa voi varata, vaikka varastoa olisi vapaana.Verkkokauppa kertoo tämän ennen kuin asiakas sitoutuu: varaustyökalun Booking options -pudotusvalikossa vaihtoehto, joka ei voi alkaa valittuna päivänä, näkyy harmaana ja kertoo seuraavan mahdollisen päivän tekstillä ”Ei saatavilla valituille päiville - seuraava vapaa ma 18.8.”. Sen valinta siirtää alkamispäivän kyseiselle päivälle. Katso Verkkokauppa.
Asiakas haluaa 3 kappaletta; valitussa sijainnissa on 1 vapaana aikavälillä ja toisessa 2. Kumpikaan ei voi toimittaa kaikkia 3 yksin, joten tuote näkyy kokonaisuutena saatavilla olevana, mutta valitussa sijainnissa enimmäismäärä on 1. Määrän pienentäminen, tai riittävän varaston omaavan sijainnin valitseminen, ratkaisee asian.
Tilauksesta valmistettava myyntilistaus, jolla on rajoittamaton saatavuus, ohittaa varasto- ja päällekkäisyyskerrokset kokonaan: kunhan se on aktiivinen, kanavassa ja myynnissä kelpoisessa sijainnissa, se on ostettavissa ilman määrän ylärajaa.
Melontalautavuokrauksella on yksi ajanjakso, 1.6.–31.8. Helmikuussa kalenterilla ei ole mitään tarjottavaa, ja listaussivu näyttää tilan Varattavissa sekä kesä-elokuun päivät tyhjän kuukauden sijaan.Asiakas, joka pakottaa huhtikuun päivät ostoskoriin, näkee rivillä merkinnän ”Ei saatavilla - tätä kohdetta ei voi varata valituille päiville”.
Suksivuokraus asettaa sunnuntain tilaan Ei päättymisaikoja sallittu rivillä Päättymisajat, koska kukaan ei ole vastaanottamassa välineitä. Sunnuntai säilyttää tavalliset aloitusaikansa.Asiakas voi ottaa perjantaista maanantaihin kestävän vuokrauksen, joka kulkee sunnuntain lävitse, ja voi myös aloittaa vuokrauksen sunnuntaina. Palautusajan valitsin ei tarjoa sunnuntaille yhtään vuoroa, ja suoraan kassalle vietävä sunnuntain palautus hylätään.
Asiakas lisää klo 10.45 alkavan varauksen, kun tili käyttää 15 minuutin varausväliä. Kauppias vaihtaa tilin 30 minuuttiin, ja ostoskori merkitsee rivin ilmoituksella off_booking_interval: klo 10.45 ei ole enää ruudukon tarjoama alku.Jo tilatut klo 10.45 alkavat varaukset säilyttävät aikansa. Tarkistus koskee vain luotavaa alkua, joten muutos ei mitätöi mitään tilaushistoriassa.
Listauksella on tilausmääräaika ”2 tuntia ennen alkua”. Asiakas lisää klo 14.00 alkavan varauksen ostoskoriinsa klo 11.30, mutta siirtyy kassalle vasta klo 12.15. Ostoskori merkitsee tuotteen, sillä määräaika oli klo 12.00 eikä tilausta voi enää tehdä kyseiselle alkamisajalle. Asiakas voi valita myöhemmän alkamisajan tai poistaa tuotteen.

​
Saatavuuden hakeminen API:n kautta

Todenna X-API-KEY-otsakkeella (katso API-avaimet). Keskeiset päätepisteet: Yleisiä kyselyparametreja ovat from / to (päivämääräväli), serviceLocationIds ja variantValueIds. Kaksi availability-päätepistettä kuuluvat dokumentoituun Admin API:in. Kaksi jälkimmäistä ovat kutsuttavissa, mutta niitä ei ole julkaistu referenssissä, joten ne voivat muuttua ilman erillistä ilmoitusta. Rakenna niiden varaan vain, jos kestät sen. Katso täydet parametrit ja vastausskeemat API-referenssistä. Se muodostetaan suoraan käytössä olevasta API:sta, joten se vastaa aina nykyisiä kenttiä.

​
Aiheeseen liittyvät artikkelit

Listaukset

Asiakkaille näkyvä katalogikohde, jolle saatavuus lasketaan.

Varastoartikkelin tila

Sisään- ja ulossitoumukset, jotka ohjaavat saatavuutta.

Ajastetut tapahtumat

Varaukset ja pidätykset, jotka estävät saatavuuden tietyksi ajaksi.

Hintataulukot

Varausten yhteydessä saatavuuden rinnalla palautettava hinnoittelu.

Sijainnit

Missä listauksia myydään ja mitkä keräilysäännöt ohjaavat noudon kelpoisuutta.

Varausasetukset

Tilin laajuinen varausväli, jonka ruudukossa valitsimet tuottavat aloitusajat.

Listauksen Rajoitukset-välilehti

Missä listaus asettaa ajanjaksonsa, aloitus- ja päättymisaikansa sekä tilausmääräaikansa.