Subiekt GT API w n8n 2026 — automatyzacja faktur + KSeF (pełen setup PL)

Subiekt GT to księgowa rzeczywistość 60% polskich MŚP. Wystawia faktury, prowadzi magazyn, robi JPK. Ale ręczne klikanie zamówień z 5 kanałów sprzedaży zabija 8-12h pracy miesięcznie. Ten przewodnik pokazuje krok-po-kroku jak połączyć Subiekt GT z n8n i automatycznie wystawiać faktury VAT + wysyłać je do KSeF.

Po co automatyzować Subiekt GT przez API?

Subiekt GT ma świetne wbudowane funkcje, ale każda integracja kosztuje czas. Przykład realnego klienta SYSTEMBOX (sklep z 30 zamówień/dzień): księgowa ręcznie kopiowała dane z Allegro, Shopify, BaseLinker, formularzy kontaktowych i emaili do Subiekta. 4 godziny dziennie. Po wdrożeniu n8n + Subiekt API: 20 minut dziennie na weryfikację automatycznych faktur.

Subiekt InsERT API to oficjalne REST API od producenta. Wymaga: licencja Subiekta GT (od 2 880 zł netto), aktywne wsparcie InsERT (300-500 zł/rok), oraz wygenerowany token API z panelu administracyjnego.

Architektura: Subiekt GT + n8n + KSeF

Workflow jest prosty: webhook z Twojego systemu → n8n decyduje typ dokumentu → Subiekt API tworzy fakturę → wysyłka do KSeF → email z linkiem do PDF. Cała operacja zajmuje 3-5 sekund i działa 24/7.

Krok 1: Wygeneruj API token w Subiekt

• Subiekt panel → Administracja → Tokeny API
• Kliknij „Wygeneruj nowy token” → nadaj nazwę „n8n-integration”
• Zaznacz uprawnienia: faktury.utworz, kontrahenci.czytaj, kontrahenci.utworz, magazyn.czytaj
• Wygeneruj → kopiuj token (zaczyna się sk_)

Krok 2: Credential w n8n

W n8n: Settings → Credentials → New → HTTP Bearer Auth. Wklej token. Save. Zapamiętaj credential ID.

Krok 3: HTTP Request node do tworzenia faktury

Node HTTP Request w n8n: Method POST, URL https://subiekt-api.insert.com.pl/v1/faktury, Authentication = Bearer (wybierz credential), Body JSON:

{ "kontrahent_nip": "{{ $json.nip }}", "pozycje": [{ "nazwa": "{{ $json.product }}", "cena_netto": {{ $json.price }}, "vat": 23 }], "data_sprzedazy": "{{ $now.format('yyyy-MM-dd') }}", "termin_platnosci": 7 }

Edge cases i gotchas

1. Kontrahent nie istnieje w Subiekt

Subiekt rzuca 404 jeśli NIP nie jest w bazie. Rozwiązanie: w n8n dodaj IF node przed Create Invoice — jeśli kontrahent nie znaleziony, najpierw stwórz przez POST /v1/kontrahenci (auto-pobranie z GUS REGON API, patrz nasz poradnik GUS REGON).

2. SKU mapping z Allegro/Shopify

Sklepy używają własnych SKU. Subiekt ma kody produktów. Trzeba mieć mapping. Najprościej: tabela w Subiekt → magazyn.csv_eksport + przechowywanie mapping w Postgres/Airtable. Workflow odbiera SKU z Allegro, mapuje przez lookup, wysyła Subiekt code do API.

3. KSeF compliance

Od 1 lutego 2026 KSeF jest obowiązkowy. Subiekt API ma flagę auto_ksef: true — po wystawieniu faktury automatycznie wysyła ją do Ministerstwa Finansów. Włącz to zawsze. Pełny przewodnik KSeF: KSeF 2026 — kompletny przewodnik.

Use cases (z polskimi realiami)

Case 1: E-commerce Shopify/Allegro → Subiekt

Webhook Allegro OrderCreated → n8n pobiera detale → Create Customer w Subiekt → Create Invoice → email do klienta z PDF. Realny czas: 4 sek. Klient SYSTEMBOX (kosmetyki, 60 zamówień/dzień) oszczędza 12h/mies = 1 800 zł/mies. Workflow Allegro → Subiekt kosztuje 1 497 zł.

Case 2: Faktura po opłaceniu z WooCommerce

Webhook WC order_status_completed → Subiekt API → KSeF → email. Workflow Faktura po opłaceniu (697 zł) ma to gotowe.

Case 3: Faktura z formularza kontaktowego

Klient zgłasza chęć usługi przez formularz → n8n wystawia fakturę pro forma w Subiekt → wysyła link do BLIK → po opłaceniu auto-konwersja na fakturę końcową + KSeF.

Koszt vs ROI

• Setup time: 2-4 godziny (sam) lub VIP setup 2 997 zł (Sergiusz robi wszystko)
• Subiekt licencja: masz już lub kup 2 880 zł netto
• n8n self-hosted: ~20 zł/mies VPS lub n8n Cloud 100 zł/mies
• Oszczędność księgowej: 8-15h/mies × 80 zł/h = 640-1200 zł/mies
• ROI: ~30-60 dni

FAQ

Czy Subiekt API jest płatne osobno?

Tak. Wymaga aktywnego wsparcia InsERT (~300-500 zł/rok) plus licencja Subiekta. API samo w sobie jest gratis, ale dostęp przez wsparcie.

Czy działa to z Subiektem Nexo?

Nexo to nowsza chmurowa wersja InsERT z innym API. Workflow jest podobny, tylko endpoint inny: https://api.insert.com.pl/nexo/v1/. SYSTEMBOX ma osobny workflow dla Nexo.

Czy mogę testować bez ryzyka?

Tak. Subiekt ma środowisko sandbox — tworzysz testowego kontrahenta + magazyn testowy. Testujesz workflow tam zanim podłączysz produkcję.