Parametry techniczne Subiekt nexo API
5 sposobów automatyzacji z Subiekt nexo API
Poniżej znajdziesz konkretne zastosowania Subiekt nexo API w projektach automatyzacji procesów B2B — z opisem logiki, endpointów i realnej oszczędności czasu.
Automatyczne tworzenie dokumentów WZ i FV ze zamówień e-commerce
Nowe zamówienie z Allegro, WooCommerce lub BaseLinker trafia przez webhook do Make. Make wywołuje Insert API (POST /documents/wz) z pozycjami zamówienia, adresem i kontrahentem. Jeśli kupujący podał NIP — równolegle tworzona jest FV VAT. Dokument wydruku PDF wraca do Make i jest wysyłany e-mailem.
POST /documents/wzPOST /documents/fvGET /contractorsPOST /contractorsSynchronizacja stanów magazynowych z Allegro i WooCommerce
Każda operacja magazynowa w Subiekcie (przyjęcie PZ, sprzedaż WZ, korekta) triggeruje webhook lub jest odpytywana przez polling (GET /items/{sku}/stock). Make propaguje zmianę stanu do Allegro (PUT /sale/offers/{id}) i WooCommerce (PUT /wp-json/wc/v3/products/{id}) — centralny magazyn jako single source of truth.
GET /itemsGET /items/{id}/stockPOST /stock-correctionsImport kontrahentów i synchronizacja z CRM (HubSpot, Pipedrive)
Gdy w HubSpot pojawia się nowy klient (deal "Closed Won"), Make sprawdza przez NIP czy kontrahent istnieje w Subiekcie (GET /contractors?nip=). Jeśli nie — tworzy (POST /contractors) z pełnymi danymi. Przy kolejnych zamówieniach kontrahent jest już w systemie — zero duplikatów.
GET /contractorsGET /contractors/{id}POST /contractorsPUT /contractors/{id}Eksport sprzedaży do BigQuery i dashboardy BI
Tygodniowy skrypt pobiera dokumenty sprzedaży (GET /documents/fv?dateFrom=&dateTo=) z paginacją, transformuje do flat JSON i ładuje do BigQuery przez API. Zarząd ma dashboard sprzedaży w Looker Studio bez ręcznych raportów z Subiekta.
GET /documents/fvGET /documents/wzGET /reports/salesAutomatyczne przyjęcia PZ od dostawców
Dostawca wysyła plik EDI lub CSV z dostawą. Skrypt parsuje plik, weryfikuje SKU w Subiekcie (GET /items?symbol=) i tworzy dokumenty PZ (POST /documents/pz) — towar pojawia się w magazynie bez ręcznego wprowadzania. Zintegrowane z przyjęciami z Allegro Fulfillment.
POST /documents/pzGET /itemsPOST /itemsKluczowe endpointy Subiekt nexo API
Poniżej lista endpointów najczęściej używanych w automatyzacjach. Każdy endpoint jest częścią standardowego REST API i obsługuje autentykację przez API Key (Insert API) lub SDK lokalny.
/documents/fv
Lista faktur VAT z filtrowaniem po dacie i kontrahencie
/documents/fv
Utwórz fakturę VAT
/documents/wz
Utwórz dokument WZ (wydanie zewnętrzne)
/documents/pz
Utwórz dokument PZ (przyjęcie zewnętrzne)
/items
Lista towarów z cenami i stanami
/items/{id}/stock
Stan magazynowy konkretnego towaru
/contractors
Lista kontrahentów (filtrowanie po NIP, nazwie)
/contractors
Utwórz kontrahenta
Zanim wdrożysz integrację produkcyjnie, przetestuj endpointy w środowisku sandbox (jeśli dostępne) lub na dedykowanym koncie testowym. Dla Subiekt nexo API dokumentację techniczną znajdziesz na https://developer.insert.pl.
Przykładowy przepływ: Przepływ: Zamówienie WooCommerce → WZ Subiekt → FV → InPost → e-mail
- WooCommerce webhook (order.created) → Make
- Make sprawdza czy kontrahent istnieje w Subiekcie po e-mailu lub NIP
- Jeśli nie — Make tworzy kontrahenta w Subiekcie (POST /contractors)
- Make tworzy WZ w Subiekcie (POST /documents/wz) z pozycjami zamówienia
- Jeśli zamówienie ma NIP firmy — Make tworzy FV (POST /documents/fv)
- Make generuje etykietę InPost (POST /v1/shipments) i numer śledzenia
- Make wysyła kupującemu e-mail z FV/paragonem w PDF i numerem śledzenia
- Make aktualizuje zamówienie w WooCommerce: status "Completed", tracking number
Jak JustAutomate wdraża integracje Subiekt nexo
W projektach JustAutomate integracja Subiekt nexo API to jeden z najczęstszych elementów automatyzacji. Nasz proces zaczyna się od audytu API — sprawdzamy dostępne endpointy, rate limity, stabilność tokenów i formatów danych po stronie klienta.
W większości przypadków używamy Make lub n8n jako middleware — narzędzia, które łączą Subiekt nexo z innymi systemami bez pisania kodu. Dla złożonych przypadków (własna logika transformacji danych, integracja z legacy systemem, niestandardowe formaty) piszemy skrypty Node.js lub Python z pełną obsługą błędów i logowaniem.
Każda integracja, którą budujemy, ma monitoring — wiemy natychmiast, gdy API zwróci błąd 5xx lub przekroczymy rate limit. Klient nie dowiaduje się o awarii z opóźnieniem — system jest samo-naprawiający i alertuje nas zanim wpłynie to na procesy.
Jeśli chcesz zintegrować Subiekt nexo ze swoimi systemami, możemy omówić zakres i ROI w 30-minutowej rozmowie. Pierwsza konsultacja jest bezpłatna.
FAQ — najczęstsze pytania o Subiekt nexo API
Czy Subiekt nexo ma API REST do integracji zewnętrznych?
Tak — Insert API (developer.insert.pl) to REST API dla Subiekta nexo i Subiekta GT. Dostęp przez klucz API generowany w panelu Insert. Alternatywnie, dla starszych wersji dostępne jest API COM/SDK (lokalne, Windows-only). Insert API jest rekomendowane dla nowych integracji.
Jaka jest różnica między Subiektem GT a Subiektem nexo w kontekście API?
Subiekt nexo ma Insert API REST — nowoczesne, cloudowe, łatwe w integracji. Subiekt GT (starszy) korzysta głównie z API COM (lokalne SDK Windows). Migracja do nexo jest zalecana przed budową nowych integracji — unikasz ograniczeń lokalnych połączeń.
Czy można integrować Subiekta z BaseLinkerem bez programowania?
BaseLinker ma wbudowany moduł synchronizacji z Subiektem nexo — stany magazynowe, zamówienia, dokumenty. Konfiguracja w panelu BaseLinker, bez kodu. Dla zaawansowanych scenariuszy (własna logika mapowania, wielomagazynowość, niestandardowe pola) konieczne jest programowanie przez Insert API.
Ile kosztuje dostęp do Insert API Subiekta?
Insert API jest częścią licencji Subiekt nexo — brak dodatkowych opłat za API. Potrzebna jest aktywna licencja nexo (abonament miesięczny lub jednorazowa). Limity requestów: 1000/minutę dla standardowych kont.
Czy Subiekt obsługuje integrację z JPK i KSeF?
Tak. Subiekt nexo generuje pliki JPK_V7M/JPK_V7K automatycznie z wystawionych dokumentów. KSeF (Krajowy System e-Faktur) — Subiekt nexo obsługuje wysyłkę e-faktur do KSeF przez własny moduł. Przez API można inicjować wysyłkę i sprawdzać status (GET /documents/fv/{id}/ksef-status).
Potrzebujesz integracji Subiekt nexo
w swoich procesach?
Budujemy integracje Subiekt nexo API z CRM, ERP, fakturowaniem i narzędziami AI. Bezpłatna konsultacja — 30 minut, konkretny plan z ROI.