Marketplace

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.

Zobacz w panelu demo
InPost Von Halsky: Strona integracji w panelu Medusy, tryb demo z danymi pokazowymi.
Strona integracji w panelu Medusy, tryb demo z danymi pokazowymi.

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. 1
    Zainstaluj paczkę z npm.
    npm install @koda-plus/medusa-plugin-inpost-marketplace
  2. 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. 3
    Uruchom migracje i otwórz integrację w panelu Medusy.
    npx medusa db:migrate
Bezpłatne, 15-minutowe spotkanie

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.

Sprawdź nasze demo

Skontaktuj się z nami

Remigiusz w granatowej koszuli i okularach
Korzystam z iMessage Korzystam z WhatsApp
Adrian w szarym golfie i okularach
Korzystam z iMessage Korzystam z WhatsApp