Pełny ekosystem emoms to 6 współpracujących usług. Aby wszystko działało, należy je zainstalować w określonej kolejności, ponieważ niektóre zależą od innych (np. BSW.BusWorker nie uruchomi się bez działającego RabbitMQ).

Gdzie znaleźć ekran instalacji

Konfiguracja webAPI jest w aplikacji s2s w menu Sklep → Konfiguracja → WebAPI. Każdą z poniższych usług dodajesz tu jako osobny wiersz, a następnie z menu kontekstowego (prawy klik) wybierasz Wygeneruj usługę i Start.

Lista zainstalowanych usług WebAPI w s2s — zielona kropka oznacza Running

Lista zainstalowanych usług w s2s — kolumna Stan: zielona kropka = Running, czerwona = Stopped.

Dropdown Nazwa aplikacji z dostępnymi typami usług: WebAPI dla NEXO, Aplikacja emoms, WebAPI dla Spedytorów, BSW.BusWorker, RabbitMQ, WebApi.Shop

Po kliknięciu Dodaj webAPI wybierz Nazwa aplikacji z listy — to jest typ instalowanej usługi.

Komponenty

#KomponentRola
1RabbitMQBroker wiadomości — fundament komunikacji między usługami.
2WebAPI dla NEXOMost między Subiektem Nexo a aplikacjami sklepowymi. Najczęściej już zainstalowany.
3WebApi.ShopAPI dla sklepów internetowych: synchronizacja zamówień, statusów, listów przewozowych.
4WebAPI dla SpedytorówIntegracja z kurierami (DPD, GLS, InPost, DHL...) — listy przewozowe, paczkomaty.
5BSW.BusWorkerWorker słuchający kolejki RabbitMQ — drukowanie, e-maile, aktualizacje statusów.
6Aplikacja emomsPanel zarządzania (przeglądarka): zamówienia, automatyzacja, monitoring.

Kolejność instalacji

W zakładce Ustawienia → WebAPI dodaj kolejne wpisy w podanej kolejności. Dla każdego: przycisk Dodaj webAPI → ustaw typ → zapisz → prawym kliknij na wiersz → Wygeneruj usługę → Start.

  1. RabbitMQ
    • Typ: RabbitMQ
    • URL: amqp://
    • SSL: nie
    • Przy generacji usługi formatka zapyta o login/hasło RabbitMQ
  2. WebAPI dla NEXO (jeśli już istnieje, pomiń)
    • Najczęściej już jest na liście (port 5001/5003)
    • Sprawdź czy ma ● zieloną kropkę
  3. WebApi.Shop
    • Typ: WebApi.Shop
    • URL: https:// (np. webapi-shop.lan)
    • SSL: tak
    • Po wygenerowaniu → Zainstaluj certyfikat na stacji
  4. WebAPI dla Spedytorów
    • Typ: WebAPI dla Spedytorów
    • URL: https:// (np. shippingintegrations.api.lan)
    • SSL: tak
    • Po wygenerowaniu → Zainstaluj certyfikat na stacji
  5. BSW.BusWorker
    • Typ: BSW.BusWorker
    • Brak URL (to worker, nie API)
    • Wymaga konta serwisowego z prawem SeServiceLogonRight (zwykle NetworkService lub konto domenowe)
    • RabbitMQ musi być Running zanim wystartujesz BSW
  6. Aplikacja emoms
    • Typ: Aplikacja emoms
    • URL: https:// (np. emoms.lan)
    • SSL: tak
    • Po wygenerowaniu → Zainstaluj certyfikat na stacji
    • Pracownicy używający emoms na innych komputerach (bez s2s) — użyj Zapisz certyfikat na dysk i zainstaluj plik .cer ręcznie na ich stacjach

Sprawdzenie po instalacji

  • Każdy wiersz w gridzie WebAPI powinien mieć ● zieloną kropkę w kolumnie Stan.
  • Kolumna Pamięć [MB] pokazuje wartość — potwierdza, że usługa odpowiada.
  • Prawy klik → Sprawdź dla każdej usługi — porównuje wersję zainstalowaną z dostępną.
  • Restart wykonuj zawsze opcją Restart z menu kontekstowego (graceful — nie przerywa pracy klientów).

Najczęstsze problemy

  • Czerwona kropka po Start → sprawdź EventLog (Pokaż log usługi). Najczęstsza przyczyna dla BSW: brak SeServiceLogonRight dla konta serwisowego (otwórz Services.msc i ustaw hasło konta — Windows automatycznie nadaje uprawnienie).
  • Brak wartości w kolumnie Pamięć → usługa nie odpowiada lub certyfikat usługi nie jest zaufany na tej stacji. Wykonaj Zainstaluj certyfikat na stacji z menu kontekstowego.
  • „Sprawdź" zwraca błąd certyfikatu → użyj Zainstaluj certyfikat na stacji.
  • BSW.BusWorker nie startuje → 99% przypadków: RabbitMQ nie działa albo BSW nie ma poprawnych poświadczeń RabbitMQ. Sprawdź wpis RabbitMQ + Wygeneruj usługę BSW od nowa (zapyta o credentials).
    Loading data...