Integracja IdoSell z Allegro, BaseLinker i InPost — 3 metody i jak wybrać [2026]

Integracja IdoSell z Allegro, BaseLinker i InPost — jak to zrobić dobrze w 2026?

Kiedy przychodzi do mnie właściciel sklepu na IdoSell z pytaniem "jak zintegrować z Allegro?", pierwsze pytanie które zadaję brzmi: ile kanałów sprzedaży obsługujesz i ile zamówień dziennie? Odpowiedź decyduje o tym, czy wystarczy natywna integracja IdoSell, czy potrzebujesz BaseLinker jako middleware, czy może niestandardowego rozwiązania przez REST API.

IdoSell (dawniej IAI-Shop) to jeden z największych polskich systemów e-commerce SaaS — obsługuje sklepy generujące od kilkudziesięciu do kilkunastu tysięcy zamówień miesięcznie. Błąd synchronizacji przy 5 zamówieniach dziennie to drobna niedogodność. Przy 500 — to realna strata pieniędzy i negatywne opinie na Allegro.

W tym artykule opisuję 3 metody integracji IdoSell z Allegro, BaseLinker i InPost — z konkretnymi kosztami 2026 w PLN, checklistą gotowości 8pkt, sekcją o KSeF i typowymi błędami których możesz uniknąć.

Czym jest IdoSell i do kogo jest skierowany?

IdoSell to SaaS e-commerce klasy enterprise, skupiony na polskim rynku. Od 2022 roku platforma należy do grupy Comarch, co ma bezpośrednie znaczenie dla integracji ERP — natywna obsługa Comarch Optima i XL jest wbudowana. W przeciwieństwie do WooCommerce czy Shoper, IdoSell jest kierowany do sklepów z wolumenem powyżej 300–500 zamówień miesięcznie: ma wbudowaną obsługę wielu magazynów, zaawansowany cennik B2B i automatyzacje wielokanałowe.

Kto korzysta z IdoSell w Polsce:

• sklepy omnichannelowe z kilkoma kanałami (własna strona + Allegro + Empik + Erli)
• dystrybutorzy hurtowi z modułem B2B i dedykowanymi cennikami per klient
• sklepy z własną siecią stacjonarną (integracja z kasami fiskalnymi POS)
• firmy z własnym magazynem, które potrzebują WMS zintegrowanego z e-commerce

To nie jest platforma dla sklepu stawiającego pierwsze kroki — jeśli masz mniej niż 100 zamówień miesięcznie i jeden kanał sprzedaży, IdoSell to over-engineering. Ale przy skalowaniu do wielokanałowości IdoSell ma istotną przewagę: zarządzanie produktami, stanami i zamówieniami z wielu kanałów w jednym miejscu.

3 metody integracji IdoSell z Allegro — porównanie

Zanim przejdę do szczegółów każdej metody, najważniejsze pytanie: czy IdoSell integruje się z Allegro natywnie, czy potrzebujesz zewnętrznego narzędzia?

Integracja natywna istnieje w panelu IdoSell (ustawienia → sprzedaż wielokanałowa → Allegro). Ale ma ograniczenia, które przy wyższych wolumenach lub wielokanałowości wymuszają inne podejście.

Metoda	Koszt wdrożenia	Najlepsza dla	Ograniczenia
Natywna IdoSell–Allegro	0 zł (w abonamencie)	< 200 ofert, 1 konto Allegro	Wolniejsza sync, brak batch
BaseLinker jako middleware	2 000–8 000 zł setup	200–5 000 ofert, multi-konto	+ 149–499 zł/mies. abonament
Custom API (REST IdoSell)	15 000–60 000 zł	> 5 000 zamówień/mies., własny WMS	Wdrożenie 4–10 tygodni

Metoda 1: Integracja natywna IdoSell–Allegro

Wbudowana w panel IAI integracja obsługuje:

• wystawianie i aktualizację ofert na Allegro (produkty z bazy IdoSell mapowane do kategorii Allegro)
• pobieranie zamówień do panelu IAI (statusy, dane kupującego, adres dostawy)
• synchronizację stanów magazynowych (domyślnie co 15–30 minut)
• generowanie etykiet dla InPost, DPD, GLS bezpośrednio z panelu

Konfiguracja: panel IdoSell → Sprzedaż wielokanałowa → Allegro → zaloguj przez OAuth2 → mapuj kategorie → włącz synchronizację.

Natywna integracja wystarczy dla jednego sklepu, jednego konta Allegro, do 200 aktywnych ofert i do 100 zamówień dziennie. Dla takiego scenariusza nie musisz płacić za BaseLinker.

Kiedy natywna integracja zaczyna zawodzić: przy sprzedaży równoległej na Allegro i Erli stany magazynowe synchronizują się osobno dla każdego kanału — ryzyko oversellingu rośnie. Brak batch operations oznacza też, że generowanie 200 etykiet dziennie zajmuje więcej czasu niż w BaseLinker.

Metoda 2: BaseLinker jako middleware dla IdoSell

BaseLinker to najpopularniejszy w Polsce system do zarządzania zamówieniami wielokanałowymi. Przy integracji IdoSell + BaseLinker + Allegro podział ról jest następujący:

IdoSell — master catalog: zarządza bazą produktów, stanami magazynowymi, cennikami B2B, powiązaniem z ERP.

BaseLinker — order hub: zbiera zamówienia ze wszystkich kanałów (Allegro, Erli, Empik, własny sklep), stosuje automatyczne reguły (zmiany statusów, generowanie etykiet, wystawianie faktur), przekazuje zamówienia z powrotem do IdoSell lub bezpośrednio do kuriera.

Allegro, Erli, Empik — kanały sprzedaży obsługiwane przez BaseLinker, nie przez IdoSell bezpośrednio.

Główne zalety BaseLinker jako middleware: - batch processing etykiet (200+ przesyłek jednocześnie) - reguły automatyzacji: "opłacone → generuj etykietę InPost → wyślij e-mail → zmień status" - centralna obsługa zwrotów i reklamacji z jednego interfejsu - obsługa wielu kont Allegro (np. B2B i B2C osobno) - integracja z InPost One API, DPD, DHL, GLS, Poczta Polska, Apaczka

Z projektu który realizowałem dla dystrybutora sprzętu AGD: przed BaseLinker obsługa 400 zamówień dziennie z Allegro i własnego sklepu zajmowała 6 godzin pracy magazyniera. Po wdrożeniu BaseLinker z regułami automatyzacji — 90 minut. Zwrot z inwestycji (wdrożenie 4 500 zł + abonament 249 zł/mies.) nastąpił w trzecim miesiącu.

Metoda 3: Custom integracja przez REST API IdoSell

IdoSell udostępnia REST API (dokumentacja: developer.idosell.com) dla integracji niestandardowych. Kiedy ma to sens:

• masz własny WMS z unikalną logiką magazynową (system lokalizacji półkowych, cross-docking, pick & pack z własnym algorytmem)
• obsługujesz B2B z dedykowanymi cennikami per klient wymagającymi integracji z CRM (Salesforce, HubSpot) przy każdej transakcji
• planujesz integrację z systemem ERP który nie jest obsługiwany przez BaseLinker (starszy SAP, własny system legacy)
• potrzebujesz dwukierunkowej synchronizacji danych klientów między IdoSell a CRM

W HeyNeuron realizowałem projekt custom API dla dystrybutora elektroniki: IdoSell REST API → własny system WMS → automatyczne generowanie zamówień zakupowych u dostawców przy spadku stanu poniżej progu. Projekt trwał 6 tygodni, koszt 25 000 zł — ale oszczędność na ręcznym przepisywaniu zamówień to 80 roboczogodzin miesięcznie. Zwrot inwestycji w 4 miesiące.

Integracja IdoSell z BaseLinker — krok po kroku

Pełna konfiguracja integracji IdoSell ↔ BaseLinker wymaga działań po obu stronach:

Strona IdoSell (panel IAI):

1. Ustawienia → Integracje → BaseLinker → wygeneruj klucz API (pojawia się raz — zanotuj od razu)
2. Skonfiguruj magazyn domyślny dla zamówień BaseLinker (lub utwórz dedykowany magazyn "BL")
3. Ustaw parametry synchronizacji stanów: wybierz webhooks real-time (nie pooling co 15 min)
4. Skonfiguruj mapowanie statusów IdoSell do statusów BaseLinker — to krytyczny krok

Strona BaseLinker:

1. Integracje → Sklepy → Dodaj sklep → wybierz IdoSell
2. Wklej klucz API z panelu IdoSell, wybierz magazyn
3. Skonfiguruj mapowanie statusów: status IdoSell "nowe" → status BL "nowe" → status Allegro "W toku"
4. Ustaw reguły automatyzacji: "Opłacone → wygeneruj etykietę InPost → wyślij e-mail → zmień status na W realizacji"
5. Przetestuj na co najmniej 10 zamówieniach testowych przed uruchomieniem produkcyjnym

Najczęstszy błąd: nieprawidłowe mapowanie statusów. Jeśli IdoSell i BaseLinker używają różnych kodów statusów, zamówienia "wiszą" w kolejce bez przetworzenia. Zawsze mapuj status po statusie z dokumentacją obu systemów otwartą jednocześnie.

Obsługa zwrotów przez BaseLinker. Zwroty Allegro generują w BaseLinker status "zwrot przyjęty". Musisz mieć regułę: "zwrot przyjęty → aktualizuj stan magazynu w IdoSell +1 sztuka". Bez tej reguły po 100 zwrotach masz 100 "zaginionych" sztuk — fizycznie wróciły do magazynu, ale w systemie ich nie ma.

Integracja IdoSell z InPost One API w 2026

InPost zakończył w Q3 2025 migrację ze starego ShipX API (api-shipx-pl.easypack24.net) na InPost One API (api.inpost.pl). Jeśli konfiguracja była robiona przed tym terminem, wymaga aktualizacji.

Jeśli używasz BaseLinker: aktualizacja do One API nastąpiła automatycznie z wersją BaseLinker 6.2. Nie musisz nic robić po stronie konfiguracji IdoSell.

Jeśli integrujesz InPost bezpośrednio z IdoSell (bez BaseLinker):

1. Wejdź na developer.inpost.pl i wygeneruj nowe klucze OAuth2 (token JWT)
2. Panel IdoSell → Kurierzy → InPost → zaktualizuj endpoint na api.inpost.pl oraz Bearer Token
3. Przetestuj generowanie etykiet dla: Paczkomat (APM), Kurier (COURIER) i InPost Flex
4. Sprawdź czy stary ShipX endpoint jest wyłączony z konfiguracji

InPost Flex w 2026. InPost Flex (nadanie przez kuriera lub punkt Żabka) stało się popularnym rozwiązaniem dla sklepów bez własnego magazynu. IdoSell obsługuje Flex przez BaseLinker od wersji 6.3 — konfiguracja identyczna jak standardowy kurier InPost, tylko inny typ przesyłki w żądaniu API.

Integracja IdoSell z Erli — wielokanałowość w praktyce

Erli (erli.pl) to drugi co do wielkości marketplace w Polsce. Pojawienie się "erli integracja idosell" w Google Autocomplete potwierdza, że sprzedawcy aktywnie szukają tej integracji.

IdoSell obsługuje Erli natywnie od 2023 roku: panel → Sprzedaż wielokanałowa → Erli → klucz API z panelu sprzedawcy Erli. Integracja obejmuje wystawianie ofert, synchronizację stanów i pobieranie zamówień.

Przy wielokanałowej sprzedaży (Allegro + Erli + własny sklep + Empik), BaseLinker jako centralny hub zamówień jest znacznie wygodniejszy. W BaseLinker masz jedno miejsce dla wszystkich zamówień, jedno miejsce dla etykiet i jeden widok stanów magazynowych.

Pułapka przy Erli + IdoSell: Erli ma inne wymagania zdjęciowe (ratio 1:1 vs 4:3 na Allegro) i inną strukturę opisów. Jeśli wystawiasz oferty natywnie z IdoSell na oba marketplace'y, musisz przygotować osobne szablony ofert — nie da się użyć tego samego opisu i zdjęć bez modyfikacji.

KSeF i automatyczne fakturowanie w IdoSell 2026

KSeF (Krajowy System e-Faktur) stał się obowiązkowy dla transakcji B2B w 2026 roku. IdoSell posiada natywną integrację z KSeF od wersji IAI 2025.

Co trzeba skonfigurować w panelu IdoSell:

1. Faktury → KSeF → token autoryzacyjny z biznes.gov.pl (generujesz go w sekcji "Zarządzanie tokenami" → "Wystawianie faktur")
2. Ustaw tryb na "produkcja" (nie "testowy" — to najczęstszy błąd: faktury trafiają do środowiska testowego KSeF i klient ich nie widzi)
3. Skonfiguruj mapowanie typów faktur: faktura VAT → KSeF type FA, faktura zaliczkowa → FA_RR, proforma → poza KSeF (proformy nie są fakturą VAT)
4. Przetestuj z jednym zamówieniem B2B i sprawdź czy faktura pojawia się na koncie klienta w KSeF

Faktury B2C (dla osób fizycznych) nie wymagają KSeF — wystawiasz tradycyjnie lub na żądanie klienta.

Ważne: jeśli faktury wystawiasz w BaseLinker (a nie w IdoSell), konfigurację KSeF robisz po stronie BaseLinker, nie IdoSell. Obie ścieżki są prawidłowe — wybór zależy od tego gdzie masz workflow fakturowania.

Ile kosztuje integracja IdoSell? Realne widełki 2026

Zakres integracji	Koszt wdrożenia	Koszt miesięczny
Natywna Allegro + InPost (samodzielnie)	0 zł	0 zł dodatkowych
BaseLinker setup przez agencję (1 marketplace)	2 000–4 000 zł	149–249 zł (BL)
BaseLinker (Allegro + Erli + InPost + KSeF)	4 000–8 000 zł	249–499 zł (BL)
Custom REST API (ERP/WMS/CRM integracja)	15 000–60 000 zł	500–2 000 zł utrzymanie

Co wchodzi w koszt wdrożenia przez agencję:

• analiza procesów i mapowanie przepływu zamówień
• konfiguracja BaseLinker: kanały, kurierzy, reguły automatyzacji
• konfiguracja KSeF jeśli w zakresie
• testy na 50+ zamówieniach testowych
• szkolenie zespołu (2–4 godziny)
• dokumentacja konfiguracji (kluczowa przy rotacji pracowników)

Samodzielna konfiguracja (IdoSell + BaseLinker + Allegro + InPost) jest możliwa — zajmuje 8–16 godzin i jest wykonalna na podstawie dokumentacji. Problemy zaczynają się przy edge cases: zamówienie wpłynęło z Allegro i Erli jednocześnie na ten sam produkt, a w magazynie jest jeden egzemplarz.

Checklist gotowości przed integracją IdoSell

Brak któregokolwiek z tych elementów to przyczyna 80% problemów przy audytach istniejących integracji:

• Produkty mają unikalne EAN lub SKU — bez tego synchronizacja stanów jest niemożliwa
• Stany magazynowe są aktualne w IdoSell — błędne stany na start = overselling w pierwszym dniu
• API IdoSell jest aktywne — panel → konto → API → wygeneruj klucz (pojawia się raz)
• [ ] Konto Allegro powiązane przez OAuth2 (nie login/hasło — stary, niezabezpieczony sposób)
• InPost One API skonfigurowane — sprawdź czy używasz nowego api.inpost.pl (nie starego ShipX)
• Mapowanie kategorii Allegro gotowe — IdoSell kategorie ≠ Allegro taksonomia; błędne mapowanie = oferty w złych kategoriach
• [ ] KSeF token aktywny lub planujesz konfigurację przed pierwszą transakcją B2B
• Środowisko testowe — testuj na dedykowanym sklepie testowym, nie na produkcji

Czerwone flagi złej integracji IdoSell

Na podstawie audytów istniejących integracji, widzę te same błędy. Warto ich unikać od początku:

Polling zamiast webhooków. Jeśli synchronizacja stanów odbywa się co 15–30 minut, możesz sprzedawać towar który już nie istnieje — szczególnie przy flash sale. IdoSell obsługuje webhooks real-time. W BaseLinker to ustawienie "Synchronizacja w czasie rzeczywistym" — zawsze je włącz.

Brak reguły dla anulowań. Anulowane zamówienia Allegro muszą automatycznie zwracać stan do magazynu w IdoSell. Bez reguły "anulowanie → +1 stan" stany rozsynchronizują się w ciągu tygodnia przy kilkudziesięciu anulacjach.

Jedna instancja dla testów i produkcji. Widziałem przypadki gdzie testowe zamówienia trafiały na produkcję, generując prawdziwe etykiety i faktury. Używaj osobnego środowiska testowego IdoSell lub dedykowanego konta BaseLinker "test".

Brak monitoringu logów. IdoSell i BaseLinker mają logi synchronizacji — skonfiguruj alerty e-mail lub Slack na błędy. Bez alertów dowiadujesz się o problemie od klientów, nie od systemu.

Ignorowanie zwrotów. Zwroty Allegro generują specjalny status w BaseLinker. Bez reguły "zwrot zaakceptowany → +1 stan w IdoSell" tracisz towar w systemie: fizycznie wrócił do magazynu, ale w systemie jest zerem.

FAQ — Integracja IdoSell z Allegro, BaseLinker i InPost

Czy IdoSell integruje się z Allegro bez BaseLinker?

Tak, integracja natywna IdoSell–Allegro jest w standardowym abonamencie. Wystarczy dla jednego konta Allegro z mniejszym wolumenem (do 200 aktywnych ofert i 100 zamówień dziennie). Przy większej skali lub wielokanałowości BaseLinker daje lepszą kontrolę i automatyzację.

Ile kosztuje integracja IdoSell z BaseLinker?

Abonament BaseLinker: 149–499 zł miesięcznie w zależności od liczby zamówień. Wdrożenie przez agencję: 2 000–8 000 zł jednorazowo w zależności od zakresu. Samodzielna konfiguracja przy prostym scenariuszu jest możliwa i zajmuje 8–16 godzin.

Czy integracja InPost z IdoSell wymaga aktualizacji w 2026?

Tak, jeśli konfiguracja była robiona przed Q3 2025 — stare ShipX API zostało zdeprecjonowane. Należy przejść na InPost One API (api.inpost.pl) z OAuth2. Przez BaseLinker — aktualizacja jest automatyczna od wersji 6.2.

Jak zintegrować IdoSell z Erli?

Natywnie: panel IdoSell → Sprzedaż wielokanałowa → Erli → klucz API z panelu sprzedawcy Erli. Przy sprzedaży wielokanałowej (Allegro + Erli + sklep), BaseLinker jako centralny hub zamówień jest znacznie wygodniejszy niż zarządzanie każdym kanałem z IdoSell osobno.

Czy IdoSell obsługuje KSeF automatycznie?

Tak, od wersji IAI z 2025 roku. Faktury B2B wystawiane w panelu są przesyłane do KSeF automatycznie. Wymagana konfiguracja: token z biznes.gov.pl i tryb "produkcja" (nie "sandbox" — typowy błąd powodujący niewidzialność faktur).

Jak działa synchronizacja stanów między IdoSell a BaseLinker?

IdoSell wysyła webhook do BaseLinker przy każdej zmianie stanu (sprzedaż, zwrot, przyjęcie dostawy). BaseLinker aktualizuje stany na Allegro i pozostałych kanałach. Webhooks real-time eliminują opóźnienia poolingu i ryzyko oversellingu przy gwałtownych wyprzedażach.

Jak zintegrować IdoSell z SubiektGT lub nexo?

Comarch Optima i XL są obsługiwane natywnie przez IdoSell. Dla Subiekt GT/nexo: przez integrator trzeci (SellIntegro, SubSync) lub przez BaseLinker ERP module. Subiekt nexo z REST API daje lepsze możliwości automatyzacji niż GT (który obsługuje tylko Sferę COM ze starszym interfejsem).

Kiedy potrzebuję custom API zamiast BaseLinker?

Custom REST API IdoSell ma sens gdy masz własny WMS z unikalną logiką magazynową, obsługujesz B2B z dedykowanymi cennikami per klient wymagającymi integracji z CRM, albo planujesz integracje z systemami których BaseLinker nie obsługuje standardowo (SAP, własny ERP legacy).

Podsumowanie

Integracja IdoSell z Allegro, BaseLinker i InPost jest technicznie dobrze udokumentowana — platformy mają otwarte API i wbudowane konektory. Trudność leży w szczegółach: mapowanie statusów, obsługa zwrotów i anulacji, webhooks zamiast poolingu, aktualizacja do InPost One API i konfiguracja KSeF.

Z doświadczenia: 80% sklepów na IdoSell dobrze obsłuży BaseLinker jako middleware — to sprawdzony hub dla sprzedaży wielokanałowej z możliwością rozbudowy o kolejne kanały. Integracja custom API ma sens gdy wolumen lub specyfika procesów wychodzi poza standardowy scenariusz.

Jeśli chcesz przeprowadzić audyt swojej obecnej integracji lub wdrożyć nową od zera — skontaktuj się z nami. W HeyNeuron realizowałem integracje dla sklepów od 200 do 8 000 zamówień miesięcznie.

Więcej o integracjach e-commerce: - Integracja BaseLinker ze sklepem online - Integracja PrestaShop z Allegro, BaseLinker i InPost - Integracja Shoper z Allegro i BaseLinker - Automatyzacja zamówień z integracją ERP - Integracja InPost ze sklepem - Integracja Allegro ze sklepem - Usługi integracji HeyNeuron