Przejdź do treści

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łataIle wynosiNa jakich zasadach
Prowizja od sprzedażyod 2,93% do 19,86% brutto, zależnie od kategoriiod ceny towaru z kosztem dostawy, najmniej 0,15 zł; darmowa dostawa i dostawa w Erli PRO nie wchodzą do podstawy
Opłata transakcyjna1,49% płatnościtylko na Koncie Basic, przy płatnościach przez operatora płatności
Koszt podstawowej promocji1% 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 Shop99,90 zł brutto miesięcznie za skleppierwszy 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

DaneKierunekNa co uważać
ZamówieniaErli do integratoralista zamówień według daty zmiany albo skrzynka zdarzeń, do 500 nieprzeczytanych wiadomości naraz, potwierdzanych po przetworzeniu
Stanyintegrator do ErliErli zmniejsza stan po zakupie, ale po anulowaniu go nie przywraca, więc stan musi wysłać integrator
Cenyintegrator do Erliceny produktu w trakcie promocji nie zmienisz przez API
Ręczne zmiany w panelu Erlizostają w Erlipole edytowane ręcznie zostaje zamrożone i API go nie nadpisze
Status realizacjiintegrator do Erlisprzedawca musi aktualizować stan zamówienia
Numer przesyłkiintegrator do Erliprzy przesyłkach Erli numer uzupełnia się sam po wygenerowaniu przesyłki
Produktyintegrator do Erlizapis 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.

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

  • Sprzedaż wielokanałowa

    Jedna lista zamówień z Allegro, sklepu i Erli

    24 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łączenie

    26 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łączenie

    26 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.

Wszystkie artykuły: Sprzedaż wielokanałowa