Integracja ERP ze sklepem: ceny, stany i zamówienia
Zespół przepisuje zamówienia ze sklepu do ERP, a ceny i stany w sklepie nie nadążają za ERP? Ustalamy, który system odpowiada za które dane, i wdrażamy wymianę przez API albo pliki: ceny i stany trafiają z ERP do sklepu, a zamówienia wracają do ERP bez przepisywania.
Wymiana przez BaseLinkerstany ok. 115 tys. produktów i wariantów z BaseLinkera, zamówienia wracają do BaseLinkera bez przepisywaniaSportina B2B · Magento + BaseLinker- cena bazowa
- stan magazynowy
- status i dokument
- cena · ERP → sklep Cena bazowa dobowo lub przy zmianie
- stan · ERP → sklep Stan magazynowy co kilkanaście–kilkadziesiąt minut
- zamówienie · sklep → ERP Zamówienie z pozycjami na zdarzenie
- status · ERP → sklep Status i numer dokumentu na zdarzenie, wraca do zamówienia w sklepie
- opis · bez synchronizacji Opis marketingowy zostaje w sklepie; import z ERP go nie nadpisuje
- opis marketingowy
- zamówienie
Który system odpowiada za dane
Zwykle zaczyna się od pracy ręcznej: zamówienia ze sklepu ktoś przepisuje do ERP, stany w sklepie nie zgadzają się z magazynem, a cena zmieniona w ERP nie dociera do sklepu albo dociera z opóźnieniem. Źródło prawdy to system, którego wartość wygrywa, gdy oba systemy mają inną. Matrycę ustalamy przed wdrożeniem i na niej opieramy całą wymianę. Poniżej najczęstszy układ – konkretny projekt może mieć inny, ale każde pole musi mieć jedną odpowiedź.
Trzy najważniejsze pola: cena, stan i zamówienie
| Typ danych | System główny | Kierunek | Częstotliwość |
|---|---|---|---|
| Cena bazowa i cenniki kontrahentów | ERP | ERP → sklep | dobowo lub przy zmianie |
| Stan magazynowy | ERP | ERP → sklep | co kilkanaście–kilkadziesiąt minut |
| Zamówienia | sklep | sklep → ERP | na zdarzenie |
Pełna matryca: osiem typów danych
system główny, odbiorczy, kierunek i częstotliwość – także pola bez synchronizacji
| Typ danych | System główny | System odbiorczy | Kierunek | Częstotliwość |
|---|---|---|---|---|
| Kartoteka towaru, SKU, EAN | ERP | sklep | jednokierunkowo | przy zmianie |
| Cena bazowa i cenniki kontrahentów | ERP | sklep | jednokierunkowo | dobowo lub przy zmianie |
| Promocje i ceny czasowe | sklep | — | bez synchronizacji | — |
| Stan magazynowy | ERP | sklep | jednokierunkowo | co kilkanaście–kilkadziesiąt minut |
| Opisy, zdjęcia, treści SEO | sklep | — | bez synchronizacji | — |
| Zamówienia | sklep | ERP | jednokierunkowo | na zdarzenie |
| Status realizacji i dokument sprzedaży (numer dokumentu wraca do zamówienia w sklepie) | ERP | sklep | jednokierunkowo | na zdarzenie |
| Dane kontrahenta B2B | ERP | sklep | jednokierunkowo | przy zmianie |
Dane i kierunek, aktualność, transport – w tej kolejności
Integracja ma usunąć przepisywanie dla uzgodnionych danych, a nie połączyć „wszystko ze wszystkim”. Dlatego najpierw ustalamy, co płynie i w którą stronę, potem jak często, a dopiero na końcu – czym.
-
01
Dane i kierunek
Co integracja obejmuje, a co zostaje poza nią.
Z ERP do sklepukartoteka towaru (SKU, EAN, warianty), ceny bazowe i cenniki kontrahentów, stany magazynowe, dane kontrahentów B2B – w zakresie, który ERP udostępnia.Ze sklepu do ERPzamówienia z pozycjami, danymi do dokumentu i sposobem dostawy, w formacie, który przyjmuje ERP.Z ERP z powrotem do sklepustatus realizacji i numer dokumentu sprzedaży, jeśli ERP je udostępnia i są potrzebne w obsłudze zamówienia.Sposób wymianyAPI systemu, wymiana plików CSV/XML w uzgodnionym katalogu albo warstwa pośrednia, np. BaseLinker lub własny proces z kolejką i logiem.Poza zakresem integracjikonfiguracja samego ERP, licencje i moduły dostawcy ERP oraz zmiany księgowe. Te ustawienia zostają po stronie osoby lub firmy, która opiekuje się ERP – integracja z nich korzysta. -
02
Aktualność
Nie każde pole musi być aktualne co minutę. Częstsza wymiana to więcej zapytań, kolejek i miejsc, w których coś może się nie udać, dlatego tryb dobieramy osobno dla każdego typu danych.
Batch- łatwy do powtórzenia
- prosty audyt
- jasne okno przetwarzania
Na zdarzenie- szybka reakcja
- ale wymaga kolejek i ochrony przed duplikatami
Hybryda- zamówienia na zdarzenie
- stany cyklicznie
- kartoteka nocą
Każdy tryb ma określone, co się dzieje po błędzie: ponowienie, wyjątek, alert. -
03
Transport: API, XML czy CSV
Wybór zależy od tego, co udostępnia ERP.
WarunekRekomendacjaUwagaERP ma REST/SOAPAPIdwukierunkowość możliwatylko eksport plikówXML/CSVpotrzebny harmonogram i archiwumdane zagnieżdżoneXML/JSONCSV wymaga osobnego wiersza na wariant z kolumną produktu nadrzędnego; XML/JSON odwzorowują zagnieżdżenie wprostduży wolumenpliki + paczkiAPI po rekordzie będzie za wolnebrak dostępu do ERPwarstwa pośrednia (np. BaseLinker albo własny proces)ustal właściciela procesu
Trzy układy, które występują w polskim e-commerce
ERP jako centrum
ERP prowadzi kartotekę, ceny i stany. Sklep jest kanałem sprzedaży i zwraca zamówienia. Najprostszy w utrzymaniu, wymaga jednak, żeby ERP miał komplet danych produktowych.
- Kiedy: jedna główna baza towarowa, sprzedaż głównie przez własny sklep.
Warstwa pośrednia
Między systemami stoi proces, który normalizuje dane, waliduje je i pilnuje kolejek. Więcej pracy na starcie, ale awaria jednego systemu nie zatrzymuje drugiego. Podobnie wymienia dane platforma B2B Sportina na Magento 2.4.8, którą wdrożyliśmy (bez ERP): produkty i stany przychodzą z BaseLinkera, a bieżące zamówienia partnerów trafiają do BaseLinkera i dalej do istniejącego procesu firmy.
- Kiedy: kilka kanałów sprzedaży, wiele źródeł danych, wymóg logów i ponowień.
Podział kompetencji
ERP odpowiada za dane handlowe, sklep za katalog i treści. Każdy system jest źródłem prawdy dla swojego zestawu pól, wymiana obejmuje tylko część danych.
- Kiedy: rozbudowany content i SEO po stronie sklepu, ERP bez pól marketingowych.
Co rozstrzygnąć i co przygotować
Do rozstrzygnięcia przed wdrożeniem
Kto odpowiada po stronie ERP
Bez osoby, która może zmienić konfigurację eksportu albo dodać pole, projekt zatrzymuje się na pierwszym brakującym atrybucie.
Środowisko testowe
Integracja testowana na produkcji to zamówienia-widma i pomieszane dokumenty. Potrzebna jest kopia ERP albo tryb próbny.
Historia sprzed integracji
Trzeba zdecydować, czy przenosimy zamówienia i kontrahentów wstecz, czy startujemy od daty granicznej.
Co się dzieje przy awarii
Kolejka trzyma dane czy je gubi, kto dostaje alert, jak długo sklep może działać bez ERP — to decyzje biznesowe, nie techniczne.
Do przygotowania, żeby ustalić zakres
- nazwę i wersję ERP oraz sklepu, a także informację, czy ERP ma API, eksport plików, czy działa już przez BaseLinkera
- osobę po stronie ERP, która może sprawdzić albo zmienić eksport i dodać brakujące pole
- listę danych do wymiany i to, kto dziś je zmienia: ceny, stany, kartoteka, zamówienia, statusy
- przykładowy eksport z ERP na kilkunastu produktach i jedno przykładowe zamówienie ze sklepu
- informację, czy jest kopia ERP albo tryb próbny do testów
- opis wyjątków: warianty, jednostki, cenniki kontrahentów, zamówienia częściowe, zwroty
Pięć etapów, odbiór na uzgodnionych scenariuszach
Każdy scenariusz z uzgodnionego przepływu sprawdzamy na danych przed odbiorem, więc integrację przejmujesz z udokumentowanym wynikiem testów.
- Rozpoznanie i matryca pólUstalamy, który system odpowiada za każde pole, kierunek i częstotliwość wymiany. To dokument, na którym opiera się dalsza praca.
- Próbka danych i mapowanieNa eksporcie z ERP sprawdzamy SKU, EAN, warianty i jednostki. Przebieg próbny pokazuje raport różnic bez zapisu w sklepie.
- Wymiana na środowisku testowymWdrażamy wymianę dla uzgodnionych danych, z logiem operacji, kolejką i obsługą błędów.
- Testy uzgodnionego przepływuPrzechodzimy scenariusze z tabeli w rozwinięciu niżej, razem z osobą, która obsługuje zamówienia w ERP.
- Uruchomienie etapamiNajpierw jeden typ danych, np. stany, potem zamówienia. Po każdym etapie sprawdzamy logi i zgodność danych w obu systemach.
Odbiór tych samych trzech pól: cena, stan, zamówienie
Cena
nowa wartość pojawia się w sklepie w uzgodnionym czasie; pola bez synchronizacji zostają nietknięte
Stan
nowa wartość pojawia się w sklepie w uzgodnionym czasie; przy braku odpowiedzi ERP albo braku pliku dane czekają w kolejce, a wskazana osoba dostaje alert
Zamówienie
pozycje, SKU, ilości, ceny, dostawa i dane do dokumentu w ERP tak jak w sklepie; ponowne wysłanie tego samego zamówienia nie tworzy w ERP drugiego dokumentu
Co sprawdzamy przed uruchomieniem
nowe zamówienie, ponowne wysłanie, anulowanie i zwrot, produkt bez odpowiednika, nowe produkty, zmiana ceny i stanu, brak odpowiedzi ERP
| Scenariusz | Co musi się zgadzać |
|---|---|
| Nowe zamówienie | pozycje, SKU, ilości, ceny, dostawa i dane do dokumentu w ERP tak jak w sklepie |
| Ponowne wysłanie tego samego zamówienia | w ERP nie powstaje drugi dokument |
| Anulowanie i zwrot | status i stan po obu stronach według uzgodnionej reguły, jeśli te zdarzenia są w zakresie |
| Aktualizacja produktu bez jednoznacznego odpowiednika | zmiana jest wstrzymana, a rekord trafia do raportu wyjątków – nic nie nadpisuje „podobnego” produktu |
| Uzgodnione tworzenie nowych produktów | brak odpowiednika jest tu oczekiwany: rekord przechodzi walidację i powstaje według ustalonych zasad; do raportu trafiają tylko rekordy, które walidacji nie przeszły |
| Zmiana ceny i stanu w ERP | nowa wartość pojawia się w sklepie w uzgodnionym czasie; pola bez synchronizacji zostają nietknięte |
| Brak odpowiedzi ERP albo brak pliku | dane czekają w kolejce, a wskazana osoba dostaje alert |
Od czego zależy wycena i późniejsze utrzymanie
Zakres wymiany
liczba typów danych i kierunków; zamówienia z powrotem statusów to więcej pracy niż same stany.
Możliwości ERP
API z dokumentacją, eksport plików albo tylko warstwa pośrednia; od tego zależy też, jak szybko dane mogą być aktualne.
Jakość danych
zgodność SKU i EAN w obu systemach, warianty, jednostki, duplikaty. Porządki w danych bywają większą częścią pracy niż sama wymiana.
Wyjątki w procesie
cenniki dla poszczególnych kontrahentów, zamówienia częściowe, zwroty, kilka magazynów.
Warunki testów
dostępność kopii ERP albo trybu próbnego i osoby po stronie ERP w ustalonych terminach.
Utrzymanie po starcie
aktualizacje ERP, sklepu i ich API, przegląd logów i raportu wyjątków, zmiany w procesie. Zakres opieki ustalamy osobno.
Cenę i termin podajemy na piśmie po ustaleniu zakresu i obejrzeniu próbki danych.
Wdrożenia i problemy, które już rozwiązaliśmy
Działająca wymiana danych, problemy rozwiązane w praktyce i zakres, który przygotujemy dla Twojego ERP.
Przykład wdrożenia
Platforma B2B Sportina na Magento 2.4.8 z wymianą danych przez BaseLinkera (bez ERP): produkty i stany z BaseLinkera, bieżące zamówienia partnerów do BaseLinkera bez przepisywania.
Rozwiązane problemy
Problemy, które diagnozowaliśmy i rozwiązywaliśmy, opisane w poradnikach: zamówienie z Magento nie zdejmuje stanu oraz limit API BaseLinkera dzielony z ERP. Zasady synchronizacji stanów między ERP, sklepem i BaseLinkerem zbiera poradnik o synchronizacji stanów.
Integracja z Twoim ERP
Integracja z ERP przez jego API albo wymianę plików na zasadach opisanych wyżej. Możliwości konkretnego ERP potwierdzamy na próbce danych z Twojego systemu, zanim podamy zakres.
Napisz, jaki masz ERP i co dziś przepisujecie ręcznie między systemami
Odpowiemy propozycją podziału: który system odpowiada za które pole, i wskażemy, od których pól zacząć, żeby najszybciej skończyć z ręcznym przepisywaniem. Dostępów nie wpisuj w formularzu.
Jaki masz ERP
i jaki sklep
Co przepisujecie ręcznie
między systemami
Propozycja podziału pól
i pola do pierwszego etapu