Integracja Erli: jak podłączyć sklep i integrator
Zespół Fide-Soft ·
Erli to polski marketplace, do którego sklep albo integrator łączy się przez Erli Shop API. Zanim podłączysz kanał, warto znać warunki z regulaminu: kto może sprzedawać, jakie są prowizje i opłaty, czego Erli wymaga od ofert i od czego zależy wypłata środków. Opisujemy też, co integrator synchronizuje z Erli i w którą stronę. Dokumenty Erli sprawdziliśmy 26.10.2026.
Kto może sprzedawać na Erli
Według Regulaminu dla Sprzedających (wersja od 1 października 2026) z Erli korzystają przedsiębiorcy, wyłącznie w celach związanych z działalnością gospodarczą. Firmy z innych krajów Unii Europejskiej sprzedają jako Sprzedający Zagraniczny, z numerem VAT UE. Żeby wystawiać oferty, aktywujesz konto, podając:
- nazwę, pod którą będziesz widoczny na Erli, i firmę, pod którą prowadzisz działalność,
- adres siedziby, NIP, a jeśli zostały nadane, REGON i KRS,
- numer rachunku bankowego,
- imię, nazwisko, telefon i e-mail osoby do kontaktu,
- przy jednoosobowej działalności także datę i miejsce urodzenia.
Po podaniu danych weryfikację prowadzi zewnętrzny operator płatności. Może ona obejmować potwierdzenie tożsamości i przelew na wskazany rachunek. Konta dzielą się na Konto Basic i Konto ERLI Shop, a rodzaj konta zmienisz w panelu w zakładce „Informacje o sklepie”.
Ile kosztuje sprzedaż na Erli
| Opłata | Ile wynosi | Na jakich zasadach |
|---|---|---|
| Prowizja od sprzedaży | od 2,93% do 19,86% brutto, zależnie od kategorii | od ceny towaru z kosztem dostawy, najmniej 0,15 zł; darmowa dostawa i dostawa w Erli PRO nie wchodzą do podstawy |
| Opłata transakcyjna | 1,49% płatności | tylko na Koncie Basic, przy płatnościach przez operatora płatności |
| Koszt podstawowej promocji | 1% wartości zamówienia z dostawą | gdy wpływy brutto z ostatnich 30 dni przekraczają 5 000 zł i nie masz aktywnej kampanii ERLI Campaigns |
| Konto ERLI Shop | 99,90 zł brutto miesięcznie za sklep | pierwszy miesiąc bez opłaty, w zamian narzędzia promocji, logo przy ofertach i rozszerzone statystyki |
Część stawek w cenniku ma próg kwotowy, a część także górny limit prowizji, więc przed wystawieniem sprawdź swoją kategorię w cenniku albo w kalkulatorze opłat na stronie regulaminów Erli. Opłaty i prowizje z danego miesiąca Erli dokumentuje fakturą wystawianą w następnym miesiącu, a gdy przepisy tego wymagają, wystawia ją w KSeF.
Wymagania dla ofert
Regulamin wymienia, co musi mieć każda oferta: pełną nazwę i opis towaru, stałą cenę brutto w złotych, zdjęcie, kategorię z atrybutami i parametrami, dostępną liczbę sztuk oraz warunki sprzedaży, czyli płatność, formy i koszty dostawy, przewidywany termin dostawy, reklamacje, gwarancję i prawo odstąpienia. Dla towarów, które tego wymagają, podajesz klasę energetyczną.
Kilka zasad, o które łatwo się potknąć:
- Minimalna cena oferty to 1 zł brutto.
- Towar powinien być fabrycznie nowy, a regulamin wymienia kategorie zabronione, m.in. alkohol, wyroby tytoniowe i leki na receptę.
- Oferta z czasem dostawy dłuższym niż 7 dni wymaga zgody Erli.
- Na zgłoszenia kupujących odpowiadasz w ciągu 24 godzin, a po anulowaniu zamówienia przez kupującego zwracasz pieniądze w ciągu 3 dni roboczych.
- Nieopłacone zamówienie rozwiązuje się po 48 godzinach przy płatności online i po 7 dniach przy przelewie tradycyjnym albo racie.
W API Erli rękojmia i zasady zwrotu są obowiązkowe dla każdego produktu, a wybierasz je identyfikatorami zasad zapisanych w panelu.
Co synchronizuje integrator z Erli
| Dane | Kierunek | Na co uważać |
|---|---|---|
| Zamówienia | Erli do integratora | lista zamówień według daty zmiany albo skrzynka zdarzeń, do 500 nieprzeczytanych wiadomości naraz, potwierdzanych po przetworzeniu |
| Stany | integrator do Erli | Erli zmniejsza stan po zakupie, ale po anulowaniu go nie przywraca, więc stan musi wysłać integrator |
| Ceny | integrator do Erli | ceny produktu w trakcie promocji nie zmienisz przez API |
| Ręczne zmiany w panelu Erli | zostają w Erli | pole edytowane ręcznie zostaje zamrożone i API go nie nadpisze |
| Status realizacji | integrator do Erli | sprzedawca musi aktualizować stan zamówienia |
| Numer przesyłki | integrator do Erli | przy przesyłkach Erli numer uzupełnia się sam po wygenerowaniu przesyłki |
| Produkty | integrator do Erli | zapis jest asynchroniczny, a zmiana może pojawić się na stronie z opóźnieniem do 20 minut |
Jedna rzecz wpływa na pieniądze. Erli zatrzymuje środki z zamówienia, dopóki nie wprowadzisz numeru przesyłki albo nie zmienisz statusu realizacji. Przy przesyłkach rejestrowanych środki są zwalniane po statusie „wysłana” w śledzeniu przesyłki, a Erli śledzi przesyłki InPost, DHL, DPD, Orlen, Poczty Polskiej, GLS i UPS. Przesyłkę innego przewoźnika regulamin traktuje jak nierejestrowaną.
Drugi szczegół dotyczy koszyka. Gdy kupujący wybierze dla różnych produktów różne metody dostawy, Erli tworzy osobne zamówienie dla każdej metody, więc na liście w integratorze zobaczysz kilka zamówień od jednego klienta.
Jak podłączyć Erli krok po kroku
- Załóż konto sprzedawcy, aktywuj je danymi firmy i przejdź weryfikację operatora płatności.
- Ustaw w panelu Erli cenniki dostaw oraz zasady rękojmi, gwarancji i zwrotów.
- W panelu sklepu wybierz Metoda integracji, Własna integracja po API i skopiuj klucz API. Klucz wkleja się tylko w panelu integratora.
- Powiąż oferty Erli z produktami w integratorze po SKU, zanim włączysz wysyłanie stanów.
- Złóż zamówienie testowe i sprawdź, czy trafia na listę z właściwą dostawą i kwotą.
- Nadaj paczkę i sprawdź, czy numer przesyłki widać w zamówieniu na Erli.
Klucz API przesyłasz w nagłówku Authorization przy każdym zapytaniu. Limit zapytań Erli zmienia się zależnie od obciążenia serwisu, a po jego przekroczeniu API odpowiada kodem 429, więc integrator powinien ponawiać zapytania z odstępem.
Erli w Commerce OS Integrator
Erli jest w tabeli funkcji Commerce OS Integrator razem z Empik, Kaufland, Amazon i eBay. Na wdrożeniu podłączamy Twoje konto sprzedawcy i klucz API i testujemy połączenie na Twoim koncie. Zamówienia z Erli trafiają na tę samą listę co zamówienia z Allegro i sklepu, z tymi samymi folderami statusów. Sprzedaż w jednym kanale zmniejsza stan, a nowy stan wraca do pozostałych kanałów. Numer przesyłki wraca do kanału, w którym klient kupił, a etykietę i fakturę tworzysz z tego samego zamówienia.
Reguły mogą mieć warunek kanału, więc klienci z Erli dostają np. inną treść SMS niż klienci z Allegro. Jak wygląda dzień pracy z Allegro, sklepem i Erli na jednej liście, opisujemy w artykule Jedna lista zamówień z Allegro, sklepu i Erli.
W planie Integrator Start podłączysz do 3 kanałów sprzedaży, w wyższych planach bez limitu. Ceny są w cenniku Integratora. Jeśli dziś obsługujesz Erli przez BaseLinkera, zakres przejścia opisujemy na stronie Migracja z BaseLinkera, a oszczędność policzysz w kalkulatorze zwrotu z migracji.
Na co uważać po podłączeniu
- Ręczne poprawki w panelu Erli. Każde ręcznie edytowane pole zostaje zamrożone, więc późniejsza zmiana z integratora go nie zmieni. Poprawiaj dane w jednym miejscu.
- Anulowane zamówienia. Stan na Erli po anulowaniu nie wraca sam, dlatego integrator musi wysłać aktualny stan.
- Darmowa dostawa. Gdy kupujący nie płaci za dostawę, prowizja nie obejmuje kosztu dostawy, ale wysyłkę płacisz Ty, więc uwzględnij ją w cenie.
- Próg 5 000 zł. Po przekroczeniu progu wpływów z 30 dni bez aktywnej kampanii ERLI Campaigns Erli dolicza 1% kosztu podstawowej promocji.
- Numer przesyłki. Bez numeru środki z zamówienia czekają na wypłatę dłużej.
Najczęstsze pytania
- Ile wynosi prowizja na Erli?
- Zależy od kategorii: według cennika obowiązującego od 3 marca 2026 od 2,93% do 19,86% brutto, liczona od ceny towaru razem z kosztem dostawy. Najniższa prowizja to 0,15 zł.
- Czy na Erli jest abonament?
- Konto Basic nie ma opłaty miesięcznej, ale płaci 1,49% opłaty transakcyjnej od płatności. Konto ERLI Shop kosztuje 99,90 zł brutto miesięcznie za sklep, a pierwszy miesiąc jest bez opłaty.
- Gdzie znajdę klucz API Erli?
- W panelu zarządzania sklepem na Erli, w sekcji Metoda integracji, Własna integracja po API. Klucz dołącza się do każdego zapytania w nagłówku Authorization.
- Czy integrator przenosi numer przesyłki do Erli?
- Tak, integrator wysyła numer przesyłki przez API Erli. Przy metodach dostawy Erli numer uzupełnia się sam po wygenerowaniu przesyłki.
- Dlaczego Erli wstrzymuje wypłatę środków z zamówienia?
- Najczęściej z powodu braku numeru przesyłki albo statusu realizacji. Przy przesyłkach rejestrowanych Erli zwalnia środki po statusie „wysłana” w śledzeniu przesyłki.
- Czy Commerce OS Integrator obsługuje Erli?
- Tak. Erli jest w tabeli funkcji Integratora, a konto sprzedawcy i klucz API podłączamy na wdrożeniu. Zamówienia z Erli są na wspólnej liście, a stany i numery przesyłek wracają do Erli.
Źródła
- Erli: Regulamin dla Sprzedających (od 01.10.2026), stan na 26.10.2026
- Erli: cennik opłat i prowizji (od 03.03.2026), stan na 26.10.2026
- Erli: Regulamin Konta ERLI Shop (od 01.10.2026), stan na 26.10.2026
- Erli: lista regulaminów i kalkulator opłat, stan na 26.10.2026
- Erli Shop API: dokumentacja, stan na 26.10.2026
- Erli: pomoc, rozliczenia i prowizje, stan na 26.10.2026
- Commerce OS Integrator: kanały sprzedaży i wdrożenie, stan na 26.10.2026
Powiązane artykuły
Sprzedaż wielokanałowa
Jedna lista zamówień z Allegro, sklepu i Erli24 października 2026
Jak zarządzać zamówieniami z wielu kanałów w jednym panelu: Allegro, sklep, Erli, Empik, Kaufland. Foldery statusów, wspólne stany, etykiety, faktury i zysk na kanale.
Sprzedaż wielokanałowa
Integracja Empik Marketplace: wymagania i podłączenie26 października 2026
Integracja Empik Marketplace: wymagania dla sprzedawcy, plany i opłata platformowa, oferty po EAN, akceptacja zamówień w 5 dni i podłączenie integratora przez klucz API.
Sprzedaż wielokanałowa
Integracja Kaufland.pl: wymagania i podłączenie26 października 2026
Integracja Kaufland.pl: wymagania dla sprzedawcy, opłata podstawowa i prowizje, oferty po EAN, zamówienia w jednostkach, zwroty i podłączenie integratora do Seller API.