Skladová položka

Tabulka skladových položek v administraci — Inventář > Skladové položky

Definice

Skladová položka je jednotka inventáře, kterou skutečně vlastníte: digitální dvojče fyzické věci. Skladové položky se ukládají jako záznamy inventáře (v API nazývané article), jeden záznam na položku, nebo jeden záznam pokrývající několik identických položek; jak je sledujete, je vaše volba. Záznam nese kódy, místo, podmínku, atributy, média, dokumenty, úplnou časovou osu událostí a příjmy a výdaje a patří k tenantovi a k místu. Může být také propojen se SKU, od kterého ve výchozím nastavení dědí pole na úrovni produktu.

Analogie: Představte si skladovou položku jako cestovní pas fyzického produktu. Pas sleduje cestu člověka pod jedinečným ID a skladová položka sleduje celý životní cyklus produktu pod svým vlastním kódem položky (kde byla, co se s ní stalo a kde právě je).

Zvláštnost v TWICE: Skladové položky jsou ve výchozím nastavení sériově evidované. Registrace sleduje každou jednotku jednotlivě, pokud nevypnete Sledovat individuálně. Jedna fyzická věc = jedna skladová položka. Právě to umožňuje ziskovost na úrovni jednotlivé položky, sledování podmínky a historii údržby, a je to základ hlavní knihy skladové položky.

Kde to použiji?

Skladové položky jsou základem systému inventáře TWICE. Se skladovými položkami pracujete, když:

Registrujete nový inventář: zaznamenáváte jednotky vstupující do vaší flotily, obchodu nebo skladu
Sledujete životní cyklus položky: používání, pronájmy, prodeje, údržbu, odpisy, likvidaci
Řídíte dostupnost: víte, co je po ruce, co je u zákazníka nebo v opravě
Analyzujete ziskovost: čtete příjmy a náklady jednotlivé položky přes hlavní knihu
Vyřizujete objednávky: přiřazujete konkrétní položky k objednávkám zákazníků, skenujete je při vydání a vrácení

Sériová evidence skladových položek umožňuje přesné sledování pro pronájmové provozy, programy zpětného odkupu, workflow renovací a provozy náročné na údržbu.

Hlavní kniha skladové položky

Každá skladová položka má vlastní hlavní knihu: chronologický zápis finančních položek seskupených jako příjem nebo náklad. Společně tvoří ziskovost položky. V administraci se to zobrazuje jako karta Příjmy a výdaje položky; zdroj v API je articleLedgers.

Pole	Co zachycuje
`itemIncome`	Součet všech položek hlavní knihy se `group: 'income'` (pronájmy, prodeje, poplatky za pozdní vrácení, doplňky)
`itemCosts`	Součet všech položek hlavní knihy se `group: 'cost'` (nákupní cena, opravy, odpisy)
`profitability`	`itemIncome - itemCosts` pro tuto konkrétní skladovou položku
`changeType`	`initial` (vstupní zápis nákupu), `update` (ruční), nebo `depreciation` (systémový)

Položky hlavní knihy mohou být vázané na orderId (automaticky zaznamenané, když položka vydělá z objednávky), na scheduledEventId (např. rezervace údržby, která vyvolala náklad), nebo mohou stát samostatně (ruční úpravy).

Ziskovost na úrovni jednotlivé položky vyžaduje sériovou evidenci. U sdružených skladových položek (jeden záznam pokrývající několik jednotek) platí souhrny hlavní knihy pro celý pool jako celek, nelze je přiřadit ke konkrétní jednotce. Viz Sledování inventáře.

Zpracování množství: sériové vs sdružené

Jak se skladová položka sleduje, se rozhoduje při registraci pomocí zaškrtávacího pole Sledovat individuálně (trackIndividually v žádosti o vytvoření, výchozí true) a pole Množství.

Režim	Vytvořené záznamy	Chování
Sériový	Jeden na fyzickou jednotku	Úplná historie životního cyklu a samostatná hlavní kniha na jednotku
Sdružený	Jeden pro celý pool	N identických jednotek sledovaných jako jeden záznam, agregovaná historie a hlavní kniha

Se zapnutým Sledovat individuálně vytvoří registrace množství N jeden záznam inventáře na skladovou položku. S vypnutým vytvoříte jeden záznam pokrývající všech N. trackIndividually je vstup jen při vytvoření. Neukládá se na zdroji Article. V odpovědích objekt quantity vykazuje celkový počet jednotek záznamu (total) a jeho rozpad byLocation. Kdy zvolit který režim:

Sériový: kola, lyže, fotoaparáty, vleky, kajaky, e-koloběžky, jakékoli pronajímatelné nebo vysoce hodnotné aktivum.
Sdružený: helmy, zámky, poutka, permanentky na vlek (pokud ne RFID), drobné spotřební zboží, které nepotřebujete sledovat jednotlivě.

Režim se nastavuje při vytvoření. Pro pozdější změnu vytvoříte nový záznam a migrujete historii; úprava na místě není podporována. Více: Sledování inventáře.

Klíčové vlastnosti

Skladová položka je reprezentována typem Article. Nejdůležitější pole:

Vlastnost	Typ	Popis
`id`	UUID	Jedinečný identifikátor skladové položky.
`codes`	string[]	Jeden nebo více kódů položky. Každý kód je jedinečný v rámci tenanta. Viz Skladové kódy.
`name`	string	Zobrazovaný název v administraci.
`status`	`active` / `inactive` / `draft`	Provozní životní cyklus. V UI se zobrazuje jako Aktivní, Neaktivní a Koncept. Viz Status skladové položky.
`skuId`	UUID, nullable	Volitelné propojení s nadřazeným SKU. Pokud je nastaveno, položka zdědí pole na úrovni SKU.
`sku`	object	Vnořený souhrn SKU (`id`, `name`, `code`), pokud je propojeno.
`fulfillmentFields`	array	Hodnoty polí vyřízení nesené položkou, odděleně od `attributes`. Vrací je jen administrátorské koncové body.
`taxonomyCategoryId`	string, nullable	Kategorie taxonomie, do které položka patří.
`purchasePrice`	number, nullable	Nákupní cena (v nejmenších jednotkách). Vstupuje do hlavní knihy jako počáteční (`initial`) nákladová položka.
`purchasePriceOrigin`	`article` / `sku`	Zdroj hodnoty nákupní ceny.
`description`	rich text JSON, nullable	Dlouhý popis.
`descriptionOrigin`	`article` / `sku`	Zdroj popisu.
`condition`	string, nullable	Volný text s podmínkou položky (např. `Nová`, `Dobrá`, `Uspokojivá`).
`attributes`	array	Atributy zdroje přiřazené k této položce (zděděné ze SKU, přepisovatelné na položce).
`tags`	array	Odkazy na štítky.
`media`	array	Uspořádaný seznam obrázků/videí.
`documents`	array	Uspořádaný seznam souborů s volitelným komentářem na soubor.
`itemIncome`	number	Vypočítaný součet příjmových položek hlavní knihy.
`itemCosts`	number	Vypočítaný součet nákladových položek hlavní knihy.
`profitability`	number	`itemIncome - itemCosts`.
`parentId` / `path`	string	Volitelná podpora hierarchie pro seskupené artikly.
`createdAt`	ISO datetime	Časové razítko vytvoření.

Stav jednotlivé položky se počítá v čase dotazu a je vystaven v odpovědi article-with-availability:

Pole	Popis
`unavailability`	Pole rozsahů nedostupnosti (objednávky, naplánované události). Určuje fyzický stav U zákazníka a výpočty dostupnosti k prodeji.
`scheduledEvents`	Rezervace a poznámky přiřazené k této položce. Viz Události skladové položky.
`articleLocations`	Časově vymezená přiřazení místa. Aktuální přiřazení určuje současné místo položky.
`quantity` / `availability`	Objekty s celkovým počtem (`total`) a rozpadem `byLocation`: celkový počet jednotek na záznamu a jednotek aktuálně dostupných.
`temporalStock`	Časově rozdělené `stockBalance`, `stockAvailableToSell`, `stockCommitted`, `stockUtilisation`.
`conflicts`	Výhled konfliktů vyřízení, pokud snížíte množství nebo změníte místo.

Dědičnost vlastností ze SKU. purchasePrice, description, atributy a kategorii lze definovat na SKU. Skladová položka čte ze SKU, pokud nemá vlastní hodnotu. Pole *Origin v API říkají, který zdroj dodal danou hodnotu (article nebo sku). Nastavení hodnoty na položce přepíše výchozí hodnotu ze SKU; vymazání hodnoty umožní opětovné zdědění.Hodnoty polí vyřízení dědí stejným způsobem a jsou oddělené od attributes: vyhrává hodnota zadaná na objednávce, poté položky, poté jejího SKU. Viz Pole vyřízení.

Status

Status popisuje, kde se položka nachází ve svém provozním životním cyklu. Existují tři hodnoty:

Aktivní: provozní, dostupná k přiřazení k objednávkám. (status: 'active' v API.)
Neaktivní: vyloučena z provozu (např. v opravě, vyřazená, ztracená nebo prodaná). Zachována v systému. (status: 'inactive'.)
Koncept: registrace probíhá. Ještě není provozní. (status: 'draft'.)

Do dostupnosti k prodeji se počítají a k novým objednávkám lze přiřadit jen položky Aktivní. Neaktivní položky si zachovávají celou historii (hlavní knihu, události, přílohy). Více: Status skladové položky.

Stav (U vás / U zákazníka)

Stav popisuje fyzické umístění položky vzhledem k vašemu provozu. Je automatický. Nelze jej nastavit ručně.

U vás: po ruce ve vašem inventáři. Může být i tak vázán na nadcházející objednávku.
U zákazníka: momentálně u zákazníka (pronájem v průběhu) nebo jinak mimo dosah.

Přechody stavu nastávají při událostech vyřízení:

Vyzvednutí/předání → U zákazníka
Vrácení → U vás

Více: Stav skladové položky.

Sledování místa

Skladová položka je vždy vázána na místo. Pole articleLocations ukládá přiřazení jako časové rozsahy:

{
  "id": "loc_abc123",
  "articleId": "art_xyz789",
  "serviceLocationId": "loc_helsinki",
  "slotId": "slot_42",
  "range": { "start": "2025-01-01T00:00:00Z", "end": null }
}

Aktuální místo je přiřazení, jehož rozsah zahrnuje now.
Budoucí přesuny lze naplánovat přidáním nového rozsahu s budoucím začátkem.
Všechny změny místa se zaznamenávají do protokolu aktivit jako události location_changed.

Když změníte místo přes API (PUT /articles/:id s novým serviceLocationId), TWICE zkontroluje konflikty: objednávky nebo naplánované události, které by přesun ponechal bez řešení. Pole conflicts v odpovědi artiklu je proaktivně zobrazí.

Média a dokumenty

Dvě uspořádané sady souborů na položku:

Média (media): obrázky a videa zobrazená v detailu položky. První médium se v seznamech používá jako náhled. Lze měnit pořadí.
Dokumenty (documents): libovolné soubory (PDF, tabulky, fotografie). Každý dokument nese orderIndex a volitelný comment.

Dokumenty lze také přiložit ke konkrétním naplánovaným událostem (např. poznámky z kontroly u rezervace údržby). Viz Události skladové položky.

Protokol aktivit a události

Každá skladová položka má dva proudy historie:

Protokol aktivit: systémem zaznamenané změny na samotné položce. Příklady zaznamenaných typů událostí:
- assigned_to_order / freed_from_order
- handed_out / returned
- status_changed
- allocation_changed
- sku_changed
- location_changed
- identifiers_changed
- specifications_changed
Naplánované události: uživatelem vytvořené rezervace a poznámky, které mohou blokovat dostupnost a mohou mít přiložené dokumenty. Typy: reservation, note.

Obě jsou viditelné na kartě Časová osa / Události v detailu položky. Více: Události skladové položky.

Vztahy

Patří ke SKU (volitelné)

Skladové položky se mohou propojit se SKU přes skuId. SKU slouží jako šablona na úrovni produktu: purchasePrice, description, atributy a kategorie se přenášejí dolů, pokud nejsou přepsané. Skladová položka bez SKU je zcela samostatná.

Má hlavní knihu

Má mnoho položek, které se slučují do itemIncome, itemCosts a profitability.

Má události

Má mnoho a . Viz Události.

Odkazuje na objednávky a zákazníky

Propojena s objednávkami, které položku rezervují. Stav a nedostupnost jsou řízeny objednávkami, které položku zahrnují. Události životního cyklu jako handed_out a returned pocházejí z vyřízení objednávky.

Existuje na místě

Patří k místu. Místo je časově vymezené (articleLocations), takže přesuny a budoucí posuny jsou plnohodnotnou funkcí.

Životní cyklus

Vytvoření

Skladové položky vstupují do vašeho systému při registraci nového inventáře.

Jak vytvořím skladovou položku?

V Inventář → Skladové položky klikněte na Registrovat položky a zvolte Ruční zadání. V dialogu Registrovat novou skladovou položku zadejte název, zvolte, zda Sledovat individuálně, nastavte množství, vyberte místo vstupu a volitelně propojte se SKU.

Jaké informace jsou vyžadovány?

Minimum: name a serviceLocationId. Doporučeno: skuId (pro dědičnost), taxonomyCategoryId, purchasePrice a jeden nebo více codes (automaticky vygenerováno, pokud vynecháno).

Počáteční stav a hromadné vytváření

Nová položka je aktivní od okamžiku registrace.

Jaký je počáteční stav?

Nové položky mají ve výchozím nastavení status: 'active' (Aktivní) a stav U vás. Okamžitě se objeví ve výpočtech dostupnosti. Pokud položky potřebují kontrolu před uvedením do provozu, nastavte při vytvoření status na inactive (Neaktivní).

Mohu vytvořit více najednou?

Ano. Použijte hromadnou registraci v administraci (automaticky vygeneruje kódy pro N položek), import z CSV, nebo POST /articles/create-many pro import přes API. Viz Hromadné vytváření, který požadavek zvolit a kolik záznamů vytvořit.

Používání

Aktivní skladové položky se účastní objednávek, inzerátů a reportů.

Kde skladové položky uvidím?

Tabulka Inventář → Skladové položky, stránka detailu položky (karty Všeobecné / Atributy / Příjmy a výdaje / Vyřízení / Dokumenty / Události / Protokol aktivit), obrazovky vyřízení, kalendáře dostupnosti a stránky detailu SKU.

Jaké akce mohu provést?

Upravit jakékoli pole, přesunout místo, změnit status, přidat média nebo dokumenty, přidat naplánované události (rezervace/poznámky), zaznamenat položky příjmů a výdajů, přidat štítky a propojit/odpojit SKU.

Jak to ovlivňuje inzeráty?

Do dostupnosti k prodeji inzerátu přispívají jen položky se status: active a stavem U vás (a nevázané na překrývající se rezervaci). Viz Stav skladové položky.

Úprava

Aktualizujte pole po celý životní cyklus.

Jak upravím skladovou položku?

Otevřete detail položky a upravte inline, nebo vyberte více řádků v tabulce a použijte hromadnou úpravu. Koncový bod API je PUT /articles/:id.

Co lze změnit?

Téměř vše: název, propojení se SKU, kódy, status, místo, atributy, podmínku, nákupní cenu, popis, média, dokumenty, štítky. Samotné id je neměnné. Kódy lze přidávat nebo odebírat, ale musí zůstat jedinečné v rámci tenanta.

Co s množstvím?

U sdružených položek použijte POST /articles/:id/increase-quantity nebo POST /articles/:id/decrease-quantity. Před snížením zavolejte GET /articles/:id/plan-quantity-change, abyste viděli, co by to ovlivnilo (blockingUnavailabilities, moves, removedSlotIds).

Vyřazení nebo smazání

Před smazáním raději měňte status, aby se zachovala historie.

Jak položku vyřadím?

Nastavte status na Neaktivní. Veškerá historie (hlavní kniha, události, přílohy) se zachová a položka okamžitě vypadne z dostupnosti. POST /articles/:id/inactivate se také pokusí přeřadit nadcházející rezervace na jinou dostupnou skladovou položku.

Jak položku odstraním úplně?

Archivujte ji, což zachová záznam čitelný. Viz Archivace skladových položek.

Kdy lze položku smazat úplně?

Jen když nikdy nebyla na objednávce. DELETE /articles/:id odmítne se zprávou Stock items with order history cannot be deleted — archive them instead u položky, která je na objednávce nebo má rezervaci vázanou na objednávku. Status objednávky se nebere v úvahu, takže uzavření objednávky odmítnutí nezruší.

Co se stane s historií při smazání?

Nic. Smazatelná položka nemá žádnou historii objednávek, kterou by mohla ztratit.

Časté dotazy

Kdy mám použít záznam s množstvím > 1?

Použijte sdružený sklad pro identické, nízkohodnotné, zaměnitelné položky, u kterých individuální sledování nepřináší žádnou hodnotu (helmy, zámky, poutka). Použijte sériovou evidenci (množství = 1, Sledovat individuálně) pro vše, co chcete sledovat po jednotkách: vysoce hodnotné vybavení, cokoli, co se odepisuje jinak, cokoli pronajímané.

Mohu změnit propojení se SKU u skladové položky?

Ano. Nastavte skuId na novou hodnotu (nebo null pro odpojení). Změna se zaznamená jako událost sku_changed. Existující hlavní kniha a historie událostí zůstávají u položky.

Jaký je rozdíl mezi kódem položky a kódem SKU?

codes patří ke skladové položce. Identifikuje fyzickou věc. code na SKU identifikuje typ produktu. Jedno SKU může mít mnoho skladových položek, každou s vlastními kódy položky.

Které vlastnosti se dědí ze SKU?

purchasePrice, description, atributy a taxonomyCategoryId. API vrací pole *Origin, která říkají, zda hodnota pochází z artiklu, nebo ze SKU. Nastavení hodnoty na artiklu přepíše; vymazání umožní opětovné zdědění.

Jak se stav liší od statusu?

Status je vaše rozhodnutí (Aktivní / Neaktivní / Koncept). Stav nastavuje vyřízení (U vás / U zákazníka). Jsou nezávislé. Položka Aktivní / U zákazníka je zdravý inventář, který je momentálně u zákazníka.

Co když se položka ztratí nebo je rozprodána?

Nastavte její status na Neaktivní. Neexistuje samostatný status Ztraceno nebo Prodáno. Změna retroaktivně neupravuje objednávky, které položku zahrnují; ty vyřešte ručně (refundace, přeřazení). Důvod zaznamenejte jako poznámku nebo položku hlavní knihy.

Reference pro vývojáře

Skladové položky jsou v API vystaveny jako articles.

API: Articles

Otevřít koncový bod v referenci API.

Související články

SKU

Šablona na úrovni produktu pro skladové položky

Status skladové položky

Aktivní / Neaktivní / Koncept

Stav skladové položky

U vás / U zákazníka, fyzické umístění vs váš provoz

Skladové kódy

Identifikátory, čárové kódy, workflow skenování

Sledování inventáře

Sériové vs sdružené

Události skladové položky

Rezervace, poznámky, protokol aktivit

Vítejte v dokumentaci TWICE

Orientace v TWICE

Jak systém funguje

Definice

Kde to použiji?

Hlavní kniha skladové položky

Zpracování množství: sériové vs sdružené

Klíčové vlastnosti

Status

Stav (U vás / U zákazníka)

Sledování místa

Média a dokumenty

Protokol aktivit a události

Vztahy

Životní cyklus

Časté dotazy

Reference pro vývojáře

API: Articles

Související články

SKU

Status skladové položky

Stav skladové položky

Skladové kódy

Sledování inventáře

Události skladové položky

​Definice

​Kde to použiji?

​Hlavní kniha skladové položky

​Zpracování množství: sériové vs sdružené

​Klíčové vlastnosti

​Status

​Stav (U vás / U zákazníka)

​Sledování místa

​Média a dokumenty

​Protokol aktivit a události

​Vztahy

​Životní cyklus

​Časté dotazy

​Reference pro vývojáře

API: Articles

​Související články

SKU

Status skladové položky

Stav skladové položky

Skladové kódy

Sledování inventáře

Události skladové položky

Definice

Kde to použiji?

Hlavní kniha skladové položky

Zpracování množství: sériové vs sdružené

Klíčové vlastnosti

Status

Stav (U vás / U zákazníka)

Sledování místa

Média a dokumenty

Protokol aktivit a události

Vztahy

Životní cyklus

Časté dotazy

Reference pro vývojáře

Související články