Opis
Wtyczka „Epaka.pl Wysyłki z WooCommerce” pozwala zintegrować Twój sklep WooCommerce z platformą kurierską epaka.pl. Dzięki niej możesz:
- Tworzyć przesyłki bezpośrednio z zamówień WooCommerce (również masowo)
- Automatycznie pobierać dane odbiorców
- Generować i drukować etykiety nadawcze
- Śledzić status przesyłek
- Korzystać z wielu przewoźników w jednej integracji
- Oszczędzać czas i pieniądze dzięki korzystnym stawkom kurierskim
Pełny poradnik znajduje się tutaj:
https://www.epaka.pl/biznes/integracje/woocommerce
Zewnętrzne usługi
Ta wtyczka łączy się z usługami zewnętrznymi w celu zapewnienia swojej funkcjonalności:
Epaka.pl API (https://api.epaka.pl)
– Cel: Tworzenie przesyłek, śledzenie paczek, generowanie etykiet, zarządzanie przewoźnikami oraz uwierzytelnianie użytkowników
– Przesyłane dane: Szczegóły zamówienia (imię i nazwisko odbiorcy, adres, numer telefonu), wymiary i waga paczki, preferencje wysyłki oraz dane uwierzytelniające
– Kiedy: Za każdym razem, gdy tworzysz przesyłkę, sprawdzasz status przesyłki, generujesz etykiety lub się uwierzytelniasz
– Dostawca usługi: Epaka.pl
– Regulamin: https://www.epaka.pl/regulamin
– Polityka prywatności: https://www.epaka.pl/privacy-policy
Nominatim OpenStreetMap API (https://nominatim.openstreetmap.org
)
– Cel: Geokodowanie i walidacja adresów dla map punktów odbioru
– Przesyłane dane: Ciągi adresowe do wyszukiwania geokodowania (nazwy ulic, nazwy miast)
– Kiedy: Podczas wyświetlania map punktów odbioru oraz walidacji adresów w procesie zamówienia
– Dostawca usługi: OpenStreetMap Foundation
– Warunki korzystania: https://operations.osmfoundation.org/policies/nominatim/
– Polityka prywatności: https://osmfoundation.org/wiki/Privacy_Policy
OpenStreetMap Tile Server (https://tile.openstreetmap.org)
– Cel: Wyświetlanie kafelków map dla lokalizacji punktów odbioru
– Przesyłane dane: Żądania pobrania kafelków map z współrzędnymi
– Kiedy: Podczas wyświetlania interaktywnych map z punktami odbioru
– Dostawca usługi: OpenStreetMap Foundation
– Warunki korzystania: https://operations.osmfoundation.org/policies/tiles/
– Polityka prywatności: https://osmfoundation.org/wiki/Privacy_Policy
Zrzuty ekranu










Instalacja
- Zainstaluj wtyczkę przez panel WordPressa lub wgraj plik ZIP ręcznie.
- Activate the plugin.
- Skonfiguruj dostęp do API w ustawieniach modułu (Client ID, API Key, Secret).
- Zdefiniuj dane nadawcy i utwórz szablony przesyłek.
Najczęściej zadawane pytania
-
Czy muszę mieć konto na epaka.pl?
-
Tak, wtyczka wymaga aktywnego konta klienta epaka.pl z dostępem do API.
-
Gdzie znajdę instrukcję obsługi wtyczki?
-
Pełny poradnik znajduje się tutaj:
https://www.epaka.pl/biznes/integracje/woocommerce -
Czy wtyczka działa z wieloma przewoźnikami?
-
Tak, możesz nadawać paczki przez wielu kurierów dostępnych w platformie epaka.pl.
-
Nie wiem jak działają niektóre funkcje i znalazłem błąd. Z kim się skontaktować?
-
Koniecznie napisz do nas na integracje@epaka.pl
-
Jak skontaktować się z epaka.pl w sprawie oferty biznesowej?
-
Napisz do nas na bok@epaka.pl lub zadzwoń pod nr (22) 250-89-37
Recenzje
Kontrybutorzy i deweloperzy
„Epaka.pl – wysyłki z WooCommerce” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.
ZaangażowaniWtyczka „Epaka.pl – wysyłki z WooCommerce” została przetłumaczona na 1 język. Podziękuj tłumaczom za ich wkład.
Przetłumacz wtyczkę “Epaka.pl – wysyłki z WooCommerce” na swój język.
Interesuje cię rozwój wtyczki?
Przeglądaj kod, sprawdź repozytorium SVN lub czytaj dziennik rozwoju przez RSS.
Rejestr zmian
1.2.1
- Ulepszenia kompatybilności z wersją WordPress 6.8
- Ulepszono interfejs tworzenia wysyłek
- Zoptymalizowana obsługa błędów API
- Dodano obsługę Flexible Shipping
1.3.1
- Ulepszona zgodność z popularnymi wtyczkami
1.4.2
- Kilka drobnych poprawek stabilności
1.4.3
- Kilka drobnych poprawek stabilności
1.4.4
- Kilka drobnych poprawek stabilności
1.4.5
- Kilka drobnych poprawek stabilności
1.4.6
- Ulepszona widoczność metody wysyłki na podstawie limitów wagi i wymiarów koszyka
1.5.0
- Kilka drobnych poprawek stabilności
1.6.0
- Dodano funkcję grupowania przewoźników, która umożliwia grupowanie wielu przewoźników razem, dzięki czemu WooCommerce automatycznie wyświetla tylko najtańszą dostępną opcję z każdej grupy podczas realizacji transakcji.
- Dodano ustawienie progu bezpłatnej wysyłki, aby skonfigurować całkowitą kwotę w koszyku, powyżej której wszystkie metody wysyłki epaka.pl staną się bezpłatne
- Ulepszony widok listy przewoźników z wizualnym grupowaniem i kolorowymi odznakami
- Ulepszony wyświetlacz front-end: metody wysyłki teraz pokazują nazwy grup zamiast nazw szablonów, gdy przewoźnicy należą do grup
- Naprawiono logikę stref wysyłek międzynarodowych: przewoźnicy są teraz prawidłowo przypisani do stref krajów docelowych, co zapewnia odpowiednią widoczność klientom międzynarodowym
- Naprawiono błąd podczas tworzenia stref, który powodował nieprawidłowe przypisywanie przewoźników do istniejących stref zamiast tworzenia nowych
- Ulepszona obsługa wysyłek międzynarodowych: klienci widzą teraz wszystkie dostępne metody wysyłki do swojego kraju, niezależnie od lokalizacji nadawcy
1.6.1
- Poprawiona funkcjonalność mapy i wyboru punktów dostawy
1.7.0
- Added white-label support: configure button background and text colors from plugin settings
- Improved CSS encapsulation on frontend — all plugin classes now use
epakshfo-prefix to prevent theme style conflicts - Fixed map search buttons and geolocation button inheriting styles from Astra and other themes
- Added country-based Nominatim geocoding: address search in map now filtered by carrier’s receiver country
- Fixed race condition in map initialization using generation counter and requestAnimationFrame
- Fixed WooCommerce Blocks checkout: map state no longer lost when address fields change (MutationObserver)
- Fixed postcode-based map centering on initial map open
- Fixed WC()->session null check and HPOS compatibility for order meta
- Fixed country storage: sender/receiver countries now stored as ISO codes (e.g. PL) instead of numeric index
- Fixed json_decode null protection on additional_options field; soft-deleted carriers now excluded from checkout
- Added SVG geolocation icon with animated loading state instead of text placeholder
- Geolocation button and „Change point” button now use white-label colors
- Security: added .htaccess and index.php protection to logs directory
- Fixed token validation in CronController
- Added last cron status update timestamp in settings
- Improved error logging: replaced context parameter with line number
- Fixed encryption methods to use dynamic keys
- Fixed sslverify to respect WP_DEBUG setting
- Fixed order retrieval with enforced allowed sorting parameters
- Improved admin menu capabilities set to manage_woocommerce
- Added order edit page in plugin admin panel with shipping/billing address fields and form validation
- Added „View in WooCommerce” button in order details linking to native WC order edit page
- Added shipment tracking display in order and shipment details via PHP proxy (CORS-safe)
- Fixed house number meta key for WooCommerce additional checkout fields
- Fixed billing address sync when saving order edits — billing fields now updated from shipping
- Fixed empty column appearing before sender info section in all shipment views
- Fixed parcel locker map returning empty points — corrected form-data encoding of latlng parameters and removed wp_kses stripping JSON response
- Fixed country code case sensitivity in map point requests — country is now normalized to uppercase
- Added InPost marker icon support for courier ID 57
- Fixed critical crash when shipping zone cannot be matched for an order — orders no longer fail to appear in epaka.pl
- Added default sender pickup points per carrier configurable in plugin settings
- Added map modal — pickup point selection now opens in an overlay instead of inline
- Added order edit page in plugin admin panel with shipping and billing address fields
- Added shipment tracking display in order and shipment details
- Added WP-Cron auto-sync scheduling with configurable intervals from plugin settings
- Added processing state lock on shipping section during checkout updates to prevent race conditions
- Added point selection display with full address details at checkout
- Added geocoding support for address fields in map initialization
- Added time display for order and parcel creation dates in admin views
- Improved Polish translations across admin and frontend
- Fixed postal code field mapping in order and shipment controllers
1.7.1
- Fixed map markers for pickup points — replaced plain logo icons with styled pin markers featuring white background, rounded corners, and drop shadow for improved visibility on the map
- Fixed duplicate „Zmień paczkomat” / „Zmień punkt” buttons appearing after payment method change on classic checkout
- Fixed map reappearing after a pickup point was already selected and payment method changed
- Added pickup point memory when switching between delivery methods — previously selected parcel locker or pickup point is restored automatically when returning to the same carrier
- Fixed pickup point label disappearing when switching between carriers in WooCommerce Blocks checkout (MutationObserver over-restore race condition)
- Added selected pickup point name and address to order shipping address — visible on thank you page, My Account, order emails, and admin order view
- Fixed map centering: after geocoding the address, map now centers and loads points at correct zoom without showing „Pokaż punkty” button
1.7.2
- Fixed fatal error on order edit screen when an order has a refund — order item value column no longer requires strict WC_Order_Item type, preventing TypeError from WooCommerce’s OrderRefund object
1.7.3
- Added diagnostic logs accordion in the Support tab, grouped by date, so admins can review recent plugin logs directly from the panel
- Added log file download button in the Support tab logs accordion
- Fixed pickup point map showing points from outside the current view instead of the actual visible area — corrected the „direction” parameter sent to epaka.pl’s point search
- Fixed pickup point map returning too few or no points when zoomed out over a wide area
- Added marker clustering to the pickup point map so nearby points group into a single badge with a count instead of overlapping pins, splitting apart automatically as you zoom in
- Added automatic point loading as the map is panned/zoomed, replacing the manual „Show points” button
- Added local caching of already-loaded map points so revisiting the same area doesn’t trigger a new request
- Fixed pickup point map becoming unresponsive (unable to pan/zoom) while points were loading in the background
1.7.4
- Added loading spinner next to the address search bar while pickup points are being fetched
- Fixed loading spinner not appearing at checkout — the element was silently stripped by output sanitization before reaching the page
- Fixed search icon in the pickup point map not being centered/sized correctly in its button
- Fixed pickup point map not appearing in WooCommerce Blocks checkout after selecting a shipping method — the script was targeting the wrong button element
- Added server-side validation blocking order placement (both classic and WooCommerce Blocks checkout) when the chosen shipping method requires a pickup point but none was selected
- Fixed customer phone number showing empty in the order list and order details screen when only the billing phone was provided — now falls back to billing phone if shipping phone is empty
- Fixed phone number being effectively optional on WooCommerce Blocks checkout despite appearing required
- Fixed pickup point map in the admin order edit screen loading points for the wrong carrier — it was using the internal carrier row ID instead of the courier type ID
1.7.5
- Fixed epaka.pl API error messages being replaced with a generic fallback („Błąd tworzenia zamówienia”) whenever the API returned a plain-text message instead of a field-level error list — real error details (e.g. insufficient account balance) are now shown
- Added detailed per-order error messages to the WooCommerce order list bulk action „Wygeneruj przesyłki (epaka.pl)” — previously only an error count was shown, now the actual epaka.pl error is listed for each failed order
1.7.6
- Fixed label generation failing for international shipments — pickup time slots were requested for the receiver’s post code and country instead of the sender’s, causing errors like „Dla podanego kodu pocztowego nadawcy niemożliwe jest nadanie przesyłki w tym czasie” and „pickupTime: Podaj godziny odbioru” for foreign delivery addresses
- Fixed „receiver.postCode: Zbyt długi kod pocztowy” API error for post codes written with spaces (e.g. Dutch „1234 AB”, Slovak „811 01”) — post codes are now normalized to their compact form before being sent to the API
1.7.7
- Fixed the stored epaka.pl connection being permanently dropped (forcing users to reconnect and re-enter credentials) after a single transient error — such as a brief network hiccup or momentary epaka.pl downtime — during a background token refresh; the connection is now only cleared when epaka.pl explicitly rejects the credentials
- Fixed password and client secret being silently altered by input sanitization on the connection form, which could cause valid credentials to be rejected when they contained certain special characters
- Fixed a critical error that could crash the entire admin panel when the account balance could not be fetched for the sidebar badge — the balance badge is now simply hidden instead of breaking the page
- Fixed selected parcel locker / Orlen Paczka pickup point not being saved on orders paid through payment methods that confirm payment via a server-to-server callback (e.g. BLIK, Przelewy24, PayU, Stripe) — the pickup point is now saved on the order at checkout instead of relying solely on the browser session, which is unavailable during those callbacks
1.7.8
- Fixed connecting to epaka.pl failing with „Unauthorized client: grant_type is invalid” — the plugin now authenticates using the client_credentials grant (client_id/client_secret only), matching the currently documented epaka.pl API; the password grant it previously relied on is no longer supported by epaka.pl. The connection form no longer asks for your epaka.pl account email/password — only the application’s client_id and client_secret are needed
1.8.0
- Fixed duplicate shipments appearing for a single order — the internal order record could be created twice when overlapping checkout hooks (payment confirmation, thank-you page, order status change) all fired for the same order and the „already processed” guard was based on order meta that isn’t always reliable in time (e.g. under WooCommerce HPOS). Order creation is now additionally guarded by a database-level lock and checked directly against existing records, preventing the race entirely
- Fixed selected parcel locker / pickup point occasionally not being saved on the order, causing „Wygeneruj przesyłkę” to fail with „nie wybrano paczkomatu” even though a point was chosen at checkout. On classic checkout, the selected point is now also submitted directly with the checkout form instead of relying solely on the browser session. On WooCommerce Blocks checkout, the point is now written straight onto the underlying draft order the moment it’s picked, so it survives even if the session is lost before „Place order” (cache, cookie reset on payment redirects, etc.)
- Added a warning note on the order itself whenever a pickup-point carrier ends up with no captured point, so it’s caught immediately instead of only discovered later when generating the shipment
- Added a setting to hide other, non-epaka paid shipping methods once the free shipping threshold is reached („Po przekroczeniu progu ukryj pozostałe płatne metody dostawy”), instead of only zeroing the cost of epaka-managed carriers. Off by default
- Fixed the free shipping threshold setting not reliably taking effect after being changed — WooCommerce caches computed shipping rates per session, and the plugin wasn’t invalidating that cache when settings were saved (an incorrect
function_exists('wc_cache_helper')check that never actually ran); saving settings now properly bumps WooCommerce’s shipping rate cache - Added a warning notice in settings clarifying that the free shipping threshold applies to all epaka-managed shipping methods, including higher-cost ones like pallet shipping — so stores with pallet-requiring assortment can set the threshold with that in mind
- Added an optional minimum weight field per shipping method („Waga minimalna”), so bulky/expensive methods like pallet shipping can be kept out of the cart for orders that don’t actually need them, symmetric to the existing maximum weight/dimensions limits
1.8.1
- Confirmed compatibility with WordPress 7.1
- Fixed a „doing it wrong” notice logged on every shipments/orders list or count query that had no active filters, caused by preparing an SQL query with an empty parameter list
- Fixed a PHP warning on the shipments list when a parcel referenced an order record that no longer exists
1.8.2
- Fixed shipment creation failing with the epaka.pl API error „packages.0.weight: Wartość musi być większa od zera” for orders whose total weight was very small (e.g. 0.01 kg) — the calculated package weight is now raised to a minimum of 0.5 kg before being sent to the API when it would otherwise fall below that threshold