Integracja ERLI z Comarch ERP XL - jak zaplanować synchronizację

Integracja ERLI z Comarch ERP XL powinna wymieniać te obiekty, dla których firma określiła właściciela danych i regułę aktualizacji. Zakres może obejmować produkty, warianty, ceny, stany, zamówienia, dane klientów, statusy i dokumenty, jeśli wybrana metoda obsługuje te operacje.

ERLI udostępnia Marketplace API oparte na REST i HTTPS. Klucz autoryzacyjny sprzedawca znajdzie w panelu zarządzania sklepem w sekcji Metoda integracji > Własna integracja po API; dokumentacja ERLI sprawdzona w październiku 2026 r. opisuje przekazywanie klucza w nagłówku Authorization (dokumentacja Marketplace API ERLI).

Tabela pokazuje przykładowy podział odpowiedzialności. Źródło prawdy oznacza system, w którym firma zatwierdza wartość danego obiektu.

Ten podział jest punktem wyjścia do specyfikacji, a nie potwierdzeniem funkcji konkretnego konektora. Uzgodnij również, czy dane klienta trafiają do ERP XL przed rezerwacją, czy dopiero po walidacji zamówienia.

Możliwość integracji zależy od wersji i konfiguracji Comarch ERP XL, dostępnych interfejsów oraz aktywnej metody integracji ERLI. Przed rozmową z dostawcą zbierz informacje o środowisku, modułach i skali katalogu.

Comarch publikuje dokumentację autoryzacji API ERP XL dla Comarch BPM (dawniej DMS), ale dostępność tego interfejsu nie potwierdza obsługi wszystkich operacji marketplace. Zakres operacji sprawdź dla konkretnej instalacji i rozwiązania (dokumentacja autoryzacji API Comarch ERP XL).

Przygotuj do rozmowy z integratorem następujące dane:

• wersję ERP XL, sposób hostowania systemu oraz wykorzystywane moduły, dodatki i modyfikacje;
• liczbę SKU, wariantów, magazynów i typowy wolumen zamówień;
• przykłady kartotek produktu, cennika, stanu i zamówienia z wyjątkiem;
• dostępną metodę integracji ERLI oraz interfejs lub konektor ERP XL;
• informację o środowisku testowym, dostępach technicznych i osobie zatwierdzającej wyniki.

Klucz API ERLI traktuj jak poufne poświadczenie: przechowuj go poza kodem źródłowym i nie umieszczaj w logach ani dokumentach przekazywanych dalej. Jeśli połączenie ma obejmować również inne kanały sprzedaży, wdrożenie integracji z BaseLinkerem może być osobnym elementem architektury, którego zakres trzeba dopasować do ERP XL.

Gotowy konektor pasuje, gdy obsługuje wymagane operacje ERLI i ERP XL oraz jest aktualizowany wraz ze zmianami tych systemów. Integrator pośredniczący może obsłużyć kilka kanałów w jednym miejscu, a rozwiązanie dedykowane pozwala dostosować mapowanie i wyjątki do procesu firmy.

Tabela porównuje metody połączenia według zakresu, elastyczności, monitoringu i utrzymania. Porównuj oferty dla tych samych operacji, odpowiedzialności za aktualizacje i scenariuszy testowych.

Wybierz metodę, która opisuje anulowanie, błędne dane i ponowienia, a nie tylko przekazanie poprawnego zamówienia. Integrator powinien wskazać, kto odpowiada za aktualizacje, monitoring i odzyskanie przerwanej operacji.

Mapowanie produktów powinno opierać się na trwałym kluczu, który łączy ofertę ERLI z kartoteką ERP XL bez tworzenia duplikatu. Do uzgodnienia są SKU, identyfikator produktu, wariant, waluta, cennik oraz magazyn będący źródłem stanu.

Ustal reguły dla brakujących SKU, nieaktywnych produktów i zmian kategorii ERLI. Dla stanów określ, czy marketplace otrzymuje ilość z jednego magazynu, sumę magazynów czy stan pomniejszony o rezerwacje i zapas bezpieczeństwa.

Marketplace API ERLI rozróżnia zewnętrzny identyfikator produktu, kategorię, atrybuty i grupę wariantową; dokumentacja zaleca używanie deterministycznych identyfikatorów dla wariantów. Jeśli ręczna edycja produktu w panelu zamroziła pole, API nie zmieni go standardową aktualizacją. Zalecamy sprawdzić status zamrożenia przed diagnozowaniem rozbieżnej ceny lub opisu (dokumentacja produktów ERLI).

Perspektywa KC Mobile: Z naszych wdrożeń wynika, że niezgodny identyfikator produktu potrafi przerwać dalszą obsługę zamówienia. Zalecamy przetestować jeden produkt z wariantem przed importem całego katalogu.

Proces zamówienia powinien pobrać rekord z ERLI, zweryfikować jego dane, dopasować produkty i klienta, a następnie utworzyć uzgodniony dokument w ERP XL. Dostępność tworzenia dokumentu zależy od konkretnego konektora lub wdrożenia ERP XL.

Przebieg warto opisać jako zdarzenia z określonym wynikiem:

1. Integracja pobiera zamówienie i zachowuje jego identyfikator ERLI.
2. Proces sprawdza płatność, dane dostawy, SKU, ilości i dostępność klienta w kartotece.
3. Po walidacji integracja tworzy uzgodniony rekord w ERP XL, na przykład zamówienie lub dokument handlowy.
4. System zapisuje powiązanie identyfikatora ERLI z numerem rekordu ERP XL.
5. ERP XL lub integrator przekazuje status realizacji do ERLI zgodnie z ustaloną regułą.

Firma powinna zdecydować, czy brak SKU, błędny adres, niepotwierdzona płatność albo anulowanie blokują dokument, czy tworzą zadanie do ręcznej weryfikacji. Utworzenie dokumentu nie potwierdza zapłaty, a rezerwacja nie oznacza wydania towaru.

Test odbiorczy powinien sprawdzić nowy produkt, zmianę ceny, stan zerowy, błędny adres, anulowanie, zwrot i ponowienie po błędzie. Testuj na kontrolowanym katalogu i zapisuj oczekiwany wynik oraz dowód poprawności dla każdego przypadku.

Tabela wskazuje scenariusze wraz z kryterium odbioru. Ustal, kto zatwierdza wynik po stronie sprzedaży, magazynu i administracji ERP XL.

ERLI podaje w dokumentacji sprawdzonej w październiku 2026 r., że limit zapytań zależy od obciążenia serwisu, a jego przekroczenie zwraca HTTP 429. Integrator powinien kontrolować tempo żądań i obsłużyć ponowienie przez kolejkę, zamiast bezwarunkowo powtarzać zapis (dokumentacja limitów Marketplace API ERLI).

Czas i koszt wdrożenia zależą od dostępności interfejsów, liczby magazynów i kanałów, jakości kartotek, reguł cenowych oraz obsługi dokumentów i wyjątków. Sama liczba produktów lub zamówień nie wystarcza do oszacowania prac.

Poproś o ofertę, która osobno opisuje analizę, konfigurację, programowanie, testy, uruchomienie i utrzymanie. Zakres powinien wskazywać wymagane licencje, synchronizowane obiekty, monitoring, odpowiedzialność za aktualizacje oraz kryteria odbioru.

Przed wyceną przekaż wersje systemów, liczbę SKU i magazynów, przykłady kartotek oraz zamówienia obejmujące anulowanie lub błędny adres. Taki brief pozwala ocenić, czy oferta obejmuje reguły firmy, a nie wyłącznie podstawową wymianę rekordów.

Jeśli firma potrzebuje wykonawcy do skonfigurowania warstwy obsługującej wiele kanałów, oferta wdrożenia BaseLinkera KC Mobile opisuje tę usługę. Połączenie ERLI z ERP XL trzeba potwierdzić jako osobny zakres prac.

Diagnozowanie błędu zacznij od ustalenia, czy dotyczy danych, autoryzacji, limitu żądań czy połączenia z ERP XL. Zapisz identyfikator zamówienia lub produktu, czas, kod odpowiedzi i komunikat, nie ujawniając poufnych poświadczeń.

HTTP 429 oznacza przekroczenie aktualnego limitu żądań ERLI; ogranicz tempo i ponów operację przez kolejkę integratora. Przy błędzie autoryzacji sprawdź, czy klucz jest aktywny i przekazywany w nagłówku Authorization, a po stronie ERP XL potwierdź uprawnienia konta technicznego. Szczegóły limitów i autoryzacji ERLI sprawdziliśmy w październiku 2026 r. (dokumentacja Marketplace API ERLI).

Nie ponawiaj ręcznie operacji tworzącej dokument, zanim nie ustalisz, czy poprzednia próba zakończyła się sukcesem. Porównaj identyfikator zamówienia ERLI z zapisanym powiązaniem w ERP XL, popraw przyczynę i wznów wyłącznie nieudaną czynność.

• IdoSell Bridge: modele integracji IdoSell z systemami magazynowo-księgowymi
• Integracja Comarch EDI z Comarch Optima: dokumenty, mapowanie i kontrola błędów
• Co to jest BaseLinker, dlaczego firmy go wdrażają i kiedy się opłaca
• Automatyzacja obsługi sprzedaży na Allegro: od zamówienia do wysyłki