Integracja Subiekt nexo z n8n — jak automatyzować sprzedaż, magazyn i obsługę klienta

https://produkcjaprogramy.pl/2026/05/20/integracja-subiekt-nexo-z-n8n-automatyzacja-procesw-sprzedazy-magazynu-i-produkcji/

Integracja Subiekt nexo z n8n to bardzo ciekawy kierunek dla firm, które chcą zautomatyzować powtarzalne procesy handlowe, magazynowe i administracyjne. Subiekt nexo jest systemem do obsługi sprzedaży i magazynów, a n8n pełni rolę platformy automatyzacji, która potrafi łączyć różne aplikacje, API, bazy danych, webhooki i usługi zewnętrzne. n8n posiada wiele gotowych integracji, a tam, gdzie nie ma dedykowanego konektora, można użyć uniwersalnego węzła HTTP Request do komunikacji z zewnętrznym API. (docs.n8n.io)

W praktyce najważniejsze pytanie brzmi: jak połączyć Subiekt nexo z n8n bezpiecznie i poprawnie? Odpowiedź nie brzmi: „podłącz n8n bezpośrednio do bazy SQL i zapisuj dane w tabelach”. Znacznie lepszym podejściem jest zastosowanie warstwy pośredniej, czyli własnej usługi integracyjnej, która komunikuje się z Subiektem przez mechanizmy udostępniane przez InsERT, a dopiero na zewnątrz wystawia proste API dla n8n.

Dlaczego warto integrować Subiekt nexo z n8n?

W wielu firmach Subiekt nexo jest centralnym miejscem obsługi dokumentów sprzedaży, kartotek kontrahentów, towarów, stanów magazynowych, zamówień i faktur. Problem polega na tym, że proces biznesowy rzadko kończy się tylko w Subiekcie. Dane z dokumentów trzeba często przekazać dalej: do CRM, sklepu internetowego, systemu WMS, arkusza Excel, systemu kurierskiego, mailingu, aplikacji produkcyjnej, systemu raportowego albo narzędzia AI.

n8n może pełnić funkcję warstwy automatyzacji między Subiektem nexo a resztą firmy. Przykładowo: po utworzeniu zamówienia od klienta można automatycznie wysłać powiadomienie do handlowca, sprawdzić kompletność danych, wygenerować zadanie w CRM, wysłać dane do systemu produkcyjnego albo przygotować wiadomość e-mail do klienta.

Najważniejsza zasada: n8n nie powinien bezpośrednio modyfikować bazy Subiekta

Subiekt nexo pracuje na bazie danych MS SQL, więc technicznie możliwe jest odczytywanie danych przez zapytania SQL. Jednak bezpośrednie zapisywanie danych do tabel systemowych to bardzo ryzykowne podejście. Można w ten sposób ominąć logikę biznesową programu, walidacje, numerację dokumentów, mechanizmy rozliczeń, magazyn, powiązania między dokumentami i kontrolę uprawnień.

Bezpieczniejsza architektura wygląda tak:

Subiekt nexo / SQL Server / Sfera → własna usługa integracyjna → REST API → n8n → inne systemy

W takim układzie n8n nie musi znać wewnętrznej struktury bazy Subiekta. Wysyła tylko żądanie do usługi, na przykład:

GET /api/customers

GET /api/orders/open

POST /api/orders

POST /api/invoices/create

POST /api/warehouse/reservation

Dopiero usługa integracyjna, napisana najczęściej w C# / .NET, wykonuje właściwe operacje po stronie Subiekta nexo.

Rola Sfery i Sfery zdarzeniowej

W ekosystemie InsERT nexo kluczową rolę przy rozbudowie i integracjach pełni Sfera. InsERT opisuje Sferę jako mechanizm umożliwiający rozszerzanie funkcjonalności programów nexo PRO. Z kolei Sfera zdarzeniowa pozwala wykonywać dodatkowe operacje w reakcji na zdarzenia zachodzące w programie, na przykład czynność użytkownika, zapis dokumentu, ostrzeżenie, blokadę lub własny proces biznesowy. (insert.com.pl)

To oznacza, że w bardziej zaawansowanych scenariuszach można zbudować integrację, która nie tylko cyklicznie odpytuje Subiekta o dane, ale reaguje na zdarzenia w systemie. Przykład: użytkownik zapisuje zamówienie od klienta, a rozszerzenie wywołuje usługę integracyjną, która wysyła informację do n8n. W dyskusjach technicznych na forum InsERT pojawiają się właśnie takie scenariusze: Subiekt nexo PRO / Gestor nexo PRO połączony z n8n i ChatGPT przez pośrednią usługę C#/.NET, która wystawia REST API dla n8n. Trzeba jednak traktować forum jako źródło praktycznych wskazówek, a nie formalną dokumentację producenta. (Forum InsERT)

Proponowana architektura integracji

Najbardziej praktyczny model integracji wygląda następująco:

1. Subiekt nexo PRO

To główny system sprzedażowo-magazynowy. Tutaj znajdują się kartoteki kontrahentów, asortyment, cenniki, zamówienia, faktury, dokumenty magazynowe i rozrachunki.

2. Baza SQL Server

Może służyć głównie do odczytu raportowego, analiz i pobierania danych pomocniczych. Przy zapisie danych należy zachować dużą ostrożność i nie omijać mechanizmów aplikacji.

3. Usługa integracyjna C# / .NET

To najważniejszy element. Może działać jako:

aplikacja ASP.NET Core Web API,
Windows Service,
lokalny serwis na serwerze Subiekta,
moduł pośredniczący między Sferą a n8n.

Jej zadaniem jest tłumaczenie prostych zapytań z n8n na operacje zrozumiałe dla Subiekta nexo.

4. REST API dla n8n

n8n najlepiej komunikuje się z usługą pośrednią przez HTTP. Oficjalna dokumentacja n8n wskazuje węzeł HTTP Request jako uniwersalne narzędzie do wykonywania żądań HTTP do aplikacji i usług posiadających API. (docs.n8n.io)

5. n8n jako orkiestrator procesu

n8n nie powinien być miejscem, gdzie umieszcza się całą logikę Subiekta. Lepiej, aby odpowiadał za orkiestrację:

kiedy uruchomić proces,
do jakich systemów wysłać dane,
jakie warunki sprawdzić,
jakie powiadomienia wysłać,
jak połączyć Subiekta z CRM, e-mailem, AI, arkuszem, WMS lub sklepem.

Przykładowe automatyzacje

1. Nowe zamówienie od klienta → powiadomienie i zadanie

Po utworzeniu zamówienia od klienta w Subiekcie usługa integracyjna wysyła dane do n8n. n8n może wtedy:

wysłać wiadomość e-mail do opiekuna klienta,
dodać zadanie w CRM,
sprawdzić, czy klient ma przeterminowane płatności,
wysłać informację do działu produkcji,
utworzyć wpis w arkuszu kontrolnym.

2. Brak towaru → automatyczne powiadomienie

n8n może cyklicznie pytać usługę integracyjną o towary poniżej stanu minimalnego. Następnie może wysłać raport do zakupowca albo przygotować listę pozycji do zamówienia u dostawcy.

3. Faktura sprzedaży → e-mail do klienta

Po wystawieniu faktury Subiekt nexo może przekazać informację do usługi integracyjnej, a n8n może:

pobrać dane dokumentu,
przygotować wiadomość e-mail,
dodać załącznik PDF, jeżeli jest dostępny,
wysłać maila przez Outlook, Gmail lub SMTP,
zapisać ślad operacji w CRM.

4. Subiekt nexo + AI

Bardzo ciekawy scenariusz to połączenie Subiekta z modelem AI. n8n może przekazać dane klienta, historię zamówień lub opis sprawy do modelu językowego, a następnie wygenerować:

propozycję odpowiedzi do klienta,
podsumowanie historii współpracy,
notatkę dla handlowca,
analizę ryzyka opóźnienia,
sugestię produktów uzupełniających.

Tutaj trzeba jednak uważać na dane osobowe, tajemnice handlowe i kontrolę tego, co trafia do zewnętrznych usług AI.

5. Integracja z systemem produkcyjnym

W firmie produkcyjnej Subiekt nexo często obsługuje sprzedaż, magazyn i dokumenty handlowe, ale produkcja jest realizowana w osobnym systemie, na przykład Mozart Produkcja, MES, WMS lub autorskim module. W takim przypadku n8n może przekazywać dane z zamówień klienta do systemu produkcyjnego:

numer zamówienia,
klient,
termin realizacji,
pozycje asortymentowe,
ilości,
priorytet,
status płatności,
uwagi handlowe.

W drugą stronę system produkcyjny może zwracać do n8n status realizacji, a n8n może aktualizować CRM, wysyłać powiadomienia lub uruchamiać kolejne kroki procesu.

Integracja przez webhooki

Jedną z najwygodniejszych metod komunikacji jest webhook. Mechanizm wygląda tak:

W Subiekcie dzieje się zdarzenie, na przykład zapisano zamówienie.
Rozszerzenie lub usługa integracyjna wysyła żądanie HTTP do webhooka n8n.
n8n odbiera dane i uruchamia workflow.
Workflow wykonuje kolejne kroki: pobiera szczegóły dokumentu, sprawdza warunki, wysyła wiadomości, zapisuje dane w innych systemach.

W przypadku n8n self-hosted trzeba szczególnie zadbać o poprawną konfigurację adresu webhooka, HTTPS, reverse proxy i zmienne środowiskowe. Oficjalna dokumentacja n8n opisuje webhooki i integracje, a w praktyce wiele problemów z webhookami wynika z błędnej konfiguracji publicznego adresu instancji lub środowiska self-hosted. (docs.n8n.io)

Integracja cykliczna zamiast zdarzeniowej

Nie każda firma musi od razu wdrażać Sferę zdarzeniową. Czasami wystarczy prostszy model:

co 5 minut pobierz nowe zamówienia,
raz dziennie pobierz zaległe płatności,
raz na godzinę sprawdź stany magazynowe,
codziennie rano wyślij raport sprzedaży,
raz w tygodniu wygeneruj zestawienie nierotujących towarów.

Taki model jest prostszy, tańszy i łatwiejszy do utrzymania. Wadą jest opóźnienie, bo proces nie uruchamia się natychmiast po zdarzeniu, tylko według harmonogramu.

Czego nie robić?

Największe błędy przy integracji Subiekt nexo z n8n to:

Bezpośrednie zapisywanie danych do tabel SQL Subiekta.
To może uszkodzić spójność danych lub ominąć logikę programu.
Trzymanie całej logiki biznesowej w n8n.
n8n powinien orkiestracyjnie łączyć systemy, ale reguły specyficzne dla Subiekta lepiej umieścić w usłudze integracyjnej.
Brak kontroli uprawnień.
Integracja powinna działać na osobnym użytkowniku/operatorze z ograniczonym zakresem dostępu.
Brak logowania operacji.
Każde utworzenie dokumentu, aktualizacja kontrahenta czy wysłanie danych powinny być rejestrowane.
Brak kolejkowania i ponawiania.
Jeżeli Subiekt, SQL Server, n8n albo zewnętrzne API chwilowo nie działa, proces nie może po prostu „zgubić” dokumentu.
Wysyłanie zbyt wielu danych do AI.
Modele AI powinny dostawać tylko te dane, które są naprawdę potrzebne do wykonania zadania.

Minimalny zakres techniczny projektu

Dobrze zaprojektowany projekt integracji powinien obejmować:

analizę procesów biznesowych,
listę dokumentów i danych do wymiany,
określenie, które operacje są tylko do odczytu, a które tworzą lub modyfikują dane,
projekt usługi integracyjnej,
projekt endpointów REST API,
konfigurację n8n,
mechanizm autoryzacji,
logowanie błędów,
retry,
kolejkę zadań,
środowisko testowe,
dokumentację techniczną.

Przykładowe endpointy usługi integracyjnej

Usługa pośrednia dla n8n mogłaby udostępniać na przykład takie endpointy:

Endpoint
Cel

GET /api/customers/{id}
pobranie danych kontrahenta

GET /api/orders/new
lista nowych zamówień

GET /api/orders/{id}
szczegóły zamówienia

POST /api/orders
utworzenie zamówienia

POST /api/invoices/from-order/{id}
utworzenie faktury z zamówienia

GET /api/products/{symbol}/stock
pobranie stanu magazynowego

GET /api/payments/overdue
lista zaległych płatności

POST /api/notes/customer/{id}
dodanie notatki do kontrahenta

POST /api/webhook/order-created
przekazanie zdarzenia do n8n

Bezpieczeństwo

Integracja Subiekt nexo z n8n powinna być traktowana jak integracja systemów krytycznych. Przechodzą przez nią dane klientów, dokumenty handlowe, ceny, rabaty, informacje magazynowe i czasami dane finansowe.

Należy zastosować:

HTTPS,
tokeny API,
ograniczenie adresów IP,
osobne konto techniczne,
rejestrowanie wszystkich operacji,
szyfrowanie sekretów,
kopie zapasowe,
środowisko testowe,
walidację danych wejściowych,
ochronę webhooków przed przypadkowym lub złośliwym wywołaniem.

Jest to szczególnie ważne w automatyzacjach z AI, bo agentowe workflow mogą być podatne na nadużycia, jeśli bez kontroli przyjmują dane z zewnątrz i wykonują akcje w systemach firmowych. W najnowszych analizach bezpieczeństwa workflow agentowych wskazuje się ryzyka związane z manipulacją wejściami, wyciekiem poświadczeń i niekontrolowanym wykonywaniem akcji przez automatyzacje. (arXiv)

Czy warto?

Tak, ale pod warunkiem że integracja jest zaprojektowana profesjonalnie. n8n może być bardzo dobrym narzędziem do automatyzacji procesów wokół Subiekta nexo, szczególnie tam, gdzie firma chce szybko łączyć sprzedaż, magazyn, CRM, e-mail, system produkcyjny, raportowanie i AI.

Najlepszy model to nie „n8n bezpośrednio grzebiący w bazie Subiekta”, ale:

Subiekt nexo PRO + Sfera / usługa C# + REST API + n8n

Taka architektura jest bezpieczniejsza, bardziej odporna na aktualizacje, łatwiejsza do rozwijania i lepiej oddziela logikę systemu ERP od logiki automatyzacji.

Podsumowanie

Integracja Subiekt nexo z n8n pozwala zbudować nowoczesny ekosystem automatyzacji dla małej lub średniej firmy. Może obsługiwać powiadomienia, raporty, synchronizacje, zadania CRM, procesy magazynowe, integracje kurierskie, systemy produkcyjne i moduły AI.

Najważniejsze rekomendacje:

nie zapisuj danych bezpośrednio do tabel Subiekta,
zbuduj pośrednią usługę integracyjną w C#/.NET,
używaj n8n jako orkiestratora procesów,
stosuj webhooki lub harmonogramy,
loguj każdą operację,
zadbaj o bezpieczeństwo i uprawnienia,
zaczynaj od prostych automatyzacji, a dopiero później przechodź do procesów zdarzeniowych.

Dobrze wdrożona integracja może realnie odciążyć handlowców, magazyn, księgowość i dział obsługi klienta, a jednocześnie stworzyć fundament pod dalszą automatyzację firmy — od CRM, przez WMS, aż po produkcję i AI.