Subiekt GT + Shopify + Allegro — automatyzacja zamówień w 2 tygodnie

Problem: dlaczego Subiekt nie wystarczy sam

Subiekt GT robi świetną robotę jako księga + magazyn + sprzedaż dla MŚP — ale jest single-tenant desktop app, nie cloud-native. Jego natywna integracja z e-commerce to: insERT Nexo (drogi enterprise upgrade) lub Sello (basic plug-and-play, brak elastyczności). Reszta firm robi to ręcznie: księgowa codziennie pobiera zamówienia z 3 sklepów, przepisuje do Subiekta, wystawia faktury, exportuje.

Architektura: Subiekt jako "system of record"

Cały trick polega na tym żeby NIE zamieniać Subiekta. Subiekt zostaje "system of record" dla księgowej (faktury, magazyn, deklaracje VAT). Wokół niego budujesz middleware (n8n) który normalizuje dane ze sklepów i wpina do Subiekta przez API. Sklepy pozostają niezmienione, księgowa dalej pracuje w Subiekcie który zna, ale 90% danych wprowadza się samo.

Diagram flow (uproszczony)

• SHOPIFY → webhook order.created → n8n
• ALLEGRO → API polling co 5 min → n8n
• BASELINKER (Amazon, eBay) → webhook → n8n
• n8n (hub) → walidacja NIP GUS → mapowanie produktów → SUBIEKT GT API
• SUBIEKT → faktura PDF → n8n
• n8n → KSeF API (FA(2) XML) → UID
• n8n → email klient (PDF + UID) + magazynier (SMS Stork)

Subiekt GT Web API — co to jest i jak działa

Od wersji 1.75+ Subiekt GT ma natywny "Subiekt Web API" — REST endpoint po HTTPS, autoryzowany tokenem lub OAuth2. Działa lokalnie (lokalny serwer w sieci firmowej) lub przez tunel ngrok / Cloudflare Tunnel jeśli serwer Subiekt jest w firmie a n8n w chmurze.

Endpointy które używam najczęściej

• GET /api/towary — lista produktów (do mapowania ID Shopify ↔ Subiekt)
• GET /api/kontrahenci?nip=XXX — wyszukiwanie klienta po NIP
• POST /api/kontrahenci — dodanie nowego klienta B2B
• POST /api/dokumenty/faktura-sprzedaz — wystawienie faktury VAT
• GET /api/dokumenty/{id}/pdf — pobranie PDF faktury
• POST /api/dokumenty/{id}/wyslij-ksef — wystawienie w KSeF (od v1.81)
• GET /api/magazyn/stany?towar=XXX — sprawdzenie stanu magazynowego

Mapowanie produktów: największa pułapka

Pierwsza rzecz która kładzie automatyzację: te same produkty mają różne ID w Shopify, Allegro i Subiekcie. Sklep ma kod "FOTEL-X1-BLACK", Allegro ma offer_id "1234567890", Subiekt ma symbol "FX1-CZ" z indeksem "001". Bez właściwego mapowania faktura wystawia się na "Produkt nieznany" lub workflow się wywala.

Setup mappingu — tabela referencyjna

Najprostsze rozwiązanie: tabela w PostgreSQL (lub Google Sheet dla MŚP) z kolumnami: subiekt_symbol, shopify_sku, allegro_offer_id, baselinker_product_id, nazwa, cena_netto, VAT, GTU. n8n przed każdą fakturą lookup-uje produkt po external ID, znajduje subiekt_symbol, używa go w POST /faktura.

Automatyczna synchronizacja

Drugi workflow: cron co 30 min sprawdza nowe produkty w Subiekcie i wgrywa do Shopify (jeśli mają zaznaczone "publikuj online" w karcie towaru). Aktualizacja stanu magazynowego: webhook na zmianę stanu w Subiekcie → update inventory_quantity w Shopify, Allegro, BaseLinker.

Walidacja NIP klienta B2B

Klienci B2B w sklepie wpisują NIP w checkout, ale 15% wpisuje błędnie lub niekompletny. Bez walidacji wystawiasz faktury na nieprawidłowe NIP-y, kompletne pobranie z KSeF, klient nie odlicza VAT. Walidacja w n8n: API GUS REGON (free) → dla każdego NIP-u zwraca pełne dane firmy: nazwa, adres, kod, status czynnego podatnika.

• GET https://wl-api.mf.gov.pl/api/search/nip/{nip}?date=2026-05-15 — biały lista (czynny VAT)
• GET https://prod.ceidg.gov.pl/api/v1/firm/{nip} — CEIDG (jednoosobowe działalności)
• GET https://wyszukiwarka.gov.pl/api/firm/{regon} — REGON GUS (sp. z o.o. i wyższe)

Stack magazynu — SMS Stork + InPost

Po wystawieniu faktury workflow pcha zamówienie do magazynu (Subiekt automatycznie rezerwuje stan). SMS Stork wysyła SMS do magazyniera z numerem zamówienia, listą produktów i kuponem wysyłkowym. Magazynier pakuje, skanuje QR z SMS-a, n8n marks "shipped" w Shopify + tworzy nadanie w InPost API.

Tracking dla klienta

Klient dostaje 3 wiadomości email automatycznie: (1) Order confirmation z linkiem do faktury KSeF, (2) "Zamówienie pakujemy" gdy magazyn zacznie, (3) "Twoja paczka wysłana" z numerem trackingu InPost. Plus opcjonalnie SMS dla wartości >1000 zł.

Realny case: Fotel-Bis (Białystok)

Sklep meblowy z Białegostoku, 10 osób, ~80 zamówień dziennie (60% B2C ze Shopify, 30% B2B z WooCommerce, 10% Allegro). Przed wdrożeniem: 2 księgowe spędzały po 3h dziennie na przepisywaniu zamówień, 1-2 błędy NIP miesięcznie, B2B klienci czekali 1-2 dni na fakturę.

Stack wdrożenia

• Subiekt GT 1.81 z modułem Web API (1200 zł licencja) i modułem KSeF (1500 zł licencja)
• n8n self-hosted na VPS Hetzner CX21 (80 zł/mc)
• PostgreSQL na Supabase free tier (mapping tabel + logi)
• Cloudflare Tunnel (komunikacja n8n ↔ Subiekt w sieci firmowej)
• SMS Stork API + InPost API + Resend (mail) + KSeF token

Timeline

1. Tydzień 1: audyt + mapping produktów (700 SKU) + setup VPS + Subiekt Web API
2. Tydzień 2: główny workflow (Shopify → Subiekt) + walidacja NIP + KSeF integration
3. Tydzień 3: drugi workflow (Allegro → Subiekt) + magazyn SMS + tracking mail flow
4. Go-live: 1 dzień soft launch (50% ruchu), tydzień monitoring

Efekty po 3 miesiącach

• 14 h/tydz odzyskane (księgowe robią teraz analizy zamiast przepisywania)
• 6 sekund — czas faktury (z 4-6 minut ręcznie)
• 0 błędów NIP (walidacja GUS przed wystawieniem)
• Klient B2B dostaje fakturę w 30 sek po zamówieniu (zamiast 24-48 h)
• +12% conversion w sklepie B2B (szybsze faktury → szybsza decyzja zakupowa)
• Cena wdrożenia: 7 900 zł netto fixed (3 tygodnie roboty + 90 dni monitoringu)

Najczęstsze błędy

• Brak walidacji NIP — workflow działa, ale generuje faktury na błędne firmy
• Bezpośredni dostęp do bazy MS SQL Subiekta — łamie się przy update Subiekta
• Brak mapping tabeli produktów — pierwsza nieznana SKU wywala cały workflow
• Brak retry logic dla KSeF — peak hours mogą zwracać timeout, faktury "gubią się"
• Brak fallback queue — jeśli Subiekt jest wyłączony, workflow zalewa się błędami

Kiedy NIE warto automatyzować

• <30 zamówień/mc — księgowa ręcznie szybciej niż setup + monitoring automatyzacji
• Bardzo niestandardowe procesy (każde zamówienie negocjowane, custom warunki) — automation jest pożarem
• Firma w fazie pivot — nie automatyzuj procesu który zmieni się za 3 miesiące
• Brak osoby która rozumie Subiekta dogłębnie — bez sponsora wewnątrz firmy projekt kiedyś się zatrzyma

FAQ — najczęstsze pytania