Wysyłka ZK z Subiekta do sklepu i realizacja ZK (seria ZZK)

Jak skonfigurować automatyczne przesyłanie Zamówień Klienta (ZK) z Subiekta GT do sklepu (Sellasist) i — opcjonalnie — sprawić, by po wystawieniu dokumentu w sklepie ZK zostało w Subiekcie zrealizowane, a nie usunięte.

1. Jak to działa — w skrócie

   Moduł „Wysyłka ZK do OMS" działa w dwie strony. Najpierw z Subiekta do sklepu: Zamówienia Klienta (ZK), które oznaczysz wybraną flagą, integrator co kilka minut zamienia na nowe zamówienia w sklepie (Sellasist) — wraz z pozycjami, płatnością i adresem. Następnie, gdy w sklepie wystawisz na to zamówienie dokument sprzedaży, wraca on do Subiekta i powstaje tam faktura albo paragon.
   
   Domyślnie po wystawieniu dokumentu powiązane ZK jest usuwane (służyło tylko do rezerwacji towaru). Jeśli wolisz, żeby ZK zostało w Subiekcie zrealizowane jako pełnoprawny dokument („na podstawie ZK"), a nie usuwane — służy do tego opcja „Pole dodatkowe OMS na ID ZK (realizacja przez serię ZZK)" opisana w dalszej części.
   
   Moduł wymaga pełnej licencji (FULL) i dotyczy Subiekta GT (w InsERT NEXO jest niedostępny).

2. Włączenie modułu i częstotliwość sprawdzania

   1. W konfiguratorze otwórz sekcję „Wysyłka ZK do OMS" i włącz przełącznik „Włącz moduł wysyłania ZK do OMS". Dopiero wtedy pojawią się pozostałe opcje.
   2. Ustaw „Co ile minut wyszukiwać nowe ZK" — jak często integrator ma zaglądać do Subiekta po nowe, oznaczone flagą ZK (np. co 5 minut).

3. Flagi — czym oznaczasz ZK i co dzieje się po wysyłce

   Wysyłką steruje flaga ustawiana na ZK w Subiekcie. Najpierw kliknij „Pobierz dane z Subiekta", aby wczytać listę dostępnych flag, a następnie ustaw trzy flagi:

   • „Flaga ZK do przesłania do OMS" — flaga, którą zaznaczasz na ZK, żeby trafiło do sklepu. Tylko ZK z tą flagą są wysyłane.
   • „Flaga po przesłaniu ZK do OMS" — flaga ustawiana automatycznie po udanej wysyłce. Dzięki niej widzisz, że ZK już poszło, i nie zostanie wysłane drugi raz.
   • „Flaga po błędzie przesyłania ZK" — flaga ustawiana, gdy wysyłka się nie powiedzie (np. brakuje danych). Ułatwia wyłapanie ZK do poprawienia.

4. Status w sklepie, podtytuł i co zrobić z ZK po wysłaniu

   • „Status tworzonego zamówienia w OMS" — z jakim statusem ma powstać nowe zamówienie w sklepie po przesłaniu ZK.
   • „Wpisz numer zamówienia w podtytuł" — po włączeniu numer zamówienia ze sklepu trafia w podtytuł ZK w Subiekcie (ułatwia późniejsze odszukanie).
   • „Co zrobić z ZK po przesłaniu do OMS" — akcja na ZK zaraz po jego wysłaniu. Do wyboru:
     • Usuń ZK — kasuje ZK w Subiekcie;
     • Realizuj bez dokumentu i zmień flagę — oznacza ZK jako zrealizowane (bez wystawiania dokumentu) i ustawia flagę;
     • Tylko zmień flagę — zostawia ZK otwarte i ustawia flagę po wysyłce;
     • Tylko zmień flagę, nie zmieniaj uwag — jw., a dodatkowo nie rusza pola uwag na ZK;
     • Realizuj bez dokumentu i zmień flagę, nie zmieniaj uwag — jak „Realizuj bez dokumentu…", ale bez zmiany uwag.

   Ważne: jeśli chcesz później realizować ZK przez serię ZZK (kolejna sekcja), wybierz tutaj „Tylko zmień flagę, nie zmieniaj uwag". ZK musi nadal istnieć w Subiekcie jako otwarte zamówienie, żeby dokument wystawiony w sklepie miał co zrealizować — opcje „Usuń ZK" oraz „Realizuj bez dokumentu…" by to uniemożliwiły.

5. Dane z ZK przenoszone do pól dodatkowych w sklepie

   Możesz przepisać wybrane informacje z ZK do pól dodatkowych zamówienia w sklepie (przydatne do podglądu i filtrowania). Każde pole wybierasz z listy pól dodatkowych Twojego sklepu; opcja „Nie mapuj" wyłącza dany przepis.

   • „Wprowadź operatora z ZK do pola dodatkowego OMS" + „Pole dodatkowe OMS dla operatora" — nazwa operatora, który wystawił ZK.
   • „Wprowadź symbol kontrahenta z ZK…" + „Pole dodatkowe OMS dla symbolu kontrahenta" — symbol klienta z Subiekta.
   • „Pole dodatkowe OMS dla uwag z dokumentu" — uwagi wpisane na ZK.
   • „Pole dodatkowe OMS na NUMER ZK" — czytelny numer ZK (np. ZK 123/2026). To osobne ustawienie niż „Dodaj numer ZK do pola dodatkowego" z sekcji „Dokumenty": tamto dotyczy kierunku odwrotnego (ze sklepu na ZK), a to — kierunku ZK → sklep.

6. Pole dodatkowe OMS na ID ZK — realizacja przez serię ZZK (zamiast usuwania)

   Ta opcja sprawia, że po wystawieniu dokumentu w sklepie powiązane ZK w Subiekcie zostaje zrealizowane (jako faktura albo paragon wystawiony „na podstawie ZK"), a nie usunięte.
   
   Jak to ustawić — krok po kroku:

   1. W polu „Pole dodatkowe OMS na ID ZK (realizacja przez serię ZZK)" wskaż pole dodatkowe w sklepie, w którym integrator zapisze identyfikator ZK. „Nie mapuj" = funkcja wyłączona. Przy każdej wysyłce ZK → sklep ten identyfikator zapisuje się tam automatycznie — to po nim dokument zostanie później bezbłędnie powiązany z właściwym ZK (pewniej niż po numerze czy podtytule).
   2. Ustaw „Co zrobić z ZK po przesłaniu do OMS" na „Tylko zmień flagę, nie zmieniaj uwag" — dzięki temu ZK zostaje w Subiekcie jako otwarte zamówienie i jest co zrealizować (opcje „Usuń ZK" oraz „Realizuj bez dokumentu…" by to uniemożliwiły).
   3. W sklepie (Sellasist) dokument na to zamówienie wystaw na numeracji (serii) zaczynającej się od „ZZK". To właśnie prefiks ZZK w numerze dokumentu jest dla integratora sygnałem: „zamiast usuwać ZK — zrealizuj je".

   Rodzaj dokumentu w Subiekcie zależy od dalszej części numeru:

   • ZZKPAi… → powstaje paragon imienny (PAi);
   • każdy inny numer z prefiksem ZZK (np. ZZK…, ZZKFS…) → powstaje faktura sprzedaży (FS).

   Co się dzieje pod spodem (dla Ciebie): integrator odczytuje zapisany wcześniej identyfikator ZK, wystawia na jego podstawie dokument końcowy i tym samym realizuje to ZK. Ponieważ dokument powstaje „na podstawie ZK", integrator już nie usuwa ani nie zamyka tego ZK dodatkowo.
   
   Czym ta opcja różni się od pozostałych sposobów zamykania ZK:

   • Domyślnie (bez tej opcji) — po wystawieniu dokumentu ZK jest usuwane.
   • „Zamiast usuwać ZK — oznacz jako zrealizowane bez dokumentu" (sekcja „Tworzenie i obsługa ZK") — ZK otrzymuje status „zrealizowane", ale bez powiązanego dokumentu.
   • Seria ZZK (ta opcja) — ZK zostaje zrealizowane konkretnym dokumentem (FS lub PAi) trwale powiązanym w Subiekcie.

   O czym pamiętać:

   • Pole na ID ZK musi być ustawione. Jeśli w sklepie pojawi się dokument z serii ZZK, a pole nie jest skonfigurowane lub nie zawiera identyfikatora ZK, integrator zgłosi błąd i nie wystawi dokumentu.
   • To samo pole chroni przed zapętleniem: zamówienie, które powstało z ZK Subiekta, nie utworzy w drodze powrotnej kolejnego ZK.

7. Mapowanie płatności i dostawy (Sellasist)

   Aby zamówienie w Sellaście miało poprawną płatność i dostawę (sekcja widoczna, gdy sklepem jest Sellasist):

   • „Mapowanie płatności Subiekt → OMS (Sellasist)" — dla każdego typu płatności z Subiekta wskaż odpowiadającą metodę płatności w Sellaście. „Nie mapuj" zostawia pole puste.
   • „Mapowanie SKU dostawy Subiekt → metoda dostawy OMS (Sellasist)" — kliknij „Dodaj nowe mapowanie" i przypisz symbol (SKU) usługi dostawy z Subiekta do metody dostawy w Sellaście.

8. Rozdziel płatnika i odbiorcę (Sellasist)

   Opcja „Rozdziel płatnika i odbiorcę" (domyślnie wyłączona; dotyczy Sellasist) decyduje, skąd biorą się dane do faktury i adres dostawy w sklepie:

   • wyłączona — i dane do faktury, i adres dostawy pobierane są z odbiorcy;
   • włączona — dane płatnika (nazwa, adres, NIP) trafiają do danych do faktury, a dane odbiorcy do adresu dostawy.

   Reguły przy włączonej opcji: gdy na ZK odbiorca jest inny niż płatnik → faktura = płatnik, dostawa = odbiorca; gdy jest sam płatnik mający w karcie adres dostawy → faktura = płatnik, dostawa = jego adres dostawy; gdy jest sam płatnik bez adresu dostawy → faktura i dostawa otrzymują te same dane płatnika.