Przejdź do treści

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 + BaseLinker

Od dostawcy do sklepu

schemat ogólny
  1. od dostawcy · plik, XML albo APIHurtowniakod produktu, EAN, nazwa, atrybuty; cena katalogowa albo zakupowa, waluta; dostępność u dostawcy
  2. bufor i walidacjaKontrola → raport wyjątkówbrak pliku, błąd, sprzeczny kod: raport wyjątków zamiast zapisu
  3. w sklepieSklepaktualizacja 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
Schemat ogólny. Pola i zasady ustalamy dla każdego dostawcy osobno.

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?

  1. 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.
  2. 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.
  3. 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
Plik świeży
  • 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
Brak pliku
  • 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
Dane niepoprawne
  • 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
Schemat ogólny. Pola i zasady ustalamy dla każdego dostawcy osobno.

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
Tak samo przy Shoper API

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.

  1. DiagnozaCo dostajeszdla 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
  2. PilotCo dostajeszjeden uzgodniony dostawca i próbka produktów: zaakceptowany plan zmian, zapis i kontrola wyniku
  3. RozszerzenieCo dostajeszkolejni dostawcy i uzgodniony zakres produktów
  4. Utrzymanie (opcjonalnie)Co dostajeszmonitoring 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).

Sposoby dostarczania danych hurtowni do własnego sklepu i kiedy który wystarcza
DrogaKiedy wystarczaNa co uważać
Gotowa aplikacja hurtowni dla platformy sklepuhurtownia ma aplikację dla Twojej platformy, a aplikacja przenosi potrzebne pola i pozwala ustawić reguły cenco aplikacja robi z produktem wycofanym, z ręcznie zmienioną ceną i z brakiem pliku
Import pliku (CSV albo XML) według harmonogramuhurtownia udostępnia plik, a dane wystarczy odświeżać raz albo kilka razy dzienniestany i ceny bywają w osobnych plikach; brak pliku nie może oznaczać stanu zero
Połączenie z API hurtownihurtownia ma API, a potrzebne są częstsze aktualizacje albo dane, których nie ma w plikulimity zapytań, logowanie każdego przebiegu i dane dostępowe przekazywane osobnym kanałem
Przez BaseLinkeraBaseLinker już obsługuje Twoje zamówienia i marketplace’ywedł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ów

Kontrola importu produktów

Jak sprawdzamy, że import dał właściwy katalog: rozliczenie rekordów, odczyt kontrolny i kontrola po czasie.

Kontrola importu produktów

API, XML czy CSV

Poradnik o wyborze sposobu połączenia z hurtownią i przygotowaniu danych.

API, XML czy CSV

Integracja sklepu z hurtownią — pytania

Nie ma tu Twojego pytania? Napisz

Tak, jeśli obsługuje wymagane dane, reguły cen, częstotliwość aktualizacji i wyjątki. Najpierw sprawdzamy jej możliwości i konfigurację. Własny kod proponujemy wtedy, gdy pozostaje konkretny zakres, którego gotowe rozwiązanie nie obsługuje.
Klucz – SKU, EAN albo kod producenta – dobieramy do danych konkretnego dostawcy i do tego, czy identyfikatory są unikalne. Przy aktualizacji istniejącego katalogu brak jednoznacznego dopasowania zatrzymuje zmianę danego produktu i trafia do raportu. Przy uzgodnionym dodawaniu nowych produktów brak odpowiednika jest oczekiwany – nowy produkt powstaje po przejściu walidacji i zgodnie z ustalonym sposobem publikacji. Kilka dopasowań albo sprzeczne identyfikatory wymagają wyjaśnienia.
Nie automatycznie. Ustalamy, jak ją pokazać w sklepie: jako stan do sprzedaży, jako 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.
Brak pliku albo odpowiedzi API nie oznacza stanu zero. Przebieg zatrzymuje się i trafia do raportu, a sklep zostaje z ostatnimi poprawnymi danymi albo z zasadą, którą ustalimy przy diagnozie.
Nie w podstawowym zakresie. Przesyłanie zamówień do hurtowni, rezerwacje, faktury i obsługa wysyłek wymagają osobnego zakresu, który ustalamy po diagnozie.

Napisz, 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ąć.

przesyłasz

Platforma sklepu

np. Shoper, WooCommerce, Magento

przesyłasz

Liczba dostawców

hurtownie, producenci, inni dostawcy

przesyłasz

Format danych

plik, XML, API

przesyłasz

Co ma się aktualizować

nowe produkty, ceny czy dostępność