Integracje API dla sklepów internetowych,
hurtowni i procesów B2B
Jeśli aktualizujesz stany magazynowe ręcznie, eksportujesz zamówienia do Excela albo przeklejasz produkty między systemami — to jest zakres dla integracji API. Budujemy połączenia między sklepem, hurtownią, ERP i systemami logistycznymi, z walidacją danych przed zapisem.
XML / CSV
Enova / Apilo
mapowanie · logi · błędy
Shoper / Magento / WC
CSV / alert
Co łączymy najczęściej?
Import produktów z hurtowni
Automatyczny import nowych produktów z pliku XML, CSV albo API hurtowni. Mapowanie kategorii, atrybutów i cen.
Aktualizacja stanów i cen
Cykliczna aktualizacja stanów i cen z zewnętrznego źródła, np. co kilkanaście lub kilkadziesiąt minut — zależnie od limitów API, źródła danych i ryzyka biznesowego.
Eksport zamówień do ERP
Automatyczny eksport zamówień z WooCommerce/Shopera/Magento do Enova, Apilo, Subiekta lub własnego systemu.
Mapowanie kategorii
Tłumaczenie struktury kategorii hurtowni na strukturę sklepu. Reguły, słowniki, AI — zależnie od skali.
Walidacja i logi
Każda integracja ma logi błędów, raport operacji i alerty przy nieudanych aktualizacjach. Pełna transparentność.
Multi-source integracje
Kilka hurtowni naraz, priorytetyzacja stanów, konsolidacja asortymentu z wielu dostawców w jednym katalogu.
Z czym pracujemy?
- REST API: Shoper, Magento, WooCommerce, własne endpointy
- XML: centra, hurtownie, formaty własne i branżowe
- CSV: importy z Excela, konwersje, mapowanie kolumn
- ERP: Enova, Apilo, Subiekt GT, własne bazy
- Python: requests, pandas, xmltodict, SQLite, PostgreSQL
- Cron / Task Scheduler: automatyczne uruchamianie cykliczne
Analiza źródeł danych
Sprawdzamy format, jakość i dostępność danych: API, plik XML/CSV, baza, FTP. Oceniamy kompletność i mapowanie.
Mapowanie i walidacja
Tworzymy słownik mapowania między strukturą źródłową a strukturą sklepu. Definiujemy reguły walidacji.
Wdrożenie na testowych danych
Uruchomienie na małym zbiorze, weryfikacja wyników, korekta edge cases przed produkcją.
Produkcja i monitoring
Pełny import na produkcji, logi i raport po każdym uruchomieniu, alert przy błędach krytycznych.
Dobra integracja pokazuje status, błąd i kolejny krok — nie tylko przesyła dane
Import, eksport i synchronizacja muszą mieć dry-run, logi, walidację oraz jasne reguły, co wolno zapisać automatycznie.
Gdy głównym problemem jest wymiana danych produktowych, rozwijamy ją jako import i eksport CSV/XML/API. Gdy proces dotyczy zamówień hurtowych, osobno projektujemy eksport zamówień B2B do ERP, żeby nie mieszać katalogu z dokumentem sprzedażowym.
Przy integracji z hurtownią dobór formatu ma znaczenie: API, XML i CSV różnią się aktualnością danych, ryzykiem błędów oraz kosztem utrzymania. Ten wybór rozpisaliśmy szerzej w poradniku o integracji sklepu z hurtownią przez API, XML lub CSV.
ERP / hurtownia / CSV / XML
SKU, EAN, kategorie, ceny
błędy, braki, logi
Shoper / Woo / Magento
Poza ERP i hurtownią: z czym jeszcze spina się sklep
ERP i hurtownia to najczęstsze kierunki, ale nie jedyne. Poniżej systemy, o które pytają najczęściej — z informacją, co realnie przechodzi między nimi a sklepem i w którą stronę.
| System | Co przechodzi | Kierunek | Mechanizm |
|---|---|---|---|
| System zgłoszeń / helpdesk | zamówienie, pozycje, status, dokument, dane klienta | ze sklepu do systemu zgłoszeń | API na żądanie albo webhook przy zdarzeniu |
| WMS i magazyn | zamówienia do kompletacji, wysyłki, dostępność | oba kierunki | API lub pliki wymiany |
| Spedycja i kurierzy | przesyłki, etykiety, numery listów, statusy | oba kierunki | API przewoźnika lub broker |
| PIM | opisy, atrybuty, zdjęcia, tłumaczenia | do sklepu | eksport z PIM i import z walidacją |
| BI i arkusze | sprzedaż, jakość danych, rotacja, zwroty | ze sklepu | zaplanowany eksport CSV lub odczyt przez API |
| Marketing automation | zdarzenia zakupowe, segmenty, porzucone koszyki | ze sklepu | zdarzenia po stronie serwera, nie tylko w przeglądarce |
| Monitoring cen | ceny konkurencji, reguły cenowe | do sklepu | import cen z limitem marży minimalnej |
System zgłoszeń a sklep: co jest realnym problemem
Pytanie „jak zintegrować system ticketowy ze sklepem" prawie nigdy nie dotyczy samego połączenia. Dotyczy tego, żeby osoba obsługująca zgłoszenie nie musiała otwierać drugiego systemu, żeby sprawdzić, co klient kupił i na jakim etapie jest przesyłka.
- 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 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
Integracja, która pokazuje status i błąd — nie tylko przesyła dane
Stany różnią się między sklepem a hurtownią
Problem: Ręczne aktualizacje albo zbyt rzadka synchronizacja prowadzą do sprzedaży niedostępnych produktów. Co robimy: Budujemy cykliczną synchronizację stanów i cen z retry, harmonogramem dopasowanym do limitów API i alertem przy błędzie. Efekt: Stany zgadzają się ze źródłem, a sklep nie przyjmuje zamówień na towar, którego nie ma.
Zamówienia przepisywane ręcznie do ERP
Problem: Zespół przeklejał zamówienia z WooCommerce/Shopera/Magento do Enova, Apilo czy Subiekta. Co robimy: Automatyzujemy eksport zamówień do ERP i spinamy proces przez Shoper API lub API platformy, z logiem operacji. Efekt: Zamówienia trafiają do ERP bez przepisywania, a błędy są widoczne od razu, nie po fakturze.
Import z hurtowni nadpisuje poprawne dane
Problem: Plik XML/CSV z brakami albo złym mapowaniem psuje opisane już produkty. Co robimy: Dodajemy walidację pól, test na próbce, dry-run i backup przed zapisem na produkcji. Efekt: Publikujemy tylko poprawne rekordy na czystych danych produktowych, a operacja jest odwracalna. Ten sam mechanizm publikacji przez API wykorzystaliśmy w realizacji 21 000 produktów dla CMP.
Co najczęściej łączymy z integracjami API?
Shoper API
Import produktów, stany, ceny i eksport zamówień przez Shoper API — z walidacją, logami i retry.
Magento i Magento B2B
Integracje dużego katalogu i B2B: ERP, BaseLinker, cenniki i kolejność synchronizacji.
Naprawa sklepu po wdrożeniu
Zabezpieczenie integracji, która nadpisuje dane po nieudanym wdrożeniu lub migracji.
Masz ręczną integrację, którą można zautomatyzować?
Opisz systemy, format danych i to, co dziś robicie ręcznie. Sprawdzimy, co jest możliwe, i zaproponujemy zakres MVP.