Jak działa AB Connect — zanim zaczniesz konfigurację

Najważniejsze zasady działania integratora, które warto zrozumieć przed konfiguracją. Dotyczy obu wariantów — Subiekt NEXO i Subiekt GT.

1. AB Connect reaguje na zdarzenia, nie na bieżący status

   AB Connect różni się od typowych łączników sklep–Subiekt. Większość podobnych narzędzi co jakiś czas pyta sklep „które zamówienia są teraz w statusie X?" i przetwarza je według bieżącego stanu. AB Connect działa inaczej — opiera się na strumieniu zdarzeń.

   Zamiast pytać o aktualny status, integrator nasłuchuje kolejki zdarzeń ze sklepu (zmiana statusu, nowe zamówienie, dodanie przesyłki) i reaguje na nie na bieżąco. Dzięki temu każde zdarzenie jest obsłużone dokładnie raz, w odpowiedniej kolejności — bez ryzyka pominięcia ani podwójnego przetworzenia.

2. Przykłady działania na żywo i po przerwie

   • Normalna praca: zamówienie trafia do statusu „Zapłacone" o 10:00. AB Connect odbiera zdarzenie i natychmiast tworzy ZK oraz wystawia fakturę w Subiekcie.
   • Przerwa w działaniu: integrator zostaje wyłączony w piątek o 17:00. W weekend wpływa 40 zamówień. Po uruchomieniu w poniedziałek AB Connect nie patrzy na aktualny status — odczytuje wszystkie zdarzenia z kolejki, które zaszły podczas jego nieobecności, i przetwarza je po kolei, tak jakby działy się na żywo.
   • Zamówienie zmienione po przerwie: zamówienie zmieniło status w sobotę, a w niedzielę klient je anulował. Po uruchomieniu integrator przetworzy oba zdarzenia w kolejności — najpierw utworzy ZK, potem je usunie. Efekt końcowy będzie poprawny.

   ⚠️ Ważne: jeśli integrator był wyłączony przez dłuższy czas, po uruchomieniu może przez chwilę intensywnie nadrabiać zaległe zdarzenia. To zachowanie prawidłowe — nie przerywaj pracy programu podczas „nadrabiania zaległości".

3. Jak AB Connect decyduje, jaki dokument wystawić

   Statusy w sklepie nie wybierają typu dokumentu. O tym, czy powstanie faktura, paragon, WZ, WDT czy OSS, decydują dwie rzeczy:

   1. Co utworzysz w sklepie — jeśli w Sellasist wystawisz fakturę, AB Connect wystawi fakturę w Subiekcie; jeśli paragon zwykły — powstanie paragon. Integrator reaguje na zdarzenie ze sklepu, nie na sam status.
   2. Prefiks w numerze dokumentu sklepu (czyli nazwa serii faktur) — jeśli prefiks pasuje do jednej z rozpoznawanych nazw, AB Connect utworzy w Subiekcie odpowiedni typ dokumentu. Brak pasującego prefiksu = faktura sprzedaży (FS) lub zachowanie z ustawienia „Co zrobić przy braku NIP".

4. Tabela prefiksów (rozpoznawanie typu dokumentu)

   Prefiks sprawdzany jest od początku numeru, bez rozróżniania wielkości liter. Część prefiksów dotyczy tylko Subiekta GT:

   • PAi — paragon imienny (NEXO i GT)
   • WZ — WZ bez VAT (NEXO i GT)
   • VWZ — WZ z VAT (tylko Subiekt GT)
   • WDT — faktura sprzedaży z oznaczeniem WDT (wewnątrzwspólnotowa dostawa towarów); wymaga pełnej licencji
   • OOU — faktura sprzedaży, odwrotne obciążenie usługi; wymaga pełnej licencji (tylko Subiekt GT)
   • WSTOSK — faktura sprzedaży z oznaczeniem WSTO-SK; wymaga pełnej licencji (tylko Subiekt GT)
   • EX — faktura sprzedaży, eksport poza UE (NEXO i GT)
   • OSS — faktura sprzedaży OSS; wymaga pełnej licencji, stawki VAT wg ustawień (NEXO i GT)
   • FM — faktura marża (tylko Subiekt GT)
   • FSZalCz — zaliczka częściowa (tylko Subiekt GT)
   • PAiFSd — paragon imienny + faktura sprzedaży detaliczna do paragonu (NEXO i GT)
   • brak prefiksu z listy — FS, jeśli klient ma poprawny NIP; w przeciwnym razie zachowanie z ustawienia „Co zrobić przy braku NIP" (błąd / FS / FS+fiskalizacja / FSd+paragon). To wariant domyślny i najczęściej używany.

5. Rozszerzenie numeru i markery w numerze dokumentu

   Rozszerzenie numeru — fragment otoczony znakami / i \ w prefiksie serii. AB Connect przekaże go jako rozszerzenie numeru dokumentu w Subiekcie:

   • OSS/ADE\ → faktura OSS z rozszerzeniem ADE: FS 1/ADE/2024
   • FS/EU\ → faktura sprzedaży z rozszerzeniem EU

   Pozwala to oddzielić numerację dokumentów po typie lub rynku, zachowując ten sam typ dokumentu.

   Markery w numerze (gdziekolwiek, tylko Subiekt GT):

   • BEZSKUT — dokument nie powoduje ruchów magazynowych. Działa tylko dla faktur i paragonów imiennych.
   • SUBT — AB Connect pomija sprawdzanie operatora przy szukaniu istniejącego dokumentu. Pozwala wgrać dokument, który w podtytule ma numer zamówienia ze sklepu, ale został wystawiony ręcznie przez innego użytkownika niż skonfigurowany w integratorze.

   💡 Liczba kopii do wydruku (tylko Subiekt GT): można ją zaszyć w prefiksie — FA{P:3} wymusza 3 kopie, FA{P:0} nie drukuje kopii. Można łączyć z rozszerzeniem: OSS{P:0}/DE\.

6. Przykładowy scenariusz (Sellasist)

   Chcesz, żeby zamówienia w statusie D wystawiały paragon, w statusie E fakturę VAT, a w statusie F dokument WZ:

   1. Tworzysz w Sellasist trzy serie dokumentów z prefiksami PAi (paragon), FS (faktura) i WZ.
   2. Akcje automatyczne w Sellasist na zmianę statusu wystawiają odpowiedni dokument z właściwą serią.
   3. AB Connect odbiera zdarzenie utworzenia dokumentu, czyta prefiks numeru i wystawia w Subiekcie odpowiednio: paragon imienny, fakturę lub WZ.

   Dzięki temu o typie dokumentu decydujesz na poziomie Sellasist (wybór serii w akcji), a AB Connect tylko replikuje to do Subiekta.