Integracje API dla sklepów i zaplecza e-commerce
Zespół przepisuje zamówienia do ERP, a stany w sklepie rozjeżdżają się z hurtownią? Łączymy sklep z ERP, hurtownią, BaseLinkerem i systemami zamówień przez API albo pliki XML/CSV, także w B2B. Każde pole ma jedno źródło, a każdy błąd wymiany trafia do raportu.
Realizacjaok. 115 tys. produktów i wariantów z BaseLinkera, zamówienia partnerów wracają do BaseLinkera bez przepisywaniaSportina B2B · Magento + BaseLinker- 1 · sklep → ERP Zamówienie #D-1042, 3 pozycje pozycje po SKU, dane klienta, dostawa; ponowienie nie tworzy drugiego dokumentu
- 2 · ERP → sklep Numer dokumentu, status „w realizacji” co dokładnie wraca, zależy od ERP
- 3 · ERP albo kurier → sklep Status „wysłane” i numer przesyłki klient widzi go w sklepie i w wiadomości
Co synchronizujemy i jak często: każde pole ma jedno źródło
Typowy układ dla sklepu z hurtownią i ERP. Każde pole ma jednego właściciela i jeden kierunek; konkretny projekt może go zmienić, ale każde pole musi mieć jedną odpowiedź.
Cena, stany i zamówienia: skąd i dokąd
typowy układ- Hurtownia albo ERPwłaściciel ceny, stanu magazynowego i kartoteki
- Sklepstan co kilkanaście–kilkadziesiąt minut, cena razem ze stanami albo dobowo; opisy, zdjęcia i treści SEO zostają w sklepie, bez synchronizacji
- ERP, BaseLinker lub Apilozamówienia ze sklepu przez API platformy, z logiem operacji
- Status, numer przesyłkiz ERP, BaseLinkera albo od kuriera, na zdarzenie
| Dane | Właściciel pola | Kierunek | Częstotliwość | Wyjątek | Kontrola zapisu |
|---|---|---|---|---|---|
| Stan magazynowy | hurtownia albo ERP | → sklep | co kilkanaście–kilkadziesiąt minut | produkt bez dopasowania po SKU lub EAN trafia do raportu, nie jest pomijany po cichu | zapis tylko zmian, ponowienie, alert |
| Cena | ERP albo hurtownia | → sklep | razem ze stanami albo dobowo | cena z monitoringu konkurencji nie schodzi poniżej marży minimalnej | zakres ceny sprawdzany przed zapisem |
| Nowe produkty, kartoteka | hurtownia albo ERP | → sklep | przy nowym pliku lub zmianie | rekord z brakami (EAN, kategoria, zdjęcie) czeka w raporcie | walidacja pól, test na próbce |
| Opisy, zdjęcia, treści SEO | sklep | bez synchronizacji | — | plik XML/CSV z brakami albo złym mapowaniem nie nadpisuje opisanego produktu | kopia pól przed zapisem, zmiana odwracalna |
| Zamówienia | sklep | → ERP, BaseLinker lub Apilo | na zdarzenie | pozycja bez odpowiednika w kartotece; ponowienie nie tworzy drugiego dokumentu | log operacji; błąd widoczny od razu, nie po fakturze |
| Status, numer przesyłki | ERP, BaseLinker albo kurier | → sklep | na zdarzenie | synchronizujemy kilka statusów granicznych w jednym kierunku, nie wszystkie w obie strony | log operacji |
Stan w sklepie nie zgadza się z hurtownią
Z tym problemem sklepy przychodzą najczęściej. Niżej przebieg, który projektujemy: gdzie widać objaw, w którym miejscu go kontrolujemy i jaki wynik da się potem sprawdzić.
- Zamówienie na towar, którego nie maSklep przyjmuje zamówienie na towar, którego hurtownia już nie ma. Przyczyną są ręczne aktualizacje albo zbyt rzadka synchronizacja, a czasem dwa systemy zapisujące ten sam stan, przez co wartość wraca do poprzedniej.
- Jeden właściciel stanuStan ma jednego właściciela: hurtownię albo ERP. Synchronizacja działa cyklicznie, w harmonogramie dopasowanym do limitów API. Zapisujemy tylko zmienione rekordy, odrzucone zapytanie wraca do kolejki, a nieudany przebieg wysyła alert. Po zapisie odczyt sprawdza, czy sklep ma tę samą wartość co źródło.
- Stany zgodne ze źródłemStany zgadzają się ze źródłem w ustalonym cyklu, a sklep nie przyjmuje zamówień na towar, którego nie ma. Gdy synchronizacja się nie powiedzie, widać to w alercie i raporcie przebiegu.
Kontrole, dzięki którym błędny zapis nie psuje sprzedaży
- Dry-runpodgląd zmian przed zapisem
- Logzapisuje każdą operację z wynikiem, a każdy przebieg kończy się raportem
- Retryponawia zapytanie odrzucone przez limit lub błąd sieci
- Kopia zmienianych pólpozwala wycofać uzgodnione zapisy
- Alertnieudana aktualizacja wysyła alert
Częstotliwość wynika z limitów API: BaseLinker przyjmuje 100 zapytań na minutę, Shoper liczy operacje i podaje ich stan w nagłówkach odpowiedzi (domyślnie 10 operacji, zwalniane po 2 na sekundę; w konkretnym sklepie wartości mogą być inne).
Zamówienia do ERP przekazujemy przez Shoper API lub API platformy. Zapis przez API z walidacją przed zapisem działa w sklepie CMP na Shoper Storefront: 21 639 nazw produktów w ok. 4 h, bez błędu (realizacja CMP Polska). Jak przygotować katalog przed importem, opisujemy przy danych produktowych.
Limity API, od których zależy harmonogram
- BaseLinker: zapytań na minutę
- 100 / min
- Shoper: domyślny licznik, zwalniany po 2 na sekundę
- 10 operacji
Co jeszcze łączymy: skąd, co i dokąd
Cztery przepływy, o które sklepy pytają najczęściej. Działają na API, plikach, regułach i harmonogramie, bez AI; model AI dokładamy tylko tam, gdzie poprawia wynik, np. przy tłumaczeniu kategorii hurtowni. Dwa układy opisujemy osobno: integrację sklepu z hurtownią (produkty, ceny i dostępność od dostawców) i integrację BaseLinkera (gdy BaseLinker jest w środku).
Nowe produkty, kategorie, atrybuty i ceny
Automatyczny import; kategorie hurtowni tłumaczone na drzewo sklepu regułami i słownikami, przy dużej skali także z pomocą AI.
- Hurtownia: XML, CSV albo API
- Sklep: Shoper, WooCommerce, Magento
Stany i ceny
Cyklicznie, np. co kilkanaście lub kilkadziesiąt minut — zależnie od limitów API, źródła danych i ryzyka biznesowego.
- Hurtownia albo ERP: API, plik, eksport
- Sklep: Shoper, WooCommerce, Magento
Zamówienia z pozycjami
Eksport bez przepisywania, przez API platformy, z logiem operacji.
- Sklep: WooCommerce, Shoper, Magento
- ERP albo system zamówień: ERP z własnym API lub eksportem plików; BaseLinker, Apilo
Stany z priorytetem dostawcy, asortyment do scalenia
Priorytetyzacja stanów i konsolidacja asortymentu z wielu dostawców.
- Kilka hurtowni: każda z własnym formatem
- Jeden katalog sklepu: bez duplikatów tego samego towaru
Pozostałe połączenia: helpdesk, magazyn, kurierzy, PIM, BI, marketing
WMS, spedycja, PIM, BI i arkusze, marketing automation, monitoring cen – skąd, co i dokąd
- Sklep przekazuje: zamówienie, pozycje, status, dokument, dane klientaAPI na żądanie albo webhook przy zdarzeniu do: System zgłoszeńhelpdesk
- Sklep wymienia w obu kierunkach: zamówienia do kompletacji, wysyłki, dostępnośćAPI lub pliki wymiany, oba kierunki z: WMS i magazyn
- Sklep wymienia w obu kierunkach: przesyłki, etykiety, numery listów, statusyAPI przewoźnika lub broker, oba kierunki z: Spedycja i kurierzy
- PIM przekazuje: opisy, atrybuty, zdjęcia, tłumaczeniaeksport z PIM i import z walidacją do: Sklep
- Sklep przekazuje: sprzedaż, jakość danych, rotacja, zwrotyzaplanowany eksport CSV lub odczyt przez API do: BI i arkusze
- Sklep przekazuje: zdarzenia zakupowe, segmenty, porzucone koszykizdarzenia po stronie serwera, nie tylko w przeglądarce do: Marketing automation
- Monitoring cen przekazuje: ceny konkurencji, reguły cenoweimport cen z limitem marży minimalnej do: Sklep
System zgłoszeń a sklep
co musi zawierać zgłoszenie i dwa sposoby realizacji
Osoba obsługująca zgłoszenie powinna widzieć zamówienie, pozycje i status przesyłki bez otwierania panelu sklepu. Budujemy wymianę danych z helpdeskiem, który już masz, o ile udostępnia API.
- zgłoszenie musi mieć kontekst: numer zamówienia, pozycje, kwotę, metodę dostawy i status,
- dopasowanie zgłoszenia do zamówienia po adresie e-mail bywa zawodne — potrzebny jest numer zamówienia albo identyfikator klienta,
- zmiana statusu w sklepie powinna aktualizować zgłoszenie, a nie generować kolejne,
- zwrot i reklamacja to inne procesy niż pytanie o dostawę — i inne dane wejściowe,
- bez klucza idempotencji (znacznika, po którym system rozpoznaje powtórzone zdarzenie) ten sam webhook potrafi utworzyć trzy zgłoszenia z jednego zdarzenia,
- dane osobowe w zgłoszeniu wymagają decyzji, co faktycznie przesyłamy, a co pobieramy dopiero na żądanie.
Dwa sposoby realizacji
Technologie i szczegółowe zakresy
REST API, XML, CSV, ERP, systemy zamówień, Python, harmonogram
Jak uruchamiamy integrację bez przestoju sprzedaży
Od próbki do monitoringu. Najpierw sprawdzamy możliwości i konfigurację tego, co już jest; kod piszemy tylko dla zakresu, którego dostępne rozwiązania nie obsługują.
- Analiza źródeł danychFormat, jakość i dostępność danych: API, plik XML/CSV, baza, FTP. Oceniamy kompletność i mapowanie.
- Mapowanie i regułySłownik między strukturą źródła a sklepem oraz tabela reguł jak wyżej.
- Test na małym zbiorzeWeryfikacja wyników i korekta przypadków brzegowych przed produkcją.
- Produkcja i monitoringPełny przebieg, log i raport po każdym uruchomieniu, alert przy błędach krytycznych.
Inny zakres – osobne strony
- Automatyzacje — gdy problemem jest ręczna praca na danych w jednym systemie, a nie wymiana między systemami.
- Import i eksport CSV/XML/API — gdy głównym problemem jest wymiana danych produktowych.
- Eksport zamówień B2B do ERP — projektowany osobno, żeby nie mieszać katalogu z dokumentem sprzedażowym.
- Integracja ERP ze sklepem — matryca źródła prawdy i wybór między API a plikami.
- Poradnik: integracja sklepu z hurtownią przez API, XML lub CSV — formaty różnią się aktualnością danych, ryzykiem błędów i kosztem utrzymania.
Podaj dwa systemy i dane, które mają między nimi przechodzić
Na przykład „hurtownia XML → Shoper: stany i ceny” albo „WooCommerce → ERP: zamówienia”. Dopisz, co dziś robicie ręcznie. Zaproponujemy pierwszy etap, który najszybciej zdejmie z zespołu ręczne przepisywanie danych.
hurtownia XML → Shoper: stany i cenyWooCommerce → ERP: zamówieniadziś ręcznie: …co robicie ręcznie