Przejdź do treści

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
ERP i sklep: kto jest właścicielem danych i w którą stronę płyną przykładowy wariant
ERP kartoteka i magazyn
  • cena bazowa
  • stan magazynowy
  • status i dokument
  1. cena · ERP → sklep Cena bazowa dobowo lub przy zmianie
  2. stan · ERP → sklep Stan magazynowy co kilkanaście–kilkadziesiąt minut
  3. zamówienie · sklep → ERP Zamówienie z pozycjami na zdarzenie
  4. status · ERP → sklep Status i numer dokumentu na zdarzenie, wraca do zamówienia w sklepie
  5. opis · bez synchronizacji Opis marketingowy zostaje w sklepie; import z ERP go nie nadpisuje
Sklep Shoper, WooCommerce albo Magento
  • opis marketingowy
  • zamówienie
Jeden z możliwych podziałów, nie architektura każdego wdrożenia. Pełną matrycę ustalamy razem – przykład zaraz niżej.

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

matryca źródła prawdynajczęstszy układ
Typ danychSystem głównyKierunekCzęstotliwość
Cena bazowa i cenniki kontrahentówERPERP → sklepdobowo lub przy zmianie
Stan magazynowyERPERP → sklepco kilkanaście–kilkadziesiąt minut
Zamówieniasklepsklep → ERPna zdarzenie
Pozostałe typy danych – kartoteka, promocje, opisy, statusy i dokumenty, dane kontrahenta B2B – w pełnej matrycy poniżej.

Pełna matryca: osiem typów danych

system główny, odbiorczy, kierunek i częstotliwość – także pola bez synchronizacji
Podział odpowiedzialności za dane między ERP a sklepem
Typ danychSystem głównySystem odbiorczyKierunekCzęstotliwość
Kartoteka towaru, SKU, EANERPsklepjednokierunkowoprzy zmianie
Cena bazowa i cenniki kontrahentówERPsklepjednokierunkowodobowo lub przy zmianie
Promocje i ceny czasowesklep—bez synchronizacji—
Stan magazynowyERPsklepjednokierunkowoco kilkanaście–kilkadziesiąt minut
Opisy, zdjęcia, treści SEOsklep—bez synchronizacji—
ZamówieniasklepERPjednokierunkowona zdarzenie
Status realizacji i dokument sprzedaży (numer dokumentu wraca do zamówienia w sklepie)ERPsklepjednokierunkowona zdarzenie
Dane kontrahenta B2BERPsklepjednokierunkowoprzy 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.

  1. 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.
  2. 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.
  3. 03

    Transport: API, XML czy CSV

    Wybór zależy od tego, co udostępnia ERP.

    WarunekRekomendacjaUwaga
    ERP ma REST/SOAPAPIdwukierunkowość możliwa
    tylko eksport plikówXML/CSVpotrzebny harmonogram i archiwum
    dane zagnieżdżoneXML/JSONCSV wymaga osobnego wiersza na wariant z kolumną produktu nadrzędnego; XML/JSON odwzorowują zagnieżdżenie wprost
    duży wolumenpliki + paczkiAPI po rekordzie będzie za wolne
    brak 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.
np. BaseLinker jako centrum wymiany

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.

  1. 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.
  2. 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.
  3. Wymiana na środowisku testowymWdrażamy wymianę dla uzgodnionych danych, z logiem operacji, kolejką i obsługą błędów.
  4. Testy uzgodnionego przepływuPrzechodzimy scenariusze z tabeli w rozwinięciu niżej, razem z osobą, która obsługuje zamówienia w ERP.
  5. 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

zmiana ceny w ERP

Cena

nowa wartość pojawia się w sklepie w uzgodnionym czasie; pola bez synchronizacji zostają nietknięte

zmiana stanu w ERP

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

nowe zamówienie

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
Scenariusze testów integracji ERP ze sklepem
ScenariuszCo musi się zgadzać
Nowe zamówieniepozycje, SKU, ilości, ceny, dostawa i dane do dokumentu w ERP tak jak w sklepie
Ponowne wysłanie tego samego zamówieniaw ERP nie powstaje drugi dokument
Anulowanie i zwrotstatus i stan po obu stronach według uzgodnionej reguły, jeśli te zdarzenia są w zakresie
Aktualizacja produktu bez jednoznacznego odpowiednikazmiana jest wstrzymana, a rekord trafia do raportu wyjątków – nic nie nadpisuje „podobnego” produktu
Uzgodnione tworzenie nowych produktówbrak 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 ERPnowa wartość pojawia się w sklepie w uzgodnionym czasie; pola bez synchronizacji zostają nietknięte
Brak odpowiedzi ERP albo brak plikudane 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.

wykonane · wymiana przez BaseLinker

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.

znane z diagnoz

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.

oferowane

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.

Wymiana przez BaseLinkerok. 115 tys. produktów i wariantów, 31 modułów Magento, 936 testów przed wdrożeniemSportina B2B · Magento + BaseLinker

Integracja ERP — pytania

Nie ma tu Twojego pytania? Napisz

Od spisania, które pole należy do którego systemu. Nie od wyboru technologii. Cena bazowa, stan, opis, kategoria, dane klienta i status zamówienia mogą mieć różne systemy nadrzędne. Ta tabela decyduje później o kierunkach, częstotliwości i sposobie rozwiązywania konfliktów.
Pliki wystarczają, gdy dane zmieniają się w cyklu dobowym i akceptujesz opóźnienie. API jest potrzebne, gdy stan i cena muszą być aktualne w ciągu minut albo gdy komunikacja ma iść w obie strony. Wybór wynika z wymaganej świeżości danych, nie z mody.
Batch przetwarza paczkę rekordów w ustalonych oknach i jest łatwiejszy do kontrolowania, powtórzenia i audytu. Real time reaguje na zdarzenie, ale wymaga kolejek, obsługi błędów i zabezpieczenia przed duplikatami. W praktyce większość wdrożeń łączy jedno z drugim.
Zostaje eksport i import plików w uzgodnionym formacie, najczęściej CSV lub XML, z katalogiem wymiany i harmonogramem. Warto wtedy szczególnie zadbać o walidację, znacznik czasu, archiwizację przetworzonych plików i alert, gdy plik nie pojawi się o czasie.
ERP zwykle odpowiada za dane handlowe i księgowe: cenę bazową, stan, kontrahenta i dokumenty. Sklep odpowiada za prezentację, treści, promocje i proces zakupowy. Granicę trzeba spisać, bo to ona decyduje, kto rozwiązuje problem, gdy dane się rozjadą.

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.

przesyłasz

Jaki masz ERP

i jaki sklep

przesyłasz

Co przepisujecie ręcznie

między systemami

odpowiadamy

Propozycja podziału pól

i pola do pierwszego etapu