Integracja InPost
z Medusą
Wysyłka InPostem prosto z Medusy: cztery opcje dostawy (Paczkomat i kurier, z pobraniem lub bez), wybrany paczkomat sprawdzony w checkoucie, a realizacja wysyłki staje się przesyłką ShipX z planu, który człowiek czyta przed wysłaniem. Etykieta idzie przez backend, statusy przez webhook, a reszta sklepu dowiaduje się przez zdarzenia.
Co dokładnie
robi ta integracja
-
Cztery opcje dostawy
Paczkomat i kurier, obie z pobraniem lub bez. Opcja paczkomatowa wymaga poprawnego kodu paczkomatu z listy InPost, kurierska – polskiego adresu, a pobranie – koszyka w złotówkach.
-
Paczkomat wybrany w checkoucie
Sklep pokazuje Geowidget InPost albo własną wyszukiwarkę paczkomatów, a kod wybranego punktu ląduje w metadanych metody dostawy i na realizacji wysyłki.
-
Plan, który człowiek czyta
Zanim cokolwiek wyjdzie do ShipX, panel pokazuje odbiorcę, paczkomat albo adres, rozmiar, wagę, pobranie z ubezpieczeniem i dokładne żądanie API. Przesyłkę wysyła przycisk z planu.
-
Przesyłka dokładnie raz
Jeden wiersz na realizację, atomowe zajęcie przed żądaniem, a niejasna odpowiedź nigdy nie kończy się drugą przesyłką: najpierw wyszukujemy ją w ShipX po odbiorcy i referencji.
-
Statusy i etykiety
Webhook mówi tylko, co się zmieniło, a wtyczka czyta przesyłkę z ShipX sama. Etykieta PDF w A6 albo A4 idzie przez backend, więc token nigdy nie trafia do przeglądarki.
-
Zdarzenia dla reszty sklepu
Utworzona, zmieniona, dostarczona – każde zdarzenie Medusy z udokumentowanym payloadem bez danych osobowych. E-maile mogą wysłać „paczkę czeka w paczkomacie”, a ERP zareagować bez zmian we wtyczce.
Jak pilnuje
Twoich danych
-
Dwa włączniki na zapis
Opcja w konfiguracji to twardy wyłącznik, przełącznik w Ustawieniach – ten dzienny, z zapisem kto i kiedy. Bez obu nic nie idzie do InPost, a realizacje i tak się zapisują.
-
Pobranie tylko raz na zamówienie
Kwota pobrania to to, co zostało do zapłaty, tylko na pierwszej przesyłce pobraniowej zamówienia. Zamówienie opłacone online nigdy nie dostaje pobrania.
-
Token zostaje na serwerze
Klucz API tylko w nagłówku do ShipX, maskowany w logach, błędach i panelu. Dane odbiorcy czyta się z zamówienia dopiero przy budowaniu planu.
-
Anulowanie tylko, gdy ShipX pozwala
Status czyta się najpierw, a anulować można tylko stany, które InPost dopuszcza. Przesyłki utworzone poza wtyczką są tylko śledzone, nigdy kasowane ani opłacane.
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-inpost - 2 Dopisz wtyczkę do medusa-config.ts.
const inpost = { apiToken: process.env.INPOST_API_TOKEN, organizationId: process.env.INPOST_ORGANIZATION_ID, webhookSecret: process.env.INPOST_WEBHOOK_SECRET, // sandbox: true, // Writes: off unless allowed here AND armed in the admin (allowed by default in demo mode, simulated). // shipmentWriter: true, // create, pay a prepaid offer, order a pickup, cancel // fulfillmentStatusWriter: true, // mark Medusa fulfillments shipped and delivered // demo: true, // sample shipments from your orders, nothing sent to InPost } plugins: [{ resolve: "@koda-plus/medusa-plugin-inpost", options: inpost }], modules: [ { resolve: "@medusajs/medusa/fulfillment", options: { providers: [ { resolve: "@medusajs/medusa/fulfillment-manual", id: "manual" }, { resolve: "@koda-plus/medusa-plugin-inpost/providers/inpost", id: "inpost", options: inpost }, ], }, }, ] - 3 Uruchom migracje i otwórz integrację w panelu Medusy.
npx medusa db:migrate
Pracuje u naszych klientów
Zobacz realizacje
Pozostałe
integracje
- Allegro Oferty, zamówienia, stany i przesyłki
- BaseLinker 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
- 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
- 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
- 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.