Czy API wystarczy? Kiedy lepsza jest integracja przez pliki

0
121
Rate this post

Z tego wpisu dowiesz się:

Intuicja: co to znaczy „integrować” e‑commerce z ERP w praktyce

Co faktycznie „jeździ” między systemami

Integracja w e‑commerce nie dotyczy „magicznych połączeń systemów”, tylko bardzo konkretnych danych, które muszą regularnie migrować między ERP, sklepem internetowym, systemami płatności i kurierami. Najczęściej są to:

  • Produkty – nazwy, opisy, kategorie, zdjęcia, a przede wszystkim kody (SKU, EAN) i powiązania z magazynami.
  • Stany magazynowe – liczba dostępnych sztuk, rezerwacje, stany w wielu lokalizacjach.
  • Ceny – podstawowe, promocyjne, cenniki hurtowe, waluty, rabaty.
  • Zamówienia – koszyki zamienione w zlecenia, dane klienta, adresy, wybrane dostawy i płatności.
  • Dokumenty – faktury, paragony, korekty, dokumenty magazynowe (WZ, PZ), noty.
  • Przesyłki – numery listów przewozowych, statusy paczek, informacje o zwrotach.

W praktyce integracja to zdefiniowanie, kto jest źródłem prawdy dla danej informacji (np. stany i ceny są „własnością” ERP, a zamówienia rodzą się w sklepie) oraz jak często i jaką drogą te dane mają wędrować.

Dwa podstawowe style integracji: online vs wsadowa

Przy integracjach e‑commerce pojawiają się dwa główne podejścia do wymiany danych:

  • Integracja online (API, webservice) – dane są odczytywane i zapisywane „na życzenie”, zwykle od razu po wystąpieniu zdarzenia. Przykład: klient złożył zamówienie, system sklepu w sekundę wysyła je do ERP przez API.
  • Integracja wsadowa (pliki, eksporty, kolejki) – dane są gromadzone, a następnie przesyłane w paczkach, np. co 5 minut, co godzinę albo raz dziennie. Przykład: o 2:00 w nocy ERP generuje plik CSV ze stanami i cenami, który sklep importuje przed otwarciem sprzedaży.

Oba style mogą współistnieć w jednym projekcie. Integracja online pasuje tam, gdzie liczy się szybkość reakcji (np. rezerwacja towaru po złożeniu zamówienia), a wsadowa – gdy wolumen danych jest duży, a wymagana częstotliwość aktualizacji niższa (np. zmiany cen raz dziennie).

Różne oczekiwania firm co do „real-time”

Hasło „real-time integracja” brzmi atrakcyjnie, ale w praktyce oznacza zupełnie różne rzeczy dla różnych firm. Dla części „prawie na żywo” to:

  • aktualizacja stanów co 5 minut,
  • przesyłanie zamówień do ERP co minutę,
  • zrzut dokumentów do księgowości raz dziennie – i to jest w pełni akceptowalne.

Przed wyborem między API a plikami warto nazwać te oczekiwania wprost: jak bardzo nasze procesy cierpią, jeśli dane będą spóźnione o X minut lub godzin. Często okazuje się, że „real-time” jest tylko życzeniem, a w rzeczywistości spokojnie wystarczy integracja wsadowa.

Jak wygląda dzień bez integracji

Obraz dnia bez integracji dobrze pokazuje, po co w ogóle rozważać API czy pliki. Typowy schemat:

  • Pracownik rano eksportuje zamówienia ze sklepu do pliku i ręcznie importuje je do ERP, czasem jeszcze wszystko przepisuje.
  • Stany magazynowe aktualizowane są raz na jakiś czas „na czuja”, stąd częste sytuacje: „produkt był na stronie, ale już go nie ma na magazynie”.
  • Ceny promocyjne trzeba zmieniać osobno w ERP i w sklepie, co generuje błędy i konflikty.
  • Numery przesyłek wprowadza się ręcznie do systemu sklepu, a klienci dzwonią, bo nie widzą aktualnego statusu paczki.

Każdy z tych kroków można zautomatyzować na dwa sposoby: wydzwaniając się do API drugiego systemu albo wymieniając