Eksport zamówień

Moduł eksportu zamówień pozwala generować pliki CSV z danymi zamówień WooCommerce. Obsługuje ponad 30 konfigurowalnych pól, filtry zakresu dat i statusów zamówień. Konfiguracja wyboru pól zapisywana jest w opcjach WordPress.

Włączenie modułu

Przejdź do Polski > Moduły i włącz Eksport zamówień (ID modułu: order_export).

Panel eksportu

Panel eksportu dostępny jest w WooCommerce > Eksport zamówień (admin.php?page=polski-order-export).

Filtry

Zakres dat

Wybierz okres, z którego chcesz eksportować zamówienia:

• Data od - początek zakresu (pole date picker)
• Data do - koniec zakresu (pole date picker)
• Predefiniowane zakresy: Dzisiaj, Ostatnie 7 dni, Ostatnie 30 dni, Bieżący miesiąc, Poprzedni miesiąc, Bieżący rok

Daty odnoszą się do daty utworzenia zamówienia (date_created).

Status zamówienia

Wybierz statusy zamówień do eksportu (wielokrotny wybór):

• Oczekujące na płatność (pending)
• Przetwarzane (processing)
• Wstrzymane (on-hold)
• Zakończone (completed)
• Anulowane (cancelled)
• Zwrócone (refunded)
• Nieudane (failed)

Domyślnie zaznaczone są: Przetwarzane i Zakończone.

Wybór pól

Zaznacz pola, które mają znaleźć się w pliku CSV. Konfiguracja pól zapisywana jest w opcjach WordPress i jest pamiętana między eksportami.

Pola zamówienia

Pole	Kolumna CSV	Opis
ID zamówienia	order_id	Numer zamówienia
Data zamówienia	order_date	Data i godzina utworzenia
Status	order_status	Status zamówienia
Waluta	currency	Kod waluty (np. PLN)
Metoda płatności	payment_method	Nazwa metody płatności
Tytuł metody płatności	payment_method_title	Wyświetlana nazwa płatności
Suma zamówienia	order_total	Kwota łączna
Suma produktów	order_subtotal	Kwota produktów (bez dostawy)
Kwota podatku	order_tax	Łączna kwota podatku
Koszt dostawy	shipping_total	Koszt dostawy
Metoda dostawy	shipping_method	Nazwa metody dostawy
Rabat	discount_total	Łączna kwota rabatów
Kod kuponu	coupon_codes	Użyte kody kuponów
Notatka klienta	customer_note	Uwagi klienta do zamówienia
IP klienta	customer_ip	Adres IP klienta

Pola adresowe - rozliczeniowe

Pole	Kolumna CSV
Imię (rozliczeniowe)	billing_first_name
Nazwisko (rozliczeniowe)	billing_last_name
Firma	billing_company
NIP	billing_nip
Adres linia 1	billing_address_1
Adres linia 2	billing_address_2
Miasto	billing_city
Kod pocztowy	billing_postcode
Województwo	billing_state
Kraj	billing_country
E-mail	billing_email
Telefon	billing_phone

Pola adresowe - wysyłkowe

Pole	Kolumna CSV
Imię (wysyłkowe)	shipping_first_name
Nazwisko (wysyłkowe)	shipping_last_name
Firma (wysyłkowa)	shipping_company
Adres linia 1	shipping_address_1
Adres linia 2	shipping_address_2
Miasto	shipping_city
Kod pocztowy	shipping_postcode
Województwo	shipping_state
Kraj	shipping_country

Pola produktów

Pole	Kolumna CSV	Opis
Nazwa produktu	product_name	Nazwa produktu w zamówieniu
SKU	product_sku	Kod SKU produktu
Ilość	product_qty	Zamówiona ilość
Cena jednostkowa	product_price	Cena za sztukę
Suma pozycji	line_total	Łączna kwota pozycji

Gdy zamówienie zawiera wiele produktów, każdy produkt eksportowany jest jako osobny wiersz z powtórzonymi danymi zamówienia.

Format pliku CSV

• Kodowanie: UTF-8 z BOM (dla poprawnego wyświetlania polskich znaków w Excel)
• Separator: średnik (;) - standard dla polskiego Excela
• Separator tekstu: podwójny cudzysłów (")
• Końce linii: \r\n (Windows)

Eksport

Po skonfigurowaniu filtrów i pól kliknij Eksportuj do CSV. Plik zostanie pobrany przez przeglądarkę.

Dla dużych zbiorów danych (powyżej 10 000 zamówień) eksport wykonywany jest w tle z paskiem postępu. Po zakończeniu plik dostępny jest do pobrania przez 24 godziny.

WP-CLI

Eksportuj zamówienia z linii komend:

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

Parametry:

• --date-from - data początkowa (YYYY-MM-DD)
• --date-to - data końcowa (YYYY-MM-DD)
• --status - status zamówień (oddzielone przecinkiem)
• --fields - lista pól (oddzielone przecinkiem)
• --output - ścieżka pliku wyjściowego

Hooki

// Dodaj własne pole do eksportu
add_filter('polski/order_export/fields', function (array $fields): array {
    $fields['custom_field'] = [
        'label'    => 'Pole niestandardowe',
        'callback' => function (\WC_Order $order): string {
            return $order->get_meta('_custom_field');
        },
    ];
    return $fields;
});

// Modyfikacja zapytania zamówień
add_filter('polski/order_export/query_args', function (array $args): array {
    $args['meta_key']   = '_billing_nip';
    $args['meta_compare'] = 'EXISTS';
    return $args;
});

Rozwiązywanie problemów

Polskie znaki wyświetlają się niepoprawnie w Excel - upewnij się, że opcja BOM jest włączona (domyślnie tak). W starszych wersjach Excela użyj importu danych z ustawieniem kodowania UTF-8.

Eksport trwa zbyt długo - przy bardzo dużej liczbie zamówień użyj WP-CLI zamiast interfejsu webowego. Rozważ zawężenie zakresu dat.

Brak pola NIP w eksporcie - pole billing_nip jest dostępne tylko gdy moduł NIP w kasie jest aktywny.

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.