BerlinettaBerlinetta

Blog11 min czytania

Integracja Erli z WooCommerce: oferty, stany i zamówienia

Jak połączyć Erli z WooCommerce: sposoby integracji, wymagane dane, synchronizacja stanów i cen, zamówienia i przesyłki oraz typowe błędy do wyłapania.

Zespół BerlinettySprzedaż wielokanałowa w praktyce

W tym artykule

Erli i WooCommerce łączysz na jeden z trzech sposobów. Możesz napisać własne połączenie przez API, kupić wtyczkę do sklepu albo podpiąć oba kanały do jednego systemu sprzedaży wielokanałowej. Gdy sprzedajesz w obu miejscach i chcesz mieć wspólny magazyn, najmniej pracy daje trzecia droga. Produkt opisujesz raz, stan i cena trafiają na ofertę w Erli i do sklepu, a zamówienia z obu kanałów obsługujesz w jednym panelu. Tak działa Berlinetta: to polski system, który zbiera zamówienia z Erli, WooCommerce, Allegro i innych kanałów, a nadawanie paczek i fakturowanie ma w tym samym miejscu. Poniżej przechodzimy przez całą integrację krok po kroku: co przygotować, jak połączyć produkty, jak utrzymać zgodne stany i co sprawdzić przed startem.

Krótko mówiąc

  • Erli udostępnia Shop API w architekturze REST, a dostęp do niego ma tylko sklep zarejestrowany na marketplace.
  • WooCommerce wymienia dane przez REST API, do którego generujesz klucze Consumer Key i Consumer Secret z odpowiednimi uprawnieniami.
  • Integracja ma przenosić trzy rzeczy: oferty z cenami, stany magazynowe oraz zamówienia ze statusem i numerem przesyłki.
  • Najczęstsze błędy to niespójne SKU, warianty połączone z niewłaściwymi pozycjami i dwa miejsca, w których ktoś ręcznie zmienia stan.
  • System wielokanałowy z jednym magazynem rozwiązuje te problemy u źródła. W Berlinettcie pakiet zaczyna się od 89 zł netto miesięcznie, a przez pierwsze 30 dni korzystasz za darmo.

Co właściwie ma robić integracja Erli z WooCommerce

Sklep na WooCommerce i konto na Erli to dwa osobne systemy. Każdy ma własną listę produktów, własne stany i własne zamówienia. Bez połączenia sprzedajesz ten sam towar w dwóch miejscach i liczysz na to, że zdążysz poprawić stan, zanim ktoś kupi ostatnią sztukę drugi raz.

Dobra integracja przejmuje trzy przepływy danych:

  1. Oferty i ceny. Produkt opisany raz pojawia się w obu kanałach, z poprawną kategorią, parametrami i ceną.
  2. Stany magazynowe. Sprzedaż w jednym kanale od razu zmniejsza dostępność w drugim.
  3. Zamówienia i realizacja. Zamówienie z Erli trafia tam, gdzie je pakujesz. Erli dostaje z powrotem status i numer przesyłki.

Ostatni punkt jest obowiązkowy. Zgodnie z dokumentacją Erli sprzedawca musi aktualizować stan zamówień, przez API albo w panelu, i wprowadzać informacje o śledzeniu przesyłki. Jeśli integracja tego nie robi, zostaje ręczne przepisywanie danych przy każdej paczce.

Trzy sposoby połączenia sklepu z Erli

Połączenie Erli z WooCommerce nie sprowadza się do jednego przycisku w panelu marketplace’u. Wybierasz model, który decyduje o tym, ile pracy zostaje po Twojej stronie.

Sposób Gdzie są dane Co obsługuje Co zostaje po Twojej stronie
System wielokanałowy (np. Berlinetta) Jeden panel z kartą produktu i wspólnym magazynem Oferty, stany, ceny, zamówienia, wysyłka, faktury, także dla Allegro i innych kanałów Konfiguracja kont i połączenie produktów
Wtyczka w WooCommerce Sklep jest centrum, Erli dostaje dane z WordPressa Zwykle oferty i stany z listy produktów w sklepie Wysyłka, dokumenty i każdy kolejny marketplace osobno
Własna integracja po API Twój kod między Erli a sklepem To, co zaprogramujesz Utrzymanie kodu, obsługa błędów, zmiany w API

Własna integracja ma sens w firmach z działem IT. Takie projekty często zaczynają się od kilkumiesięcznego pilotażu, jak w opisie wdrożenia integracji CRM z ERP, a potem wymagają stałego utrzymania. Wtyczka rozwiązuje jeden kanał. Gdy dochodzi Allegro, kurierzy i faktury z KSeF, liczba osobnych narzędzi rośnie.

Dla małego i średniego sklepu najprostszy jest system wielokanałowy. Dane o towarze, stanie i zamówieniu są w jednym miejscu, a Erli i WooCommerce stają się kanałami sprzedaży tego samego magazynu. Jeśli porównujesz konkretne narzędzia, zestawienie najlepszych integracji Erli pokazuje różnice w funkcjach i cenach.

Co przygotować przed konfiguracją

Zanim połączysz kanały, zbierz dostępy i uporządkuj dane. To oszczędza większość poprawek po starcie.

Po stronie Erli:

  • Aktywne konto sprzedawcy. Według dokumentacji dostęp do Shop API ma tylko sklep zarejestrowany na marketplace.
  • Wybraną metodę integracji w panelu Erli. Klucz API do własnego połączenia znajdziesz w sekcji „Metoda integracji > Własna integracja po API”.
  • Ustawione cenniki dostaw i dane zwrotów, bo pojawiają się na każdej ofercie.

Po stronie WooCommerce:

  • Konto administratora sklepu.
  • Klucze REST API. WooCommerce pozwala nadać im uprawnienie read, write lub read/write. Do synchronizacji stanów i zamówień potrzebny jest zapis, więc samo „read” nie wystarczy.
  • Sklep dostępny przez HTTPS, bo na tym opiera się bezpieczna wymiana danych.

Po stronie produktów:

  • Unikalne SKU dla każdego produktu i każdego wariantu.
  • Kody EAN tam, gdzie je masz.
  • Kompletne opisy, zdjęcia i parametry. Erli wymaga też danych producenta zgodnych z GPSR, czyli unijnym rozporządzeniem o ogólnym bezpieczeństwie produktów. Uzupełnij je przed wystawieniem, a nie po odrzuceniu oferty.

Integracja krok po kroku

Tak wygląda połączenie Erli i WooCommerce w systemie wielokanałowym. Przy każdym kroku piszemy, gdzie najczęściej pojawiają się błędy.

  1. Załóż konto w systemie. W Berlinettcie konto testowe zakładasz sam i od razu zaczynasz pracę, bez wdrożenia. Masz 30 dni bezpłatnego testu, więc całą konfigurację przejdziesz na prawdziwych danych.
  2. Podłącz sklep WooCommerce. Podajesz adres sklepu i dane dostępowe. Najczęstszy błąd to klucze tylko do odczytu: system widzi produkty, ale nie może zmienić stanu ani dodać zamówienia.
  3. Podłącz konto Erli. Łączysz konto sprzedawcy z panelem. Sprawdź, czy wybrana w Erli metoda integracji zgadza się z narzędziem, którego używasz.
  4. Zbuduj katalog. Produkty pobierasz ze sklepu albo zakładasz w panelu. W Berlinettcie produkt opisujesz raz i z jego karty wystawiasz oferty we wszystkich kanałach.
  5. Połącz istniejące oferty. Jeśli masz już oferty na Erli, połącz je z produktami po SKU lub EAN. Pominięcie tego kroku tworzy duplikaty, a stany rozjeżdżają się od pierwszego dnia.
  6. Ustaw stany i ceny. Wybierz jedno źródło stanu. W Berlinettcie wspólny stan i ceny same trafiają na oferty w Erli i do sklepu.
  7. Skonfiguruj wysyłkę. Podłącz konta kurierskie i zdecyduj, jak nadajesz paczki z Erli. Berlinetta obsługuje InPost, DHL, GLS, DPD, Pocztę Polską i FedEx, brokerów Furgonetka i Base.courier oraz ErliPRO.
  8. Ustaw dokumenty. Faktury i paragony wystawiasz z zamówienia, z wysyłką do KSeF. Jeśli prowadzisz księgowość w inFakcie albo w Subiekcie nexo PRO, Berlinetta się z nimi łączy.
  9. Przetestuj na jednym produkcie. Zanim włączysz cały katalog, przeprowadź pełny cykl zamówienia. Opisujemy go niżej.

Produkty, warianty i SKU

SKU, czyli wewnętrzny kod produktu, jest kluczem, po którym system rozpoznaje ten sam towar w obu kanałach. Gdy w sklepie koszulka ma SKU „KOS-CZ-M”, a na Erli oferta tej samej koszulki ma inny kod albo nie ma go wcale, integracja nie wie, że to jeden produkt.

Najwięcej problemów sprawiają warianty. W WooCommerce produkt zmienny ma wariacje, na przykład rozmiar i kolor, a każda powinna mieć własne SKU i własny stan. Na Erli każdy wariant musi trafić do właściwej pozycji. Trzy zasady oszczędzają godziny poprawek:

  • Jeden wariant, jedno SKU. Nie używaj kodu produktu nadrzędnego dla wszystkich rozmiarów.
  • Te same nazwy parametrów. „M” w sklepie i „Rozmiar M” na Erli to dla człowieka to samo, dla mapowania niekoniecznie.
  • Stała struktura kodów. Ustal schemat, np. model, kolor i rozmiar, i trzymaj się go przy nowych produktach.

Karta produktu w systemie wielokanałowym porządkuje to od strony magazynu. Wariant istnieje raz, ma jeden stan i jedno SKU, a oferty w kanałach są jego odbiciem.

Stany i ceny bez sprzedaży na minusie

Overselling, czyli sprzedaż towaru, którego już nie masz, to najdroższy skutek braku integracji. Zamówienie trzeba anulować, klient jest niezadowolony, a ocena konta na marketplace spada.

Najpewniejszy model to jeden wspólny stan, z którego korzystają wszystkie kanały. Sprzedaż w sklepie zmniejsza stan w magazynie, a ten od razu trafia na ofertę w Erli. Działa to też odwrotnie. Model ten opisujemy szerzej w tekście o synchronizacji stanów w e-commerce.

Dwie praktyczne wskazówki:

  • Zmieniaj stan w jednym miejscu. Ręczna korekta w panelu WooCommerce, gdy źródłem jest system, zostanie nadpisana albo stworzy rozbieżność.
  • Ustal rezerwę dla ostatnich sztuk. Przy towarze o dużej rotacji pokaż w kanałach o sztukę mniej niż w magazynie.

Ceny warto ustawiać osobno dla kanałów. Na Erli prowizja wynosi od 2,93% do 19,86% brutto zależnie od kategorii (cennik obowiązuje od 3 marca 2026 r.). Liczy się ją od ceny razem z dostawą, poza Erli PRO i dostawą za 0 zł. Cena na Erli powinna to uwzględniać, a system z regułami cenowymi zrobi to za Ciebie przy każdej zmianie.

Zamówienia, statusy i numer przesyłki

Shop API Erli przechowuje nowe zdarzenia w tak zwanym inboksie. Zamówienia można też pobierać z listy zamówień, filtrując po dacie aktualizacji. W praktyce dla Ciebie liczy się efekt: zamówienie z Erli pojawia się w panelu obok zamówień ze sklepu, z danymi kupującego, wybraną dostawą i płatnością.

Pełny cykl zamówienia z Erli wygląda tak:

  1. Zamówienie trafia do panelu i zmniejsza wspólny stan.
  2. Pakujesz towar i nadajesz paczkę. W Berlinettcie robisz to bezpośrednio z zamówienia, przez wybranego kuriera, brokera albo ErliPRO. Więcej o tym w opisie wysyłki i etykiet kurierskich.
  3. Status realizacji i informacja o przesyłce wracają do Erli, bo tego wymaga marketplace.
  4. Wystawiasz fakturę lub paragon z zamówienia i wysyłasz dokument do KSeF. Szczegóły znajdziesz w opisie faktur z zamówień.
  5. Zwrot lub reklamację obsługujesz w tym samym panelu.

W większym magazynie przydają się dwie funkcje. Manager pakowania pokazuje pakowaczom kolejkę zamówień i nalicza im premie. Plan hali pokazuje, gdzie leży towar. Reguły automatyczne pozwalają z kolei przypisać zamówieniu kuriera czy status bez klikania.

Jak przetestować integrację i naprawić typowe problemy

Przed włączeniem całego katalogu sprawdź jeden produkt z wariantami. Taki test zajmuje kwadrans i wyłapuje większość błędów konfiguracji.

Lista kontrolna testu:

  • Oferta pojawia się na Erli z poprawną ceną, zdjęciami i parametrami.
  • Zmiana stanu w systemie zmienia stan w sklepie i na Erli.
  • Testowe zamówienie w sklepie zmniejsza stan na Erli.
  • Zamówienie z Erli pojawia się w panelu z właściwym wariantem.
  • Po nadaniu paczki Erli pokazuje status i numer przesyłki.
  • Dokument sprzedaży wystawia się z poprawnymi danymi.

Typowe problemy i ich przyczyny:

Objaw Najczęstsza przyczyna Co zrobić
Stan na Erli nie zmienia się Oferta nie jest połączona z produktem Połącz ofertę z produktem po SKU lub EAN
Sprzedał się zły rozmiar Wariant połączony z inną pozycją Sprawdź SKU każdego wariantu
Oferty zdublowane Katalog zaimportowany bez łączenia istniejących ofert Połącz duplikaty i zamknij nadmiarowe oferty
Zamówienia nie trafiają do sklepu Klucze WooCommerce tylko do odczytu Wygeneruj klucze z uprawnieniem read/write
Stan wraca do starej wartości Ręczna zmiana w drugim miejscu Zmieniaj stan tylko w systemie
Oferta odrzucona Brak danych producenta (GPSR) lub parametrów Uzupełnij kartę produktu i wystaw ponownie

Ile kosztuje sprzedaż na Erli z WooCommerce

Na całkowity koszt składają się dwie pozycje: prowizja marketplace’u i narzędzie do integracji. Według zestawienia prowizji Erli w podstawowym modelu nie ma abonamentu, a płacisz prowizję od sprzedaży, której stawka zależy od kategorii.

W Berlinettcie cena zależy tylko od liczby zamówień w miesiącu. Nie ma opłaty od zamówienia ani prowizji od sprzedaży.

Pakiet Zamówień miesięcznie Miesięcznie Rocznie
Berlinetta 250 do 250 89 zł 890 zł
Berlinetta 500 do 500 129 zł 1290 zł
Berlinetta 2000 do 2000 249 zł 2490 zł
Berlinetta 5000 do 5000 489 zł 4890 zł
Berlinetta 12000 do 12 000 749 zł 7490 zł
Berlinetta Enterprise powyżej 12 000 wycena indywidualna wycena indywidualna

Ceny są podane netto. Każdy pakiet zawiera wszystkie integracje, dowolną liczbę pracowników i kont, magazyn, sprzedaż B2B i KSeF, bez płatnych dodatków.

Erli i WooCommerce w jednym panelu Berlinetty

Jeśli sprzedajesz w sklepie na WooCommerce i na Erli, Berlinetta łączy oba kanały we wspólny magazyn. Produkt opisujesz raz i wystawiasz z jego karty, stan i ceny same trafiają na oferty, a zamówienia z obu kanałów pakujesz, nadajesz i fakturujesz w tym samym miejscu. Gdy dołożysz Allegro, OLX albo sklep na Shoperze, podłączasz kolejny kanał do tego samego katalogu.

Pulpit Berlinetty: sprzedaż z dziś z wykresem, zamówienia spakowane i wysłane, statusy zamówień, skróty i najnowsze zamówienia.

Zobacz, jak działa integracja z Erli i integracja WooCommerce, a potem załóż konto testowe w Berlinettcie. Przez 30 dni korzystasz bez opłat, a później płacisz od 89 zł netto miesięcznie.

Nasze zdanie: integruj magazyn, nie tylko dwa kanały

Pytanie o integrację Erli z WooCommerce zwykle zaczyna się od jednego problemu: jak przenieść oferty ze sklepu na marketplace. Szybko okazuje się, że to dopiero początek. Potem trzeba pilnować stanów, nadawać paczki, wysyłać numery przesyłek, wystawiać faktury do KSeF i obsługiwać zwroty.

Dlatego budujemy Berlinettę wokół jednej karty produktu i jednego magazynu. Kanały sprzedaży są dla nas kolejnymi miejscami wystawienia tego samego towaru, a nie osobnymi systemami, które trzeba ze sobą godzić. Dzięki temu dołożenie Erli do sklepu, a potem Allegro, nie wymaga nowego narzędzia ani nowego wdrożenia.

Uważamy też, że cena systemu powinna być przewidywalna. Płacisz za liczbę zamówień w miesiącu, nie za każde zamówienie i nie za dodatkowe moduły. Kolejne integracje dokładamy na prośbę klientów, więc system rośnie razem z kanałami, w których sprzedajesz.

Zespół Berlinetta

Najczęstsze pytania

Czy da się połączyć Erli z WooCommerce bez programisty?

Tak. W systemie wielokanałowym podłączasz sklep i konto Erli w panelu, bez pisania kodu. W Berlinettcie konto testowe zakładasz sam i pracujesz od razu, bez wdrożenia. Programista jest potrzebny tylko wtedy, gdy budujesz własną integrację na Shop API Erli.

Czy oferty na Erli mogą mieć inne ceny niż w sklepie?

Tak i często warto je różnicować. Prowizja Erli zależy od kategorii i jest liczona od ceny z dostawą, więc cena na marketplace może być wyższa niż w sklepie. W systemie ustawiasz ceny dla kanałów, a stan magazynowy pozostaje wspólny.

Co się stanie, gdy ten sam produkt sprzeda się jednocześnie w sklepie i na Erli?

Przy wspólnym stanie pierwsza sprzedaż od razu zmniejsza dostępność w obu kanałach. Ryzyko dotyczy praktycznie tylko ostatniej sztuki przy bardzo dużym ruchu. Dlatego przy szybko rotującym towarze warto zostawić w kanałach sztukę rezerwy.

Wspólny stan po sprzedaży w dwóch kanałach

Czy mogę dodać Allegro do tej samej integracji?

Tak. Berlinetta zbiera zamówienia z Allegro, Erli, OLX i sklepów na WooCommerce, Shoperze i PrestaShop we wspólnym panelu, z jednym katalogiem i magazynem. Jak połączyć oba marketplace’y, opisujemy w tekście o integracji Allegro z Erli.

Ile trwa uruchomienie integracji?

Podłączenie kanałów to kwestia jednego posiedzenia. Najwięcej czasu zajmuje uporządkowanie SKU i połączenie istniejących ofert z produktami. Przy kilkuset produktach z dobrze opisanymi wariantami zwykle mieścisz się w okresie testowym z dużym zapasem.

Źródła

  1. 1.ERLI Shop API: dokumentacja
  2. 2.WooCommerce REST API: Authentication
  3. 3.Prowizje marketplace 2026: porównanie 22 platform w Polsce
  4. 4.3 Month POC for CRM ERP Integration

Pytania

Najczęstsze pytania

Czy da się połączyć Erli z WooCommerce bez programisty?

Tak. W systemie wielokanałowym podłączasz sklep i konto Erli w panelu, bez pisania kodu. W Berlinettcie konto testowe zakładasz sam i pracujesz od razu, bez wdrożenia. Programista jest potrzebny tylko wtedy, gdy budujesz własną integrację na Shop API Erli.

Czy oferty na Erli mogą mieć inne ceny niż w sklepie?

Tak i często warto je różnicować. Prowizja Erli zależy od kategorii i jest liczona od ceny z dostawą, więc cena na marketplace może być wyższa niż w sklepie. W systemie ustawiasz ceny dla kanałów, a stan magazynowy pozostaje wspólny.

Co się stanie, gdy ten sam produkt sprzeda się jednocześnie w sklepie i na Erli?

Przy wspólnym stanie pierwsza sprzedaż od razu zmniejsza dostępność w obu kanałach. Ryzyko dotyczy praktycznie tylko ostatniej sztuki przy bardzo dużym ruchu. Dlatego przy szybko rotującym towarze warto zostawić w kanałach sztukę rezerwy.

Czy mogę dodać Allegro do tej samej integracji?

Tak. Berlinetta zbiera zamówienia z Allegro, Erli, OLX i sklepów na WooCommerce, Shoperze i PrestaShop we wspólnym panelu, z jednym katalogiem i magazynem. Jak połączyć oba marketplace'y, opisujemy w tekście o integracji Allegro z Erli.

Ile trwa uruchomienie integracji?

Podłączenie kanałów to kwestia jednego posiedzenia. Najwięcej czasu zajmuje uporządkowanie SKU i połączenie istniejących ofert z produktami. Przy kilkuset produktach z dobrze opisanymi wariantami zwykle mieścisz się w okresie testowym z dużym zapasem.

Sprzedajesz w kilku miejscach naraz?

Obsługuj Allegro, Erli, własny sklep i kurierów w jednym panelu. Bez przepisywania danych.