> ## 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. # Stav skladové položky > Pochopte, jak stav skladové položky (U vás/U zákazníka) automaticky sleduje, zda je položka po ruce, nebo u zákazníka. ![Stav skladové položky na kartě Všeobecné](https://mintcdn.com/twicecommerce/lZhc_tO8u1u_bL0Q/images/stock-item-general-tab.webp?fit=max\&auto=format\&n=lZhc_tO8u1u_bL0Q\&q=85\&s=e0a29bba3d2126e9149d978d008e2a62) Inventář > Skladové položky > \[Položka] > Všeobecné ## Definice Stav skladové položky (Stav skladové položky sleduje, zda je položka právě U vás (fyzicky ve vašem skladu) nebo U zákazníka (v držení zákazníka). Mění se automaticky podle vyřízení a vrácení na objednávkách.) sleduje, kde se položka fyzicky nachází: po ruce ve vašem inventáři, nebo u zákazníka. Stav je **automatický**: TWICE jej aktualizuje na základě událostí vyřízení na objednávkách, kterých se položka účastní. **Dvě hodnoty stavu:** * **U vás**: položka je po ruce ve vašem inventáři. Může být stále vázána na nadcházející objednávku, ale fyzicky je u vás. * **U zákazníka**: položka je u zákazníka (pronajatá nebo prodaná) nebo jinak mimo dosah. Stav se zobrazuje jako štítek na skladové položce a je vystaven přes rozsahy nedostupnosti v API article. ## Stav vs status Jde o dvě nezávislé dimenze. Obě uvidíte na stejné položce. | Dimenze | Co sleduje | Hodnoty | Nastavuje | | - | - | - | - | | **Stav** | Kde se položka fyzicky nachází | U vás / U zákazníka | Systém vyřízení (automaticky) | | **Status** | Fáze životního cyklu položky | Aktivní / Neaktivní / Koncept | Operátor (ručně) | Naprosto zdravé kolo, které je právě půjčené, zobrazuje **Aktivní / U zákazníka**. Stejné kolo v opravě po vrácení z půjčení zobrazuje **Neaktivní / U vás**. Více: [Status skladové položky](https://www.twicecommerce.com/docs/cs/concepts/inventory/stock-item-status.md). ## Kde to použiji? Stav vidíte u každé skladové položky v **Inventář → Skladové položky** a na kartě **Všeobecné** položky. Stav je také filtrovacím sloupcem v tabulce skladových položek. Stav ovlivňuje: * **Available To Sell (ATS)**: do dostupnosti se počítají pouze položky ve stavu **U vás**, které nejsou vázané na překrývající se rezervace. * **Proces vrácení**: u položek ve stavu **U zákazníka** se očekává vrácení; to řídí připomínky vrácení a reporting o zpožděných vrácení. * **Kalendářové pohledy**: vidíte, kdy se očekává, že se položky vrátí do stavu **U vás**. * **Detekce konfliktů**: přesun položky ve stavu **U zákazníka** je označen jako problém, protože ji stále má zákazník. Více: [Skladová položka: karta Všeobecné](https://www.twicecommerce.com/docs/cs/inventory/stock-items/general.md). ## Klíčové vlastnosti | Vlastnost | U vás | U zákazníka | | - | - | - | | Fyzické umístění | Po ruce ve vašem inventáři | U zákazníka | | Lze vyzvednout pro novou objednávku | Ano | Ne, dokud není vráceno | | Počítá se do ATS *právě teď* | Ano | Ne | | Lze nastavit ručně | Ne (automatické) | Ne (automatické) | | V kalendáři zobrazeno jako obsazené | Pouze pokud vázáno | Vždy až do vrácení | ## Jak se stav mění Přechody stavu řídí **události vyřízení** na objednávkách, které skladovou položku obsahují. Příslušné události se zaznamenávají do protokolu aktivit položky. ### U vás → U zákazníka Spouští se, když je položka na objednávce **předána**. Zaznamenané události: * `handed_out`: vyzvednutí / výdej při pronájmu nebo prodeji. * `assigned_to_order` následované předáním: položka byla rezervována a poté fyzicky vydána. Jakmile je položka předána, účastní se rozsahu `unavailability` řízeného objednávkou. ATS pro jakýkoli rozsah překrývající se s touto nedostupností klesne o jednu. ### U zákazníka → U vás Spouští se, když: * `returned`: položka je vrácena na objednávce pronájmu. * Objednávka je zrušena, nebo je řádková položka odebrána před vyzvednutím (položka fakticky nikdy neopustila sklad). * Vyřízení je vráceno zpět (operátor v administraci zruší předání). Když dojde k vrácení, rozsah nedostupnosti se uzavře v okamžiku vrácení a ATS se obnoví. ```mermaid theme={null} stateDiagram-v2 state "U vás" as In state "U zákazníka" as Out [*] --> In In --> Out: předání / odeslání Out --> In: vráceno Out --> In: objednávka zrušena Out --> In: předání vráceno zpět ``` > [!TIP] > > Skladová položka může být **U vás** a přitom stále **vázaná** na nadcházející objednávku. Stav popisuje pouze fyzické umístění, ne to, zda je položka rezervovaná. Výpočty dostupnosti berou v úvahu obojí. ## Jak vyřízení řídí stav Skladovou položku posouvá **skupina vyřízení** stavu položky, ve kterém se nachází její řádek objednávky, nikdy název stavu. Položka ve stavu Připravuje se nebo Předáno zabírá jednotku; stav Vráceno nebo Odstraněno ji uvolňuje. Níže uvedené fáze proto platí bez ohledu na to, jaké konkrétní stavy si váš účet definuje pod [Stavy vyřízení položek](https://www.twicecommerce.com/docs/cs/settings/orders/item-fulfillment-states.md). Řádkové položky objednávky procházejí fázemi vyzvednutí a vrácení: 1. **Rezervace**: objednávka je vytvořena; položka je **U vás**, ale nyní vázaná na rezervující objednávku. ATS pro rezervovaný rozsah klesá. 2. **Předání**: operátor označí řádek jako vyzvednutý. Protokol aktivit zaznamená `handed_out`. Stav se změní na **U zákazníka**. 3. **Zákazník má položku**: stav zůstává **U zákazníka**. Reporty o pozdním vrácení zobrazují položky po termínu. 4. **Vrácení**: operátor označí řádek jako vrácený. Protokol aktivit zaznamená `returned`. Stav se změní na **U vás**. Položka je uvolněna pro další pronájem. 5. **Dokončení / zrušení objednávky**: uzavírá stranu objednávky. Pokud je řádek odebrán před předáním, zaznamená se `freed_from_order`. Pro **prodejní objednávky** je obdobným procesem vyřízení / odeslání; po odeslání je položka **U zákazníka** natrvalo a obvykle se jí také ručně nastaví status **Neaktivní**, jakmile ji přestanete provozně sledovat. Pro **sdružený inventář** (jeden záznam pokrývající více jednotek) pracují stav a nedostupnost s **počty**, ne s jednotlivými identitami. Počet jednotek **U zákazníka** je součet aktivních vyřízených řádků, které čerpají z tohoto poolu. ## Výpočet ATS Available To Sell odpovídá na otázku: *pro požadovaný rozsah dat, kolik jednotek tohoto SKU mohu vázat na novou rezervaci?* Pro ATS SKU v rozsahu `[start, end]`: 1. Začněte celkovým počtem propojených skladových položek se `status = active`, jejichž servisní místo odpovídá požadovanému. 2. Odečtěte jednotky, které jsou **U zákazníka** s datem vrácení pozdějším než `start`. 3. Odečtěte jednotky, které jsou **U vás**, ale vázané na překrývající se rezervace (`scheduledEvents.type = reservation` a rozsahy nedostupnosti z jiných objednávek). 4. Zbytek je ATS pro daný rozsah. Engine vystavuje výsledek jako `temporalStock` v odpovědi article-availability, čtyři řady dvojic `{ range, value }`: | Pole | Význam | | - | - | | `stockBalance` | Jednotky v evidenci pro daný rozsah (celkem, minus jednotky odebrané dokončenými prodeji). | | `stockCommitted` | Jednotky vázané na objednávky a rezervace překrývající se s rozsahem. | | `stockAvailableToSell` | `stockBalance − stockCommitted`, ohraničeno zdola nulou. Toto je ATS. | | `stockUtilisation` | `stockCommitted / stockBalance`, v procentech. | **Vypočtený příklad.** SKU má na jednom místě 10 aktivních skladových položek: * 3 jsou **U zákazníka** na pronájmech běžících do **15. ledna**. * 5 je **U vás**, ale vázáno na objednávku pokrývající **10.–13. ledna**. * Zbylé 2 jsou **U vás** a nevázané. | Rozsah | `stockBalance` | `stockCommitted` | `stockAvailableToSell` | | - | - | - | - | | **1.–9. ledna** | 10 | 3 (pronájmy) | 7 | | **10.–13. ledna** | 10 | 8 (3 pronájmy + 5 vázaných) | 2 | | **14.–15. ledna** | 10 | 3 (pronájmy) | 7 | | **od 16. ledna** | 10 | 0 | 10 | `stockBalance` zůstává po celou dobu 10. Pronájmy jednotky vážou, ale neodebírají je z evidence. Pouze prodeje snižují zůstatek. `stockUtilisation` pro 10.–13. ledna je 80 %. ## Hraniční případy > **Položka se ztratí, zatímco je U zákazníka** > > Změňte **status** položky na **Neaktivní** na kartě Všeobecné a zaznamenejte důvod jako poznámku. Stav zůstává **U zákazníka**, dokud se související objednávka neuzavře nebo nezruší. Položka je stále vedena jako v držení zákazníka, dokud tento cyklus neuzavřete. Hlavní kniha a historie událostí zůstávají zachovány. > **Vícedenní pronájem přesahující hranici kalendáře** > > Stav se nastavuje při fyzickém předání, ne při datu začátku rezervace. Položka rezervovaná na 5.–12. ledna, ale ještě nevyzvednutá, je 5. ledna **U vás**. Jakmile je předána, zůstává **U zákazníka** po celou dobu pronájmu (napříč dny, týdny nebo měsíci), dokud není vrácena. > **Zákazník vrátí jednu ze dvou položek na víceřádkové položce** > > Částečná vrácení se u sdružených řádků řeší po jednotkách, u sériových řádků po položkách. Vrácené jednotky se přepnou zpět na **U vás**; zbytek zůstává **U zákazníka** až do vlastního vrácení. > **Položka vrácena na jiné místo, než ze kterého odešla** > > Vrácení aktualizuje stav na **U vás** a zaznamená se událost `location_changed`. `articleLocations` article dostane nový rozsah začínající v okamžiku vrácení na novém servisním místě. > **Vyřízení bylo omylem vráceno zpět** > > Znovu vyřiďte řádek. Položka se přepne zpět na **U zákazníka** a protokol aktivit zaznamená novou událost `handed_out`. Dřívější vrácení zůstává v protokolu pro účely auditu. > **Položka rezervována, ale nikdy nevyzvednuta** > > Dokud se objednávka nezruší, položka zůstává **U vás**, ale rezervace se stále počítá do ATS pro rezervovaný rozsah. Zrušte objednávku, abyste uvolnili ATS. ## Vyhledávání položek podle stavu Stav je nepřímo vystaven přes rozsahy `unavailability` a pole `articleLocations`. Pro nalezení položek, které jsou právě **U zákazníka**, vypište article s rozsahem dat pokrývajícím „teď" a filtrujte na ty, které mají aktivní nedostupnost typu `order`, u níž již proběhlo předání a ještě neproběhlo vrácení. V administraci: otevřete **Inventář → Skladové položky** a filtrujte sloupec **Stav** na **U zákazníka**. V API: předejte `dateRange` pokrývající sledovaný okamžik. Skladové položky, které jsou aktuálně u zákazníka, mají rozsah nedostupnosti překrývající se s tímto bodem, pocházející z řádku objednávky ve fázi předáno. ## Časté dotazy > **Mohu stav změnit ručně?** > > Ne. Stav se nastavuje automaticky vyřízením a vrácením na objednávkách. Pro jeho změnu vyřiďte nebo vraťte řádek objednávky pro danou položku. > **Co když se položka ztratí, zatímco je U zákazníka?** > > Aktualizujte **status** položky na **Neaktivní** na kartě Všeobecné a zaznamenejte důvod jako poznámku. Stav zůstává **U zákazníka**, dokud se související objednávka neuzavře nebo nezruší. > **Jak najdu všechny položky, které jsou aktuálně U zákazníka?** > > Otevřete **Inventář → Skladové položky** a filtrujte sloupec Stav na **U zákazníka**. Uvidíte všechny položky v držení zákazníků spolu s jejich souvisejícími objednávkami. > **Ovlivňuje stav dostupnost v mém online obchodě?** > > Ano. Výpočty ATS počítají pouze položky ve stavu **U vás**, které nejsou vázané na překrývající se rezervace pro požadované období. Položky **U zákazníka** s vrácením po požadovaném datu začátku se od ATS odečítají. > **Položka ukazuje U vás, ale zákazník ji stále má. Co se stalo?** > > Nejpravděpodobněji byl řádek objednávky v administraci označen jako vrácený bez fyzického vrácení. Znovu otevřete řádek objednávky nebo použijte protokol aktivit k prošetření; v případě potřeby lze řádek znovu vyřídit. ## Reference pro vývojáře Stav skladové položky se čte z endpointů `articles`. Filtrujte podle `dateRange`, abyste viděli položky, které jsou aktuálně U zákazníka. > **[API: Articles](https://www.twicecommerce.com/docs/api-reference/articles)** > > 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 > **[Status skladové položky](https://www.twicecommerce.com/docs/cs/concepts/inventory/stock-item-status.md)** > > Provozní životní cyklus (Aktivní / Neaktivní / Koncept) > **[Události skladové položky](https://www.twicecommerce.com/docs/cs/concepts/inventory/events.md)** > > Jak objednávky a rezervace zaznamenávají události > **[Životní cyklus objednávky](https://www.twicecommerce.com/docs/cs/concepts/orders/order-lifecycle.md)** > > Jak vyřízení a vrácení řídí změny stavu > **[Stavy vyřízení položek](https://www.twicecommerce.com/docs/cs/settings/orders/item-fulfillment-states.md)** > > Pojmenujte stavy, kterými personál posouvá položky objednávky > **[Nastavení životního cyklu objednávky](https://www.twicecommerce.com/docs/cs/settings/orders/order-lifecycle.md)** > > Co udělá přesun objednávky s jejími položkami This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.