Přejít na hlavní obsah
Tabulka inzerátů v administraci

Katalog > Inzeráty

​
Definice

Analogie: Inzerát je výkladní verze vašeho produktu. SKU a skladové položky popisují, co vlastníte, inzerát popisuje, co prodáváte: jeho název, fotografie, ceny, doby trvání a místa, kde se zobrazuje.
Zvláštnost v TWICE: Inzerát není sklad. Dostupnost se odvozuje v reálném čase ze skladových položek, které jsou s ním propojeny prostřednictvím pravidel plnění. Dva inzeráty mohou vést ke stejným fyzickým jednotkám (například inzerát na denní pronájem a inzerát na dlouhodobé předplatné téhož kola).

​
Inzerát vs. SKU vs. skladová položka

Inzerát se propojuje se skladem prostřednictvím pravidel plnění, ne přímými cizími klíči. Pravidlo říká: „pro splnění tohoto inzerátu rezervujte 1 jednotku odpovídající attribute:bike_size = M”. Pravidlo se v okamžiku objednávky přeloží na odpovídající skladové položky, a proto může jeden inzerát čerpat z mnoha SKU a mnoho SKU může zásobovat mnoho inzerátů. Viz také: SKU, Skladová položka.

​
Kde to použiji?

  • Správa katalogu: Vytvářejte, organizujte a publikujte produkty, které si zákazníci mohou objednat
  • Internetový obchod: Vše publikované do online kanálu se vykresluje z inzerátu
  • Vytváření objednávek: Návrh objednávky v administraci i pokladna na výkladní skříni začínají u inzerátu
  • Ceny: Připojte jednu nebo více cenových tabulek pro řízení sazeb za pronájem, prodej a předplatné
  • Varianty: Nabízejte velikost, barvu nebo jiné osy v rámci jednoho inzerátu
  • Dostupnost: Počítejte dostupnost k prodeji (ATS) v reálném čase průnikem pravidel plnění se skladovými položkami
  • Kolekce: Seskupujte inzeráty pro navigaci a merchandising na výkladní skříni
  • Prodejní kanály: Řiďte, zda je inzerát viditelný v administraci a v internetovém obchodě
  • Doplňky: Označte inzerát jako pouze doplňkový, nebo k jiným inzerátům připojte doplňky
  • SEO a marketing: URL adresa, titulek stránky, meta popis, obrázek OpenGraph, noindex

​
Klíčové vlastnosti

​
Identita a obsah

​
Stav a viditelnost

Výběr stavu v administraci nabízí pouze Veřejné (active) a Koncept (draft). Hodnota template je vyhrazená pro systémové šablony a není stavem publikování určeným pro uživatele.Archivace je samostatná osa nezávislá na stavu publikování. Nastavením inzerátu na Koncept ho ponecháte v katalogu, ale mimo výkladní skříň, archivací ho vyřadíte z používání úplně. Viz Archivace a mazání.

​
Ceny a daně

Cena se nikdy neukládá přímo na inzerát. Veškeré ceny žijí v připojených cenových tabulkách (řádky pro rezervace, prodej i předplatné). Viz koncept Cenová tabulka.

​
Limity a chování rezervace

unit je jedna z hodnot seconds, minutes, hours, days, weeks, months.

​
Sklad a plnění

​
Varianty

Inzerát bez variant se považuje za nabídku s jedním SKU. Viz koncept Varianta.

​
Média, dokumenty a SEO

​
Doplňky a související inzeráty

​
Požadavky pokladny

​
Vztahy

Inzerát je jeden řádek ve vašem katalogu. Je jednotkou merchandisingu a tím, co se objednává. Inzeráty se vypisují, filtrují a seskupují v Katalog → Inzeráty.
Inzerát neukazuje na jedno SKU. Každé pravidlo plnění na inzerátu přiřazuje jednu nebo více skladových položek podle atributu, kódu SKU nebo jiných filtrů. Dostupnost inzerátu je průnikem těchto shod s rezervacemi v kalendáři.
Inzerát se může objevit v libovolném počtu kolekcí, ať už přidaný ručně (manuální kolekce), nebo přiřazený podle štítku (chytrá kolekce). Viz koncept Kolekce.
Dva boolean příznaky řídí, kde je inzerát nabízen: Administrace a Internetový obchod. Vypnutím obou zůstane inzerát v katalogu, ale mimo provoz. Viz koncept Internetový obchod.
Každý CatalogItemServiceLocationLink určuje místo, ze kterého lze inzerát plnit. Používají ho filtry dostupnosti na výkladní skříni i směrování objednávek.
Veškeré ceny žijí v připojených cenových tabulkách. Inzerát obvykle má výchozí (vždy platnou) cenovou tabulku a volitelné časově omezené tabulky pro akce nebo sezónní ceny.

​
Karty detailu inzerátu

Po otevření inzerátu v administraci nabízí stránka zdroje tyto karty:

​
Výpočet dostupnosti

Dostupnost (ATS, Available-To-Sell) se na inzerátu nikdy neukládá. Počítá se na vyžádání pomocí koncových bodů dostupnosti katalogu:
  • GET /catalog/:id/quantity – celkový počet dostupných jednotek pro inzerát v daném rozsahu dat a vybraných místech
  • GET /catalog/:id/available-by-variant-value-groups – rozpad podle kombinací hodnot variant
Výpočet projde pravidla plnění inzerátu, vyhodnotí conditions každého pravidla vůči skladovým položkám a odečte stávající rezervace v požadovaném okně. Inzerát s inventoryTrackingEnabled = false se považuje za nekonečně dostupný.

​
Životní cyklus

1

Vytvoření

Vytvořte inzerát od začátku, ze šablony, duplikováním existujícího inzerátu nebo přímo z SKU (POST /catalog/from-article/:articleId).
Striktně vyžadován je pouze name. Aby byl inzerát kupitelný, potřebujete navíc alespoň jedno pravidlo plnění (nebo inventoryTrackingEnabled = false), jednu cenovou tabulku a alespoň jeden povolený prodejní kanál.
Nové inzeráty se vytvářejí se status = 'draft'. Jsou pro zákazníky neviditelné, dokud je nepřepnete na Veřejné.
Ano. Použijte POST /catalog/ pro přímé vytvoření, POST /catalog/many pro hromadný import nebo POST /catalog/from-article/:articleId pro založení inzerátu z existujícího SKU.
2

Publikování

Přepněte status na active a povolte prodejní kanály, na kterých se má inzerát objevit.
V internetovém obchodě, pokud je salesChannelOnline = true, a v návrhu objednávky v administraci, pokud je salesChannelAdmin = true.
Nic v API. Inzerát bez pravidla plnění a s inventoryTrackingEnabled = true ale ukáže nulovou dostupnost. Inzerát bez cenové tabulky nelze u pokladny ocenit.
3

Aktualizace

Většinu polí lze upravit přes PUT /catalog/:id. Pravidla, varianty, cenové tabulky a čárové kódy mají vlastní vnořené koncové body.
Obsahová pole (název, popis, média, SEO) jsou bezpečná. Změny pravidel ovlivňují jen budoucí výpočty dostupnosti, existující objednávky si zachovávají data inzerátu, která zachytily.
Pokud má cena platit až od budoucího data, přidejte novou datovanou cenovou tabulku místo úpravy té výchozí. Existující objednávky se zpětně nepřeceňují.
4

Vyřazení

Nastavením status = 'draft' vyřadíte inzerát z provozu, ale zachováte jeho historii, DELETE /catalog/:id ho odstraní. Inzeráty, na které odkazují objednávky, se pro účely historického reportingu uchovávají i po smazání.

​
Časté dotazy

SKU je definice skladu: kód, který identifikuje typ jednotky, kterou vlastníte. Inzerát je prodejná nabídka ve vašem katalogu. Jedno SKU může zásobovat mnoho inzerátů (například denní pronájem, týdenní pronájem a přímý prodej téhož kola). Jeden inzerát může vést k mnoha SKU prostřednictvím pravidel plnění.
Ano. Vytvořte jeden inzerát na každou nabídku a připojte ke každému jinou cenovou tabulku, nebo připojte k jednomu inzerátu více cenových tabulek s nepřekrývajícími se okny availabilityRange.
Každé pravidlo plnění se vyhodnotí na sadu kandidátských skladových položek podle shody atributu nebo kódu. ATS inzerátu pro dané časové okno se rovná počtu kandidátských skladových položek mínus jednotky již rezervované pro toto okno.
template je interní stav používaný funkcí systémových šablon. Není zobrazen ve výběru stavu v administraci a není stavem publikování určeným pro uživatele.
Ano. Model cenové tabulky zahrnuje samostatné bookingPricingRows, salesPricingRows a subscriptionPricingRows. Přepínači bookingsEnabled, salesEnabled a subscriptionsEnabled na tabulce řídíte, které režimy nákupu jsou nabízeny.
Veškerá cenová logika žije na cenových tabulkách, aby mohlo pro jeden inzerát koexistovat více sazebníků, časově omezené akce a násobitele podle varianty. Inzerát bez cenové tabulky je neoceněný.

​
Reference pro vývojáře

Inzeráty jsou v API vystaveny jako položky catalog.

API: Catalog

Otevřít koncový bod v referenci API.

​
Související články

Varianty

Velikost, barva a další osy v rámci inzerátu

Cenové tabulky

Znovupoužitelné cenové struktury připojené k inzerátům

Kolekce

Manuální a chytré skupiny inzerátů

SKU

Definice skladu, ze které inzerát plní

Skladová položka

Fyzické jednotky rezervované při objednání inzerátu

Internetový obchod

Kde se veřejné inzeráty zobrazují zákazníkům