Integracja hurtowni z Allegro i sklepem internetowym

Hurtownie udostępniają dane na trzy sposoby i często łączą je ze sobą. Plik służy zwykle do oferty i stanów, a zamówienia idą innym kanałem.

Szerzej o różnicach w artykule Integracja z hurtownią: XML, CSV czy API?

• Oferta i zdjęcia. Nazwy, opisy, zdjęcia i kategorie z pliku hurtowni, przypisane do Twoich ofert na Allegro i w sklepie.
• Stany. Gdy hurtownia nie ma towaru, oferta przestaje go sprzedawać. Im częściej hurtownia odświeża plik, tym mniejsze ryzyko sprzedaży towaru, którego już nie ma.
• Ceny z regułą marży. Cena hurtowa plus Twoja marża, zaokrąglenie i VAT. Szczegóły mają znaczenie: Ikonka podaje w pliku cenę sugerowaną netto, więc VAT trzeba doliczyć.
• Zamówienia do hurtowni. Zamówienie z Allegro idzie do hurtowni dopiero wtedy, gdy Allegro oznaczy je jako gotowe do realizacji. Wcześniej adres i dane do faktury mogą się jeszcze zmienić.
• Numery przesyłek z powrotem. Numer przesyłki trafia do zamówienia na Allegro, więc kupujący widzi go przy zamówieniu.
• Faktury. Ikonka wystawia fakturę zawsze na dane z Twojego konta, także przy dropshippingu. Fakturę dla kupującego wystawia Twój program do faktur, a integracja może dodać ją do zamówienia na Allegro jako PDF albo link.

Ikonka to hurtownia z Białegostoku (hurt, dropshipping, import). Opisujemy ją jako przykład, bo w październiku 2026 uruchomiła API zamówień. SkalujOnline nie jest partnerem Ikonki. Poniżej są wyłącznie fakty z publicznych stron i dokumentacji Ikonki.

Plik XML: oferta, ceny, stany

• BASIC: pełna oferta z opisami i zdjęciami, aktualizacja raz dziennie.
• LIGHT: kod, kod kreskowy, stan, VAT i cena, aktualizacja co godzinę.
• Od 1 września 2025 plik jest płatny: 199 zł brutto rocznie dla klientów z Polski. Bez opłaty dla klientów, którzy współpracują z Ikonką co najmniej 12 miesięcy i w tym czasie mają obrót co najmniej 100 000 zł netto.
• Link do pliku generuje się po zalogowaniu na konto.

API zamówień: co robi

• Przyjmuje zamówienie z Twojego systemu bez udziału pracownika, na tych samych cenach i warunkach co w sklepie Ikonki. Jest bezpłatne dla kontrahentów z kontem B2B.
• Logowanie: e-mail i hasło konta B2B w sklepie Ikonki, nie osobny klucz. Integracja musi więc przechowywać te dane, a po zmianie hasła w sklepie trzeba je zmienić także w integracji.
• Sprawdza zamówienie bez zapisu (checkOnly): zwraca wartość, koszt dostawy, liczbę paczek i wynik sprawdzenia produktów, dostawy, płatności i adresu.
• Chroni przed duplikatem: ten sam identyfikator zamówienia z Twojego systemu daje jedno zamówienie w Ikonce, nawet przy ponownym wysłaniu.
• Gdy brakuje towaru, odrzuca zamówienie i podaje wszystkie powody naraz.
• Przyjmuje do 200 pozycji w jednym zamówieniu.

Czego API nie robi

Status zamówienia, numer przesyłki i faktury Ikonka pokazuje w koncie w sklepie, nie w API. Oferta, ceny i stany idą plikiem XML. Pełne połączenie z Allegro potrzebuje więc pliku i API naraz, a informacja „wysłane” musi przyjść z innego źródła.

Wysyłka z etykietą Allegro

W API Ikonki są formy wysyłki własnej z etykietą, w tym DPD i InPost opisane jako „Allegro SMART!”. Do zamówienia dołącza się numer przesyłki i etykietę PDF w formacie A6. Allegro pozwala pobrać etykietę Wysyłam z Allegro właśnie jako PDF A6. Formaty się zgadzają, więc da się zaprojektować przepływ: zamówienie z Allegro, etykieta z Allegro, zamówienie w Ikonce z tą etykietą, a numer przesyłki znany od razu. Czy formy wysyłki własnej są dostępne na Twoim koncie, pokazuje katalog form dostawy w API Ikonki.

Ograniczenia

• 6 zapytań na minutę i 100 na godzinę z jednego konta, łącznie ze sprawdzeniem bez zapisu i katalogiem. Przy większej liczbie zamówień trzeba je kolejkować.
• Zamówienie za pobraniem tylko w sklepie internetowym, przez API odmowa.
• Wysyłka GLS z własną etykietą tylko w sklepie, przez API odmowa.

Krok po kroku opisujemy to w artykule API Ikonki: jak połączyć je z Allegro.

• Action (IT, AGD): pliki XLSX albo CSV dla partnerów platformy I-SERWIS (ceny, stany, wymiary, opisy, zdjęcia, kategorie) albo REST API lub EDI. Dokumentacja API nie jest publiczna.
• AB (IT, elektronika): API XML w dwie strony. Wydaje produkty, ceny, stany, statusy zamówień, numery listów przewozowych i faktury, a przyjmuje zamówienia z adresem klienta końcowego. Wymaga aneksu do umowy, opłaty zależą od obrotu.
• Hurtownie na IdoSell: otwarty standard dropshippingu ICDF obejmuje sprawdzenie dostępności, zamówienie z adresem odbiorcy, status i powiadomienie o wysyłce z numerem paczki. Hurtownia musi włączyć dropshipping po swojej stronie.

Wzór się powtarza: plik na ofertę i stany, osobny kanał na zamówienia, a status i faktura często tylko w panelu hurtowni. Integracja spina te kanały w jeden przepływ.

Gotowy konektor wystarcza, gdy hurtownia go ma, sprzedajesz jej towar bez wyjątków i nie potrzebujesz własnych reguł. Ikonka sama wskazuje do Allegro platformy Sky-Shop, TakeDrop, BaseLinker, Redcart i Apilo, a połączenie przez Base Connect opisuje jako „już wkrótce”.

Integracja własna ma sens, gdy:

• jeden produkt jest w kilku hurtowniach i zamówienie ma iść tam, gdzie jest towar albo niższa cena;
• hurtownia ma nowe API, którego konektor jeszcze nie obsługuje;
• przy wysyłce przez hurtownię ma być użyta etykieta z Allegro;
• marża zależy od kategorii, dostawcy albo kosztu wysyłki;
• zamówienia mają trafiać także do programu księgowego, który nie ma wtyczki.

• konto B2B w hurtowni i dostęp do pliku albo API (w Ikonce: abonament pliku XML albo zwolnienie z opłaty);
• lista kategorii i produktów, które mają trafić na Allegro i do sklepu;
• reguły cen: marża, zaokrąglenia, koszty wysyłki;
• konto Allegro, które podłączasz przez logowanie na stronie Allegro, bez podawania nam hasła;
• dostęp do sklepu albo programu do faktur, jeśli też mają być w przepływie.

Czy da się to połączyć z Twoją platformą sklepu, zależy od tego, co ta platforma udostępnia: API, import pliku albo wtyczkę. Sprawdzamy to przy opisie procesu, przed wyceną. Wycena to ryczałt za zakres albo stawka godzinowa (Regulamin usług wdrożeniowych i dedykowanych, §2).