Definice
Dostupnost odpovídá na jednu otázku, které inzeráty může zákazník v tomto prodejním kanálu získat?, a umožňuje ji prohloubit kontextem:- …s daným typem vyřízení
- …na konkrétním místě
- …k rezervaci mezi dvěma daty
Jak to funguje
Dostupnost není binární. Zda je inzerát dostupný, závisí na několika faktorech, které se vrstvou přidávaného kontextu:- Inzerát – inzerát je aktivní, viditelný v kanálu a má alespoň jeden platný typ nákupu.
- Sklad – alespoň jedno místo drží zásobu (u položek, které sledují inventář).
- Vyřízení – způsob vyřízení dokáže zákazníka obsloužit. U vyzvednutí v obchodě je inzerát na daném místě způsobilý pouze tehdy, když se tam prodává a pravidla vyřízení daného místa nabízejí vyzvednutí v obchodě pro typ nákupu inzerátu (pronájem nebo prodej).
- Data – u rezervací je požadované období bez konfliktů v kalendáři.
Způsobilost vs. dostupnost
Dva z těchto faktorů odpovídají na odlišné otázky a výkladní skříň je vyhodnocuje v tomto pořadí:- Způsobilost je fakt konfigurace – lze tento inzerát na tomto místě vůbec vyřídit? Místo je pro inzerát způsobilé, když se inzerát na něm prodává a místo nabízí způsob vyřízení pro jeho typ nákupu. Nezávisí na stavu zásob ani na datech, takže ji lze vyhodnotit předem – pro zobrazení „dostupné k vyzvednutí na těchto místech” a pro filtrování výběru místa.
- Dostupnost na to vrství zásoby a data – mají způsobilá místa opravdu požadované položky volné pro zvolené období? Místo může být způsobilé, a přesto vyprodané pro dané období nebo množství.
Signál dostupnosti vs. přesná zásoba
V pohledu procházení je dostupnost signál, tedy dostupné někde, ne počet. Sděluje zákazníkovi, zda lze položku koupit a na kolika místech, aniž by odhalovala přesná množství:Rozhodnutí o rezervaci
Zda může zákazník inzerát získat, je součin (A zároveň) napříč několika vrstvami – každá musí projít a první vrstva, která selže, je důvodem, proč inzerát není nabídnut. Výkladní skříň je vyhodnocuje od nejlevnější (čistá konfigurace) po nejkonkrétnější (živé zásoby a data):Inzerát je prodejný
- Status Aktivní – koncept a šablonové inzeráty se nikdy nenabízí.
- Zapnuto v zákazníkově prodejním kanálu (
salesChannelOnlinepro Internetový obchod). - Má alespoň jeden typ nákupu s řádkem v připojené cenové tabulce: zapnutý rezervační řádek v platném okně pro pronájmy, nebo prodejní řádek pro nákupy.
Místo dokáže inzerát vyřídit – způsobilost
- Inzerát se prodává na místě (propojeno) a místo je aktivní se zapnutým kanálem.
- Pravidla vyřízení daného místa nabízejí požadovaný způsob vyřízení (např. vyzvednutí v obchodě) pro daný typ nákupu. Prodejna, která nabízí vyzvednutí pro prodej, ale ne pro pronájem, dělá pronájem tam nezpůsobilým, i kdyby byl skladem.
Zásoba existuje – dostupnost
Data odpovídají cenovému řádku a otevírací době místa (rezervace)
- Rezervační řádek musí pokrýt danou dobu trvání a respektovat svá omezení
weekdaysatimeOfDayRange, datové okno tabulky a minimální/maximální dobu rezervace inzerátu – jinak cena neexistuje, a tedy ani rezervovatelná možnost. - Hodiny vyřízení místa musí umožňovat zvolený čas vyzvednutí a vrácení. Hodiny vyzvednutí omezují začátek rezervace, hodiny vrácení omezují její konec. Místa bez vlastních hodin vyřízení se řídí otevírací dobou.
Každá jednotka je volná pro celé období (rezervace)
Uplynul minimální předstih z odstupu před rezervací (rezervace)
Začátek je na mřížce rezervačního intervalu (rezervace)
off_booking_interval a pokladna odmítne začátek při vytváření objednávky.Berte interval jako mřížku pro výběr, ne jako odpověď o dostupnosti. Endpointy dostupnosti začátek mimo mřížku neodmítají a správa objednávek v administraci úmyslně rezervuje mimo mřížku.Termín objednávky neuplynul (rezervace a předplatná)
- V pevně stanovený čas předem – čas začátku minus pevný odstup (např. 2 hodiny před začátkem).
- Do určité denní doby – mezní čas dřívějšího dne, vyhodnocený v časovém pásmu servisního místa (např. do 18:00, 1 den před začátkem).
order_deadline. Uživatelé administrace jsou z toho vyňati – personál může vytvářet objednávky i po termínu.Úprava existující řádkové položky
Když se dostupnost počítá pro řádkovou položku, která je právě upravována, vlastní rezervace této řádkové položky je z kontroly vyloučena, spolu s rezervacemi jakýchkoli k ní připojených doplňků. Výjimka pokrývá celou rezervovanou stopu, okna odstupu včetně, takže řádková položka nikdy neblokuje vlastní úpravu. Bez ní by se vlastní odstup položky počítal proti ní: skladová položka s dvouhodinovým odstupem po rezervaci by odmítla hodinové prodloužení téhož rezervačního období, které tento odstup vytvořilo. Vyloučení prodané skladové položky uvolňuje kapacitu, kterou prodej zabral, stejným způsobem, takže přeplánování prodeje vidí vlastní jednotku znovu jako dostupnou. Pravidlo platí všude, kde se existující řádková položka přeplánovává nebo se jí mění výběr – v editoru řádkové položky v administraci i v úpravě košíku ve výkladní skříni. Nevztahuje se na jiné řádkové položky téže objednávky – ty si drží své rezervace normálně a úprava, která se s některou střetne, se nahlásí jako nedostupná.Položky již v košíku
Položky v košíku se kontrolují, jako by už byly rezervované, včetně odstupů. Druhý pronájem téže skladové položky, který začíná uvnitř odstupu po prvním pronájmu, se nenabízí, i když se samotná rezervační období nepřekrývají. Totéž platí pro kontrolu jednotlivých obchodů na stránce košíku – obchod se počítá jako „Košík je dostupný” jen tehdy, když dokáže naráz udržet každou položku v košíku i s jejími okny odstupu.Příklady
Pronájem prodávaný v obchodě, který nabízí vyzvednutí jen pro prodej
Pronájem prodávaný v obchodě, který nabízí vyzvednutí jen pro prodej
Skladem, ale zvolená data jsou v konfliktu
Skladem, ale zvolená data jsou v konfliktu
Prodloužení pronájmu, kterému stojí v cestě vlastní odstup
Prodloužení pronájmu, kterému stojí v cestě vlastní odstup
Rezervovatelné, ale ne v požadovaný den nebo na požadovanou dobu
Rezervovatelné, ale ne v požadovaný den nebo na požadovanou dobu
weekdays) s dvoudenním minimem. Sobotní začátek nebo jednodenní rezervace neodpovídá žádnému řádku – neexistuje cena, takže pro tento výběr nejde rezervovat, i když je zásoba volná.Výkladní skříň to zákazníkovi ukáže dřív, než se zaváže: v rozbalovací nabídce Možnosti rezervace v rezervačním widgetu je možnost, kterou nelze v daný den zahájit, zešedlá a popsaná dalším možným datem – „Pro vybraná data není k dispozici – další dostupné po 18. 8.” Jejím výběrem se datum začátku přesune na tento den. Viz Možnosti rezervace a zvolené datum.Množství přesahuje to, co drží jedno místo
Množství přesahuje to, co drží jedno místo
Prodejní položka bez pravidel zásob
Prodejní položka bez pravidel zásob
Položka v košíku vypadne z mřížky po změně intervalu
Položka v košíku vypadne z mřížky po změně intervalu
off_booking_interval: 10:45 už není začátek, který mřížka nabízí.Rezervace už objednané na 10:45 si svůj čas ponechají. Kontroluje se jen vytvářený začátek, takže žádná objednávka v historii se změnou neznehodnotí.Dotazování dostupnosti přes API
Ověřte se hlavičkouX-API-KEY (viz Klíče API). Hlavní endpointy:
from / to (rozsah dat), serviceLocationIds a variantValueIds.
Oba endpointy availability jsou součástí dokumentovaného Admin API. Poslední dva jsou dosažitelné, ale nejsou publikovány v referenci, takže se mohou bez upozornění změnit. Stavte na nich jen tehdy, pokud to dokážete unést.
Úplné parametry a schémata odpovědí najdete v API referenci – je generovaná z živého API, takže vždy odráží aktuální pole.