Settings Guide
Pro Stokkap Connect 1.6.6. V administraci WordPress otevřete Stokkap → Nastavení; každá karta se věnuje jiné oblasti pluginu.
Stokkap connection
This card manages the link between your WooCommerce store and the Stokkap web app.
Not connected
A "Connect to Stokkap" button is shown. Clicking it redirects you to the Stokkap app to authorise the connection. Once authorised, you are redirected back and a welcome modal confirms the connection is active.
Connected
The card shows your connection status including a truncated Client ID, your Store ID, and when the connection was last verified. Two buttons are available:
- Test Connection - Sends a test request to verify the link is still working. Use this if you suspect sync has stopped or after server changes.
- Disconnect - Removes the connection. Webhooks will stop and sync will pause. Your WooCommerce products, stock levels, and locations remain unaffected. You can reconnect at any time and your data in the Stokkap app is preserved.
The connection is required for webhooks, the Stokkap web app, and barcode scanning features to work. Location management and stock tracking within WooCommerce work independently of the connection.
Webhooks
Webhooky poskytují aktualizace z WooCommerce do aplikace Stokkap v reálném čase, takže se změny zásob a produktů zobrazují rychle bez čekání na plánovanou synchronizaci. Doručení se může zpozdit, pokud je některá služba dočasně nedostupná.
- Enable Webhooks - Master toggle. When off, no events are sent. Requires an active connection and subscription.
- Webhook Events - Choose which events to send (shown when webhooks are enabled):
| Event | What triggers it |
|---|---|
| Stock Updated | Any stock level change (order, manual edit, API, stocktake) |
| Low Stock Alert | Prodejní zásoby dosáhnou hranice nízkých zásob nebo klesnou pod ni |
| Out of Stock | Prodejní zásoby dosáhnou nuly |
| Product Created | A new product is published |
| Product Updated | Product details are changed (title, price, SKU, etc.) |
| Product Trashed | A product is moved to the trash |
| Product Restored | A trashed product is restored |
| Product Deleted (Permanent) | A product is permanently deleted |
All events are enabled by default. You can disable individual events you don't need - for example, if you only use the app for stock management, you might disable the product lifecycle events to reduce traffic.
Stock settings
Prodejní zásoby zahrnují množství v aktivních prodejních lokacích a nezahrnují množství v neprodejních lokacích.
- Hranice nízkých zásob — spustí upozornění, když prodejní zásoby dosáhnou této úrovně nebo klesnou pod ni. Výchozí hodnota: 5; hodnotou 0 tato upozornění vypnete. Vlastní hranice produktů se spravují ve WooCommerce.
- Automatický přepočet — jak často Stokkap přepočítává prodejní zásoby WooCommerce z aktivních prodejních lokací:
| Option | Description |
|---|---|
| Hourly | |
| Every 6 Hours | |
| Twice Daily | |
| Daily | |
| Disabled (default) |
This is a safety net that catches any drift between location stocks and the WooCommerce total. Under normal operation, totals are recalculated instantly whenever stock changes. You only need this if you suspect totals might get out of sync - for example, after a database migration. For most stores, leaving this disabled is fine.
External Stock Changes
Je-li tato možnost zapnutá, změny provedené jinými pluginy v poli zásob WooCommerce u produktů spravovaných Stokkap se promítnou do způsobilých prodejních lokací. Zvýšení směřují do způsobilé prodejní lokace s nejvyšší prioritou; snížení se řídí prioritou odepisování. Neprodejní zásoby jsou vyloučeny. Ve výchozím nastavení vypnuto.
Enable this if you use plugins that sync stock levels directly to WooCommerce - for example, Square inventory sync, external warehouse management systems, or bulk stock import tools. Without this setting, direct stock changes on managed products are overwritten the next time Stokkap recalculates from location values.
This does not affect order-based stock changes (those are already handled correctly) or stock changes made through the Stokkap admin, API, or web app.
Compatibility with other stock plugins
U produktů spravovaných Stokkap se prodejní zásoby WooCommerce přepočítávají z aktivních prodejních lokací. Neprodejní množství jsou vyloučena.
Plugins that create WooCommerce orders work fine. If a plugin creates a proper WooCommerce order and reduces stock through the standard order flow, Stokkap detects it and depletes from locations in priority order. This includes most marketplace plugins (e.g., eBay, Amazon) that import sales as WooCommerce orders, POS plugins that create orders, and subscription renewals.
Plugins that sync stock levels directly will conflict by default. If a plugin writes to WooCommerce's stock field directly (without creating an order), the change will be overwritten the next time Stokkap recalculates from location values. This includes inventory sync tools that push stock quantities from external systems (e.g., Square inventory sync, external warehouse management systems, or bulk stock import tools that update the WooCommerce stock field rather than Stokkap's location meta).
To handle this, you have three options:
- Zapněte Externí změny zásob výše, aby se rozdíl automaticky promítal do způsobilých prodejních lokací.
- Leave those products unmanaged by Stokkap - if you don't need multi-location stock tracking for those products.
- Používejte podporované importy zásob produktů pro prodejní lokace. Pokyny k importu a omezení neprodejních zásob najdete v průvodci lokacemi.
Nastavení nákladů
- Výchozí měna nákladů — vyberte měnu nových nákladů.
- Různé měny nákladů podle produktu — zapněte tuto možnost, aby produkty mohly používat vlastní měnu nákladů.
- Daňový režim nákladů — zvolte, zda se nové náklady zadávají včetně daně, nebo bez daně.
Výchozí nastavení platí pro nové náklady. Existující náklady si zachovají uloženou měnu a daňový režim.
Location types
A shortcut card linking to the Location Types management page. No settings to configure here - just a convenient link. For full details, see the Location Management Guide.
Neprodejní lokace
Zapněte lokace, jejichž zásoby jsou vyloučeny z prodeje. Existující lokace zůstávají prodejní. Po zapnutí zvolte při vytváření nové lokace Neprodejní. Tuto funkci zde nelze vypnout.
Použijte samostatné tlačítko Povolit neprodejní lokace pod kartou Typy lokací.
Použití a omezení najdete ve Správě lokací.
Správa objednávek
Povolte zaměstnancům přístup k objednávkám v aplikaci Stokkap. Přístup každé osoby se nadále řídí jejími individuálními oprávněními; viz Nastavení aplikace.
Features
Enable or disable optional Stokkap features.
- Admin Toolbar - Shows Stokkap quick actions (Quick Lookup, barcode scanning) in the WordPress admin toolbar at the top of every admin page. Enabled by default. Disable if you prefer a cleaner toolbar.
-
Pick & Pack (Premium) - Enables the order picking and packing workflow. When active, this adds:
- The Pick & Pack page under the Stokkap menu
- Bulk actions on the WooCommerce orders list
- The "Packed" order status
A page reload is required after changing this setting. Only available with a subscription plan that includes Pick & Pack.
- POS Orders (Premium) - Enables order creation from the Quick Lookup modal. When active, staff can scan products and create orders directly from the barcode lookup interface - useful for in-store point-of-sale workflows. Only available with a subscription plan that includes POS.
- Location-Based Shipping (Premium) - Also known as Smart Delivery. When available on your subscription, this shows a link to the dedicated shipping settings page. Smart Delivery documentation will be covered separately.
Features marked Premium are greyed out if your subscription plan does not include them. They will be available as subscription add-ons.
CDN
Serve product images from a CDN instead of your origin server. This only affects images displayed in the Stokkap web app - it does not change your WooCommerce storefront.
- Enable CDN - Toggle CDN image delivery on or off.
- CDN Hostname - The hostname to use for image URLs (shown when CDN is enabled). Enter just the hostname without
https://- for example,cdn.example.com. Your CDN must be configured to proxy requests back to your WordPress site for this to work.
This is useful if your server is behind a firewall or has limited bandwidth, or if you want faster image loading in the Stokkap app for staff using it in-store or on mobile.
Advanced
- Debug Logging - Writes detailed debug information to the WooCommerce status log (found at WooCommerce > Status > Logs). Leave this off unless you are troubleshooting an issue. Debug logs can grow quickly on busy stores.
-
Delete Data on Uninstall - When enabled, all Stokkap data is permanently deleted if the plugin is uninstalled (deleted, not just deactivated). This includes:
- All locations and location types
- Stock logs and webhook logs
- Product meta data (location stock values, managed flags)
This is irreversible. Only enable this if you are certain you want a clean removal. Deactivating the plugin does not delete data regardless of this setting - it only takes effect when the plugin is fully deleted from WordPress.
-
Clear Logs - Immediately delete log entries. Choose from:
- Všechny protokoly — vymaže protokoly webhooků i zásob včetně čekajících doručení webhooků.
- Protokoly webhooků — vymaže protokoly doručení webhooků a čekající doručení webhooků.
- Stock Logs - Clears only stock change history
This is useful for freeing up database space on stores with high transaction volume, or for clearing test data after initial setup.
Průvodce nastavením
Pomocí možnosti Průvodce nastavením znovu otevřete nastavení s průvodcem. Úplný postup najdete v části Začínáme.
Saving settings
Kliknutím na Uložit nastavení uložíte běžná nastavení včetně zásob, nákladů a správy objednávek. Akce připojení, zapnutí neprodejních lokací, opětovné otevření průvodce a vymazání protokolů mají vlastní tlačítka. Změny platí po uložení; po změně Pick & Pack stránku znovu načtěte.