Průvodce nastavením lokací Stokkap

Understanding the two-tier system

Location Types are categories that describe the kind of place stock is stored. Think of them as labels: Shop, Warehouse, Supplier.

Locations are the specific named places within those categories. "Main Shop", "London Warehouse", "Acme Supplies Ltd" are all locations.

Produkt lze přiřadit k více lokacím stejného typu, například ke dvěma prodejnám nebo několika skladovým regálům. Typy seskupují podobné lokace; pro každé místo nepotřebujete samostatný typ.

Step 1 - Create location types

Navigate to your WordPress admin:

Stokkap → Location Types

Adding a type

1. Enter a Label - the display name shown throughout the admin (e.g., "Shop")
2. Optionally set a Slug - an internal identifier auto-generated from the label if left blank. Uses only lowercase letters, numbers, and underscores. The slug cannot be changed after creation, so choose carefully or leave blank to auto-generate.
3. Set the Priority - this controls stock depletion order (explained in detail below). Lower numbers mean higher priority. The default auto-increments in steps of 10 (10, 20, 30...) to leave room for re-ordering later.

Click Add Location Type to save.

Real-world type examples

Here are setups for different kinds of stores:

Small independent shop:

Typ	Priorita
Shop	10
Supplier	20

Simple - sell from the shop first, fall back to supplier stock.

Multi-location retailer:

Typ	Priorita
Shop	10
Warehouse	20
Supplier	30

Shop floor stock sells first. When the shop is empty, warehouse stock is used. Supplier stock is the last resort.

Online-only business with multiple warehouses:

Typ	Priorita
Hlavní sklad	10
Záložní sklad	20
Dropshippingový dodavatel	30

Prioritise your main warehouse, overflow handles excess, suppliers fulfil the rest.

Retailer with shelved and displayed stock:

Typ	Priorita
Výstavní plocha	10
Police	20
Zadní sklad	30
Supplier	40

Sell displayed items first, restock from shelves, then back room, then fall back to supplier.

Container storage business (real customer example):

Typ	Priorita
Prodejní plocha	10
Malý kontejner	20
Velký kontejner	30
Zázemí	40
Supplier	50

This customer uses container types to separate different physical storage areas. Stock is taken from the shop floor first, then small containers, then large containers, then back office reserves, and finally the supplier. Each container type can hold many location names describing exact positions.

Editing and deleting types

• Click Edit next to any type to change its label or priority. The slug remains fixed.
• Click Delete to remove a type. You can only delete a type that has no locations assigned to it. Reassign or delete its locations first.

Step 2 - Create locations

Navigate to your WordPress admin:

Stokkap → Locations

This page will not be available until you have created at least one location type.

Adding a location

1. Enter a Name - the specific place (e.g., "Main Shop", "Birmingham Warehouse", "Acme Supplies Ltd")
2. Select the Type from the dropdown
3. Set the Priority - defaults to the type's priority, but can be overridden per location. This controls the order within the same type and across types.

Click Add Location to save.

Real-world location examples

Small independent shop with one supplier:

Název umístění	Typ	Priorita
My Shop	Shop	10
Main Supplier	Supplier	20

Multi-location retailer:

Název umístění	Typ	Priorita
Manchester Store	Shop	10
Leeds Store	Shop	10
Central Warehouse	Warehouse	20
Acme Wholesale	Supplier	30
Budget Parts Ltd	Supplier	30

Warehouse with zone-based shelving:

Název umístění	Typ	Priorita
Zone A - Electronics	Shelf	10
Zone B - Clothing	Shelf	10
Zone C - Homeware	Shelf	10
Returns Area	Shelf	15
Main Supplier	Supplier	20

Produkt může mít zásoby na několika policích. Lokace nazvaná Returns Area zůstává prodejní, pokud nebyla výslovně vytvořena jako neprodejní. Nižší priorita odepisování pouze odkládá její využití; prodeji z této lokace nezabrání.

Container storage with position codes (real customer example):

Název umístění	Typ	Priorita
Shop Front	Prodejní plocha	10
L/H/S/Shelf 1	Malý kontejner	20
L/H/S/Shelf 2	Malý kontejner	20
L/H/S/Rack 1	Malý kontejner	20
R/H/S/Shelf 1	Velký kontejner	30
R/H/S/Rack 1	Velký kontejner	30
Back Office Store	Zázemí	40
Wholesale Direct	Supplier	50

Krátké kódy pozic jako L/H/S (levá strana) nebo R/H/S (pravá strana) s číslem police či regálu pomáhají zboží najít. Produkt může mít více lokací v rámci stejného typu kontejneru.

The locations table

Your locations are displayed in a table showing:

• Priority number
• Name
• Slug (shown as the meta key format _st_stock_{slug})
• Type
• Status (Active/Inactive)
• Actions (Edit, Delete)

Přetažením řádků změníte prioritu odepisování. Objednávky používají způsobilé aktivní prodejní lokace shora dolů; neprodejní zásoby se přeskakují.

Editing a location

Click Edit next to any location. You can change:

• Name - rename the location at any time
• Type - reassign to a different type
• Priority - adjust the depletion order
• Aktivní — běžné lokace lze deaktivovat až po převedení nebo odstranění jejich zásob. Neprodejní lokace nelze deaktivovat.

Prodejnost se určuje při vytvoření lokace. Existující lokace nelze změnit z prodejních na neprodejní ani opačně. Jakmile jsou zásoby připravené k prodeji, převeďte je do prodejní lokace.

Deleting a location

Smazání lokace odstraní samotné místo, nejen jeho přiřazení k jednomu produktu. Neprodejní lokace je nutné před smazáním vyprázdnit. Smazání mohou blokovat také nevyřešené vazby nebo operace.

Je-li lokace prázdná: potvrďte smazání po vyřešení zbývajících vazeb nebo operací.

U běžných prodejních lokací se zásobami: dialog smazání nabízí tyto možnosti. Neobcházejí kontroly pro neprodejní lokace:

1. Download Report - Generates a text file listing every product at that location with its SKU, barcode, stock quantity, and product name. Use this to verify what will be affected before proceeding.
2. Transfer & Delete - Choose a destination location from the dropdown. All stock is transferred to the destination in the background, then the location is deleted. Use this when moving stock to a new location (e.g., closing a store and moving inventory to your warehouse).
3. Delete Without Transfer - Permanently removes the location and all associated stock data. This requires an extra confirmation checkbox: "I understand this will permanently lose X unit(s)". Only use this if the stock no longer exists physically.

Odebrání přiřazení jednomu produktu je samostatná akce. Před smazáním neprodejní lokace přesuňte zboží běžným nebo hromadným převodem.

Neprodejní lokace

Neprodejní lokace obsahují evidované zásoby, které nejsou dostupné k prodeji, například poškozené zboží, vratky čekající na kontrolu nebo zásoby čekající na kontrolu kvality.

Neprodejnost je vlastností jednotlivé lokace, nikoli samostatným typem lokace. Prodejní i neprodejní lokace mohou patřit do typu Warehouse nebo Shop.

Zapnutí a vytvoření neprodejní lokace

1. Aktualizujte Stokkap Connect na verzi 1.6.6 nebo novější a používejte nejnovější aplikaci Stokkap.
2. Otevřete Stokkap → Nastavení.
3. Pod kartou nastavení Typy lokací najděte Neprodejní lokace a klikněte na Povolit neprodejní lokace.
4. Otevřete Stokkap → Lokace, vytvořte novou lokaci a zaškrtněte Neprodejní.

Existující lokace zůstávají prodejní. Zapnutí funkce nemění stávající zásoby.

Chcete-li zásoby uvolnit k prodeji, převeďte je do prodejní lokace.

Podporované postupy a omezení

Pro běžné produkty bez sledování sériových čísel:

• Zobrazení a úpravy: editace produktu, Quick Lookup, Stock Control a Scan podporují neprodejní množství. Lokace mají jasný klasifikační štítek Neprodejní.
• Přesun zásob: běžné i hromadné převody podporují přesuny mezi prodejními a neprodejními lokacemi.
• Počítání: neprodejní lokace jsou vyloučeny z inventur i průběžného a hromadného počítání.
• Nepodporované cíle: neprodejní lokace nelze použít pro zásoby se sériovými čísly, příjem nákupů ani hromadnou aktivaci.
• Importy CSV: podporované importní postupy nemohou vytvářet ani měnit neprodejní zůstatky. Běžné importy prodejních zásob fungují dál.
• Přehledy a exporty: mohou zobrazovat neprodejní množství a štítky lokací. Neprodejní zásoby jsou vyloučeny z ocenění nákupními i maloobchodními cenami a v přehledech nízkých či vyprodaných zásob se nepočítají jako dostupné prodejní zásoby.

Reordering locations (drag and drop)

The locations table supports drag-and-drop reordering. Grab the handle on the left side of any row and drag it to a new position. The priority numbers update automatically when you drop.

Způsobilé prodejní zásoby se odepisují shora dolů. Objednávky používají aktivní prodejní lokace podle priority a v případě potřeby pokračují další lokací. Neprodejní zásoby se přeskakují bez ohledu na prioritu.

This is the quickest way to adjust depletion order without manually editing priority numbers.

How priority and stock depletion works

Priority is the core concept that determines which location's stock is used first when a customer places an order.

The depletion cascade

Při objednávce Stokkap používá způsobilé aktivní prodejní lokace od nejnižšího čísla priority (nejvyšší priorita) po nejvyšší. Neprodejní zásoby se vždy přeskakují:

Example: A customer orders 8 units of a product.

Název umístění	Priorita	Dostupné zásoby	Akce
Main Shop	10	3 kusy	Odebrat 3 (zbývá 0)
Warehouse	20	10 kusů	Odebrat 5 (zbývá 5)
Supplier	30	50 kusů	Přeskočeno (objednávka pokryta)

Výsledek: 3 kusy pocházejí z Main Shop a 5 z Warehouse. Prodejní zásoby WooCommerce klesnou o 8.

Pokud jsou povoleny objednávky na objednání a způsobilé prodejní zásoby nestačí, chybějící množství se přiřadí způsobilé prodejní lokaci s nejvyšší prioritou. Neprodejní zásoby nemohou pokrýt tento nedostatek.

Type priority vs location priority

Location types have a default priority that new locations inherit. You can override this on individual locations.

For most setups, keeping all locations of the same type at the same priority works well - the system processes them in the order they appear. If you need finer control (e.g., preferring one warehouse over another), give individual locations different priority numbers.

Smart Delivery add-on: zone-based priority overrides

With the Smart Delivery add-on (coming soon as a subscription), you can override the default type priority per WooCommerce shipping zone. This lets you change which location type is preferred based on where the customer is shipping to.

For example, your default priority might be Shop (10) > Warehouse (20) > Supplier (30). But for international orders, you could set it to Warehouse first because it is closer to the port. Each shipping zone can have its own priority order.

Smart Delivery also enables:

• Geolocation-aware depletion - Stokkap detects the customer's location automatically and applies the correct priority order before they even reach checkout.
• Delivery time messages - Show customers estimated delivery times on product pages based on which location would supply their order.
• Shipping rate filtering - Automatically show or hide shipping methods based on which location types will fulfil the order.
• Click-and-collect fulfilment - Orders using a click-and-collect shipping rate can be prioritised to deplete shop floor stock.

Bulk import & export (CSV)

Use the built-in CSV import and export tools when you need to create a lot of locations or location types at once - for example, 10+ locations, warehouse aisle-and-bin grids, or multi-store rollouts.

Two separate CSVs

Stokkap uses separate importers for:

1. Location Types - the categories such as Shop, Warehouse, Supplier, or Aisle M01.
2. Locations - the actual places within those types, such as Main Shop, Central Warehouse, or M01-G01.

Create location types first, then import locations that reference those types.

Location Types CSV columns

Sloupec	Povinné?	Poznámky
label	Povinné	Zobrazovaný název typu, například Warehouse nebo Aisle M01.
slug	Volitelné	Interní identifikátor. Pokud je prázdný, Stokkap jej vytvoří z názvu. Slug je po vytvoření trvalý a nelze jej později změnit importem CSV.
priority	Volitelné	Priorita odebírání zásob. Nejprve se použijí nižší čísla. Prázdná hodnota použije běžné výchozí chování priorit ve Stokkap.

Locations CSV columns

Sloupec	Povinné?	Poznámky
name	Povinné	Zobrazovaný název umístění, například Main Shop nebo M01-G01.
type	Povinné	Typ umístění. Lze použít slug nebo název typu; při porovnávání nezáleží na velikosti písmen.
priority	Volitelné	Priorita odebírání zásob z tohoto umístění. Pokud je prázdná, použije se priorita nebo výchozí chování typu umístění.

Duplicate detection and preview

For locations, duplicates are detected by name + type. If your CSV contains a location with the same name under the same type as an existing location, Stokkap treats it as the same location rather than creating a duplicate.

After you drop in a CSV, Stokkap shows an import preview table with a per-row status. Review this before importing so you can catch missing required columns, unknown types, duplicate rows, and invalid priority values.

Export existing data

Use Export existing before preparing a large import. The exported CSV gives you the current column structure and real examples from your store, so it is the safest starting point for edits in a spreadsheet.

From the Locations import card, you can also use the Export location types shortcut. This is useful when building a locations CSV because you can copy the exact type labels or slugs into the type column.

Worked example: 792 warehouse bins

Scenario: a warehouse with 8 aisles x 99 bays = 792 storage bins.

1. Create 8 location types, one per aisle: M01, M02, ... M08. You can create them through the UI or import a Location Types CSV:

   label,priority
   Aisle M01,10
   Aisle M02,20
   ...
   Aisle M08,80

2. Generate the bay locations in a spreadsheet:

   name,type,priority
   M01-G01,aisle_m01,10
   M01-G02,aisle_m01,20
   ...
   M08-G99,aisle_m08,990

3. Save the spreadsheet as CSV, drop it into the import widget, review the preview table, then click Import.

Assigning locations to products

Location assignment within the plugin is available on the WooCommerce product edit screen and quick edit. The Stokkap web app offers additional ways to assign locations - including barcode scanning, the product list, and the product detail view.

Simple products (full edit)

1. Open any simple product and go to the Inventory tab
2. Tick Manage with Stokkap to enable multi-location stock management. This also enables WooCommerce's "Manage stock?" if it was not already enabled.
3. The location stock section appears. Click Add location type... and select a type (e.g., "Shop")
4. A row appears with a dropdown of all locations of that type. Select the specific location (e.g., "Main Shop")
5. Enter the stock quantity
6. Opakujte pro další lokace, včetně více lokací stejného typu.
7. Součty rozlišují prodejní, neprodejní a evidované zásoby. Do prodejních zásob WooCommerce se započítávají pouze zásoby v aktivních prodejních lokacích.

Kliknutím na X u řádku lokace odeberete její přiřazení tomuto produktu. Nemusíte nejprve uložit nulové množství. Odebrání odstraní evidované množství z tohoto produktu; zásoby se nepřevedou jinam a neprodejní zásoby se nestanou prodejními. Při fyzickém přesunu zboží použijte převod. Převedení všech zásob může ponechat přiřazení s nulovým množstvím; jeho odebrání je samostatná akce.

Simple products (quick edit)

For faster updates from the product list:

1. Go to Products in WooCommerce
2. Hover over a product and click Quick Edit
3. The Stokkap section shows the same location type rows - adjust quantities or add/remove locations
4. Click Update to save

Quick edit is ideal for day-to-day stock adjustments without opening the full product editor.

Variable products

For variable products, stock is managed per variation, not at the parent level. Open each variation's panel to see the same location type and stock fields as simple products. Each variation can be at different locations with different quantities.

Prodejní, neprodejní a evidované zásoby

Prodejní zásoby WooCommerce pocházejí z aktivních prodejních lokací. Neprodejní množství zůstávají evidována samostatně a jsou vyloučena z prodejních zásob.

Součet	Význam
Prodejní zásoby	Zásoby v aktivních prodejních lokacích; používají se jako prodejní zásoby WooCommerce.
Neprodejní zásoby	Evidovaná množství v neprodejních lokacích, vyloučená z prodejních zásob.
Evidované zásoby	Prodejní zásoby plus neprodejní zásoby.

Příklad: 10 prodejních + 4 neprodejní = 14 evidovaných. Prodejní zásoby WooCommerce jsou 10. Převeďte 2 kusy do prodejní lokace: 12 prodejních + 2 neprodejní = 14 evidovaných. Prodejní zásoby WooCommerce jsou nyní 12.

Stokkap automaticky synchronizuje prodejní zásoby WooCommerce při změně způsobilých prodejních množství. Úprava pouze neprodejních zásob prodejní zásoby nezvýší.

Neaktivní lokace nepřispívají k prodejním zásobám WooCommerce. Před deaktivací běžné lokace zásoby převeďte nebo odstraňte; neprodejní lokace nelze deaktivovat.

Bulk setup and CSV import

There are three bulk workflows, each for a different job:

• Hromadné nastavení — zapíná správu Stokkap pro mnoho produktů. Jako cíl aktivace použijte prodejní lokaci; neprodejní lokace nejsou jako cíle podporovány.
• CSV import for locations and location types - new in 1.4.9. Use the built-in CSV tools to create or update the locations and types themselves. See Bulk import & export (CSV) above.
• Importy CSV zásob produktů — běžné importy prodejních zásob zůstávají podporovány, včetně více lokací stejného typu. Podporované importní postupy nemohou vytvářet ani měnit neprodejní zůstatky. K úpravám použijte editaci produktu, Quick Lookup, Stock Control nebo Scan a k přesunu zásob převody. Výše uvedené konfigurační soubory CSV vytvářejí nebo aktualizují lokace a typy, nikoli množství produktů.

Tips and best practices

• Start simple. Two types (Shop and Supplier) is enough for most small businesses. Add more as your needs grow.
• Use types for categories, locations for specifics. "Warehouse" is a type. "Birmingham Warehouse" is a location.
• Leave gaps in priority numbers. The auto-increment of 10, 20, 30 leaves room to slot in new types later without renumbering everything.
• Drag to reorder rather than editing priority numbers manually - it is faster and the numbers update automatically.
• Download the report before deleting a location with stock. Even if you plan to transfer, the report is a useful backup.
• Při přesunu zboží převeďte zásoby. Běžné i hromadné převody podporují prodejní i neprodejní lokace. Neprodejní lokaci před smazáním vyprázdněte.
• Slugs are permanent. Think of them as internal codes. The display name can be changed freely, but the slug sticks. If you make a mistake, delete the location and create a new one (transferring stock to the replacement).
• Více lokací stejného druhu? Ponechte je pod stejným typem. Produkt může mít zásoby ve více těchto lokacích.