Události - TWICE Commerce

Časová osa událostí skladové položky — Inventář > Skladové položky > [Položka] > Události

Definice

Události skladové položky tvoří časovou osu všeho, co se s danou položkou stalo. TWICE rozlišuje dvě vrstvy:

Naplánované události: časově vymezené bloky (rezervace a poznámky) vytvořené vámi nebo automatizací. Mohou blokovat dostupnost a mohou nést přílohy.
Události protokolu aktivit: systémem zaznamenaná historie změn položky (přiřazení k objednávce, vyřízení, status, místo, atributy).

Dohromady odpovídají na otázky: co tato položka právě dělá? a co se s ní stalo?

Analogie: Události skladové položky jsou jejím kalendářem a zároveň jejím deníkem. Kalendář (naplánované události) je pohled do budoucna na to, co je zavázáno; deník (protokol aktivit) je auditovatelný záznam všeho, co se stalo.

Kde to použiji?

Události se zobrazují na kartě Události každé skladové položky. S událostmi pracujete, když:

Sledování dostupnosti položky: vidíte, co blokuje dostupnost a kdy budou položky volné.
Zaznamenávání objednávek zákazníků: události objednávek se zaznamenávají automaticky při přiřazení položek k objednávkám.
Správa interních rezervací: blokujte položky pro údržbu, uskladnění nebo interní použití.
Přidávání dokumentace: zaznamenávejte kontroly, poznámky k podmínce, protokoly oprav nebo důležitá pozorování.
Audit historie položky: přesně rekonstruujte, kdy a proč se změnil stav, status, místo nebo SKU položky.
Reporting: prohlížejte všechny události napříč svým inventářem v jedné tabulce.

Naplánované události

Naplánované události ovládá uživatel a žijí na article přes scheduledEvents. Existují dva typy:

Typ	Blokuje dostupnost	Viditelné zákazníkovi	Vytváří
`reservation`	Ano	Ne	Operátor (ručně) nebo workflow
`note`	Ne	Ne	Operátor (ručně)

Oba typy mají stejný tvar:

{
  "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 může být null pro otevřené události. Rezervace s null datem konce činí položku nedostupnou, dokud není rezervace uzavřena.

Rezervace

Rezervace vytvářejí pro položku rozsah unavailability. Jde o způsob, jak vyjmout skladovou položku z dostupného poolu z interního důvodu (ne kvůli objednávce zákazníka), jako je údržba, focení, školení nebo přidržení položky na známou akci.

Ručně vytvořené z karty Události skladové položky přes Přidat → Rezervace, což otevře panel Naplánovat rezervaci, nebo přes POST /articles/:id/scheduled-events. Položka bez dosavadních událostí nabízí v prázdném stavu Rezervovat article.
Během rozsahu rezervace položka vypadne z ATS a nelze ji přiřadit k novým objednávkám.
Jakmile uplyne datum konce, dostupnost se automaticky obnoví. Rezervace vyprší samy. Není potřeba ruční úklid.
Rezervace může nést přílohu přes hlavní knihu article (scheduledEventId na položce hlavní knihy), např. zaznamenejte náklad na opravu k rezervaci, která práci naplánovala.

Upřednostněte rezervaci před statusem Neaktivní, pokud má nedostupnost známé datum konce. Rezervace vyprší automaticky; Neaktivní vyžaduje ruční reaktivaci. Viz Status skladové položky.

Priorita rezervace

Ručně vytvořená rezervace má přednost před stávajícími vazbami (objednávkami a jinými rezervacemi), pokud skladová položka nemá volnou kapacitu. TWICE konflikt řeší v tomto pořadí:

Použije jakoukoli volnou kapacitu.
Přesune stávající vazby do jiných volných slotů, pokud je to možné.
Jako poslední možnost uvolní co nejméně stávajících vazeb potřebných k uvolnění místa.

Dotčené objednávky a rezervace se neruší: uvolní se pouze jejich vazba na tuto konkrétní skladovou položku pro překrývající se data.

Uvolnění vazby znamená, že dotčená objednávka nebo rezervace už danou skladovou položku pro překrývající se období nerezervuje. Samotná objednávka zůstává aktivní, ale skladová položka se pro toto okno stává nepřiřazenou. Dotčené objednávce možná budete muset přiřadit náhradní skladovou položku.

Potvrzovací dialog zobrazující dotčené objednávky při vytváření konfliktní rezervace — Potvrzovací dialog konfliktu rezervace

Když systém určí, že je nutné vazby uvolnit, ještě před jakoukoli změnou se zobrazí potvrzovací dialog. Dialog zobrazuje:

Rezervaci, kterou přidáváte (název, data, místo).
Prohledávatelný seznam každé objednávky a rezervace, která o vazbu na skladovou položku přijde.
Každý dotčený řádek lze rozbalit pro načtení podrobností: u objednávek číslo objednávky, zákazníka, status a data; u rezervací název a komentář.
Zaškrtávací pole „Potvrďte, že rozumíte dopadu” podmiňuje potvrzovací tlačítko Přidat rezervaci.

Pokud se sada dotčených vazeb mezi otevřením dialogu a potvrzením změní (například jiný operátor mezitím přidá novou objednávku), TWICE vás požádá, abyste si aktualizovaný seznam znovu prohlédli, než se cokoli uvolní.

Dotčeny jsou pouze vazby na stejném servisním místě jako rezervace. Vazby na jiných místech pro stejnou skladovou položku zůstávají nedotčeny.

Poznámky

Poznámky jsou časově označené záznamy, které neblokují dostupnost. Použijte je k zdokumentování čehokoli provozního, co má zůstat na záznamu položky, ale nejde o závazek v reálném čase.

Ručně vytvořené z karty Události skladové položky přes Přidat → Poznámka, což otevře panel Přidat poznámku, nebo přes POST /articles/:id/scheduled-events s type: 'note'.
Viditelné operátorům s přístupem k položce; zákazníkům se nikdy nezobrazují.
Mohou mít endDate, pokud pozorování pokrývá rozsah (např. „podmínka pozorována 10.–15. ledna”), nebo null pro jediné časové razítko.
Užitečné jako základ pro hlášení incidentů, historii podmínky a provozní předávání.

Události objednávky (protokol aktivit)

Když je položka přiřazena k objednávce zákazníka, TWICE zaznamená do protokolu aktivit proud událostí. Tyto události jsou řízené systémem a nelze je upravovat. Kompletní sada systémových typů událostí:

`eventType`	Kdy nastane	Kontext
`assigned_to_order`	Položka je přidána k objednávce	`orderId`, `orderNumber`, `orderProductId`, `price`, `shopperId`
`freed_from_order`	Položka je odebrána z objednávky, nebo je objednávka zrušena	Stejné jako výše
`handed_out`	Operátor označí řádek jako vyzvednutý; stav se přepne na U zákazníka	`orderId`, `orderNumber`, `shopperId`
`returned`	Operátor označí řádek jako vrácený; stav se přepne na U vás	`orderId`, `orderNumber`, `price`, `shopperId`, `orderProductId`
`allocation_changed`	Změnila se alokace položky mezi pronájmem a prodejem	`attributeChanges.from.allocation`, `attributeChanges.to.allocation`
`status_changed`	Status se změnil (např. Aktivní → Neaktivní)	`attributeChanges.from.status`, `attributeChanges.to.status`
`sku_changed`	Propojení SKU se změnilo	`attributeChanges.from.sku`, `attributeChanges.to.sku`
`location_changed`	Servisní místo se změnilo	`attributeChanges.from.storeId`, `attributeChanges.to.storeId`
`identifiers_changed`	Pole `codes` bylo aktualizováno	`attributeChanges.from.itemCodes`, `attributeChanges.to.itemCodes`
`specifications_changed`	Atributy nebo hodnoty pevných polí se změnily	`attributeChanges.from`, `attributeChanges.to`

Události objednávky se zobrazují přímo ve stejné časové ose Události, takže vidíte pohromadě jak závazky (rezervace, poznámky), tak historický záznam.

Srovnání

Vlastnost	Událost objednávky	Rezervace	Poznámka
Zdroj	Systém	Uživatel nebo workflow	Uživatel
Kde se spravuje	Sekce Objednávky	Karta Události skladové položky	Karta Události skladové položky
Blokuje dostupnost	Ano (dokud je řádek aktivní)	Ano	Ne
Viditelné zákazníkovi	Ano	Ne	Ne
Časově vymezené	Ano (období pronájmu nebo objednávky)	Ano (období rezervace)	Volitelně (časové razítko)
Vyprší automaticky	Ano (při vrácení / zrušení)	Ano (v `endDate`)	Nevztahuje se
Nese přílohy	Přes samotnou objednávku	Přes odkaz na hlavní knihu article	Přes odkaz na hlavní knihu article
Běžné případy užití	Pronájmy a prodeje zákazníkům	Údržba, interní vazba	Poznámky k podmínce, protokoly incidentů

Kde spravovat události

Zákaznické objednávky

Spravujte objednávky. Objednávky automaticky zaznamenávají události na přiřazených skladových položkách.

Interní rezervace a poznámky

Přidávejte a spravujte rezervace a poznámky z karty Události skladové položky.

Karta Události zobrazuje naplánované události a protokol aktivit společně v chronologickém pořadí, což vám dává kompletní obraz o životním cyklu položky.

Interní rezervace vs vazby

Rezervace jsou jediný způsob, jak v TWICE „zablokovat” inventář mimo objednávku. Běžné vzory:

Servisní okno. Zablokujte položku na naplánované servisní období. K rezervaci přiložte nákladovou položku hlavní knihy pro fakturu za opravu.
Focení nebo školení. Zablokujte položku bez zapojení systému objednávek.
Vazba operátora. Zákazník je na cestě k vyzvednutí: vytvořte krátkou rezervaci, aby si tuto položku nemohl rezervovat nikdo jiný.
Posouzení poškození. Zablokujte položku, dokud ji neprohlédnete a nerozhodnete, zda ji vrátit do provozu.

Rezervace nelze převést na objednávky. Jde o samostatný proces. Pokud zákazník chce položku, kterou máte rezervovanou, smažte nebo zkraťte rezervaci a vytvořte skutečnou objednávku.

Dokumenty přiložené k událostem

Soubory lze k událostem přiložit dvěma mechanismy:

Dokumenty skladové položky (documents na article): globální pro celou položku.
Položky hlavní knihy article s scheduledEventId: finanční položky vázané na konkrétní rezervaci. Položka hlavní knihy může odkazovat na přílohu souboru jako součást své datové části value.

Například: rezervace Yearly service vytvoří položku hlavní knihy typu cost ve výši 150 € s přiloženou PDF účtenkou. Rezervace i položka hlavní knihy zůstávají propojené, díky čemuž je auditní stopa položky dohledatelná od začátku do konce.

Spouštěče workflow z událostí

Události jsou přirozeným háčkem pro automatizaci. Běžné vzory:

Při handed_out → spusťte časovač; označte objednávku jako opožděnou, pokud returned nenastane do N dnů.
Při returned → vytvořte rezervaci údržby, pokud byl řádek objednávky označen jako poškozený.
Při status_changed na Ztraceno → upozorněte provoz a otevřete tiket ve svém podpůrném systému.
Při vypršení rezervace → automaticky nastavte status zpět na Aktivní po uzavření servisního okna.
Při assigned_to_order → zapište webhook do svého skladového systému pro přípravu položky.

Více: Workflows.

Životní cyklus

Vytvoření

Události se vytvářejí automaticky (protokol aktivit) nebo ručně (rezervace, poznámky).

Jak se vytvářejí události objednávky?

Automaticky při přiřazení položky k objednávce zákazníka. Události nastávají v tomto typickém pořadí: assigned_to_order → handed_out → returned. Zrušení zaznamená freed_from_order.

Ruční vytvoření

Rezervace a poznámky se přidávají ručně z karty Události.

Jak vytvořím rezervaci?

Otevřete skladovou položku, přejděte na Události, zvolte Přidat → Rezervace a v panelu Naplánovat rezervaci nastavte data začátku a konce a volitelný název/komentář. Pokud je položka pro požadovaný rozsah plně vytížena, potvrzovací dialog před vytvořením rezervace ukáže, které stávající vazby se uvolní. API: POST /articles/:id/scheduled-events s type: 'reservation'.

Jak vytvořím poznámku?

Stejný postup jako u rezervace, ale zvolte Přidat → Poznámka a vyplňte panel Přidat poznámku. API: POST /articles/:id/scheduled-events s type: 'note'.

Automatizované vytvoření

Lze vytváření událostí automatizovat?

Ano. Použijte přímo API, nebo je spusťte přes workflow na základě událostí zákaznických objednávek, změn atributů nebo externích spouštěčů.

Zobrazení

Události se na kartě Události zobrazují v chronologickém pořadí.

Kde vidím události?

Po jednotlivé položce: Inventář → Skladové položky → [Položka] → Události. Napříč všemi položkami: Inventář → Události.

Jak jsou události řazeny?

Chronologicky, od nejnovější. Rozhraní umožňuje filtrovat podle typu události a rozsahu dat.

Co se zobrazuje u každé události?

U naplánovaných událostí: datum začátku, datum konce, typ, název, komentář, místo. U událostí protokolu aktivit: časové razítko, typ události, hodnoty před/po (attributeChanges) nebo kontext objednávky (eventContext).

Úprava

Naplánované události lze upravovat; položky protokolu aktivit ne.

Mohu upravovat události objednávky?

Ne přímo. Jde o systémový auditní protokol. Upravte podkladovou objednávku. Protokol aktivit zaznamená nové přechody.

Mohu upravit rezervaci?

Ano. PUT /articles/:id/scheduled-events/:eventId s novými poli. Nebo klikněte na rezervaci v časové ose a upravte ji. Dostupnost se přepočítá okamžitě.

Mohu upravit poznámku?

Ano. Stejný endpoint jako u rezervací.

Smazání

Naplánované události lze smazat; protokol aktivit ne.

Jak smažu rezervaci?

Klikněte na rezervaci a zvolte Smazat, nebo použijte DELETE /articles/:id/scheduled-events/:eventId. Blokovaná dostupnost se okamžitě uvolní.

Jak smažu poznámku?

Stejně jako u rezervací.

Mohu smazat události objednávky?

Ne, jde o auditovatelnou historii. Zrušení podkladové objednávky zaznamená freed_from_order (a případně returned, pokud je to relevantní), ale původní událost assigned_to_order zůstává v protokolu.

Hromadné mazání?

POST /articles/:id/scheduled-events/delete-many přijímá buď explicitní ids, nebo sémantiku deleteAllExcept.

Časté dotazy

Proč bych použil rezervaci místo objednávky?

Rezervace slouží pro interní bloky (údržba, vazby, focení) bez zapojení zákazníků, plateb nebo stavu objednávky. Objednávky slouží pro transakce se zákazníky.

Mohu převést rezervaci na objednávku?

Ne. Jde o samostatné entity. Pokud zákazník chce položku, kterou máte rezervovanou, smažte rezervaci a vytvořte skutečnou objednávku.

Zobrazují se poznámky zákazníkům?

Ne. Poznámky jsou pouze interní a zákazníkům se nikdy nezobrazují.

Mohu k událostem přiložit dokumenty?

Ano. Dokumenty na skladové položce jsou vždy přístupné z kteréhokoli pohledu na události. Položky hlavní knihy article mohou odkazovat na konkrétní scheduledEventId, takže finanční přílohy (faktury, účtenky) zůstávají spojené s rezervací, která je vyvolala.

Jak události ovlivňují výpočty dostupnosti?

Rezervace i objednávky blokují dostupnost pro rozsah dat, který pokrývají. Poznámky ne. Události protokolu aktivit dostupnost přímo neřídí. Zaznamenávají, co už se stalo.

Mohu vidět všechny události napříč všemi skladovými položkami?

Ano, Inventář → Události vám dá jednotnou tabulku. Filtrujte podle typu události, vytvářejte vlastní pohledy, seskupujte podle skladové položky a exportujte pro reporting. Pro historii jednotlivé položky použijte kartu Události skladové položky.

Co se stane, když se rezervace překrývá s objednávkou?

Situace	Co se stane
Je dostupný volný slot kapacity	Rezervace jej zabere a objednávka není dotčena
Žádný volný slot neexistuje	TWICE se pokusí nedestruktivně přeřadit stávající vazby do volných slotů
Skutečně žádné místo ani po přeřazení	Systém vás požádá o potvrzení uvolnění minimální sady stávajících vazeb

Dotčené objednávky se neruší: uvolní se pouze jejich vazba na tuto konkrétní skladovou položku. Kompletní algoritmus najdete výše v části Priorita rezervace.

Co jsou konflikty skladových položek na objednávkách?

Když rezervace uvolní vazbu z objednávky, dotčená skladová položka se na dané objednávce zobrazí jako nedostupná. Seznam objednávek zobrazuje varovný banner shrnující počet objednávek s konflikty a karta Skladové položky objednávky zvýrazňuje konflikt červeným počítadlem. Konflikt vyřešíte přiřazením náhradní skladové položky.

Reference pro vývojáře

Naplánované události (rezervace a poznámky) jsou vystaveny jako unavailabilities. Položky protokolu aktivit pocházejí z audit-logs.

API: Unavailability

Otevřete endpoint v API referenci.

Související články

Skladové položky

Kompletní model a životní cyklus skladové položky

Stav skladové položky

Jak události objednávky řídí stav U vás/U zákazníka

Status skladové položky

Proč se změny statusu zaznamenávají jako události

Workflows

Automatizujte chování na základě událostí

Vítejte v dokumentaci TWICE

Orientace v TWICE

Jak systém funguje

Události skladové položky

Definice

Kde to použiji?

Naplánované události

Rezervace

Priorita rezervace

Poznámky

Události objednávky (protokol aktivit)

Srovnání

Kde spravovat události

Zákaznické objednávky

Interní rezervace a poznámky

Interní rezervace vs vazby

Dokumenty přiložené k událostem

Spouštěče workflow z událostí

Životní cyklus

Časté dotazy

Reference pro vývojáře

API: Unavailability

Související články

Skladové položky

Stav skladové položky

Status skladové položky

Workflows

​Definice

​Kde to použiji?

​Naplánované události

​Rezervace

​Priorita rezervace

​Poznámky

​Události objednávky (protokol aktivit)

​Srovnání

​Kde spravovat události

Zákaznické objednávky

Interní rezervace a poznámky

​Interní rezervace vs vazby

​Dokumenty přiložené k událostem

​Spouštěče workflow z událostí

​Životní cyklus

​Časté dotazy

​Reference pro vývojáře

API: Unavailability

​Související články

Skladové položky

Stav skladové položky

Status skladové položky

Workflows

Definice

Kde to použiji?

Naplánované události

Rezervace

Priorita rezervace

Poznámky

Události objednávky (protokol aktivit)

Srovnání

Kde spravovat události

Interní rezervace vs vazby

Dokumenty přiložené k událostem

Spouštěče workflow z událostí

Životní cyklus

Časté dotazy

Reference pro vývojáře

Související články