Bezpłatna 15-minutowa konsultacja bezpośrednio z naszymi ekspertami.
Wtyczka Partial Delivery dla Shopware 6 daje sprzedawcom elastyczny i wydajny sposób zarządzania dostawami częściowymi poszczególnych pozycji zamówienia oraz ich śledzenia. W wielu scenariuszach e-commerce nie wszystkie produkty z zamówienia są dostępne jednocześnie, na przykład z powodu braków magazynowych, opóźnień u dostawców lub różnych lokalizacji magazynów. Wtyczka pozwala od razu przygotować i wysłać dostępne artykuły, bez czekania na skompletowanie całego zamówienia.
Dzięki możliwości podziału zamówienia na kilka przesyłek wtyczka pomaga zapewnić płynne procesy logistyczne i krótsze czasy dostawy. Klienci otrzymują dostępne produkty możliwie szybko i są na bieżąco informowani o statusie pozostałych pozycji. Sprzedawcy z Polski mogą w ten sposób na przykład od razu nadać dostępne produkty kurierem lub do Paczkomatu InPost, a resztę zamówienia wysłać później. Taka przejrzystość i organizacja poprawiają całe doświadczenie zakupowe i ograniczają frustrację wynikającą z długiego oczekiwania.
1. Śledzenie dostaw częściowych
Umożliwia śledzenie wielu paczek dla jednej pozycji zamówienia.
Każda paczka ma własną ilość i własny numer przesyłki.
2. Osobna zakładka przesyłek w panelu administracyjnym
Dodaje w widoku szczegółów zamówienia nową zakładkę „Przesyłka”.
Wszystkie dostawy częściowe można przeglądać i obsługiwać bezpośrednio w panelu administracyjnym.
3. Wiele wpisów dla jednej pozycji
Obsługuje rejestrowanie wielu dostaw tego samego artykułu.
Sprawdza się na przykład przy domówieniach lub wysyłce z różnych magazynów.
Wymagania
Przed instalacją i użyciem wtyczki Partial Delivery należy zwrócić uwagę na jedno istotne wymaganie systemowe. Wtyczka została opracowana specjalnie dla Shopware Commercial Edition i korzysta z funkcji dostępnych wyłącznie w tej wersji Shopware. Dlatego Shopware Commercial musi być poprawnie zainstalowane i aktywne w Państwa środowisku, zanim wtyczka Partial Delivery będzie mogła prawidłowo działać. Sprawdzenie tego wymagania z wyprzedzeniem pozwala uniknąć problemów z kompatybilnością i zapewnia sprawną instalację oraz konfigurację.
1. Pobranie
GIT
git clone https://github.com/solution25com/partial-delivery-shopware-6-solution25.git
composer require solution25/partial-delivery
2. Instalacja wtyczki w Shopware 6
3. Aktywacja wtyczki
4. Weryfikacja instalacji
Wtyczka Partial Delivery nie wymaga po instalacji żadnej specjalnej konfiguracji.
Po aktywacji w widoku szczegółów zamówienia w panelu administracyjnym Shopware automatycznie pojawia się zakładka „Przesyłka”.
1. Klient składa zamówienie
Gdy klient składa zamówienie, pełna ilość każdego produktu jest zapisywana w kolumnie Ilość.
2. Administrator tworzy przesyłkę
W zakładce „Przesyłki” zamówienia administrator może ręcznie utworzyć przesyłkę, klikając przycisk „Utwórz przesyłkę”.
3. Rejestracja dostawy częściowej
Zamiast wysyłać całą ilość, administrator może wpisać do wysyłki tylko jej część (np. 5 z 20 sztuk).
Każda dostawa częściowa może zawierać następujące informacje:
4. Śledzenie szczegółów przesyłki
Dzięki temu z jednym zamówieniem można powiązać wiele paczek.
5. Status zamówienia i realizacja
Ten dokument opisuje niestandardowe endpointy Admin API udostępniane przez wtyczkę Partial Delivery dla Shopware 6.
Endpointy pozwalają autoryzowanym użytkownikom tworzyć i pobierać dane o dostawach częściowych dla pozycji zamówienia.
Endpoint
POST /api/_action/partial-shipment-delivery
Opis:
Tworzy jeden lub kilka wpisów dostaw częściowych dla wskazanych
orderLineItemIds
.
Każdy wpis musi zawierać:
System sprawdza:
Authorization: Bearer
Content-Type: application/json
{
"partialDeliveries": [
{
"orderLineItemId": "0195a178f96b7345ad27051c34609e52",
"quantity": 4,
"package": "Package 6",
"trackingCode": "DHL12sad31e279"
},
{
"orderLineItemId": "0195a3aea0447296bc5377d49ab95c1e",
"quantity": 1,
"package": "Package 2",
"trackingCode": "1234ABCD789"
}
]
}
Odpowiedź w przypadku powodzenia
{
"insertedIds": [
"0195a178f96b7345ad27051c34609e52",
"0195a3aea0447296bc5377d49ab95c1e"
],
"skippedItems": []
}
Pobiera wszystkie dostawy częściowe danego zamówienia, pogrupowane według pozycji zamówienia.
Każdy wynik zawiera:
Przykładowe żądanie
GET /api/_action/shipment/5b6a139e54e54ed7b7997c71f6f56f9e
Przykładowa odpowiedź
[
{
"lineItemId": "0195a3aea0447296bc5377d49ab95c1e",
"quantityOrdered": 3,
"shipments": [
{
"quantity": 1,
"package": "Package 2",
"trackingCode": "12334ASDAD9",
"createdAt": "2025-05-22T14:36:12+00:00"
}
]
},
{
"lineItemId": "0195a178f96b7345ad27051c34609e52",
"quantityOrdered": 4,
"shipments": [
{
"quantity": 4,
"package": "Package 6",
"trackingCode": "DHL12sad31e279",
"createdAt": "2025-05-22T14:36:12+00:00"
}
]
}
]
🔐Wszystkie endpointy wymagają ważnego tokena Bearer Admin API.
Token można uzyskać w standardowym procesie uwierzytelniania Shopware Admin API.
Zakładka przesyłek nie jest widoczna w panelu administracyjnym?
Proszę upewnić się, że wtyczka Partial Delivery jest zainstalowana i aktywna.
Proszę sprawdzić, czy rozszerzenie Shopware Commercial jest zainstalowane i aktywne, ponieważ jest ono wymaganą zależnością.
Proszę przebudować panel administracyjny poleceniem:
bin/build-administration.sh
Wtyczka nie jest widoczna w rozszerzeniach?
Proszę wyczyścić cache i odświeżyć listę wtyczek:
bin/console cache:clear bin/console plugin:refresh
Błąd podczas tworzenia przesyłek?
Proszę sprawdzić, czy wszystkie wymagane pola są poprawnie wypełnione:
1. Czy mogę utworzyć kilka przesyłek dla tego samego artykułu?
Tak. Każdy wpis przesyłki może mieć własną ilość i własne dane śledzenia.
2. Czy istnieje limit liczby przesyłek na zamówienie?
Nie, wtyczka nie narzuca stałego limitu. Mogą Państwo dodać dowolną liczbę wpisów przesyłek na artykuł lub zamówienie.
3. Czy muszę instalować dodatkowe wtyczki, aby korzystać z funkcji wysyłki?
Aby korzystać z pełnego zakresu funkcji, wszystkie wymagane zależności, w szczególności rozszerzenie Shopware Commercial, muszą być zainstalowane i aktywne.
Link do: WIKI