Integracja InPost Von Halsky z Medusą
Von Halsky to marketplace InPostu w aplikacji InPost Mobile. Wtyczka wystawia tam produkty z Twojej Medusy, pilnuje, żeby ceny i stany się zgadzały, a zamówienia z aplikacji trafiają do Medusy jako zwykłe zamówienia, każde tylko raz. Zwroty, reklamacje i wyniki kanału masz w tym samym panelu.
Co dokładnie
robi ta integracja
-
Produkty gotowe do wystawienia
Każdy wariant to osobna oferta. Wtyczka zbiera z Medusy wszystko, czego wymaga InPost: EAN albo markę z kodem producenta, opis, do 20 zdjęć, wymiary i wagę, stawkę VAT i dane producenta do GPSR. Jeśli czegoś brakuje, panel mówi wprost czego, zanim spróbujesz wystawić ofertę.
-
Kategorie bez ręcznej roboty
Kategorię z Medusy przypisujesz do kategorii InPost raz i dostają ją wszystkie jej produkty. Pojedynczemu produktowi możesz wybrać inną albo przyjąć tę, którą InPost podpowiada po kodzie EAN. Wymagane parametry kategorii uzupełniasz w panelu.
-
Ceny i stany zawsze aktualne
Zaznaczone oferty wystawiasz jednym przyciskiem, a potem co 5 minut zmiany cen i stanów z Medusy same trafiają do InPost. Gdy towar się skończy, oferta się zamyka, a gdy wróci na stan, otwiera się ponownie. Cena w aplikacji to cena z Medusy z VAT i Twoim narzutem.
-
Zamówienia w Medusie, bez dubli
Opłacone zamówienie z aplikacji InPost przenosisz do Medusy jednym kliknięciem albo przychodzi samo co 5 minut, jeśli włączysz automatyczny import. Trafia do osobnego kanału sprzedaży, z zarezerwowanym towarem i zapisaną płatnością, zawsze tylko raz. Paczkę nadajesz w ShipX na e-mail kupującego z zamówienia, a InPost sam ją do niego przypisze.
-
Zwroty i reklamacje w jednym miejscu
Przyjmujesz albo odrzucasz zwrot, odpowiadasz na reklamację i oddajesz pieniądze w całości lub w części, bez przełączania się do panelu InPost. Dane kontaktowe kupującego wtyczka pobiera tylko do podglądu i nigdzie ich nie zapisuje.
-
Wyniki kanału
Widzisz, ile zarabia Von Halsky na tle reszty sprzedaży: przychód, liczbę zamówień, średni koszyk, oferty, które się nie sprzedają, najczęstsze powody odrzucenia ofert, czas od płatności do nadania paczki oraz zwroty i reklamacje z przyczynami.
Jak pilnuje
Twoich danych
-
Nic nie dzieje się bez Ciebie
Wystawienie, zmianę i zamknięcie oferty, promocje, decyzje o zwrotach i zwroty pieniędzy zawsze zatwierdza człowiek. Same idą tylko ceny i stany (da się to wyłączyć), a automatyczny import zamówień jest domyślnie wyłączony.
-
Dane dostępowe pod kluczem
Sekret aplikacji nigdy nie pojawia się w panelu w całości, w logach i komunikatach błędów jest zamaskowany, a tokeny dostępu wtyczka trzyma tylko w pamięci.
-
Utratę połączenia widać od razu
InPost wyłącza oferty integracji, która straciła połączenie. Dlatego gdy InPost dwa razy z rzędu odrzuci dane dostępowe, panel pokazuje czerwony komunikat z godziną i przyczyną.
-
Zamówienia nie do podrobienia
Kupujący w Twoim sklepie nie dopisze do koszyka ani do konta pól, które udawałyby zamówienie z marketplace'u. O tym, co przyszło z InPost, decydują wyłącznie tabele wtyczki.
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-marketplace - 2 Dopisz wtyczkę do medusa-config.ts.
const vonhalsky = { environment: process.env.VONHALSKY_ENV, // "sandbox" (default) or "live" sandbox: { clientId: process.env.VONHALSKY_SANDBOX_CLIENT_ID, clientSecret: process.env.VONHALSKY_SANDBOX_CLIENT_SECRET, organizationId: process.env.VONHALSKY_SANDBOX_ORGANIZATION_ID, }, live: { clientId: process.env.VONHALSKY_LIVE_CLIENT_ID, clientSecret: process.env.VONHALSKY_LIVE_CLIENT_SECRET, organizationId: process.env.VONHALSKY_LIVE_ORGANIZATION_ID, }, markupPercent: process.env.VONHALSKY_MARKUP_PERCENT, // the admin setting wins // syncPriceStock: true, // writer: price and stock of listed offers // demo: true, // a simulated marketplace, nothing sent to InPost } plugins: [{ resolve: "@koda-plus/medusa-plugin-inpost-marketplace", options: vonhalsky }] - 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
- DPD Kurier DPD, punkty Pickup i pobranie na API DPD Polska
- 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.