Settings Guide

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.

Webhooks

Webhooki przekazują aktualizacje z WooCommerce do aplikacji Stokkap w czasie rzeczywistym, dzięki czemu zmiany stanów i produktów pojawiają się szybko, bez czekania na zaplanowaną synchronizację. Dostarczenie może się opóźnić, jeśli któraś z usług jest tymczasowo niedostępna.

• 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	Stan dostępny do sprzedaży osiąga próg niskiego stanu lub spada poniżej niego
Out of Stock	Stan dostępny do sprzedaży osiąga zero
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

Stan dostępny do sprzedaży obejmuje ilości w aktywnych lokalizacjach sprzedażowych i wyklucza ilości w lokalizacjach niesprzedażowych.

• Próg niskiego stanu — wywołuje alert, gdy stan dostępny do sprzedaży osiąga ten poziom lub spada poniżej niego. Domyślnie: 5; ustaw 0, aby wyłączyć te alerty. Indywidualnymi progami produktów zarządza się w WooCommerce.
• Automatyczne przeliczanie — częstotliwość przeliczania przez Stokkap stanu sprzedażowego WooCommerce na podstawie aktywnych lokalizacji sprzedażowych:

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

Po włączeniu zmiany wprowadzane przez inne wtyczki w polu stanu WooCommerce produktów zarządzanych przez Stokkap są stosowane do kwalifikujących się lokalizacji sprzedażowych. Zwiększenia trafiają do kwalifikującej się lokalizacji sprzedażowej o najwyższym priorytecie; zmniejszenia następują według priorytetu rozchodu. Zapas niesprzedażowy jest wykluczony. Domyślnie wyłączone.

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

Dla produktów zarządzanych przez Stokkap stan sprzedażowy WooCommerce jest przeliczany z aktywnych lokalizacji sprzedażowych. Ilości niesprzedażowe są wykluczone.

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.

To handle this, you have three options:

1. Włącz Zewnętrzne zmiany stanu powyżej, aby automatycznie zastosować różnicę do kwalifikujących się lokalizacji sprzedażowych.
2. Leave those products unmanaged by Stokkap - if you don't need multi-location stock tracking for those products.
3. Korzystaj z obsługiwanych importów stanów produktów dla lokalizacji sprzedażowych. Wskazówki dotyczące importu i ograniczeń zapasu niesprzedażowego znajdziesz w poradniku lokalizacji.

Ustawienia kosztów

• Domyślna waluta kosztów — wybierz walutę nowych kosztów.
• Różne waluty kosztów dla produktów — włącz tę opcję, aby produkty mogły używać własnej waluty kosztów.
• Sposób uwzględniania podatku w kosztach — wybierz, czy nowe koszty obejmują podatek, czy są podawane bez podatku.

Ustawienia domyślne dotyczą nowych kosztów. Istniejące koszty zachowują zapisaną walutę i sposób uwzględniania podatku.

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.

Lokalizacje niesprzedażowe

Włącz lokalizacje, których zapas jest wykluczony ze sprzedaży. Istniejące lokalizacje pozostają sprzedażowe. Po włączeniu wybierz Niesprzedażowa przy tworzeniu nowej lokalizacji. Tej funkcji nie można tutaj wyłączyć.

Użyj osobnego przycisku Włącz lokalizacje niesprzedażowe pod kartą Typy lokalizacji.

Sposób użycia i ograniczenia opisano w Zarządzaniu lokalizacjami.

Zarządzanie zamówieniami

Włącz pracownikom dostęp do zamówień w aplikacji Stokkap. Dostęp każdej osoby nadal zależy od jej indywidualnych uprawnień; zobacz Ustawienia aplikacji.

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.

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)

• Clear Logs - Immediately delete log entries. Choose from:

  • Wszystkie dzienniki — usuwa dzienniki webhooków i zmian stanu, w tym oczekujące wysyłki webhooków.
  • Dzienniki webhooków — usuwa dzienniki dostarczania webhooków oraz oczekujące wysyłki webhooków.
  • 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.

Kreator konfiguracji

Użyj opcji Kreator konfiguracji, aby ponownie otworzyć konfigurację krok po kroku. Pełny poradnik znajdziesz w Pierwszych krokach.

Saving settings

Kliknij Zapisz ustawienia, aby zapisać zwykłe ustawienia, w tym stan, koszty i zarządzanie zamówieniami. Operacje połączenia, włączanie lokalizacji niesprzedażowych, ponowne otwieranie kreatora i czyszczenie dzienników mają własne przyciski. Zmiany obowiązują po zapisaniu; po zmianie Pick & Pack odśwież stronę.