REST API · XML · CSV · ERP · Hurtownie

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.

Opisz integrację ← Automatyzacje

integracja systemów dry-run + logi

Hurtownia
XML / CSV

ERP
Enova / Apilo

Walidacja
mapowanie · logi · błędy

Sklep
Shoper / Magento / WC

Raport
CSV / alert

Najpierw sprawdzamy dane, dopiero potem zapisujemy zmiany w sklepie lub ERP.

REST

Shoper, Magento, WooCommerce, własne API

XML/CSV

import z hurtowni, Centra, własne formaty

ERP

Enova, Apilo, Subiekt, własny system

Typowe integracje

Co łączymy najczęściej?

EXP

Import produktów z hurtowni

Automatyczny import nowych produktów z pliku XML, CSV albo API hurtowni. Mapowanie kategorii, atrybutów i cen.

PERF

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.

ERP

Eksport zamówień do ERP

Automatyczny eksport zamówień z WooCommerce/Shopera/Magento do Enova, Apilo, Subiekta lub własnego systemu.

MAP

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ść.

B2B

Multi-source integracje

Kilka hurtowni naraz, priorytetyzacja stanów, konsolidacja asortymentu z wielu dostawców w jednym katalogu.

Technologie

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

Python REST API XML CSV Enova Apilo Shoper API Magento API

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.

Mapa integracji

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.

Źródło
ERP / hurtownia / CSV / XML

→

Mapper
SKU, EAN, kategorie, ceny

→

Walidacja
błędy, braki, logi

→

Sklep
Shoper / Woo / Magento

Problem → rozwiązanie → efekt

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.

Powiązane zakresy

Co najczęściej łączymy z integracjami API?

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.

FIX

Naprawa sklepu po wdrożeniu

Zabezpieczenie integracji, która nadpisuje dane po nieudanym wdrożeniu lub migracji.

FAQ

FAQ integracji API

Jak integrujecie sklep z ERP i BaseLinkerem, żeby dane się nie nadpisywały?+

Najpierw ustalamy źródło prawdy dla cen, stanów, opisów i zamówień oraz kolejność synchronizacji. Integrację budujemy na REST API lub plikach XML/CSV z walidacją, logami, retry i backupem. Większe operacje uruchamiamy najpierw na próbce i stagingu, a na produkcji włączamy monitoring i alert, gdy import przestanie działać.

Czy integracja może obsłużyć kilka hurtowni naraz?+

Tak. Przy multi-source konsolidujemy asortyment z wielu dostawców, priorytetyzujemy stany i mapujemy różne struktury kategorii na jedną strukturę sklepu. Każde źródło ma własne reguły walidacji i logi, żeby dało się sprawdzić, skąd pochodzi dany rekord i dlaczego został odrzucony albo nadpisany.

Czy CSV/XML wystarczy zamiast API?+

Często tak, jeśli integracja działa batchowo i dane nie muszą zmieniać się co kilka minut. CSV/XML wystarczy do importu katalogu, opisów albo cennika. API jest lepsze przy częstych aktualizacjach stanów, zamówieniach, statusach lub operacjach, które muszą zwracać wynik od razu.

Co jeśli dane z hurtowni są słabe?+

Wtedy najpierw trzeba je oczyścić i zmapować. Automatyczne wrzucenie złych danych tylko przenosi chaos do sklepu: puste kategorie, złe warianty, duplikaty SKU i niespójne ceny. Dlatego przed integracją robimy walidację pól oraz raport błędów.

Czy integracja może działać lokalnie?+

Na etapie MVP tak, szczególnie gdy chcemy szybko sprawdzić mapowanie i format danych. Produkcyjnie lepiej przenieść integrację na stabilny serwer, harmonogram zadań albo proces z monitoringiem, logami i alertem, gdy import przestanie działać.

Jak często powinna uruchamiać się integracja?+

To zależy od danych. Stany magazynowe mogą wymagać aktualizacji co kilka minut, opisy i kategorie zwykle wystarczy przetwarzać batchowo. Częstotliwość dobiera się do ryzyka błędu, limitów API i realnej potrzeby biznesowej.

Co powinno być w logach integracji?+

Identyfikator rekordu, źródło danych, czas przetwarzania, wynik operacji, treść błędu i informacja, czy rekord wymaga ponowienia. Bez logów integracja działa tylko do pierwszego problemu, którego nie da się szybko odtworzyć.

Masz ręczną integrację, którą można zautomatyzować?

Opisz systemy, format danych i co robisz ręcznie. Sprawdzę co jest możliwe i zaproponuję zakres MVP.

Opisz integrację → Dane produktowe

Integracje API dla sklepów internetowych,hurtowni i procesów B2B