Integracja DPD z Medusą
Wysyłka DPD prosto z Medusy: pięć opcji dostawy (kurier i DPD Pickup, z pobraniem lub bez, plus zwrot), punkt odbioru sprawdzony w checkoucie, a realizacja staje się przesyłką DPD z planu, który człowiek czyta przed wysłaniem. Etykiety i protokoły przekazania zostają w bazie, statusy przychodzą z DPD InfoServices, a Medusa może sama oznaczać realizacje jako wysłane i doręczone.
Co dokładnie
robi ta integracja
-
Pięć opcji dostawy
Kurier DPD i DPD Pickup, obie z pobraniem lub bez, plus opcja zwrotu. Kurier wymaga pełnego adresu, DPD Pickup numeru punktu i telefonu albo e-maila odbiorcy, a pobranie waluty dozwolonej dla kraju.
-
Punkt wybrany w checkoucie
Sklep pokazuje mapę PudoFinder DPD albo własną listę punktów z tras sklepu. Checkout sprawdza punkt na świeżo i zapisuje jego dane przy metodzie dostawy, a awaria wyszukiwarki punktów nie zatrzymuje sprzedaży.
-
Plan, który człowiek czyta
Zanim cokolwiek wyjdzie do DPD, panel pokazuje odbiorcę, nadawcę, paczki z wagą i wymiarami, pobranie i dokładne żądanie. Gdy zamówienie zmieniło się w międzyczasie, wysyłka wraca z nowym planem.
-
Przesyłka dokładnie raz
Niejasna odpowiedź DPD (limit czasu, błąd sieci) nigdy nie kończy się drugą przesyłką: wtyczka najpierw szuka jej w DPD po referencji, a dopiero potem pozwala utworzyć ją ponownie.
-
Przekazanie kurierowi
Do 100 przesyłek z etykietą od jednego nadawcy w jednym protokole DPD, potem opcjonalnie zamówienie kuriera. Protokół zostaje w bazie, a ponowny wydruk to świadoma decyzja, nie powtórka.
-
Statusy i realizacje w Medusie
Osobne zadanie pyta DPD InfoServices o każdy list przewozowy. Zapis statusów oznacza realizację jako wysłaną, gdy DPD ma paczkę w rękach, i jako doręczoną, gdy doręczone są wszystkie listy przesyłki.
Jak pilnuje
Twoich danych
-
Dwa włączniki na zapis
Opcja w konfiguracji to twardy wyłącznik, przełącznik w Ustawieniach ten codzienny, z zapisem, kto i kiedy go zmienił. Osobno dla przesyłek, zamawiania kuriera i statusów.
-
Pobranie tylko raz na zamówienie
Kwota pobrania to to, co zostało do zapłaty, tylko na jednej przesyłce zamówienia. Zamówienie opłacone online nigdy nie dostaje pobrania.
-
Dane dostępowe zostają na serwerze
Login, hasło i klucze DPD idą tylko w żądaniach z backendu, maskowane w logach, błędach i panelu. Etykiety i protokoły wracają z bazy, bez ponownego pytania DPD.
-
Medusa nie cofa wysyłki
Realizacja jest wysłana dopiero wtedy, gdy DPD potwierdzi, że ma paczkę, nigdy z samego przekazania. Paczka, która wraca do sklepu, nigdy nie jest oznaczona jako doręczona.
Instalacja
w trzech krokach
Pełna lista opcji, zdarzeń i tras API jest w README paczki na GitHubie.
Wklej do Claude Code, Cursora albo innego asystenta AI w swoim projekcie Medusy: zainstaluje i skonfiguruje integrację, z zapisami wyłączonymi.
- 1 Zainstaluj paczkę z npm.
npm install @koda-plus/medusa-plugin-dpd - 2 Dopisz wtyczkę do medusa-config.ts.
const dpd = { login: process.env.DPD_LOGIN, password: process.env.DPD_PASSWORD, masterFid: process.env.DPD_MASTER_FID, sender: process.env.DPD_SENDER, // JSON with the sender address // mode: "live", // sandbox by default // Writes: off unless allowed here AND armed in the admin. // shipmentWriter: true, // create shipments, labels and handover protocols // pickupWriter: true, // order the DPD courier for a handover // infoLogin, infoPassword, infoChannel: DPD InfoServices, statuses in live mode // fulfillmentStatusWriter: true, // mark Medusa fulfillments shipped and delivered // demo: true, // sample shipments from your orders, nothing sent to DPD } plugins: [{ resolve: "@koda-plus/medusa-plugin-dpd", options: dpd }], modules: [ { resolve: "@medusajs/medusa/fulfillment", options: { providers: [ { resolve: "@medusajs/medusa/fulfillment-manual", id: "manual" }, { resolve: "@koda-plus/medusa-plugin-dpd/providers/dpd", id: "dpd", options: dpd }, ], }, }, ] - 3 Uruchom migracje i otwórz integrację w panelu Medusy.
npx medusa db:migrate
Pozostałe
integracje
- Allegro Oferty, zamówienia, stany i przesyłki
- Base Karty, stany, ceny i zamówienia w obie strony
- Subiekt nexo Zamówienia jako ZK, WZ i faktury z KSeF
- Fakturownia Faktury, korekty i KSeF dokładnie raz
- InPost Paczkomaty, kurier i pobranie na API ShipX
- InPost Von Halsky Sprzedaż w aplikacji InPost Mobile prosto z Medusy
- OLX Ogłoszenia zgodne ze stanem sklepu
- Stripe Obrót, opłaty, spory i zdrowie konta
- Negocjacje Cena docelowa, kontroferta, akceptacja
- Kredyt kupiecki Limity, terminy i salda klientów
- Lojalność Punkty, drabinka nagród i historia
- Kupony Kreator w trzech krokach i wyniki każdego kuponu
- Opakowania Sztuka, karton, paleta, minimum i krok
- Zgodność UE GPSR, RODO i Omnibus w jednym panelu
- Biała lista VAT NIP, VIES i REGON w jednym panelu
- E-maile Gotowe szablony po polsku i angielsku
- Kit Zapisy ze sklepu prosto na listę newslettera w Kit
- Zadania Zadania przy zamówieniach, produktach i klientach
Opowiedz nam o swoim projekcie,
resztę dopasujemy pod Ciebie
15 minut rozmowy wystarczy, abyśmy wiedzieli, czy pasujemy do Twojego projektu.
Zaczynamy od Twoich potrzeb, nie od gotowego rozwiązania.