Integracja Subiekt nexo z n8n — automatyzacja procesów sprzedaży, magazynu i produkcji

https://michalmoroz.info/?p=837

Wstęp

W wielu małych i średnich firmach Subiekt nexo jest podstawowym systemem do obsługi sprzedaży, magazynu, faktur, zamówień, kontrahentów i asortymentu. Z kolei n8n to platforma do automatyzacji procesów, która pozwala łączyć różne systemy: pocztę e-mail, CRM, arkusze kalkulacyjne, sklepy internetowe, API, bazy danych, komunikatory, systemy AI i aplikacje firmowe.

Połączenie tych dwóch światów daje firmie bardzo duże możliwości. Subiekt nexo może pozostać głównym systemem handlowo-magazynowym, a n8n może przejąć rolę centrum automatyzacji, które uruchamia procesy, przekazuje dane, wysyła powiadomienia i integruje Subiekta z innymi narzędziami.

W praktyce oznacza to mniej ręcznego przepisywania danych, mniej pomyłek, szybszą obsługę klienta i większą kontrolę nad procesami.

Czym jest n8n?

n8n to narzędzie typu workflow automation. Pozwala tworzyć automatyzacje złożone z kolejnych kroków, tzw. node’ów. Jeden krok może pobrać dane z systemu, drugi je przetworzyć, trzeci wysłać wiadomość e-mail, a czwarty zapisać wynik w innym systemie.

n8n ma wiele gotowych integracji, ale bardzo ważną funkcją jest uniwersalny node HTTP Request, który pozwala łączyć się z dowolnym systemem posiadającym API. Oficjalna dokumentacja n8n wskazuje, że HTTP Request może być używany również wtedy, gdy dla danego systemu nie ma dedykowanego node’a integracyjnego. (n8n Docs)

To szczególnie ważne przy integracji z systemami takimi jak Subiekt nexo, gdzie zwykle najlepszym rozwiązaniem jest przygotowanie własnej warstwy pośredniej, a następnie komunikacja z nią przez API.

Dlaczego warto połączyć Subiekt nexo z n8n?

Integracja Subiekt nexo z n8n pozwala zautomatyzować wiele codziennych czynności, które w firmach są często wykonywane ręcznie.

Przykładowo pracownik wystawia zamówienie od klienta w Subiekcie. Bez integracji ktoś musi ręcznie poinformować magazyn, produkcję, handlowca, księgowość albo klienta. Przy integracji z n8n taki proces może uruchomić się automatycznie.

n8n może:

wysłać wiadomość e-mail do klienta,
powiadomić handlowca w Teams lub Slacku,
utworzyć zadanie w CRM,
przekazać dane do systemu produkcyjnego,
zapisać wpis w arkuszu Google Sheets lub Excel,
uruchomić workflow w systemie WMS,
przygotować raport,
sprawdzić zaległości płatnicze,
wysłać dane do modelu AI w celu przygotowania podsumowania lub odpowiedzi.

Największa korzyść nie polega więc tylko na samej integracji technicznej. Chodzi o to, aby procesy w firmie zaczęły wykonywać się automatycznie, zgodnie z ustalonymi regułami.

Przykładowy scenariusz biznesowy

Wyobraźmy sobie firmę produkcyjno-handlową, która korzysta z Subiekt nexo PRO. Handlowiec przyjmuje zamówienie od klienta. Po zapisaniu dokumentu powinno wydarzyć się kilka rzeczy:

Produkcja powinna otrzymać informację o nowym zamówieniu.
Magazyn powinien sprawdzić dostępność materiałów.
Klient powinien dostać potwierdzenie przyjęcia zamówienia.
Kierownik powinien zobaczyć nowe zlecenie w raporcie.
W przypadku braku towaru powinno powstać zadanie dla działu zakupów.

Bez automatyzacji każda z tych czynności wymaga zaangażowania człowieka. Z integracją Subiekt nexo + n8n proces może wyglądać inaczej:

Zapis zamówienia w Subiekcie → usługa integracyjna → webhook n8n → automatyczne powiadomienia i zadania

Dzięki temu firma nie musi czekać, aż ktoś „pamięta, żeby wysłać maila”. Proces działa według ustalonego schematu.

Jak technicznie połączyć Subiekt nexo z n8n?

Najbezpieczniejszy model integracji nie polega na tym, że n8n bezpośrednio zapisuje dane do bazy Subiekta. Lepszym rozwiązaniem jest zastosowanie warstwy pośredniej.

Rekomendowana architektura:

Subiekt nexo / nexo PRO
        ↓
Sfera / Sfera zdarzeniowa / usługa C# .NET
        ↓
Własne REST API
        ↓
n8n
        ↓
CRM / e-mail / WMS / produkcja / AI / raporty

Taki model jest znacznie bezpieczniejszy, ponieważ n8n nie musi znać struktury bazy danych Subiekta. Komunikuje się tylko z prostym API, na przykład:

GET /api/orders/new
GET /api/customers/{id}
POST /api/invoices/create
POST /api/stock/check
POST /api/events/order-created

Całą logikę związaną z Subiektem obsługuje osobna aplikacja integracyjna, najczęściej napisana w C# / .NET.

Rola Sfery w integracji

W przypadku rozwiązań InsERT nexo PRO ważnym elementem jest Sfera oraz Sfera zdarzeniowa. Z materiałów InsERT wynika, że Sfera zdarzeniowa umożliwia tworzenie własnych rozszerzeń reagujących między innymi na dodanie, edycję, próbę usunięcia obiektu lub zmianę jego właściwości. Może służyć także do wykonywania własnych akcji po dodaniu nowego obiektu albo do blokowania wybranych operacji. (YouTube)

Dla integracji z n8n oznacza to bardzo ciekawe możliwości. Przykładowo po zapisaniu zamówienia od klienta rozszerzenie może uruchomić własną akcję, która przekaże informację do usługi integracyjnej, a ta wywoła webhook n8n.

W efekcie automatyzacja może być nie tylko cykliczna, ale również zdarzeniowa.

Integracja cykliczna czy zdarzeniowa?

Są dwa podstawowe modele integracji.

1. Integracja cykliczna

W tym modelu n8n co pewien czas odpytuje usługę integracyjną o nowe dane.

Przykłady:

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

To prostsze rozwiązanie. Nie wymaga rozbudowanej obsługi zdarzeń. Jest dobre na początek, szczególnie gdy firma chce szybko uruchomić pierwsze automatyzacje.

2. Integracja zdarzeniowa

W tym modelu proces uruchamia się natychmiast po wystąpieniu zdarzenia w Subiekcie.

Przykłady:

zapisano nowe zamówienie,
zmieniono status dokumentu,
dodano nowego kontrahenta,
wystawiono fakturę,
anulowano dokument,
zmieniono dane klienta,
przyjęto towar na magazyn.

Ten model jest bardziej elegancki i szybszy, ale też bardziej wymagający technicznie. Najczęściej wymaga użycia Sfery, Sfery zdarzeniowej lub własnej aplikacji działającej blisko Subiekta.

Najlepsze przykłady automatyzacji

1. Nowe zamówienie od klienta

Po zapisaniu zamówienia w Subiekcie n8n może automatycznie:

wysłać potwierdzenie do klienta,
powiadomić handlowca,
przekazać dane do systemu produkcyjnego,
sprawdzić dostępność asortymentu,
utworzyć zadanie dla magazynu,
zapisać dane w raporcie sprzedażowym.

To jedna z najbardziej praktycznych automatyzacji, bo zamówienie od klienta jest często początkiem całego procesu firmowego.

2. Kontrola stanów magazynowych

n8n może pobierać z Subiekta informacje o stanach magazynowych i reagować na przekroczenie progów minimalnych.

Przykład:

Jeżeli stan towaru < stan minimalny
→ wyślij powiadomienie do zakupów
→ dodaj pozycję do listy zakupowej
→ utwórz zadanie dla osoby odpowiedzialnej

W firmie produkcyjnej można ten mechanizm rozszerzyć o analizę zapotrzebowania materiałowego.

3. Przeterminowane płatności

n8n może codziennie pobierać listę należności po terminie i wykonywać automatyczne działania:

wysłać raport do księgowości,
powiadomić opiekuna klienta,
przygotować przypomnienie e-mail,
oznaczyć klienta w CRM,
zablokować automatyczne przyjęcie kolejnego zamówienia do realizacji, jeżeli firma stosuje taką politykę.

4. Faktura sprzedaży i wiadomość do klienta

Po wystawieniu faktury w Subiekcie proces może automatycznie:

pobrać dane dokumentu,
pobrać lub wygenerować PDF,
wysłać wiadomość e-mail,
zapisać informację o wysyłce,
utworzyć wpis w historii kontaktu z klientem.

To ogranicza ręczną pracę i zmniejsza ryzyko, że faktura nie zostanie wysłana.

5. Integracja z produkcją

W firmie produkcyjnej Subiekt nexo często obsługuje sprzedaż i magazyn, natomiast produkcja jest prowadzona w osobnym systemie, na przykład MES, MRP, WMS albo Mozart Produkcja.

W takim przypadku n8n może pośredniczyć w przekazywaniu danych:

Zamówienie od klienta w Subiekcie
→ n8n
→ system produkcyjny
→ status produkcji
→ informacja zwrotna do handlowca

Dzięki temu handlowiec może szybciej wiedzieć, czy zamówienie jest przyjęte, w produkcji, gotowe do wysyłki czy opóźnione.

Subiekt nexo + n8n + AI

Bardzo interesującym kierunkiem jest połączenie Subiekta, n8n i sztucznej inteligencji.

n8n może pobrać dane z Subiekta, a następnie przekazać je do modelu AI w celu przygotowania:

podsumowania historii klienta,
propozycji odpowiedzi na e-mail,
analizy zaległości,
klasyfikacji zgłoszenia,
streszczenia zamówienia,
sugestii produktów uzupełniających,
raportu dla właściciela firmy.

Przykład:

Klient wysyła zapytanie e-mail
→ n8n pobiera historię klienta z Subiekta
→ AI przygotowuje propozycję odpowiedzi
→ handlowiec zatwierdza wiadomość
→ odpowiedź trafia do klienta

Ważne jest jednak, aby nie budować automatyzacji, w której AI bez kontroli człowieka wykonuje krytyczne operacje, na przykład zmienia ceny, wystawia dokumenty albo wysyła wiążące oferty. W badaniach nad automatyzacjami agentowymi zwraca się uwagę na ryzyka związane z manipulacją wejściem, wyciekiem poświadczeń i niekontrolowanym wykonaniem działań przez zautomatyzowane workflow. (arXiv)

Dlatego najlepszy model to:

AI przygotowuje propozycję, człowiek zatwierdza działanie.

Czego absolutnie unikać?

Największym błędem jest traktowanie bazy danych Subiekta jak zwykłej tabeli do swobodnego zapisu.

Subiekt nexo działa na SQL Serverze, ale to nie znaczy, że zewnętrzna automatyzacja powinna bezpośrednio dopisywać dokumenty do tabel. Dokument handlowy to nie tylko jeden rekord. To logika numeracji, magazynu, rozrachunków, powiązań, statusów, rezerwacji, operatorów, uprawnień i historii zmian.

Dlatego należy unikać:

bezpośredniego tworzenia dokumentów przez INSERT do tabel SQL,
ręcznego modyfikowania stanów magazynowych w bazie,
obchodzenia mechanizmów Subiekta,
wykonywania automatyzacji bez logów,
używania jednego konta administratora do wszystkiego,
trzymania haseł w jawnej postaci,
wysyłania pełnych danych handlowych do zewnętrznych usług bez kontroli.

Do odczytu raportowego SQL może być użyteczny, ale do zapisu i operacji biznesowych lepiej używać oficjalnych lub kontrolowanych mechanizmów integracyjnych.

Proponowany zakres pierwszego wdrożenia

Nie warto zaczynać od największego i najtrudniejszego procesu. Najlepiej uruchomić integrację etapami.

Etap 1: Automatyzacje informacyjne

Na początek warto wdrożyć procesy, które tylko odczytują dane i wysyłają informacje:

codzienny raport sprzedaży,
lista przeterminowanych płatności,
powiadomienie o nowych zamówieniach,
raport stanów minimalnych,
lista dokumentów do weryfikacji.

To najbezpieczniejszy etap, ponieważ automatyzacja nie modyfikuje jeszcze danych w Subiekcie.

Etap 2: Automatyzacje zadaniowe

Drugi etap to tworzenie zadań i przekazywanie danych do innych systemów:

zadania dla handlowców,
zgłoszenia do magazynu,
powiadomienia dla produkcji,
wpisy w CRM,
synchronizacja z arkuszami,
przekazywanie zamówień do systemu produkcyjnego.

Etap 3: Automatyzacje dokumentowe

Dopiero na kolejnym etapie warto przejść do procesów, które tworzą lub modyfikują dokumenty:

tworzenie zamówień,
generowanie faktur,
aktualizacja danych kontrahenta,
rezerwacje magazynowe,
tworzenie dokumentów magazynowych.

Tu konieczna jest większa kontrola, logowanie i testy.

Etap 4: Automatyzacje z AI

Na końcu można dodać AI:

podsumowania klientów,
automatyczne propozycje odpowiedzi,
analiza sprzedaży,
klasyfikacja zapytań,
generowanie opisów produktów,
wsparcie handlowca.

Warto jednak zostawić zatwierdzanie ważnych decyzji człowiekowi.

Bezpieczeństwo integracji

Integracja Subiekta z n8n powinna być zaprojektowana tak, jak każdy inny system krytyczny w firmie.

Należy zadbać o:

osobnego użytkownika technicznego,
ograniczone uprawnienia,
szyfrowane połączenie HTTPS,
tokeny API,
ograniczenie dostępu po adresach IP,
logowanie każdej operacji,
kopie zapasowe,
obsługę błędów,
kolejkę zadań,
mechanizm ponawiania,
środowisko testowe,
dokumentację techniczną.

Szczególnie ważne są webhooki. n8n bardzo dobrze nadaje się do pracy z webhookami, ale w przypadku instalacji self-hosted trzeba poprawnie skonfigurować publiczny adres, HTTPS, reverse proxy i środowisko, aby zewnętrzne systemy mogły prawidłowo wywoływać workflow. Oficjalna dokumentacja n8n opisuje mechanizmy integracji oraz wykorzystanie węzłów HTTP i webhooków jako podstawowych sposobów łączenia z innymi systemami. (n8n Docs)

Przykładowa architektura dla firmy produkcyjnej

Dla firmy produkcyjnej korzystającej z Subiekt nexo PRO można zaproponować następujący układ:

Subiekt nexo PRO
    |
    | dane o klientach, towarach, zamówieniach, fakturach
    ↓
Usługa integracyjna C# / .NET
    |
    | REST API + logowanie + walidacja
    ↓
n8n
    |
    | workflow automatyzujące procesy
    ↓
System produkcyjny / WMS / CRM / e-mail / AI / raporty

W takim modelu każdy system robi to, do czego jest najlepszy.

Subiekt nexo odpowiada za sprzedaż, magazyn, dokumenty i rozrachunki.

Usługa integracyjna odpowiada za bezpieczną komunikację z Subiektem.

n8n odpowiada za orkiestrację procesu.

System produkcyjny lub WMS odpowiada za realizację operacji produkcyjnych i magazynowych.

AI wspiera analizę, komunikację i podejmowanie decyzji, ale nie powinno bez nadzoru wykonywać krytycznych operacji.

Korzyści dla firmy

Dobrze wykonana integracja daje firmie kilka konkretnych korzyści.

Mniej ręcznego przepisywania danych

Dane raz wprowadzone do Subiekta mogą automatycznie trafiać do innych systemów.

Szybsza obsługa klienta

Klient szybciej dostaje potwierdzenie zamówienia, fakturę, informację o statusie lub odpowiedź handlowca.

Lepsza kontrola procesu

Właściciel lub kierownik widzi, które zamówienia są nowe, opóźnione, zagrożone lub wymagają reakcji.

Mniej pomyłek

Automatyzacja zmniejsza ryzyko błędów wynikających z ręcznego kopiowania danych.

Łatwiejsza integracja z produkcją

Subiekt może pozostać systemem handlowym, a dane produkcyjne mogą trafiać do dedykowanego systemu MES/MRP/WMS.

Możliwość użycia AI

n8n może być pomostem między danymi z Subiekta a narzędziami AI.

Kiedy taka integracja ma największy sens?

Integracja Subiekt nexo z n8n ma szczególnie duży sens, gdy firma:

ma dużo powtarzalnych czynności administracyjnych,
ręcznie przepisuje dane między systemami,
obsługuje wiele zamówień,
chce automatyzować powiadomienia,
używa CRM, sklepu internetowego lub systemu WMS,
chce połączyć Subiekta z produkcją,
potrzebuje raportów i alertów,
chce wdrożyć AI w bezpieczny, kontrolowany sposób.

Nie każda firma musi od razu budować wielki system integracyjny. Często wystarczy zacząć od jednego prostego procesu, na przykład codziennego raportu sprzedaży albo powiadomienia o nowym zamówieniu.

Podsumowanie

Integracja Subiekt nexo z n8n to sposób na uporządkowanie i automatyzację codziennych procesów w firmie. n8n może łączyć Subiekta z pocztą, CRM, arkuszami, systemem produkcyjnym, WMS, sklepem internetowym, komunikatorami i AI.

Najważniejsze jest jednak dobre zaprojektowanie architektury. n8n nie powinien bezpośrednio modyfikować bazy Subiekta. Bezpieczniejszy model to:

Subiekt nexo PRO
→ Sfera lub usługa integracyjna C#/.NET
→ REST API
→ n8n
→ inne systemy

Dzięki temu firma zyskuje automatyzację, ale nie traci kontroli nad danymi i logiką systemu handlowo-magazynowego.

Najlepiej zaczynać od prostych automatyzacji informacyjnych, następnie przejść do zadań i integracji z innymi systemami, a dopiero później do tworzenia dokumentów oraz scenariuszy z AI.

Dobrze wdrożona integracja Subiekt nexo + n8n może stać się ważnym elementem cyfrowej transformacji firmy — szczególnie tam, gdzie sprzedaż, magazyn, produkcja i obsługa klienta muszą działać szybko, spójnie i bez ręcznego przepisywania danych.