Експорт складських залишків

Модуль експорту складських залишків генерує файли CSV з даними про складські залишки продуктів WooCommerce. Він підтримує 10 налаштовуваних полів, фільтрування за порогом кількості, повну підтримку варіативних продуктів та режим попереднього перегляду в таблиці HTML.

Увімкнення модуля

Перейдіть до WooCommerce > Polski > Інструменти і ввімкніть Експорт складських залишків (ID модуля: stock_export).

Панель експорту

Панель експорту доступна в Продукти > Експорт складських залишків (edit.php?post_type=product&page=polski-stock-export).

Пороговий фільтр

Фільтруйте продукти за кількістю на складі:

Оператор	Опис	Приклад
`<=`	Менше або дорівнює	`<= 5` - продукти із запасом до 5 штук
`>=`	Більше або дорівнює	`>= 100` - продукти з великим запасом
`=`	Точно дорівнює	`= 0` - продукти без запасу

Пороговий фільтр дозволяє швидко виявляти продукти, що потребують поповнення, або продукти з надмірним запасом.

Залиште поле порогу порожнім, щоб експортувати всі продукти незалежно від складського залишку.

Вибір полів

Позначте поля, які мають увійти до експорту. Конфігурація зберігається в опціях WordPress.

Поле	Стовпець CSV	Опис
ID продукту	`product_id`	ID запису продукту (post ID)
SKU	`sku`	Код SKU продукту
Назва продукту	`product_name`	Повна назва продукту
Складський статус	`stock_status`	`instock`, `outofstock`, `onbackorder`
Кількість на складі	`stock_quantity`	Поточна кількість (null, якщо не керується)
Керування складом	`manage_stock`	`yes` або `no`
Поріг низького залишку	`low_stock_threshold`	Поріг сповіщення про низький залишок
Дозволені відкладені замовлення	`backorders`	`no`, `notify`, `yes`
Категорія	`category`	Категорії продукту (розділені комою)
Ціна	`price`	Поточна ціна продукту

Підтримка варіацій

Варіативні продукти (variable products) експортуються з повною підтримкою варіацій:

Батьківський продукт - експортується із сумарним складським залишком (якщо керування складом на рівні продукту)
Варіації - кожна варіація експортується як окремий рядок з власними складськими даними

Назва варіації містить атрибути в дужках, наприклад Сорочка поло (Червоний, XL).

Коли керування складом встановлено на рівні варіації, батьківський продукт відображає сумарний залишок усіх варіацій.

Режим попереднього перегляду

Натисніть Попередній перегляд замість Експортувати, щоб відобразити дані в таблиці HTML безпосередньо в панелі адміна. Попередній перегляд дозволяє:

Перевірити дані перед експортом
Підтвердити коректність фільтрів
Швидко переглянути складські залишки без завантаження файлу

Таблиця попереднього перегляду сортується за будь-яким стовпцем (натисніть заголовок). Рядки з нульовим складським залишком підсвічуються червоним. Рядки з низьким залишком (нижче порогу) підсвічуються жовтим.

Формат файлу CSV

Файл CSV оптимізований для відкриття в Microsoft Excel з польськими регіональними налаштуваннями:

BOM (Byte Order Mark) - файл починається з маркера UTF-8 BOM (\xEF\xBB\xBF), завдяки чому Excel правильно розпізнає кодування
Роздільник: крапка з комою (;) - Excel з польськими регіональними налаштуваннями стандартно розпізнає крапку з комою як роздільник стовпців
Кодування: UTF-8
Роздільник тексту: подвійні лапки (")
Кінці рядків: \r\n (Windows)

Завдяки BOM та крапці з комою файл CSV можна відкрити в Excel подвійним кліком - без необхідності імпорту з налаштуванням кодування.

Експорт

Після налаштування фільтрів та полів натисніть Експортувати в CSV. Файл буде завантажено браузером з назвою stock-export-YYYY-MM-DD.csv.

WP-CLI

Експортуйте складські залишки з командного рядка:

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

Параметри:

--threshold - пороговий фільтр (наприклад, <=5, >=100, =0)
--fields - список полів (розділені комою)
--include-variations - враховувати варіації (стандартно yes)
--output - шлях вихідного файлу

Хуки

// Додати власне поле до експорту
add_filter('polski/stock_export/fields', function (array $fields): array {
    $fields['warehouse_location'] = [
        'label'    => 'Розташування на складі',
        'callback' => function (\WC_Product $product): string {
            return $product->get_meta('_warehouse_location');
        },
    ];
    return $fields;
});

// Модифікація запиту продуктів
add_filter('polski/stock_export/query_args', function (array $args): array {
    $args['category'] = ['elektronika'];
    return $args;
});

// Зміна роздільника CSV
add_filter('polski/stock_export/csv_separator', function (): string {
    return ','; // кома замість крапки з комою
});

Усунення проблем

Excel відображає польські символи як кракозябри - переконайтеся, що експорт генерує файл з BOM (стандартно ввімкнено). У старіших версіях Excel (до 2016) використовуйте функцію імпорту даних з ручним встановленням кодування UTF-8.

Варіації не зʼявляються в експорті - перевірте, чи варіації мають статус “Опубліковано”. Варіації в чернетках пропускаються.

Пороговий фільтр не працює - фільтр працює лише на продуктах з увімкненим керуванням складом (manage_stock = yes). Продукти без керування складом мають stock_quantity = null.

Попередній перегляд завантажується надто довго - при понад 5 000 продуктів попередній перегляд може бути повільним. Використовуйте пороговий фільтр, щоб обмежити кількість результатів, або експортуйте безпосередньо в CSV.

Повідомлення про проблеми: github.com/wppoland/polski/issues

Ця сторінка має виключно інформаційний характер і не є юридичною консультацією. Polski for WooCommerce є програмним забезпеченням з відкритим кодом (GPLv2), що постачається без гарантій.