Przejdź do treści
ABHelp ABHelpCentrum pomocy Historia zmianPanel

Jak działa AB Connect NEXO — zanim zaczniesz konfigurację

Najważniejsze zasady działania integratora Subiekt NEXO ↔ Sellasist, które warto zrozumieć przed konfiguracją.

Ostatnia aktualizacja: 7 sierpnia 2026

  1. Co robi AB Connect NEXO

    AB Connect NEXO łączy Twój sklep (Sellasist lub Baselinker) z Subiektem NEXO i pracuje w tle przez cały dzień:

    • Zamówienia ze sklepu trafiają do Subiekta jako Zamówienia od klienta (ZK) — razem z danymi kupującego, pozycjami, rabatami, kosztem wysyłki i płatnością.
    • Faktury, paragony i WZ — gdy w sklepie wystawisz dokument, AB Connect tworzy jego odpowiednik w Subiekcie, a wygenerowany PDF odsyła do zamówienia w sklepie.
    • Stany magazynowe i ceny z Subiekta są automatycznie wysyłane do sklepu.
    • Statusy zamówień w sklepie zmieniają się same — po utworzeniu ZK, po wystawieniu dokumentu albo po błędzie (wtedy trafiają do wskazanego przez Ciebie statusu z opisem problemu).
    • Korekty i zwroty wystawione w Sellasist tworzą w Subiekcie faktury korygujące lub zwroty do paragonów.
    • KSeF — faktury mogą powstawać w Subiekcie jako e-Faktury, a numer KSeF wraca do zamówienia w sklepie.
    • Kierunek odwrotny (Beta) — zamówienie wpisane ręcznie w Subiekcie możesz jedną flagą wysłać do sklepu.

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

    Integrator nasłuchuje kolejki zdarzeń ze sklepu (zmiana statusu, wystawienie dokumentu, anulowanie zamówienia) i przetwarza je po kolei. Dzięki temu każde zdarzenie jest obsłużone dokładnie raz i we właściwej kolejności.

    Praktyczna konsekwencja: jeśli program był przez jakiś czas wyłączony (np. przez weekend), po uruchomieniu nadrobi wszystkie zaległe zdarzenia — utworzy ZK i dokumenty tak, jakby działał na żywo. Podczas nadrabiania nie wyłączaj programu.

  3. O typie dokumentu decyduje seria FAKTUR w sklepie

    To najważniejsza zasada całej integracji. AB Connect czyta prefiks numeru dokumentu wystawionego w Sellasist (czyli nazwę serii faktur) i na tej podstawie tworzy właściwy dokument w Subiekcie:

    • FS lub FV — faktura sprzedaży
    • PA — paragon
    • PAi — paragon imienny
    • PAiFSd lub FD — paragon imienny + faktura detaliczna do paragonu
    • WZ — wydanie zewnętrzne (WZ)
    • OSS — faktura sprzedaży zagranicznej OSS (stawki VAT kraju kupującego)
    • WDT — faktura wewnątrzwspólnotowa (firma z UE z numerem VAT)
    • EX — faktura eksportowa (stawka 0%)
    • inny / nieznany prefiks — powstanie faktura sprzedaży (FS); gdy klient nie ma poprawnego NIP, zadziała ustawienie „Brak NIP na fakturze"

    Seria może mieć własny dopisek — np. seria FVhurt zostanie rozpoznana jako faktura (FV), a PAIfirma2 jako paragon imienny (PAi).

    ⚠️ Ważne: w panelu Sellasist twórz zawsze serie FAKTUR, nigdy serie paragonów. To prefiks serii faktur decyduje o typie dokumentu — seria paragonów, niezależnie od prefiksu, wystawi zwykły (nie-imienny) paragon.

  4. Rozszerzenie numeracji dokumentów

    Jeśli chcesz, aby dokumenty w Subiekcie miały rozszerzoną numerację (np. FS 1/MAG2/03/2026), masz trzy możliwości — od najwyższego priorytetu:

    1. Kod kraju z faktury — po włączeniu opcji „Wstaw kod kraju jako rozszerzenie numeracji" dokumenty dla zagranicy dostaną rozszerzenie DE, CZ itd.
    2. Pole dodatkowe zamówienia — wartość wpisana w wybrane pole dodatkowe w Sellasist (maksymalnie 3 znaki).
    3. Dopisek w prefiksie serii — fragment między / i \ w nazwie serii, np. seria FS/MAG2\ utworzy dokumenty FS …/MAG2/….

  5. Co wraca do sklepu po wystawieniu dokumentu

    Po utworzeniu dokumentu w Subiekcie AB Connect może (zależnie od konfiguracji):

    • wpisać numer dokumentu i numer ZK w pola dodatkowe zamówienia,
    • wgrać PDF dokumentu do zamówienia w sklepie,
    • przenieść zamówienie do statusu sukcesu (np. „Wysłane"),
    • a przy problemie — do statusu błędu, z opisem przyczyny w polu dodatkowym „Komunikat błędu".

    Jeżeli dokument dla danego zamówienia już istnieje w Subiekcie (np. w sklepie usunięto fakturę i wystawiono ją ponownie), program nie tworzy duplikatu — ponownie wgrywa PDF istniejącego dokumentu.

  6. Co przygotować przed konfiguracją

    Zanim przejdziesz do kreatora wdrożenia, przygotuj:

    • klucz licencyjny AB Connect otrzymany od AppsBusters,
    • dostęp do serwera bazy danych Subiekta NEXO (adres serwera i nazwę bazy firmy),
    • login użytkownika Subiekta (np. Szef) i jego hasło,
    • token API z panelu Sellasist oraz adres Twojego panelu,
    • w Subiekcie: zdefiniowane formy płatności, sposób dostawy „Kurier", a przy sprzedaży zagranicznej — kraje i ich stawki VAT (w tym stawki VAT dla państw na kartotekach towarów sprzedawanych w OSS),
    • w Sellasist: serie faktur z odpowiednimi prefiksami oraz statusy, którymi chcesz sterować integracją (np. „Do realizacji", „Wysłane", „Błąd").
Czy ten artykuł był pomocny?