Kreator wdrożenia — szybka konfiguracja krok po kroku

Osiem ekranów, które ustawiają podstawy nowego wdrożenia: licencja, Subiekt, OMS, zamówienia, stany, dokumenty, paragony i start. Zamiast przeklikiwania całego konfiguratora.

1. Otwórz kreator

   Kreator znajdziesz w menu po lewej stronie panelu — pozycja Kreator wdrożenia.

   Przy zupełnie świeżej instalacji program sam zapyta: Skorzystać z uproszczonego kreatora? — odpowiedz Tak, uruchom kreator. Jeśli wolisz ustawić wszystko ręcznie, wybierz Nie, pełny konfigurator.

   Kreator jest oznaczony jako BETA. U góry widać pasek z ośmioma krokami: Licencja, Subiekt, Sellasist, Zamówienia, Stany, Dokumenty, Paragony, Koniec. Możesz się po nich cofać, klikając w numer kroku.

2. Kreator jest do NOWEGO wdrożenia

   Kreator ustawia zestaw wartości zalecanych dla nowej instalacji — ich listę pokazuje na ostatnim kroku. Jeśli przejdziesz nim przez już działającą konfigurację i klikniesz Zakończ i zapisz, te ustawienia zostaną zapisane tak, jak proponuje kreator, nawet jeśli wcześniej miałeś je inaczej.

   Na działającym wdrożeniu zmiany rób w pełnym konfiguratorze. Z pierwszego kroku kreatora wychodzisz do niego przyciskiem Powróć do pełnego konfiguratora.

3. Krok 1 z 8 — Licencja (i najważniejsze ostrzeżenie)

   Na tym ekranie jest ostrzeżenie, które decyduje o poprawności całego wdrożenia:

   W OMS twórz zawsze serie FAKTUR, nigdy serie paragonów. To prefiks serii faktur decyduje, jaki dokument powstanie w Subiekcie — np. PAi daje paragon imienny, a FS fakturę sprzedaży. Seria paragonów — niezależnie od tego, jaki nadasz jej prefiks — wystawi w Subiekcie zwykły, nie-imienny paragon, a prefiks zostanie zignorowany.

   Wpisz Klucz licencyjny i kliknij Sprawdź licencję. Po pozytywnej weryfikacji kreator sam przechodzi do kolejnego kroku.

   

   Pierwszy krok kreatora. Nad polem klucza — ostrzeżenie o seriach faktur, które decyduje, jakie dokumenty powstaną w Subiekcie.

4. Krok 2 z 8 — Subiekt

   Uzupełnij: Serwer SQL (dla instalacji lokalnej zwykle .\INSERTGT), Autentykacja Windows albo Użytkownik SQL i Hasło SQL, Baza danych (podmiot) — przycisk Wczytaj z serwera pobiera listę baz — oraz Operator (przycisk Wczytaj) i Hasło operatora.

   Zalecamy osobnego operatora dedykowanego integracji, np. SYSTEM. Przed testem aktywuj Sferę w Subiekcie GT.

   Na dole są cztery przyciski: Test SQL, Test Sfery, Zresetuj Subiekta i Odśwież dane. Przycisk Dalej odblokuje się dopiero po udanym Teście Sfery — udany test pokazuje NIP podmiotu i od razu pobiera z Subiekta magazyny, drukarki i pozostałe listy potrzebne w kolejnych krokach.

5. Krok 3 z 8 — połączenie z OMS

   Podaj Adres panelu Sellasist (np. https://twojsklep.sellasist.pl) oraz Token API i kliknij Sprawdź token.

   Po udanym połączeniu kreator napisze, ile statusów pobrał — z tej listy będziesz wybierał statusy w kolejnych krokach. Bez zielonego wyniku przycisk Dalej pozostaje nieaktywny.

6. Krok 4 z 8 — Zamówienia (ZK) i statusy

   Tu ustalasz, na jakich statusach z OMS program tworzy i usuwa zamówienia w Subiekcie:

   • Status tworzenia i aktualizacji ZK — wymagany.
   • Status usuwania ZK (opcjonalnie) i Status po usunięciu ZK.
   • Status błędu (gdy nie da się utworzyć ZK) — wymagany; tu trafi zamówienie, gdy np. brakuje produktu.
   • Zmień status w OMS, gdy brak towaru na stanie — po włączeniu wskazujesz status.
   • Zmień status po poprawnym utworzeniu / aktualizacji ZK — po włączeniu wskazujesz status.
   • Pole dodatkowe na treść błędu dokumentu (opcjonalnie) — do tego pola w OMS trafi powód niepowodzenia.

   Pułapka: status usuwania i status po usunięciu nie mogą być takie same — zamówienie wpadłoby w nieskończoną pętlę (usuń, ustaw status, usuń...). Kreator zablokuje przejście dalej i wypisze ostrzeżenie.

   Do każdej listy statusów jest filtr — wpisz fragment nazwy albo numer, żeby nie przewijać całej listy.

7. Krok 5 z 8 — Produkty i stany magazynowe

   Najpierw Wiązanie produktów — wybierz jedną z dwóch kafelków:

   • Po SKU — dopasowanie po symbolu towaru (zalecane),
   • Po EAN — dopasowanie po kodzie kreskowym.

   Wybór dotyczy jednocześnie dokumentów i stanów magazynowych.

   Przełącznik Włącz moduł aktualizacji stanów w OMS uruchamia przesyłanie stanów. Po włączeniu zaznacz magazyny Subiekta, z których liczyć stan — pomagają przyciski Zaznacz wszystkie i Pobierz magazyny. Trzeba zaznaczyć co najmniej jeden magazyn, inaczej kreator nie puści dalej.

8. Krok 6 z 8 — Dokumenty finansowe

   Ustaw:

   • Zmień status po poprawnym utworzeniu dokumentu finansowego — po włączeniu wskaż status.
   • Pole dodatkowe na fakturę z Subiekta (Sellasist) — pole typu Dokument sprzedaży, do którego trafi PDF faktury.
   • Status błędu dla pozostałych dokumentów (brak produktu) — gdy na fakturze lub paragonie brakuje produktu, dokument nie powstanie, a zamówienie trafi na ten status.
   • Domyślny magazyn w Subiekcie i Domyślne SKU dostawy.
   • Prefiks nazwy pozycji wysyłki — dla nowych wdrożeń kreator ustawia Koszt dostawy.

   Kliknięcie Dalej sprawdza komplet — jeśli czegoś brakuje, kreator napisze wprost, którego pola.

9. Krok 7 z 8 — Paragony i fiskalizacja

   Odpowiadasz na jedno pytanie: Czy wystawiasz paragony?

   • Tak, wystawiam paragony — zamówienie bez NIP dostanie paragon i fakturę uproszczoną (FSd).
   • Nie, tylko faktury — zamówienie bez NIP dostanie fakturę sprzedaży (FS).

   Przy odpowiedzi Tak dochodzi przełącznik Fiskalizuj paragony na drukarce fiskalnej, a po jego włączeniu — Domyślna drukarka fiskalna (listę pobierzesz przyciskiem Pobierz drukarki). Bez wskazania drukarki kreator nie przepuści dalej.

10. Krok 8 z 8 — Uruchomienie

    Ostatni ekran tłumaczy, jak program reaguje na zdarzenia z OMS i jak prefiks serii przekłada się na dokument w Subiekcie:

    • PAi — paragon imienny,
    • WZ — dokument WZ, VWZ — WZ z VAT,
    • OSS / WDT / EX — faktura z odpowiednim oznaczeniem,
    • brak pasującego prefiksu — faktura sprzedaży (FS).

    Tu jeszcze raz wraca ostrzeżenie z pierwszego kroku: seria paragonów w OMS zawsze da w Subiekcie zwykły, nie-imienny paragon, niezależnie od prefiksu. Serie twórz jako serie faktur.

    Przełącznik Włącz przetwarzanie dokumentów (moduł wystawiania) decyduje, czy program od razu zacznie wystawiać dokumenty. Po włączeniu przetwarzane są zdarzenia od momentu startu — zaległości sprzed włączenia są pomijane.

11. Sprawdź listę ustawień włączanych automatycznie

    Na tym samym ekranie kreator wypisuje Ustawienia włączone automatycznie dla tego wdrożenia:

    • Pomiń tworzenie ZK po zmianie statusu
    • Automatyczna korekta rabatu
    • Reset Sfery po fatalnym błędzie COM
    • Mapowanie płatności: przelew → przelew (domyślny)
    • Nie drukuj — tylko wgrywaj PDF
    • eFaktury dla wszystkich faktur z NIP
    • Rola odbiorcy = odbiorca
    • Przy eFakturze nie wgrywaj PDF do OMS
    • Sprawdzaj nadanie numeru KSeF
    • Po numerze KSeF wgraj PDF do Sellasist

    Przeczytaj tę listę zanim zapiszesz — to są realne zmiany w zachowaniu programu. Każdą z nich możesz później przestawić w pełnym konfiguratorze.

12. Zakończ i zapisz

    Kliknij Zakończ i zapisz. Kreator zapyta Zapisać konfigurację? — potwierdź przyciskiem Zapisz i uruchom ponownie. Program zapisze ustawienia i uruchomi się ponownie.

    Wyjście krzyżykiem w prawym górnym rogu kreatora kończy się pytaniem Wyjść z kreatora? — niezapisane zmiany przepadają.

    Po zapisie warto przejść przez pełny konfigurator i uzupełnić to, czego kreator nie obejmuje: mapowania serii i magazynów, pola dodatkowe, kontrahentów, KSeF.

13. Sprawdź również

    • Pierwsze uruchomienie AB Connect — od instalacji do pierwszego dokumentu — co dzieje się przed kreatorem i po nim.
    • Połączenie z Subiektem GT (Sfera) — szczegóły kroku 2 kreatora.
    • Tworzenie ZK po zmianie statusu — rozwinięcie kroku 4.
    • Bezpieczna zmiana ustawień — jak zmieniać konfigurację na działającym wdrożeniu.