Integracja z hurtownią: XML, CSV czy API?

Kto zaczyna sprzedawać towar z hurtowni na Allegro albo we własnym sklepie, szybko słyszy trzy skróty: XML, CSV i API. Często padają zamiennie, jakby znaczyły to samo. Nie znaczą. Od tego, którą drogę daje hurtownia, zależy, jak świeże są stany w Twoich ofertach, czy zamówienia trafiają do hurtowni same i skąd wziąć numer przesyłki.

Trzy sposoby, bez żargonu

Plik XML. Hurtownia publikuje pod stałym adresem plik z listą produktów: nazwy, opisy, linki do zdjęć, ceny, stany. Twój program albo platforma pobiera go co jakiś czas i aktualizuje oferty. XML to po prostu format zapisu danych ze znacznikami, czytelny dla programów.

Plik CSV albo XLSX. To samo w formie tabeli, jak arkusz kalkulacyjny. Prostszy w podglądzie, często z mniejszą liczbą pól.

API. Twój program pyta hurtownię o konkretną rzecz albo wysyła jej polecenie, na przykład „złóż to zamówienie”, i od razu dostaje odpowiedź. Nie czeka na kolejny plik.

Gotowy konektor. Ktoś już napisał program, który czyta plik albo API danej hurtowni, i sprzedaje go jako funkcję platformy (np. Base albo aplikacja w sklepie na Shoperze).

W praktyce hurtownie łączą te drogi: plik na ofertę i stany, osobny kanał na zamówienia.

Co realnie udostępniają hurtownie

Hurtownia	Oferta i stany	Zamówienia	Status, przesyłka, faktura	Warunki
Ikonka	plik XML: pełna oferta raz dziennie, ceny i stany co godzinę	API zamówień (od października 2026)	w koncie B2B, poza API	plik 199 zł brutto rocznie albo zwolnienie; API bezpłatne
Action	pliki XLSX albo CSV dla partnerów platformy I-SERWIS	REST API albo EDI	dokumentacja API niepubliczna	dla partnerów handlowych
AB	API XML	API XML, także z adresem klienta końcowego	statusy, numery listów i faktury w API	aneks do umowy, opłaty zależne od obrotu
Hurtownie na IdoSell (standard ICDF)	sprawdzenie dostępności przez API	zamówienie z adresem odbiorcy	status i powiadomienie o wysyłce z numerem paczki	hurtownia musi włączyć dropshipping

Kilka szczegółów, które robią różnicę:

Ikonka podaje w pliku cenę sugerowaną netto, więc VAT trzeba doliczyć. API zamówień ma limit 100 zapytań na godzinę z konta. Opisujemy je szerzej w artykule API Ikonki: jak połączyć je z Allegro.
Action daje każdemu partnerowi platformy I-SERWIS darmowe pliki z cenami, stanami, wymiarami, opisami, zdjęciami i kategoriami.
AB ma API w dwie strony: wydaje dane i przyjmuje zamówienia, a do paczki można dołączyć własny PDF. Ma też gotowe narzędzie do wystawiania ofert na Allegro.
Standard ICDF w IdoSell to otwarty format dla hurtowni działających na tej platformie. Sesja trwa 15 minut, a jedno zapytanie może mieć najwyżej 10 MB.

Hurtowni jest oczywiście więcej. Base w czerwcu 2026 wymieniał 24 hurtownie dropshippingowe w Polsce z linkami do swoich integracji.

Częstotliwość i nadsprzedaż

Nadsprzedaż to sytuacja, w której oferta sprzedaje towar, którego hurtownia już nie ma. Bierze się z prostej rzeczy: między dwiema aktualizacjami stanów ktoś inny kupił ostatnie sztuki.

Integracja nie pobierze świeższych danych, niż hurtownia udostępnia. Jeśli plik ze stanami odświeża się co godzinę, to przez godzinę oferta może pokazywać stan sprzed godziny. Co da się z tym zrobić:

wybrać lżejszy plik z samymi stanami i cenami, jeśli hurtownia go ma (w Ikonce plik LIGHT odświeża się co godzinę, a pełna oferta raz dziennie);
ustawić zapas bezpieczeństwa: przy małych stanach pokazywać na Allegro mniej sztuk, niż jest w pliku;
sprawdzić zamówienie przed złożeniem, jeśli API hurtowni to umożliwia (Ikonka ma sprawdzenie bez zapisu);
wysyłać do Allegro tylko zmiany, zbiorczo. Allegro ma polecenia zmieniające cenę i liczbę sztuk w wielu ofertach naraz oraz limity zapytań, których nie warto zużywać na oferty bez zmian.

Żadna z tych metod nie wyklucza nadsprzedaży całkowicie. Zmniejszają jej częstotliwość.

Ile to kosztuje w utrzymaniu

Bez konkretnych kwot, bo zależą od hurtowni i zakresu, ale z listą pozycji, które trzeba policzyć:

opłata za plik, jeśli hurtownia ją pobiera (Ikonka: 199 zł brutto rocznie dla klientów z Polski, z możliwością zwolnienia);
abonament konektora albo platformy, według cennika jej dostawcy;
budowa i utrzymanie własnej integracji: zmiany w API hurtowni, zmiany w API Allegro, pilnowanie zgody konta Allegro, która bez odświeżania wygasa najpóźniej po 3 miesiącach;
czas ręcznych obejść, który zostaje mimo integracji, na przykład przepisywanie numerów przesyłek z panelu hurtowni.

Ostatnią pozycję łatwo pominąć, a to ona pokazuje, czy integracja domyka proces, czy tylko jego część.

Pytania do hurtowni przed wyborem drogi

Zanim zapadnie decyzja, warto zadać hurtowni te pytania:

W jakim formacie jest oferta: XML, CSV, API? Czy plik jest płatny?
Jak często odświeża się plik ze stanami? Czy jest osobny, lżejszy plik z samymi stanami i cenami?
Czy cena w pliku jest netto czy brutto, zakupowa czy sugerowana?
Jak składa się zamówienia: przez API, e-mail, panel? Czy da się sprawdzić zamówienie bez zapisu albo w środowisku testowym?
Czy zamówienie może mieć adres klienta końcowego (dropshipping)?
Skąd wziąć status zamówienia, numer przesyłki i fakturę?
Jakie są limity zapytań?
Czy można wysłać zamówienie z własną etykietą, np. pobraną z Allegro?
Czy hurtownia ma gotowe połączenie z platformą, której używasz?
Jak hurtownia informuje o zmianach w pliku albo w API?

To odpowiedzi na pytania 4, 6 i 8 rozstrzygają, czy wystarczy konektor, czy potrzebna jest integracja hurtowni z Allegro zbudowana pod Twój proces.

Pytania

Co to znaczy integracja przez API?

To połączenie, w którym dwa programy wymieniają dane bez udziału człowieka, przez ustalone adresy i formaty. Twój program wysyła zapytanie albo polecenie, a hurtownia od razu odpowiada. W odróżnieniu od pliku nie trzeba czekać na kolejną aktualizację.

Jak zintegrować sklep internetowy z hurtownią?

Najpierw sprawdzić, co hurtownia udostępnia (pytania wyżej) i czy platforma sklepu ma do niej gotowy konektor. Jeśli ma, a proces jest typowy, konektor wystarcza. Jeśli nie ma albo proces wychodzi poza to, co konektor robi, potrzebna jest integracja, która czyta plik albo API hurtowni i rozmawia z API sklepu.

Czy plik XML wystarczy do sprzedaży na Allegro?

Do oferty, cen i stanów zwykle tak. Zamówienia trzeba wtedy przekazywać hurtowni inną drogą: przez API, jeśli jest, albo ręcznie w jej sklepie.

Co jest szybsze: XML czy API?

API odpowiada od razu, ale ma limity zapytań. Plik jest tak świeży, jak często hurtownia go generuje. Do stanów całego katalogu plik bywa praktyczniejszy, do zamówień API.

Masz hurtownię, której nie da się podłączyć gotowym konektorem? Opisz proces, a sprawdzimy, co ta hurtownia udostępnia.

Źródła (odczyt 23.10.2026): Ikonka: API zamówień, Ikonka: zasady integracji XML, Ikonka: generator XML, Action: e-commerce, AB: prosta integracja, IdoSell: standard ICDF, Base: hurtownie dropshipping, Allegro: zarządzanie ofertami, Allegro: uwierzytelnianie.