SubiektBridge wsparcie to oficjalne centrum dowodzenia i baza wiedzy stworzona dla administratorów, deweloperów oraz właścicieli e-commerce, którzy wdrażają integrację z systemami ERP. Znajdziesz tu kompletne instrukcje krok po kroku – od pierwszego uruchomienia instalatora, przez zaawansowaną konfigurację endpointów, aż po procedury utrzymania ciągłości pracy Twojego sklepu internetowego.
Nasza baza wiedzy jest stale aktualizowana przez inżynierów, którzy na co dzień dbają o stabilność tysięcy połączeń między środowiskami chmurowymi a programami firmy InsERT.
SubiektBridge wsparcie: 1. Szybki start i onboarding agenta
Jeśli właśnie zakupiłeś licencję i chcesz przeprowadzić pierwszą instalację w środowisku produkcyjnym, ten moduł przeprowadzi Cię przez proces konfiguracji w kilku prostych krokach.
Instalacja Agenta lokalnego
Przed uruchomieniem instalatora upewnij się, że Twój serwer spełnia minimalne wymagania systemowe. Agent lokalny wymaga środowiska Windows Server (lub Windows 10/11), zainstalowanego frameworka .NET 8 oraz dostępu do instancji Microsoft SQL Server, na której pracuje Subiekt GT lub Subiekt nexo PRO.
Pierwsze połączenie i parowanie z Cloud Proxy
Po zainicjowaniu agenta przejdź do panelu administracyjnego, aby wygenerować unikalne klucze API. Następnie wykonaj bezpieczne parowanie agenta lokalnego z węzłem chmurowym Cloud Proxy. Do zestawienia połączenia nie jest wymagany publiczny adres IP.
Mapowanie baz danych i podmiotów
Wskazanie odpowiednich podmiotów bazodanowych odbywa się w pliku konfiguracyjnym lub interfejsie graficznym. Oferowane przez SubiektBridge wsparcie obejmuje bezpieczne mapowanie wielu baz Subiekt GT oraz nexo PRO jednocześnie.
Test komunikacji (Ping)
Po zakończeniu wstępnej konfiguracji wykonaj testowe zapytanie typu Ping z poziomu panelu. Weryfikacja logów systemowych pozwoli upewnić się, że nagłówki autoryzacyjne oraz szyfrowane połączenie gRPC działają prawidłowo.
SubiektBridge wsparcie: 2. Konfiguracja modułów integracji ERP
Każdy biznes e-commerce posiada unikalną specyfikę logistyczną. Poniższe guides opisują szczegółową konfigurację poszczególnych modułów wykonawczych.
- Moduł Magazynowy: Ustawianie buforów bezpieczeństwa stanów magazynowych, precyzyjny wybór magazynów źródłowych oraz automatyczne mapowanie jednostek miar (sztuki, opakowania, palety).
- Automatyzacja Zamówień: Konfiguracja zaawansowanych schematów importu dokumentów (ZK – Zamówienie od Klienta, FS – Faktura Sprzedaży, PAi – Paragon Imienny) wraz z automatycznym mapowaniem form płatności i dostawców.
- Price Engine: Zarządzanie priorytetami cenników, przeliczanie cen hurtowych/detalicznych oraz automatyczna przewalutowania w oparciu o aktualne kursy walut.
- Logika No-Sfera: Dowiedz się, jak system symuluje i optymalizuje procesy Sfery, zapewniając ultra-szybki zapis dokumentów bez ryzyka zakleszczeń tabel w bazie MS SQL. Jeśli chcesz dowiedzieć się więcej o architekturze bezkodowej, sprawdź naszą dokumentację dotyczącą REST API dla Subiekta nexo PRO.
SubiektBridge wsparcie: 3. Rozwiązywanie problemów (Troubleshooting)
W przypadku wystąpienia nieprzewidzianych zdarzeń sieciowych lub błędów logiki biznesowej ERP, wykorzystaj poniższe procedury diagnostyczne.
Problemy z połączeniem SQL („Login failed for user”)
Komunikat ten oznacza niepoprawne dane uwierzytelniające lub brak odpowiednich uprawnień użytkownika bazy danych. Upewnij się, że konto SQL posiada uprawnienia db_owner dla bazy Subiekta oraz że włączony jest tryb mieszany autoryzacji (Mixed Mode Authentication).
Błędy Firewall i Proxy
System SubiektBridge nie wymaga otwierania portów wejściowych. Jeśli usługa zgłasza błąd połączenia z Cloud Proxy, upewnij się, że lokalny firewall nie blokuje szyfrowanego ruchu wyjściowego na porcie 443 (HTTPS/gRPC).
Błędy biznesowe Subiekta
W przypadku komunikatów z powiadomień zwrotnych, takich jak „Brak towaru na magazynie”, „Okres edycji dokumentu zamknięty” lub „Numer NIP niepoprawny”, nasza sekcja SubiektBridge wsparcie zaleca weryfikację ustawień blokad w samym programie Subiekt.
Optymalizacja wydajności
Jeśli zapytania API trwają dłużej niż przewidywane 200 ms, przeprowadź konserwację indeksów w bazie MS SQL oraz sprawdź wykorzystanie zasobów CPU/RAM na serwerze magazynowym. Przydatne informacje na temat odbierania zdarzeń znajdziesz w artykule opisującym Webhooki w Subiekcie GT.
SubiektBridge wsparcie: 4. Bezpieczeństwo i administracja systemem
Ochrona danych osobowych oraz stabilność połączenia z systemem magazynowym to nasze priorytety.
Rotacja kluczy API i zarządzanie uprawnieniami
Zalecamy regularną rotację kluczy autoryzacyjnych (Bearer Tokens). Z poziomu panelu możesz nadawać szczegółowe uprawnienia dla poszczególnych kluczy – np. ograniczając dostęp zewnętrznego developera wyłącznie do odczytu stanów magazynowych (read:stock).
Backup, Recovery i RODO
W przypadku awarii sprzętowej serwera lokalnego, ponowna instalacja agenta i przywrócenie integracji z chmury zajmuje mniej niż 15 minut. Wszystkie dane klientów przesyłane w strumieniu API są szyfrowane zgodnie z wymogami RODO/GDPR.
Najczęściej zadawane pytania (FAQ)
Czy SubiektBridge wsparcie wymaga stałego, publicznego adresu IP?
Nie. Dzięki technologii Cloud Proxy połączenie jest inicjowane od strony Twojego serwera lokalnego (ruch wychodzący), więc nie potrzebujesz stałego adresu IP ani otwierania portów na świat.
Czy system działa z Subiektem zainstalowanym w chmurze Azure lub AWS?
Tak. O ile posiadasz dostęp do bazy danych MS SQL oraz możliwości uruchomienia usługi tła, agent SubiektBridge może być zainstalowany na maszynie wirtualnej w chmurze tak samo, jak na lokalnym serwerze fizycznym.
Czy mogę połączyć jeden sklep internetowy z wieloma bazami Subiekta?
Tak, moduł Multi-Bridge pozwala na agregację danych z wielu osobnych podmiotów i serwerów w jeden spójny strumień danych REST API / gRPC.
Status Systemu i Pomoc Techniczna
Wszystkie węzły Cloud Proxy działają poprawnie ze średnim wskaźnikiem dostępności Uptime 99.98%.
Jeśli napotkałeś problem techniczny, którego nie opisano w powyższych sekcjach, nasz zespół inżynierów zapewnia bezpośrednie SubiektBridge wsparcie dla wszystkich aktywnych subskrybentów.
👉 Otwórz zgłoszenie do zespołu technicznego i uzyskaj pomoc naszych specjalistów.