Integracja Shopera z Allegro i ERP - dostępne API i typowe problemy

Integracja Shoper z ERP - jak połączyć sklep z systemem księgowo-magazynowym

Integracja Shopera z ERP najczęściej obejmuje cztery przepływy: produkty i ceny z ERP do sklepu, stany magazynowe z ERP do sklepu, zamówienia ze sklepu do ERP oraz statusy i numery dokumentów z powrotem do sklepu. Dla popularnych systemów, takich jak Subiekt, Comarch ERP Optima czy enova365, istnieją gotowe konektory - jako aplikacje w Shoper App Store albo jako usługi firm integracyjnych. Alternatywą jest połączenie ERP z integratorem, który obsługuje już Shopera i Allegro.

Przy planowaniu warto odpowiedzieć na kilka pytań, zanim zapadnie decyzja o narzędziu:

1. Który system jest źródłem prawdy dla nazw, opisów i zdjęć, a który dla cen i stanów?

2. Czy zamówienia z Allegro mają trafiać do ERP bezpośrednio, przez Shopera, czy przez integrator?

3. Jaki dokument powstaje w ERP dla zamówienia ze sklepu, a jaki dla zamówienia z Allegro?

4. Jak mapowane są warianty produktów, np. rozmiary i kolory, na kartoteki w ERP?

5. Jak często muszą się aktualizować stany, żeby nie sprzedawać towaru, którego nie ma?

Odpowiedzi na te pytania decydują o kształcie całej integracji. Przykładowo, jeśli zamówienia z Allegro mają trafiać do ERP przez Shopera, sklep staje się pośrednikiem i każdy błąd importu w Shoperze zatrzymuje też dokumenty w ERP. Jeśli idą przez integrator, Shoper i Allegro są równorzędnymi kanałami, a ERP widzi jeden strumień zamówień. Szczegóły połączenia ze sklepem dla popularnego systemu opisujemy w artykule integracja Subiekta GT ze sklepem internetowym.

Webhooki Shopera w integracji z ERP

Webhooki skracają czas, w jakim zamówienie ze sklepu trafia do ERP, ale nie zastępują okresowego sprawdzania. Jeśli serwer integracji jest chwilowo niedostępny, powiadomienie może nie dotrzeć. Dlatego integracja powinna weryfikować podpis każdej wiadomości, zapisywać identyfikatory przetworzonych zamówień, żeby nie tworzyć duplikatów, i co jakiś czas pobierać przez API listę zamówień z ostatnich godzin, żeby wyłapać te, o których nie dostała powiadomienia.

To, czy wystarczy wbudowana integracja z Allegro, czy trzeba sięgnąć po integrator lub własne rozwiązanie, najlepiej ocenić po kilku prostych kryteriach.

[#chart:wpr20b]

Typowe problemy z integracją Shopera z Allegro i ERP

Większość zgłoszeń, z którymi przychodzą do nas sprzedawcy na Shoperze, ma kilka powtarzających się przyczyn. Ich wspólny mianownik to brak jasnych reguł, który system za co odpowiada.

• Dwa systemy importują te same zamówienia z Allegro - np. wbudowana integracja Shopera i integrator działają równolegle. Skutek to zdublowane zamówienia i podwójnie zdjęte stany.

• Warianty bez unikalnych kodów - w Shoperze każdy wariant ma osobny rekord stanu. Jeśli warianty nie mają unikalnego kodu lub EAN, integracja nie ma po czym połączyć ich z ERP i ofertami Allegro.

• Ceny brutto i netto - ERP przechowuje ceny netto, sklep pokazuje brutto, a integracja źle przelicza lub zaokrągla. Różnice po kilka groszy wychodzą przy fakturach.

• Mapowanie statusów - statusy zamówień w Shoperze, na Allegro i w ERP mają różne nazwy i znaczenie. Bez tabeli mapowania zamówienie opłacone w jednym systemie wisi jako nieopłacone w drugim.

• Masowe aktualizacje i limity - przy imporcie całego cennika integracja przekracza limit zapytań i część zmian się nie zapisuje.

• Parametry Allegro - oferty Allegro wymagają parametrów kategorii, których nie ma w produkcie w Shoperze. Bez mapowania oferty nie wystawiają się albo trafiają do złej kategorii.

[#uwaga] Zanim włączysz nową integrację z Allegro lub ERP, wyłącz albo ogranicz starą. Najczęstsza przyczyna chaosu w zamówieniach to okres przejściowy, w którym dwa systemy naraz importują zamówienia albo zapisują stany. Plan migracji powinien mieć konkretną datę i godzinę przełączenia.

Poniżej najczęstsze objawy wraz z przyczynami i poprawkami, od których zaczynamy diagnozę.

[#chart:wpr20c]

Własna integracja na Shoper API - kiedy ma sens

Gotowe rozwiązania pokrywają większość potrzeb. Własna integracja ma sens, gdy proces wyraźnie od nich odbiega: ceny w sklepie i na Allegro liczone są według reguł zależnych od dostawcy i marży, katalog jest zasilany z kilku hurtowni, produkty powstają z konfiguratora albo ERP jest systemem branżowym bez konektora. Wtedy programista pisze usługę, która korzysta z Shoper API, Allegro REST API i interfejsu ERP, a całą logikę biznesową trzyma w jednym miejscu.

Taka integracja wymaga kilku elementów, które odróżniają ją od jednorazowego skryptu:

• kolejki zmian z kontrolą tempa, żeby nie przekraczać limitów API,

• obsługi webhooków Shopera z weryfikacją podpisu i okresowego uzgadniania przez API,

• logów każdej operacji i powiadomień o błędach,

• środowiska testowego - osobnego sklepu lub kopii, na której można sprawdzić zmiany przed wdrożeniem,

• dokumentacji mapowania pól, statusów i wariantów, żeby kolejny programista nie zaczynał od zera.

Wdrożenie integracji Shoper ERP krok po kroku

Niezależnie od wybranej drogi kolejność prac jest podobna. Największe ryzyko nie leży w samym programowaniu, tylko w przejściu ze starego sposobu pracy na nowy, kiedy zamówienia wpływają bez przerwy.

1. Inwentaryzacja danych - sprawdzenie, czy produkty i warianty w Shoperze mają unikalne kody i EAN zgodne z ERP i ofertami Allegro.

2. Mapa przepływów - które dane płyną skąd dokąd, jak często i który system jest ich źródłem.

3. Mapowanie statusów, płatności i dostaw - tabela, która każdemu statusowi i metodzie w jednym systemie przypisuje odpowiednik w drugim.

4. Testy na kopii - zamówienie z wariantem, rabatem, pobraniem, fakturą na firmę, anulacją i zwrotem.

5. Przełączenie - ustalona data i godzina, wyłączenie starego importu, włączenie nowego, kontrola pierwszych zamówień.

6. Monitoring - raport zamówień, które nie trafiły do ERP, i powiadomienia o błędach integracji.

Jak Vinson pomaga przy integracji Shopera z Allegro i ERP

Vinson jest autoryzowanym partnerem Shoper i certyfikowanym partnerem Base. Nasi programiści konfigurują wbudowaną integrację Shopera z Allegro, wdrażają integratory i łączą je z ERP, a tam, gdzie gotowe narzędzia nie wystarczają, piszą własne integracje na Shoper API, Allegro REST API i interfejsach systemów ERP. Zaczynamy od mapy danych i ustalenia źródeł prawdy, potem planujemy przełączenie bez dublowania zamówień i ustawiamy monitoring. Więcej o współpracy przeczytasz na stronie Wsparcie programistyczne dla e-commerce, a o wdrożeniach integratora - na stronie wdrożenie Base.

Najczęściej zadawane pytania

Czy Shoper ma API?

Tak, Shoper udostępnia REST API, przez które można odczytywać i zmieniać produkty, warianty i stany, zamówienia, klientów, kategorie i inne dane sklepu. Dostęp uzyskuje się przez konto administratora z uprawnieniem do WebAPI albo przez aplikację z Shoper App Store korzystającą z OAuth. Shoper obsługuje też webhooki o zdarzeniach w sklepie.

Jak zintegrować Shopera z Allegro?

Najprościej przez wbudowaną integrację Shopera z Allegro, która pozwala wystawiać oferty, importować zamówienia i synchronizować stany. Przy sprzedaży w wielu kanałach lub pracy z ERP lepiej sprawdza się integrator, np. Base. Własną integrację na API buduje się przy nietypowych procesach.

Jak połączyć Shopera z Subiektem lub Comarchem?

Można użyć gotowego konektora, np. aplikacji z Shoper App Store, połączyć ERP z integratorem obsługującym Shopera albo zlecić własną integrację. Przed wyborem trzeba ustalić, który system jest źródłem cen, stanów i opisów oraz jakie dokumenty mają powstawać w ERP.

Dlaczego zamówienia z Allegro dublują się w Shoperze?

Najczęściej dlatego, że zamówienia importują jednocześnie dwa systemy, np. wbudowana integracja Shopera i integrator. Trzeba wybrać jedno źródło importu, wyłączyć drugie i usunąć duplikaty, pilnując, żeby nie zostały podwójnie zdjęte stany.

Czy limity Shoper API utrudniają integrację z ERP?

Przy dobrze napisanej integracji nie. Limity mają znaczenie przy masowych aktualizacjach, np. cennika tysięcy produktów. Integracja powinna kolejkować zmiany, kontrolować tempo zapytań, ponawiać je po błędzie 429 i wysyłać tylko dane, które faktycznie się zmieniły. Warto też planować duże aktualizacje poza godzinami największego ruchu w sklepie, żeby nie konkurowały z bieżącą synchronizacją zamówień.

Integracja Shopera z Allegro i ERP działa stabilnie wtedy, gdy każda dana ma jedno źródło, a integracja szanuje limity API i pilnuje wariantów oraz statusów. Jeśli chcesz uporządkować połączenia w swoim sklepie, sprawdź wsparcie programistyczne Vinson. O tym, jak utrzymać zgodne stany we wszystkich kanałach, piszemy we wpisie synchronizacja stanów magazynowych między sklepem a marketplace.