Eksport stanów magazynowych

This content is not available in your language yet.

Moduł eksportu stanów magazynowych generuje pliki CSV z danymi o stanach magazynowych produktów WooCommerce. Obsługuje 10 konfigurowalnych pól, filtrowanie po progu ilości, pełną obsługę produktów wariantowych oraz tryb podglądu w tabeli HTML.

Włączenie modułu

Przejdź do WooCommerce > Polski > Narzędzia i włącz Eksport stanów magazynowych (ID modułu: stock_export).

Panel eksportu

Panel eksportu dostępny jest w Produkty > Eksport stanów magazynowych (edit.php?post_type=product&page=polski-stock-export).

Filtr progowy

Filtruj produkty po ilości w magazynie:

Operator	Opis	Przykład
`<=`	Mniej lub równo	`<= 5` - produkty z zapasem do 5 sztuk
`>=`	Więcej lub równo	`>= 100` - produkty z dużym zapasem
`=`	Dokładnie równo	`= 0` - produkty bez zapasu

Filtr progowy pozwala szybko identyfikować produkty wymagające uzupełnienia lub produkty z nadmiernym zapasem.

Pozostaw pole progu puste, aby eksportować wszystkie produkty niezależnie od stanu magazynowego.

Wybór pól

Zaznacz pola, które mają znaleźć się w eksporcie. Konfiguracja jest zapisywana w opcjach WordPress.

Pole	Kolumna CSV	Opis
ID produktu	`product_id`	ID wpisu produktu (post ID)
SKU	`sku`	Kod SKU produktu
Nazwa produktu	`product_name`	Pełna nazwa produktu
Status magazynowy	`stock_status`	`instock`, `outofstock`, `onbackorder`
Ilość w magazynie	`stock_quantity`	Aktualna ilość (null jeśli nie zarządzany)
Zarządzanie magazynem	`manage_stock`	`yes` lub `no`
Próg niskiego stanu	`low_stock_threshold`	Próg powiadomienia o niskim stanie
Dozwolone zamówienia wsteczne	`backorders`	`no`, `notify`, `yes`
Kategoria	`category`	Kategorie produktu (oddzielone przecinkiem)
Cena	`price`	Aktualna cena produktu

Obsługa wariacji

Produkty zmienne (variable products) eksportowane są z pełną obsługą wariacji:

Produkt nadrzędny - eksportowany z sumarycznym stanem magazynowym (jeśli zarządzanie magazynem jest na poziomie produktu)
Wariacje - każda wariacja eksportowana jest jako osobny wiersz z własnymi danymi magazynowymi

Nazwa wariacji zawiera atrybuty w nawiasie, np. Koszulka polo (Czerwony, XL).

Gdy zarządzanie magazynem jest ustawione na poziomie wariacji, produkt nadrzędny wyświetla łączny stan wszystkich wariacji.

Tryb podglądu

Kliknij Podgląd zamiast Eksportuj, aby wyświetlić dane w tabeli HTML bezpośrednio w panelu admina. Podgląd pozwala:

Sprawdzić dane przed eksportem
Zweryfikować poprawność filtrów
Szybko przejrzeć stany magazynowe bez pobierania pliku

Tabela podglądu jest sortowalna po każdej kolumnie (kliknij nagłówek). Wiersze z zerowym stanem magazynowym są podświetlone na czerwono. Wiersze z niskim stanem (poniżej progu) są podświetlone na żółto.

Format pliku CSV

Plik CSV jest zoptymalizowany pod kątem otwierania w Microsoft Excel z polskimi ustawieniami regionalnymi:

BOM (Byte Order Mark) - plik zaczyna się od znacznika UTF-8 BOM (\xEF\xBB\xBF), dzięki czemu Excel poprawnie rozpoznaje kodowanie
Separator: średnik (;) - Excel z polskimi ustawieniami regionalnymi domyślnie rozpoznaje średnik jako separator kolumn
Kodowanie: UTF-8
Separator tekstu: podwójny cudzysłów (")
Końce linii: \r\n (Windows)

Dzięki BOM i średnikowi plik CSV można otworzyć w Excel podwójnym kliknięciem - bez konieczności importu z ustawieniem kodowania.

Eksport

Po skonfigurowaniu filtrów i pól kliknij Eksportuj do CSV. Plik zostanie pobrany przez przeglądarkę z nazwą stock-export-YYYY-MM-DD.csv.

WP-CLI

Eksportuj stany magazynowe z linii komend:

wp polski export stock --threshold="<=5" --output=/tmp/low-stock.csv

Parametry:

--threshold - filtr progowy (np. <=5, >=100, =0)
--fields - lista pól (oddzielone przecinkiem)
--include-variations - uwzględnij wariacje (domyślnie yes)
--output - ścieżka pliku wyjściowego

Hooki

// Dodaj własne pole do eksportu
add_filter('polski/stock_export/fields', function (array $fields): array {
    $fields['warehouse_location'] = [
        'label'    => 'Lokalizacja w magazynie',
        'callback' => function (\WC_Product $product): string {
            return $product->get_meta('_warehouse_location');
        },
    ];
    return $fields;
});

// Modyfikacja zapytania produktów
add_filter('polski/stock_export/query_args', function (array $args): array {
    $args['category'] = ['elektronika'];
    return $args;
});

// Zmiana separatora CSV
add_filter('polski/stock_export/csv_separator', function (): string {
    return ','; // przecinek zamiast średnika
});

Rozwiązywanie problemów

Excel wyświetla polskie znaki jako krzaczki - upewnij się, że eksport generuje plik z BOM (domyślnie włączony). W starszych wersjach Excela (przed 2016) użyj funkcji importu danych z ręcznym ustawieniem kodowania UTF-8.

Wariacje nie pojawiają się w eksporcie - sprawdź, czy wariacje mają status “Opublikowane”. Wariacje w wersji roboczej są pomijane.

Filtr progowy nie działa - filtr działa tylko na produktach z włączonym zarządzaniem magazynem (manage_stock = yes). Produkty bez zarządzania magazynem mają stock_quantity = null.

Podgląd ładuje się zbyt długo - przy ponad 5 000 produktów podgląd może być wolny. Użyj filtra progowego, aby ograniczyć liczbę wyników, lub eksportuj bezpośrednio do CSV.

Zgłaszanie problemów: github.com/wppoland/polski/issues

Ta strona ma wyłącznie charakter informacyjny i nie stanowi porady prawnej. Polski for WooCommerce jest oprogramowaniem open source (GPLv2) dostarczanym bez gwarancji.