> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Události skladové položky

> Aktivity zaznamenané v časové ose skladové položky, které sledují její životní cyklus prostřednictvím objednávek, rezervací a poznámek.

![Časová osa událostí skladové položky](https://mintcdn.com/twicecommerce/lZhc_tO8u1u_bL0Q/images/stock-item-events-tab.webp?fit=max\&auto=format\&n=lZhc_tO8u1u_bL0Q\&q=85\&s=1ae48153d760c337f141a2214978a78d)

Inventář > Skladové položky > \[Položka] > Události

## Definice

<Snippet file="definitions/cs/event-definition.mdx" />

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

1. **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.
2. **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?*

> [!NOTE]
>
> **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**](https://www.twicecommerce.com/docs/cs/inventory/stock-items/events.md) 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:

```json theme={null}
{
  "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.

> [!TIP]
>
> 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](https://www.twicecommerce.com/docs/cs/concepts/inventory/stock-item-status.md).

### 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í:

1. Použije jakoukoli volnou kapacitu.
2. Přesune stávající vazby do jiných volných slotů, pokud je to možné.
3. 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.

> [!WARNING]
>
> 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](https://mintcdn.com/twicecommerce/5ARkyCTk5wMAizBn/images/stock-item-reservation-conflict-dialog.webp?fit=max\&auto=format\&n=5ARkyCTk5wMAizBn\&q=85\&s=7a70b75becf71d40b2c11961ab7c3d45)

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í.

> [!NOTE]
>
> 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](https://www.twicecommerce.com/docs/cs/orders/overview.md)**
>
> 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](https://www.twicecommerce.com/docs/cs/inventory/stock-items/events.md)**
>
> Přidávejte a spravujte rezervace a poznámky z karty Události skladové položky.

> [!NOTE]
>
> Karta [Události](https://www.twicecommerce.com/docs/cs/inventory/stock-items/events.md) 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:

1. **Dokumenty skladové položky** (`documents` na article): globální pro celou položku.
2. **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](https://www.twicecommerce.com/docs/cs/workflows.md).

## Životní cyklus

**1. 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`.

**2. 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'`.

**3. 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ěčů.

**4. 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`).

**5. Ú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í.

**6. 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](https://www.twicecommerce.com/docs/api-reference/unavailability)**
>
> Otevřete endpoint v API referenci.

## Související články

> **[Skladové položky](https://www.twicecommerce.com/docs/cs/concepts/inventory/stock-items.md)**
>
> Kompletní model a životní cyklus skladové položky

> **[Stav skladové položky](https://www.twicecommerce.com/docs/cs/concepts/inventory/stock-item-state.md)**
>
> Jak události objednávky řídí stav U vás/U zákazníka

> **[Status skladové položky](https://www.twicecommerce.com/docs/cs/concepts/inventory/stock-item-status.md)**
>
> Proč se změny statusu zaznamenávají jako události

> **[Workflows](https://www.twicecommerce.com/docs/cs/workflows.md)**
>
> Automatizujte chování na základě událostí


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.