Експорт замовлень

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

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

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

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

Панель експорту доступна в WooCommerce > Polski > Інструменти > Експорт замовлень (admin.php?page=polski-order-export).

Фільтри

Діапазон дат

Виберіть період, з якого хочете експортувати замовлення:

Дата від - початок діапазону (поле date picker)
Дата до - кінець діапазону (поле date picker)
Передвизначені діапазони: Сьогодні, Останні 7 днів, Останні 30 днів, Поточний місяць, Попередній місяць, Поточний рік

Дати стосуються дати створення замовлення (date_created).

Статус замовлення

Виберіть статуси замовлень для експорту (множинний вибір):

Очікують оплати (pending)
Обробляються (processing)
Призупинені (on-hold)
Завершені (completed)
Скасовані (cancelled)
Повернені (refunded)
Невдалі (failed)

За замовчуванням позначені: Обробляються і Завершені.

Вибір полів

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

Поля замовлення

Поле	Колонка CSV	Опис
ID замовлення	`order_id`	Номер замовлення
Дата замовлення	`order_date`	Дата і час створення
Статус	`order_status`	Статус замовлення
Валюта	`currency`	Код валюти (наприклад, PLN)
Метод оплати	`payment_method`	Назва методу оплати
Назва методу оплати	`payment_method_title`	Відображувана назва оплати
Сума замовлення	`order_total`	Загальна сума
Сума товарів	`order_subtotal`	Сума товарів (без доставки)
Сума податку	`order_tax`	Загальна сума податку
Вартість доставки	`shipping_total`	Вартість доставки
Метод доставки	`shipping_method`	Назва методу доставки
Знижка	`discount_total`	Загальна сума знижок
Код купона	`coupon_codes`	Використані коди купонів
Примітка клієнта	`customer_note`	Зауваження клієнта до замовлення
IP клієнта	`customer_ip`	IP-адреса клієнта

Поля адреси - для рахунка

Поле	Колонка CSV
Ім’я (для рахунка)	`billing_first_name`
Прізвище (для рахунка)	`billing_last_name`
Компанія	`billing_company`
NIP	`billing_nip`
Адреса рядок 1	`billing_address_1`
Адреса рядок 2	`billing_address_2`
Місто	`billing_city`
Поштовий індекс	`billing_postcode`
Воєводство	`billing_state`
Країна	`billing_country`
Email	`billing_email`
Телефон	`billing_phone`

Поля адреси - для доставки

Поле	Колонка CSV
Ім’я (доставка)	`shipping_first_name`
Прізвище (доставка)	`shipping_last_name`
Компанія (доставка)	`shipping_company`
Адреса рядок 1	`shipping_address_1`
Адреса рядок 2	`shipping_address_2`
Місто	`shipping_city`
Поштовий індекс	`shipping_postcode`
Воєводство	`shipping_state`
Країна	`shipping_country`

Поля товарів

Поле	Колонка CSV	Опис
Назва товару	`product_name`	Назва товару в замовленні
SKU	`product_sku`	Код SKU товару
Кількість	`product_qty`	Замовлена кількість
Ціна за одиницю	`product_price`	Ціна за штуку
Сума позиції	`line_total`	Загальна сума позиції

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

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

Кодування: UTF-8 з BOM (для коректного відображення польських символів в Excel)
Роздільник: крапка з комою (;) - стандарт для польського Excel
Роздільник тексту: подвійні лапки (")
Кінці рядків: \r\n (Windows)

Експорт

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

Для великих наборів даних (понад 10 000 замовлень) експорт виконується у фоні зі смугою прогресу. Після завершення файл доступний для завантаження протягом 24 годин.

WP-CLI

Експортуйте замовлення з командного рядка:

wp polski export orders --date-from=2025-01-01 --date-to=2025-12-31 --status=completed --output=/tmp/orders.csv

Параметри:

--date-from - початкова дата (YYYY-MM-DD)
--date-to - кінцева дата (YYYY-MM-DD)
--status - статус замовлень (розділені комою)
--fields - список полів (розділені комою)
--output - шлях вихідного файлу

Хуки

// Додати власне поле до експорту
add_filter('polski/order_export/fields', function (array $fields): array {
    $fields['custom_field'] = [
        'label'    => 'Нестандартне поле',
        'callback' => function (\WC_Order $order): string {
            return $order->get_meta('_custom_field');
        },
    ];
    return $fields;
});

// Модифікація запиту замовлень
add_filter('polski/order_export/query_args', function (array $args): array {
    $args['meta_key']   = '_billing_nip';
    $args['meta_compare'] = 'EXISTS';
    return $args;
});

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

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

Експорт триває занадто довго - при дуже великій кількості замовлень використайте WP-CLI замість веб-інтерфейсу. Розгляньте звуження діапазону дат.

Немає поля NIP в експорті - поле billing_nip доступне лише коли модуль NIP у касі активний.

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

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