1. Co robi moduł
Eksport zamówień do Excela pobiera zamówienia ze sklepu PrestaShop jako plik CSV, który Excel od razu otwiera, z dokładnie tymi kolumnami, których potrzebuje księgowość albo magazyn. Zestawy kolumn zapisujesz jako szablony — wiersz na zamówienie do księgowości albo wiersz na pozycję zamówienia do kompletowania paczek — i dwoma kliknięciami w Zamówienia → Eksport zamówień eksportujesz zamówienia z wybranego okresu, o wybranych statusach i przewoźnikach.
Działa z PrestaShop 1.7.8, 8.x i 9.x (PHP 7.2.5 lub nowszy) i w trybie multistore. Moduł działa tylko w panelu administracyjnym i nic nie dodaje do sklepu.
2. Instalacja
- Pobierz
ap_orderexport_v1.0.0.zipz Moje konto → Historia zamówień w addonspresta.com. - W panelu otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
- Upuść plik zip i poczekaj na potwierdzenie.
- Otwórz Zamówienia → Eksport zamówień. Czekają tam dwa gotowe szablony: Księgowość i Magazyn.
3. Jak to działa
Wybierasz szablon i filtry, a potem klikasz Pobierz CSV. Moduł wyszukuje pasujące zamówienia, zapisuje wiersz na
zamówienie albo wiersz na pozycję z kolumnami szablonu i wysyła do przeglądarki plik orders-<data>-<godzina>.csv.
Gdy żadne zamówienie nie pasuje, zamiast pustego pliku zobaczysz komunikat.
Plik to tekst UTF-8 z separatorem i znakiem dziesiętnym ustawionymi w szablonie. Przy włączonej opcji BOM dla
Excela Excel rozpoznaje kodowanie i poprawnie pokazuje polskie znaki. Tekst, który arkusz mógłby wykonać jako formułę
(zaczyna się od =, +, - albo @), dostaje na początku apostrof; numery telefonów i zwykłe liczby zostają bez
zmian.
Zamówienia są odczytywane partiami, więc nawet dziesiątki tysięcy zamówień eksportują się bez braku pamięci. Moduł nie łączy się z addonspresta.com ani z żadnym innym serwerem i nie przechowuje wyeksportowanych danych.
4. Funkcje i ustawienia
Eksportuj zamówienia
- Szablon — zestaw kolumn do eksportu.
- Data — filtr po Dacie zamówienia albo Dacie faktury z polami Od i Do. Obie daty są opcjonalne; przyciski uzupełniają je dla dziś, wczoraj, ostatnich 7 dni, tego miesiąca, poprzedniego miesiąca i tego roku. Data faktury eksportuje tylko zamówienia, które mają fakturę.
- Statusy zamówień i Przewoźnicy — zaznacz te, które chcesz. Nie zaznaczaj nic, aby wyeksportować wszystkie. Przewoźnik zmieniony w PrestaShop nadal obejmuje swoje starsze zamówienia.
- Pobierz CSV — rozpoczyna pobieranie.
Szablony
Panel Szablony pokazuje Twoje szablony z rodzajem wierszy, liczbą kolumn i separatorem. Edytuj otwiera edytor, Duplikuj tworzy kopię z dopiskiem „(kopia)”, Usuń usuwa szablon po potwierdzeniu. Ostatniego szablonu nie można usunąć, bo eksport potrzebuje co najmniej jednego. Przycisk + dodaje szablon.
Edytor szablonu
- Nazwa — do 64 znaków.
- Wiersze — Jeden wiersz na zamówienie albo Jeden wiersz na pozycję zamówienia; w drugim przypadku kolumny zamówienia powtarzają się przy każdej pozycji.
- Kolumny — wybierz kolumnę z listy i kliknij Dodaj; przesuwaj ją strzałkami albo usuń. Kolumny pojawią się w pliku w tej kolejności. Lista ma około 80 kolumn w sześciu grupach: zamówienie (numer, daty, status, płatność, waluta, produkty, wysyłka, rabaty, pakowanie na prezent i sumy netto i brutto, kwota zapłacona, numer i data faktury, przewoźnik, numer przesyłki, zatwierdzenie, prezent, wiadomość do prezentu, notatka prywatna, sklep), klient, adres dostawy, adres do faktury (imię i nazwisko, firma, adres, kod pocztowy, miasto, województwo, kraj i kod kraju, telefony, NIP, numer identyfikacyjny), podsumowanie produktów i liczba sztuk (tylko wiersz na zamówienie) oraz pozycja zamówienia (identyfikatory, nazwa, kody, EAN-13, UPC, ISBN, MPN, ilość i ilość zwrócona, ceny jednostkowe, wartości pozycji, stawka VAT, waga; tylko wiersz na pozycję). Po zmianie rodzaju wierszy kolumny, które do niego nie pasują, znikają z listy.
- Separator kolumn — średnik, przecinek albo tabulator. Znak dziesiętny — przecinek albo kropka; musi być inny niż separator. Excel po angielsku używa przecinka i kropki, a Excel po polsku i w większości języków europejskich średnika i przecinka. Nowe szablony dostają wartości dopasowane do domyślnego języka sklepu.
- BOM dla Excela i Wiersz nagłówka — oba domyślnie włączone.
Kto może korzystać
W Zaawansowane → Zespół → Uprawnienia dostęp określa zakładka Eksport zamówień (w grupie Zamówienia): Wyświetlanie pozwala otworzyć stronę i pobierać pliki, Dodawanie dodawać i duplikować szablony, Edycja zmieniać je, a Usuwanie usuwać. Przy instalacji zakładkę dostają SuperAdmini i profil pracownika, który instaluje moduł.
Strona konfiguracji
Moduły → Menedżer modułów → Eksport zamówień do Excela → Konfiguruj pokazuje ramkę Pomoc (ta instrukcja, strona modułu, kontakt, wersja) i przycisk otwierający Zamówienia → Eksport zamówień. Ta sama ramka jest na górze strony eksportu.
5. Multistore
Plik zawiera zamówienia sklepów wybranych w nagłówku panelu: wszystkich sklepów, grupy albo jednego sklepu. Pracownik, który zarządza tylko częścią sklepów, dostaje wyłącznie ich zamówienia. W trybie multistore panel eksportu podaje sklepy, których zamówienia trafią do pliku. Szablony są wspólne dla wszystkich sklepów. Jedna licencja obejmuje wszystkie sklepy instalacji.
6. Odinstalowanie
Menedżer modułów → Eksport zamówień do Excela → Odinstaluj usuwa zakładkę Eksport zamówień i Twoje szablony. Zamówienia zostają nietknięte. Aby zachować szablony, użyj Wyłącz.
7. Najczęstsze pytania i problemy
Excel pokazuje wszystko w jednej kolumnie. Separator szablonu nie pasuje do Twojego Excela. Zmień w szablonie Średnik na Przecinek albo odwrotnie, albo otwórz plik w Excelu przez Dane → Z pliku tekstowego/CSV i wybierz tam separator.
Polskie znaki wyglądają w Excelu źle. Włącz w szablonie BOM dla Excela.
Kwoty nie są rozpoznawane jako liczby. Ustaw Znak dziesiętny zgodny z Twoim Excelem: przecinek dla polskiego, kropka dla angielskiego.
Nie widzę Zamówienia → Eksport zamówień. Twój profil potrzebuje prawa Wyświetlanie do zakładki Eksport zamówień. Poproś SuperAdmina o sprawdzenie Zaawansowane → Zespół → Uprawnienia.
Brakuje części zamówień. Sprawdź sklep wybrany w nagłówku panelu, rodzaj daty (zamówienie bez faktury nie ma daty faktury) oraz zaznaczone statusy i przewoźników.
8. Aktualizacje i wsparcie
Aktualizacje są bezpłatne dożywotnio: nowe wersje pobierasz z Moje konto → Historia zamówień w addonspresta.com i wgrywasz jak nowy moduł. Szablony zostają zachowane.
Wsparcie obejmuje 12 miesięcy od zamówienia: napisz na mail@addonspresta.com albo przez formularz kontaktowy w addonspresta.com (od poniedziałku do piątku, 10:00–16:00; odpowiadamy zwykle w ciągu 2 dni roboczych). Podaj wersję PrestaShop, wersję modułu i kroki, które prowadzą do problemu.