API marketplace BRW – co sprawdzić przed integracją systemu sprzedaży

Pytania do zespołu platformy przed integracją

Rozmowa z zespołem marketplace’u przed rozpoczęciem prac pozwala uniknąć kosztownych niespodzianek. Przygotuj listę konkretnych pytań – najlepiej razem z programistą lub integratorem, który będzie realizował projekt.

1. Dostęp i uprawnienia – jak uzyskać dostęp do API, czy jest środowisko testowe, jakie są zasady klucza dostępu.

2. Dokumentacja – gdzie jest aktualna dokumentacja, jak często się zmienia i jak informowane są zmiany.

3. Zakres funkcji – które obszary są dostępne przez API, a które tylko w panelu.

4. Limity – ile zapytań można wykonać w określonym czasie, jak często aktualizować stany i ceny.

5. Formaty danych – jak przekazywać kategorie, atrybuty, warianty, zdjęcia, terminy realizacji.

6. Wysyłka wielopaczkowa – czy można przekazać kilka numerów przesyłek do jednego zamówienia.

7. Obsługa błędów – jak platforma informuje o odrzuconych ofertach i błędach importu.

8. Wsparcie techniczne – do kogo zgłaszać problemy z integracją i w jakim czasie są rozwiązywane.

Kanały kontaktu z platformą i sposób przygotowania zgłoszeń omawiamy w tekście o kontakcie z marketplace BRW dla sprzedawców.

[#tip] Poproś o dostęp do środowiska testowego i zacznij od małego zakresu: pobranie zamówień i przekazanie numeru przesyłki. Te dwie operacje szybko pokażą, jak działa API, jakie są opóźnienia i jak wygląda obsługa błędów – zanim zainwestujesz w pełną integrację katalogu.

Bezpośrednie API czy system pośredniczący

Masz dwie główne drogi integracji. Pierwsza to własny łącznik między Twoim systemem (ERP, sklepem, WMS) a API marketplace’u. Druga to system do sprzedaży wielokanałowej, który ma gotową integrację z platformą, a Ty łączysz z nim swój ERP – często też przez API, ale jedno, a nie kilka.

Dla większości sprzedawców mebli, którzy sprzedają w kilku kanałach, system pośredniczący jest szybszą i tańszą drogą. Bezpośrednie API ma sens przy bardzo dużym wolumenie, nietypowej logice (np. złożone reguły terminów produkcji) i własnym zespole IT, który utrzyma integrację. Często stosuje się też model mieszany: system wielokanałowy obsługuje marketplace’y, a ERP komunikuje się z nim przez jego API. Możliwości takiego podejścia opisujemy w tekście o API Base, a szerzej o łączeniu ERP z marketplace – w artykule o integracji ERP producenta mebli z marketplace.

Wykres – bezpośrednie API czy system pośredniczący: kiedy który wybrać. [#chart:br93]

Plan wdrożenia integracji

1. Mapa danych – co, w którą stronę i jak często ma płynąć między systemami.

2. Uporządkowanie katalogu – SKU, warianty, atrybuty, dane paczek.

3. Dokumentacja i dostęp – uzyskanie dokumentacji, kluczy i środowiska testowego.

4. Prototyp – zamówienia i wysyłki, potem stany i ceny, na końcu katalog.

5. Testy scenariuszy – produkt na stanie i na zamówienie, wielopaczkowy, anulacja, zwrot.

6. Monitoring – logi, alerty o błędach, codzienny raport rozbieżności przez pierwsze tygodnie.

7. Dokumentacja wewnętrzna – kto utrzymuje integrację i jak reagować na zmiany API.

[#przyklad] Producent mebli z kilkoma tysiącami indeksów rozważał własną integrację ERP z marketplace BRW. Po rozmowie z platformą i analizie okazało się, że potrzebuje też obsługi dwóch innych marketplace’ów. Wybrał model mieszany: system wielokanałowy z gotowymi integracjami obsługuje oferty i zamówienia na wszystkich platformach, a ERP przekazuje do niego stany i terminy przez API. Zamiast trzech łączników utrzymuje jeden.

Bezpieczeństwo i dostęp do API

Klucz dostępu do API marketplace’u daje możliwość zmiany cen, stanów i ofert oraz wglądu w dane klientów z zamówień. Dlatego trzeba go chronić tak samo jak hasło do konta bankowego. Przechowuj klucze w bezpiecznym miejscu, a nie w arkuszach czy wiadomościach e-mail, nadawaj dostęp tylko osobom i systemom, które go potrzebują, i zmieniaj klucze, gdy z projektem rozstaje się programista lub firma zewnętrzna.

• Osobne klucze dla środowiska testowego i produkcyjnego – błąd w teście nie zmieni cen w prawdziwych ofertach.

• Ograniczenie uprawnień – jeśli platforma na to pozwala, nadaj integracji tylko potrzebny zakres.

• Logowanie operacji – zapis, kto i kiedy zmienił ceny czy stany przez API.

• Ochrona danych osobowych – dane klientów z zamówień przetwarzaj zgodnie z przepisami i zasadami platformy.

Jeśli integrację realizuje firma zewnętrzna, ustal w umowie, kto jest właścicielem kodu, gdzie przechowywane są klucze i jak wygląda przekazanie projektu po zakończeniu współpracy. Przy sprzedaży w wielu kanałach z jednego systemu warto zajrzeć też do tekstu o multichannel z Base, gdzie opisujemy, jak ograniczyć liczbę osobnych połączeń do minimum.

Najczęstsze błędy przy integracji z marketplace

• Brak mapy danych – programista łączy systemy „jak się da”, a potem okazuje się, że terminy czy warianty nie przechodzą poprawnie.

• Zbyt rzadka synchronizacja stanów – oszczędność zapytań kosztem sprzedaży bez pokrycia.

• Brak obsługi błędów – odrzucone oferty i nieprzekazane numery przesyłek nikt nie zauważa przez tygodnie.

• Integracja bez właściciela – po wdrożeniu nikt nie odpowiada za zmiany w API i monitoring.

• Pominięcie scenariuszy brzegowych – meble wielopaczkowe, anulacje, zmiany adresu, częściowe zwroty.

Doświadczenia z integracjami innych platform opisujemy w tekstach o API Media Expert i API Erli. Jeśli integracja wymaga prac programistycznych lub infrastrukturalnych, pomocne może być nasze wsparcie informatyczne, a wdrożenie systemu wielokanałowego realizujemy w ramach usługi Base.

Wykres – plan wdrożenia integracji z marketplace krok po kroku. [#chart:br93b]

[#checklista] Przed integracją z API marketplace BRW: masz aktualną dokumentację i dostęp testowy; znasz limity i zakres funkcji; spisałeś mapę danych; katalog ma uporządkowane SKU, warianty i dane paczek; wiesz, jak przekazać kilka numerów przesyłek; wybrałeś model – API, system pośredniczący lub mieszany; zaplanowałeś testy scenariuszy i monitoring; integracja ma właściciela.

Najczęściej zadawane pytania

Czy marketplace BRW udostępnia API dla sprzedawców?

Dostęp do API i jego zakres potwierdź bezpośrednio z zespołem platformy – zwykle uzyskuje się go w procesie wdrożenia. Alternatywą jest gotowa integracja przez system wielokanałowy, np. Base, który deklaruje obsługę Black Red White.

Na jakiej technologii działa marketplace BRW?

Firma wdrożeniowa Ideo wspomina o integracji platformy z rozwiązaniem Mirakl, a Base oznacza integrację z Black Red White tagiem Mirakl. Traktuj to jako wskazówkę – szczegóły techniczne potwierdź w dokumentacji od platformy.

Co lepsze – własne API czy system wielokanałowy?

Dla większości sprzedawców mebli sprzedających w kilku kanałach system wielokanałowy jest szybszy i tańszy w utrzymaniu. Własne API ma sens przy dużym wolumenie, nietypowej logice i zespole IT, który utrzyma integrację.

Jak często synchronizować stany przez API?

Tak często, jak pozwalają limity platformy i jak wymaga tego Twoja sprzedaż – przy produktach magazynowych zwykle co kilka lub kilkanaście minut albo zdarzeniowo. Przy meblach na zamówienie ważniejsze są poprawne reguły stanów wirtualnych i terminów.

Ile trwa integracja z API marketplace’u?

Zależy od zakresu i jakości danych. Prosty prototyp zamówień i wysyłek może powstać szybko, ale pełna integracja katalogu z wariantami i terminami, testy i monitoring zwykle zajmują kilka tygodni lub dłużej.

Kto powinien utrzymywać integrację po wdrożeniu?

Konkretna osoba lub zespół – wewnętrzny dział IT, integrator albo dostawca systemu. Ktoś musi monitorować błędy, reagować na zmiany API i aktualizować mapowania kategorii i atrybutów.

Podsumowanie

Integracja z API marketplace BRW może znacząco odciążyć obsługę ofert i zamówień, ale wymaga przygotowania: aktualnej dokumentacji i dostępu testowego, mapy danych, uporządkowanego katalogu i jasnej decyzji, czy budować własny łącznik, czy skorzystać z systemu pośredniczącego. Dla mebli szczególnie ważne są terminy realizacji, wysyłka wielopaczkowa i częsta synchronizacja stanów. Jeśli planujesz integrację swojego systemu z marketplace BRW, umów się na bezpłatną konsultację – wdrażamy i obsługujemy sprzedaż na marketplace’ach, w tym na marketplace Black Red White.