Integracja InPost Buy przez API - kiedy warto napisać własne połączenie

Jakie dane trzeba przesyłać przez API InPost Buy

Niezależnie od szczegółów dokumentacji, każda integracja marketplace'u obsługuje te same grupy danych. Zaplanuj je z wyprzedzeniem, bo od nich zależy zakres prac i koszt utrzymania.

[#chart:ibu37b]

Szczególnie ważne są dane produktowe. Jeśli warianty są nieuporządkowane, API przeniesie ten bałagan do aplikacji. Zasady grupowania rozmiarów, kolorów i zestawów opisujemy we wpisie warianty produktów w InPost Buy.

Czy przez API ustawię inną cenę w InPost Buy niż w sklepie?

Tak - to jedna z zalet własnej integracji. Możesz przesyłać do InPost Buy cenę z osobnego cennika albo wyliczaną według reguły, np. z uwzględnieniem kosztów kanału. Jak ustalić ceny w aplikacji względem innych kanałów, piszemy we wpisie ceny w InPost Buy względem Allegro i własnego sklepu.

Jak zaplanować wdrożenie integracji InPost Buy przez API

Najwięcej problemów przy własnych integracjach wynika z pominięcia etapów. Programista zaczyna od zamówień, bo to najciekawsze, a po kilku tygodniach okazuje się, że katalog nie przechodzi walidacji. Poniżej kolejność, która ogranicza takie ryzyko.

[#chart:ibu37c]

1. Zbierz wymagania: jakie dane, w jakim kierunku, jak często i kto odpowiada za każdy obszar.

2. Uzyskaj dostęp do dokumentacji i środowiska testowego - sprawdź w Merchant Portal, jak InPost udostępnia API sprzedawcom.

3. Przygotuj mapowanie danych: kategorie, parametry, warianty, statusy zamówień.

4. Zbuduj wysyłkę katalogu i stanów, a następnie przetestuj ją na małej partii produktów.

5. Dodaj pobieranie zamówień i odsyłanie statusów, przetestuj pełną ścieżkę z zamówieniem testowym.

6. Wprowadź monitoring: logi błędów, alerty o braku synchronizacji, raport rozbieżności stanów.

7. Uruchom pełny katalog i zaplanuj przeglądy po zmianach w dokumentacji API.

[#tip] Zaplanuj mechanizm awaryjny. Jeśli integracja przestanie działać, ktoś musi wiedzieć, jak szybko wstrzymać sprzedaż lub wyzerować stany w Merchant Portal. Lepiej nie sprzedawać przez kilka godzin niż anulować kilkadziesiąt zamówień.

API czy Base - co wybrać do InPost Buy

Dla większości sklepów rozsądniejszym wyborem jest integracja przez system wielokanałowy. Base łączy się z wieloma platformami sklepowymi i marketplace'ami, więc InPost Buy staje się kolejnym kanałem w tym samym panelu. Konfiguracja nie wymaga programisty, a za aktualizacje połączenia odpowiada dostawca systemu.

API wygrywa wtedy, gdy Twój system jest nietypowy, a przeniesienie procesów do Base lub innego narzędzia oznaczałoby więcej pracy niż napisanie własnego połączenia. Wybierając API, bierzesz na siebie koszt programisty przy wdrożeniu i przy każdej zmianie po stronie platformy. Wybierając gotową integrację, płacisz abonament narzędzia, ale zyskujesz szybki start i mniejsze ryzyko techniczne.

• Czas wdrożenia - gotowa integracja to zwykle konfiguracja i testy, API to projekt programistyczny z etapami.

• Elastyczność - API pozwala obsłużyć każdy proces, gotowa integracja działa w ramach funkcji narzędzia.

• Utrzymanie - przy API odpowiadasz za nie Ty, przy gotowej integracji dostawca systemu.

• Wiele kanałów - system wielokanałowy obsłuży też Allegro i sklep, API do InPost Buy obsłuży tylko ten jeden kanał.

Z czego składa się koszt integracji InPost Buy przez API

Koszt własnej integracji trudno porównać z abonamentem gotowego narzędzia, bo rozkłada się w czasie. Na etapie wdrożenia płacisz za analizę, programowanie i testy. Później dochodzi utrzymanie: poprawki po zmianach w API platformy, aktualizacje Twojego systemu, obsługa błędów i rozbudowa o nowe funkcje. Przy porównaniu z integracją przez system wielokanałowy policz oba scenariusze w perspektywie co najmniej roku, a nie tylko pierwszego miesiąca.

• Analiza i specyfikacja - opis danych, mapowań i zasad, bez którego programista będzie zgadywał.

• Programowanie - wysyłka katalogu, stanów i cen, pobieranie zamówień, obsługa statusów.

• Testy - na małej partii produktów i na zamówieniach testowych, z poprawkami po każdym etapie.

• Monitoring - logi, alerty i raport rozbieżności, które pozwalają wykryć problem przed klientem.

• Utrzymanie - reakcja na zmiany w dokumentacji API, awarie i nowe potrzeby sprzedaży.

Ukrytym kosztem bywa też czas zespołu sprzedaży. Każda awaria własnej integracji oznacza ręczne sprawdzanie zamówień i stanów. Dlatego przed decyzją ustal, jak szybko programista jest w stanie zareagować i kto przejmie obsługę, gdy będzie niedostępny.

Bezpieczeństwo i stabilność integracji z InPost Buy

Integracja przez API ma dostęp do danych zamówień, w tym danych klientów, więc jej bezpieczeństwo to obowiązek, a nie dodatek. Klucze dostępowe przechowuj poza kodem i z ograniczonym dostępem, a uprawnienia nadawaj tylko w zakresie potrzebnym do działania integracji. Dane osobowe klientów przetwarzaj zgodnie z RODO i przechowuj tylko tak długo, jak to konieczne.

Stabilność zależy głównie od tego, jak integracja radzi sobie z błędami. Dobra integracja ponawia nieudane wysyłki, nie gubi zamówień przy chwilowym braku połączenia i zapisuje każde zdarzenie w logu. Zła integracja działa poprawnie tylko wtedy, gdy wszystko jest w porządku - a problemy wychodzą w szczycie sprzedaży, kiedy obciążenie jest największe.

Jak Vinson pomaga przy integracji InPost Buy

Vinson to agencja e-commerce z Bochni działająca od 2021 roku. Jesteśmy certyfikowanym partnerem Base, autoryzowanym partnerem Shoper, Allegro Ads Partner+, Google Partner i Meta Business Partner. Współpracowało z nami ponad 500 firm, a klienci oceniają nas na 4,9/5 ze 171 opinii. W ramach obsługi sprzedaży na InPost Buy pomagamy:

• ocenić, czy potrzebujesz własnego API, czy wystarczy integracja przez Base lub inny system,

• przygotować specyfikację danych dla programisty: kategorie, warianty, statusy, reguły cen i stanów,

• uporządkować katalog przed pierwszym wysłaniem do aplikacji,

• przetestować ścieżkę zamówienia i oferty po stronie aplikacji InPost Mobile,

• wspierać sprzedaż w nowym kanale kampaniami reklamowymi.

Niezależnie od tego, czy wybierzesz API, czy gotową integrację, najlepsze wyniki daje połączenie technologii z porządkiem w danych i jasnym podziałem odpowiedzialności w zespole. Integracja jest tak dobra, jak katalog i procesy, które obsługuje.

Najczęściej zadawane pytania

Kto powinien utrzymywać integrację InPost Buy przez API?

Najlepiej programista, który ją napisał lub dobrze zna Twój system, dostępny na stałe, a nie tylko przy wdrożeniu. Po stronie sprzedaży potrzebna jest osoba, która codziennie sprawdza log błędów i zgłasza problemy. Bez takiego podziału awaria może trwać kilka dni, zanim ktoś ją zauważy.

Czy InPost Buy udostępnia API dla sprzedawców?

Informacje o dostępie do API, dokumentacji i warunkach technicznych znajdziesz w Merchant Portal lub uzyskasz od opiekuna InPost Buy. Zakres udostępnianych funkcji może się zmieniać, dlatego przed planowaniem projektu sprawdź aktualną dokumentację (stan na maj 2026).

Ile trwa wdrożenie własnej integracji z InPost Buy?

To zależy od złożoności Twojego systemu, liczby produktów i zakresu danych. Prosta integracja katalogu i zamówień to krótszy projekt, a obsługa wielu magazynów, zwrotów i niestandardowych cen wydłuża prace. Do czasu programowania doliczaj zawsze testy i poprawki po pierwszych zamówieniach.

Czy API jest lepsze niż integracja przez Base?

Nie zawsze. API daje większą elastyczność, ale wymaga programisty i stałego utrzymania. Base pozwala podłączyć InPost Buy bez programowania i obsłużyć w jednym panelu także inne kanały. Dla typowego sklepu szybszym i bezpieczniejszym wyborem jest zwykle gotowa integracja.

Jakie dane muszę przesyłać przez API do InPost Buy?

Podstawą są produkty z kartami, stany magazynowe i ceny wysyłane do platformy oraz zamówienia pobierane do Twojego systemu. Do tego dochodzą statusy zamówień, numery przesyłek oraz obsługa zwrotów i anulacji. Dokładny format danych określa dokumentacja API dostępna dla sprzedawców.

Czy prowizja w InPost Buy zależy od metody integracji?

Prowizję i opłaty określa regulamin InPost Buy, a nie sposób połączenia. Na start InPost komunikuje prowizję 0%, ale aktualne warunki sprawdź w regulaminie i w Merchant Portal (stan na maj 2026 - sprawdź aktualny regulamin). Metoda integracji wpływa natomiast na Twoje koszty narzędzi lub programisty.

Zastanawiasz się, czy własne API to dobry pomysł dla Twojego sklepu? Zobacz, jak prowadzimy sprzedaż na InPost Buy z Vinson i jak pomagamy wybrać metodę integracji dopasowaną do katalogu i zespołu.