Integracja sklepu z hurtownią — produkty, ceny i dostępność od dostawców
Przepisywanie produktów, cen i stanów z plików kilku hurtowni zabiera zespołowi godziny, a błąd w cenie kosztuje marżę. Łączymy pliki, XML i API dostawców ze sklepem: nowe produkty, ceny według Twoich reguł i dostępność aktualizują się same, a Twoje ręczne wyjątki zostają.
Realizacjakatalog hurtowni: ok. 115 tys. produktów i wariantów ze stanami z BaseLinkera, odświeżanymi automatycznieSportina B2B · Magento + BaseLinkerOd dostawcy do sklepu
schemat ogólny- Hurtowniakod produktu, EAN, nazwa, atrybuty; cena katalogowa albo zakupowa, waluta; dostępność u dostawcy
- Kontrola → raport wyjątkówbrak pliku, błąd, sprzeczny kod: raport wyjątków zamiast zapisu
- Sklepaktualizacja dopasowanego produktu; nowy produkt tylko w uzgodnionym zakresie, po walidacji; cena według Twojej reguły, z ochroną wyjątków; dostępność w sklepie według ustalonej zasady
Gotowe połączenie, konfiguracja czy własny kod
Dla wielu hurtowni istnieją gotowe aplikacje i integracje, np. w sklepie aplikacji platformy albo w BaseLinkerze. O wyborze decyduje to, czy rozwiązanie pokrywa Twoje wymagania: potrzebne pola, reguły cen, częstotliwość aktualizacji i obsługę wyjątków. 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ą.
Czy gotowe połączenie pokrywa Twoje wymagania?
- Sytuacja: gotowe połączenie pokrywa wymagane pola, reguły cen, częstotliwość aktualizacji i obsługę wyjątków.KonfiguracjaCo robimy: konfiguracja istniejącej aplikacji, mapowanie danych i test na próbce.
- Sytuacja: połączenie jest dostępne, ale dane lub ustawienia powodują błędy.Diagnoza i porządekCo robimy: diagnoza przyczyny, uporządkowanie danych i konfiguracji; jeśli problem wynika z ograniczenia narzędzia – ustalenie potrzebnego rozszerzenia.
- Sytuacja: po sprawdzeniu dostępnych rozwiązań pozostają wymagania, których nie obsługują.Rozszerzenie albo własny kodCo robimy: rozszerzenie istniejącej integracji albo własny kod dla brakującego zakresu.
Jeśli dopiero wybierasz sposób połączenia (API, XML czy CSV) i chcesz przygotować dane samodzielnie, zacznij od poradnika o integracji sklepu z hurtownią. Jeśli w środku połączenia jest BaseLinker, zobacz integrację BaseLinkera. Cztery drogi dostarczania danych hurtowni do sklepu porównujemy pod etapami współpracy.
Błędne dane albo brak danych od dostawcy
Dostawca → bufor i walidacja → stan w sklepie: trzy stany pliku
schemat ogólny- Stan pliku: dane przechodzą walidację
- Reakcja: przed zapisem kopiujemy poprzednie wartości zmienianych pól
- W sklepie: aktualizacja dopasowanego produktu
- Dowód: każdy przebieg ma log: co zapisano, co pominięto i dlaczego
- Stan pliku: brak pliku albo brak odpowiedzi API
- Reakcja: przebieg zatrzymuje się i trafia do raportu
- W sklepie: sklep zostaje z ostatnimi poprawnymi danymi albo z zasadą, którą ustalimy; brak pliku nie oznacza automatycznie stanu zero
- Dowód: raport przebiegu
- Stan pliku: np. duży skok ceny albo nagle pusta kolumna
- Reakcja: podejrzane zmiany trafiają do wyjątków
- W sklepie: raport wyjątków zamiast zapisu
- Dowód: raport wyjątków
Zasady na błędy – pełny opis
brak pliku, podejrzane zmiany, log przebiegu, kopia zmienianych pól i jej granice
- brak pliku albo odpowiedzi API nie oznacza automatycznie stanu zero – przebieg zatrzymuje się i trafia do raportu, a sklep zostaje z ostatnimi poprawnymi danymi albo z zasadą, którą ustalimy,
- podejrzane zmiany, np. duży skok ceny albo nagle pusta kolumna, trafiają do wyjątków zamiast do sklepu,
- każdy przebieg ma log: co zapisano, co pominięto i dlaczego,
- przed zapisem kopiujemy poprzednie wartości zmienianych pól; kopia przywraca te pola, ale nie cofa wszystkich skutków integracji, np. zamówień złożonych w międzyczasie.
Co ustalamy osobno
- jak często dane są aktualizowane – ustawiamy to tak często, jak dostawca je udostępnia i jak pozwalają limity systemów
- przesyłanie zamówień do hurtowni, rezerwacje, faktury i obsługa wysyłek – wymagają osobnego zakresu
- dane dostępowe do API dostawcy i sklepu – przekazujesz osobnym kanałem, nie w formularzu
Zasady aktualizacji, dzięki którym ceny i stany zgadzają się z dostawcą
Dopasowanie produktów
Klucz – SKU, EAN albo kod producenta – dobieramy do danych dostawcy i unikalności identyfikatorów.
- aktualizacja katalogu: brak jednoznacznego dopasowania zatrzymuje zmianę produktu i trafia do raportu
- nowe produkty: powstają po walidacji, zgodnie z ustalonym sposobem publikacji
- kilka dopasowań albo sprzeczne identyfikatory wymagają wyjaśnienia
Ceny według Twoich reguł
Dla każdego dostawcy ustalamy na piśmie, skąd bierze się cena.
- katalogowa albo zakupowa z narzutem
- waluta, przeliczenie i zaokrąglenie
- ręczne ceny, promocje i wyjątki chronione według reguł, w granicach platformy
Dostępność dostawcy a stan sklepu
Dostępność u dostawcy nie jest automatycznie Twoim stanem magazynowym.
- pokazujemy ją jako stan do sprzedaży, dłuższy czas wysyłki albo osobno od własnego magazynu
- gdy stan prowadzi ERP albo BaseLinker, ustalamy, który system decyduje o polu
- dzięki temu systemy się nie nadpisują
Diagnoza, pilot, rozszerzenie
Każdy etap zamawiasz osobno. Zakres i cenę diagnozy ustalamy po poznaniu liczby dostawców i ich danych.
- Diagnozadla uzgodnionej liczby dostawców i próbki ich danych: mapa pól, propozycja klucza dopasowania, reguły cen i dostępności do zatwierdzenia, ryzyka, proponowane rozwiązanie i wycena
- Pilotjeden uzgodniony dostawca i próbka produktów: zaakceptowany plan zmian, zapis i kontrola wyniku
- Rozszerzeniekolejni dostawcy i uzgodniony zakres produktów
- Utrzymanie (opcjonalnie)monitoring przebiegów i obsługa wyjątków w ustalonym zakresie
Wynik etapu: jak sprawdzisz, że działa
Jedna lista odbiorowa: diagnoza, pilot, każdy przebieg i koniec etapu.
- po diagnozie: dokument z mapą pól i regułami do Twojej akceptacji – zanim cokolwiek zapiszemy w sklepie
- po pilocie: arkusz „było / będzie” dla próbki, wynik zapisu i odczyt kontrolny ze sklepu, który możesz porównać z plikiem dostawcy
- po każdym przebiegu: raport z liczbą zapisanych i pominiętych rekordów oraz powodami wyjątków
- na koniec etapu: opis reguł i miejsca, gdzie je zmienić, żeby nie zależały od jednej osoby
Cztery drogi do własnego sklepu: dobór według danych, nie narzędzia
Dobór drogi wynika z czterech pytań: które pola są potrzebne (ceny, stany, opisy, zdjęcia, warianty), jakie reguły mają działać (narzut, waluta, ochrona ręcznych cen), jak często dane mają się zmieniać i co ma się stać z wyjątkami (brak pliku, nowy produkt, produkt wycofany).
| Droga | Kiedy wystarcza | Na co uważać |
|---|---|---|
| Gotowa aplikacja hurtowni dla platformy sklepu | hurtownia ma aplikację dla Twojej platformy, a aplikacja przenosi potrzebne pola i pozwala ustawić reguły cen | co aplikacja robi z produktem wycofanym, z ręcznie zmienioną ceną i z brakiem pliku |
| Import pliku (CSV albo XML) według harmonogramu | hurtownia udostępnia plik, a dane wystarczy odświeżać raz albo kilka razy dziennie | stany i ceny bywają w osobnych plikach; brak pliku nie może oznaczać stanu zero |
| Połączenie z API hurtowni | hurtownia ma API, a potrzebne są częstsze aktualizacje albo dane, których nie ma w pliku | limity zapytań, logowanie każdego przebiegu i dane dostępowe przekazywane osobnym kanałem |
| Przez BaseLinkera | BaseLinker już obsługuje Twoje zamówienia i marketplace’y | według FAQ Base.com (odczyt 13.11.2026) hurtownia podłączona w Base nie wystawia produktów na własny sklep, tylko na marketplace’y z integracją dwukierunkową; dla własnego sklepu zostaje jedna z dróg wyżej albo własne połączenie przez API BaseLinkera |
Shoper
aplikacja hurtowni, import pliku albo Shoper API z kontrolą tempa zapisu
Najpierw sprawdzamy, czy hurtownia ma aplikację w sklepie aplikacji Shopera i co ona przenosi. Jeśli nie ma albo brakuje reguł, dane trafiają do sklepu przez import pliku albo przez Shoper API – z kontrolą tempa zapisu, bo API Shopera ma limit operacji. Proces cenników od wielu dostawców opisujemy przy Shoper API.
WooCommerce
importer CSV, plik XML przez wtyczkę albo własny importer, harmonogram i zapis paczkami
Wbudowany importer WooCommerce przyjmuje pliki CSV; plik XML hurtowni wymaga wtyczki importu albo własnego importera. Przy większym katalogu i częstych aktualizacjach liczy się harmonogram poza ruchem na stronie i zapis paczkami. Przebieg importu opisujemy przy sklepach WooCommerce.
BaseLinker w środku
który system jest właścicielem stanów i cen, żeby się nie nadpisywały
Gdy BaseLinker prowadzi zamówienia, a hurtownia ma zasilać własny sklep, ustalamy, który system jest właścicielem stanów i cen, żeby się nie nadpisywały. Kiedy wystarcza gotowe połączenie, a kiedy potrzebne jest własne – w poradniku BaseLinker API w praktyce.
Co już robimy na danych produktów
Cenniki od wielu dostawców
Opis metody: reguła ceny dla każdego dostawcy, plan zmian, ochrona ręcznych ustawień, zapis partiami i odczyt kontrolny.
Cenniki od wielu dostawcówKontrola importu produktów
Jak sprawdzamy, że import dał właściwy katalog: rozliczenie rekordów, odczyt kontrolny i kontrola po czasie.
Kontrola importu produktówAPI, XML czy CSV
Poradnik o wyborze sposobu połączenia z hurtownią i przygotowaniu danych.
API, XML czy CSVNapisz, ilu masz dostawców i w jakiej formie przysyłają dane
Wystarczy platforma sklepu, liczba dostawców, format danych (plik, XML, API) i to, co ma się aktualizować. Pokażemy, ile ręcznej pracy zdejmie integracja i od którego dostawcy zacząć.
Platforma sklepu
np. Shoper, WooCommerce, Magento
Liczba dostawców
hurtownie, producenci, inni dostawcy
Format danych
plik, XML, API
Co ma się aktualizować
nowe produkty, ceny czy dostępność