Konektory ERP¶

Konektor MobiSkan to aplikacja Windows instalowana u klienta, na maszynie z jego programem handlowo-magazynowym, która udostępnia dane tego programu terminalowi MobiSkan Kolektor i panelowi MobiSkan WMS.

Po co istnieje konektor¶

Programy, z którymi integruje się MobiSkan (Subiekt GT, Subiekt nexo, PC-Market), to aplikacje desktopowe instalowane lokalnie, z bazą danych na MS SQL Server. Nie mają API dostępnego przez internet, a ich jedyne dopuszczone przez producenta interfejsy zapisu to dodatki działające wyłącznie na tej samej maszynie.

Terminal z Androidem porozumiewa się po HTTPS, program ERP po SQL i przez lokalne API producenta. Bezpośrednie połączenie między nimi nie jest możliwe, dlatego potrzebny jest pośrednik stojący w tej samej sieci co ERP. Tym pośrednikiem jest konektor.

Konektor tłumaczy schemat konkretnego programu ERP na jeden, wspólny format danych. Dzięki temu terminal i panel WMS nie wiedzą, z jakim programem rozmawiają, a dołożenie obsługi kolejnego ERP nie wymaga zmian po ich stronie.

Jak to działa w sieci klienta¶

flowchart LR
    subgraph LAN[Sieć lokalna klienta]
        ERP[(Program ERP<br/>i jego baza SQL)]
        CON[Konektor MobiSkan<br/>usługa Windows]
        APP[MobiSkan Kolektor<br/>terminal Android]
        ERP --- CON
        APP -- HTTPS --> CON
    end
    WMS[MobiSkan WMS<br/>panel]
    WMS -- HTTPS --> CON
    CON -- wysyłka danych --> WMS

Trzy relacje działają niezależnie od siebie:

Relacja	Kto inicjuje	Wymaganie sieciowe
Terminal do konektora	terminal, po sparowaniu kodem QR	ta sama sieć lokalna lub WiFi
Panel WMS do konektora	panel, po wpisaniu adresu i tokenu	serwer WMS musi mieć trasę sieciową do konektora (sieć lokalna, VPN albo przekierowanie portu)
Konektor do panelu WMS	konektor, cyklicznie	konektor musi mieć dostęp do adresu API panelu

Terminal nie łączy się z konektorem przez panel WMS, a panel nie łączy się przez terminal. To trzy osobne ścieżki do jednego konektora. Terminal w danym momencie jest sparowany dokładnie z jednym systemem: albo z panelem WMS, albo bezpośrednio z konektorem ERP.

Ruch odbywa się wyłącznie po HTTPS. Konektor jest przeznaczony do pracy w sieci lokalnej i nie jest projektowany do wystawiania w internecie.

Trzy konektory i ich zakres¶

Zakres	Subiekt GT	Subiekt nexo	PC-Market
Producent	InsERT	InsERT	Insoft
Katalog towarów	tak, bez dodatkowych licencji	tak, bez dodatkowych licencji	tak
Zdjęcia towarów	tak	nie	nie
Kontrahenci	tak, bez dodatkowych licencji	wymaga Sfery nexo	tak
Magazyny	tak, bez dodatkowych licencji	wymaga Sfery nexo	tak
Stany magazynowe	tak, bez dodatkowych licencji	wymaga Sfery nexo	tak
Dokumenty magazynowe	PZ, WZ, MM, PW, RW, bez dodatkowych licencji	PZ, WZ, PW, RW, wymaga Sfery nexo, bez MM	PZ, WZ, MM, PW, RW
Zapis towaru do ERP	wymaga licencji Sfera GT	wymaga nexo PRO ze Sferą	brak
Zapis wyniku kompletacji do ERP	wymaga licencji Sfera GT	wymaga nexo PRO ze Sferą	brak
Współpraca z panelem MobiSkan WMS	pełna	tylko podgląd katalogu towarów	brak
Domyślny port	5443	5444	5445

Subiekt GT i Subiekt nexo to dwa różne produkty tej samej firmy, z osobnymi instalacjami, bazami i osobnym interfejsem automatyzacji. Nie należy ich ze sobą mylić mimo podobnej nazwy.

Szczegóły każdego konektora: Subiekt GT, Subiekt nexo, PC-Market.

Płatne dodatki producenta ERP¶

To jest informacja, którą trzeba znać przed rozmową z klientem, bo dotyczy jego kosztów.

Konektor	Co działa bez dodatkowych zakupów	Co wymaga dokupienia u producenta ERP
Subiekt GT	cały odczyt: katalog, zdjęcia, kontrahenci, magazyny, stany, dokumenty	zapis do Subiekta (towar, wynik kompletacji) wymaga licencji Sfera GT, licencjonowanej przez InsERT na stanowisko
Subiekt nexo	wyłącznie katalog towarów	wszystko poza katalogiem, w tym odczyt kontrahentów, magazynów, stanów i dokumentów, wymaga Subiekt nexo PRO z aktywnym dodatkiem Sfera, bo wersja podstawowa nexo nie wystarcza
PC-Market	cały dostępny zakres odczytu	nic do dokupienia, bo producent nie udostępnia mechanizmu zapisu, więc zapisu nie da się kupić ani włączyć

Różnica między Subiektem GT a nexo jest zasadnicza handlowo: w GT płatny dodatek dokłada tylko zapis, w nexo warunkuje także odczyt większości danych.

Wymagania¶

Maszyna z konektorem¶

Element	Wymaganie
System operacyjny	Windows x64
Program ERP	zainstalowany i skonfigurowany, z bazą na MS SQL Server
Dostęp do bazy	konto SQL tylko do odczytu na bazie podmiotu, zakładane przez instalator za zgodą administratora albo ręcznie
Sieć	otwarty port przychodzący dla ruchu z sieci lokalnej (5443, 5444 lub 5445 zależnie od konektora)
Certyfikat TLS	certyfikat samopodpisany, generowany przez instalator
Sesja użytkownika	wymagana tylko dla zapisu do Subiekta GT lub nexo: na maszynie musi być zalogowany użytkownik z uruchomioną aplikacją zasobnika systemowego

Konektor Subiekt GT i Subiekt nexo instalują się z pełnym pakietem uruchomieniowym, więc nie wymagają osobnej instalacji platformy .NET. Konektor PC-Market wymaga zainstalowanego na maszynie docelowej środowiska uruchomieniowego ASP.NET Core 8.0.

Terminal i panel¶

Terminal MobiSkan Kolektor musi być w tej samej sieci lokalnej lub WiFi co konektor.
Panel MobiSkan WMS musi mieć trasę sieciową do adresu konektora. Jeśli panel stoi poza siecią klienta, potrzebny jest VPN albo przekierowanie portu.

Wersje¶

Wszystkie trzy konektory mają wspólny numer wersji - dzielą ten sam rdzeń, więc poprawka trafia do wszystkich naraz i nie ma sensu, żeby każdy liczył się osobno. Numer widać w dwóch miejscach: w oknie O programie aplikacji zasobnika oraz w panelu po użyciu przycisku Testuj połączenie. Jest też częścią nazwy pliku instalacyjnego.

Zmiana pierwszej liczby oznacza, że konektor wymaga nowszej wersji aplikacji MobiSkan Kolektor albo panelu. Zmiana kolejnych oznacza nową funkcję lub poprawkę bez takiego wymogu.

Twarda zasada dotycząca bazy ERP¶

Konektor nie modyfikuje schematu bazy programu ERP. Nie dodaje tabel, kolumn ani wyzwalaczy i nie zmienia danych bezpośrednio w bazie. Cały zapis odbywa się wyłącznie przez oficjalne API producenta, żeby zachować numerację dokumentów, walidacje i logikę biznesową programu.

Jedyna ingerencja w ustawienia serwera SQL to utworzenie kont dostępowych dla konektora, wykonywane wyłącznie na jawną zgodę administratora zaznaczoną w kreatorze instalacji. Opis tego kroku: Instalacja konektora.