# Integracja Erli: jak podłączyć sklep i integrator

- Adres: https://commerceos.pl/blog/integracja-erli
- Autor: Zespół Fide-Soft (FIDE-SOFT prosta spółka akcyjna)
- Opublikowano: 2026-10-26
- Kategoria: [Sprzedaż wielokanałowa](https://commerceos.pl/blog/kategoria/sprzedaz-wielokanalowa)

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.

## W skrócie

Na Erli sprzedają firmy po weryfikacji przez operatora płatności, a prowizja zależy od kategorii: według cennika od 3 marca 2026 wynosi od 2,93% do 19,86% brutto, liczona od ceny z kosztem dostawy, najmniej 0,15 zł. Konto Basic płaci dodatkowo 1,49% opłaty transakcyjnej, a Konto ERLI Shop kosztuje 99,90 zł brutto miesięcznie za sklep. Integrator pobiera zamówienia przez API Erli i odsyła stany, ceny, status realizacji oraz numer przesyłki, od którego zależy zwolnienie środków.

## 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ąć:

1. Minimalna cena oferty to 1 zł brutto.
2. Towar powinien być fabrycznie nowy, a regulamin wymienia kategorie zabronione, m.in. alkohol, wyroby tytoniowe i leki na receptę.
3. Oferta z czasem dostawy dłuższym niż 7 dni wymaga zgody Erli.
4. 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.
5. 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

1. Załóż konto sprzedawcy, aktywuj je danymi firmy i przejdź weryfikację operatora płatności.
2. Ustaw w panelu Erli cenniki dostaw oraz zasady rękojmi, gwarancji i zwrotów.
3. W panelu sklepu wybierz Metoda integracji, Własna integracja po API i skopiuj klucz API. Klucz wkleja się tylko w panelu integratora.
4. Powiąż oferty Erli z produktami w integratorze po SKU, zanim włączysz wysyłanie stanów.
5. Złóż zamówienie testowe i sprawdź, czy trafia na listę z właściwą dostawą i kwotą.
6. 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.

**Ile zaoszczędzisz, przechodząc z BaseLinkera?** [Policz zwrot z migracji](https://commerceos.pl/integrator#zwrot) albo [umów rozmowę o wdrożeniu](https://commerceos.pl/integrator#wdrozenie).

## Erli w Commerce OS Integrator

Erli jest w tabeli funkcji [Commerce OS Integrator](https://commerceos.pl/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](https://commerceos.pl/blog/jedna-lista-zamowien-allegro-sklep-erli).

W planie Integrator Start podłączysz do 3 kanałów sprzedaży, w wyższych planach bez limitu. Ceny są w [cenniku Integratora](https://commerceos.pl/integrator/cennik). Jeśli dziś obsługujesz Erli przez BaseLinkera, zakres przejścia opisujemy na stronie [Migracja z BaseLinkera](https://commerceos.pl/integrator/migracja-z-baselinkera), a oszczędność policzysz w [kalkulatorze zwrotu z migracji](https://commerceos.pl/integrator#zwrot).

## 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)](https://erli.pl/regulaminy/sprzedawcy-01-10-2026), stan na 26.10.2026
- [Erli: cennik opłat i prowizji (od 03.03.2026)](https://pliki.erli.pl/cennik-03-03-2026.pdf), stan na 26.10.2026
- [Erli: Regulamin Konta ERLI Shop (od 01.10.2026)](https://erli.pl/regulaminy/erli-shop-01-10-2026), stan na 26.10.2026
- [Erli: lista regulaminów i kalkulator opłat](https://erli.pl/regulaminy), stan na 26.10.2026
- [Erli Shop API: dokumentacja](https://erli.pl/svc/shop-api/doc), stan na 26.10.2026
- [Erli: pomoc, rozliczenia i prowizje](https://erli.pl/kontakt-z-erli/wsparcie/settlements?faqId=4), stan na 26.10.2026
- [Commerce OS Integrator: kanały sprzedaży i wdrożenie](https://commerceos.pl/integrator), stan na 26.10.2026