Który dokument powstanie w Subiekcie — decyduje prefiks serii w OMS

Faktura, paragon imienny, WZ, korekta czy dokument z oznaczeniem WDT — o tym, co powstanie w Subiekcie, decyduje początek numeru dokumentu wystawionego w OMS. Tu znajdziesz pełną listę prefiksów i znaczników.

1. Zasada w jednym zdaniu

   Integrator nie zgaduje, jaki dokument ma powstać. Gdy w OMS zostaje wystawiony dokument, integrator czyta jego pełny numer i sprawdza, od czego się zaczyna. Ten początek — czyli prefiks serii, który sam ustawiasz w OMS — jednoznacznie wskazuje rodzaj dokumentu w Subiekcie.

   Status zamówienia w OMS decyduje wyłącznie o tym, kiedy dokument ma zostać wystawiony. Nie decyduje o tym, jaki to będzie dokument.

   Praktycznie oznacza to, że jedną instalacją integratora obsłużysz np. faktury dla firm, paragony imienne dla klientów detalicznych i WZ dla hurtu — wystarczy, że w OMS założysz trzy serie faktur o różnych prefiksach.

2. Prefiks numeru w OMS → dokument w Subiekcie

   Lista jest sprawdzana od góry do dołu — wygrywa pierwszy pasujący prefiks. Wielkość liter nie ma znaczenia.

   • SKUTEK → nie powstaje nowy dokument. Integrator odnajduje dokument wystawiony wcześniej dla tego zamówienia i przywraca mu skutek magazynowy (czyli faktyczne zdjęcie towaru ze stanu). Używasz tego, gdy dokument wystawiono wcześniej z odłożonym lub wycofanym skutkiem.
   • ZZK → realizacja istniejącego zamówienia klienta (ZK). Dokument końcowy powstaje na podstawie konkretnego ZK w Subiekcie — ZZKPAi daje paragon imienny, każdy inny wariant (ZZK, ZZKFS, …) daje fakturę sprzedaży. Wymaga wskazania pola dodatkowego OMS z identyfikatorem ZK w sekcji Wysyłka ZK do OMS — bez tego wystawianie kończy się błędem.
   • RW → rozchód wewnętrzny (dokument magazynowy, bez kontrahenta).
   • FSZalKon → faktura zaliczkowa końcowa. Powstaje na podstawie wcześniejszego zamówienia zaliczkowego. Jeśli tego zamówienia już nie ma w Subiekcie, integrator zgłosi błąd.
   • FSZalCz → faktura zaliczkowa częściowa (integrator zakłada zamówienie zaliczkowe i wystawia do niego zaliczkę).
   • FM → faktura marża.
   • PAi → paragon imienny.
   • PAiFSd → paragon imienny, a do niego faktura detaliczna (FSd). Do OMS trafia numer i PDF faktury detalicznej.
   • PA ze spacją (czyli PA ) → paragon imienny. Uwaga: nie zwykły paragon.
   • WZ → wydanie zewnętrzne.
   • VWZ → WZ wartościowa (wydanie zewnętrzne z cenami i VAT).
   • WDT → faktura sprzedaży oznaczona jako wewnątrzwspólnotowa dostawa towarów. Wymaga pełnej wersji.
   • OOU → faktura sprzedaży z rodzajem transakcji dla sprzedaży poza terytorium kraju (odwrotne obciążenie po stronie nabywcy). Wymaga pełnej wersji.
   • WSTOSK → faktura sprzedaży oznaczona jako WSTO-SK. Wymaga pełnej wersji.
   • EX → faktura sprzedaży oznaczona jako eksport towarów poza UE.
   • OSS → faktura sprzedaży w procedurze OSS. Wymaga pełnej wersji.
   • dowolny inny początek numeru → faktura sprzedaży (FS) — a jeśli na zamówieniu nie ma NIP, decyduje ustawienie Co zrobić przy braku NIP na zamówieniu (patrz następny krok).

3. Gdy żaden prefiks nie pasuje — decyduje NIP

   To najczęstsza ścieżka, bo tak zachowuje się każda zwykła seria faktur. Są trzy możliwe wyniki:

   • NIP jest i jest poprawny → powstaje faktura sprzedaży. Jeśli włączyłeś Fiskalizuj faktury krajowe z NIP, faktura zostanie dodatkowo skierowana na drukarkę fiskalną.
   • NIP jest, ale jest nieprawidłowy, a klient jest polski → wystawienie kończy się błędem. Ustawienie Co zrobić przy braku NIP na zamówieniu w tej sytuacji nie działa — ono dotyczy wyłącznie zamówień całkowicie bez NIP.
   • NIP-u nie ma → decyduje ustawienie Co zrobić przy braku NIP na zamówieniu (faktura, faktura z fiskalizacją, paragon + faktura detaliczna albo błąd).

4. Znaczniki, które możesz dopisać do numeru

   Poza prefiksem w numerze serii możesz umieścić znaczniki sterujące. Działają niezależnie od rodzaju dokumentu.

   • BEZSKUT — dokument powstaje bez skutku magazynowego, czyli nie zdejmuje towaru ze stanu. Znacznik może stać w dowolnym miejscu numeru.
   • {P:0} — dokument nie zostanie wydrukowany. {P:2} — zostaną wydrukowane 2 kopie na domyślnej drukarce. Ogólnie {P:n} = liczba kopii wydruku.
   • /EU\ — tekst pomiędzy ukośnikiem a odwrotnym ukośnikiem trafia do rozszerzenia numeru w Subiekcie (przykład: numer serii OSS/EU\ da w Subiekcie FS 1/EU/2026).
   • SUBT — przy sprawdzaniu, czy dokument dla tego zamówienia już istnieje, integrator przestaje ograniczać wyszukiwanie do własnego operatora. Dzięki temu rozpozna dokument wystawiony w Subiekcie przez kogoś innego i nie wystawi duplikatu. Ten znacznik jest wrażliwy na wielkość liter — musi być zapisany dużymi literami.
   • [SYMBOL] — dokument zostanie wystawiony na kontrahenta o podanym symbolu z Subiekta (przykład: FS[HURT01]). Jeśli takiego kontrahenta nie ma, wystawianie kończy się błędem.

5. Pułapka: porównywany jest POCZĄTEK numeru

   Integrator sprawdza, czy numer zaczyna się od danego prefiksu — nie czy jest mu równy. Seria nazwana przypadkiem tak, że zaczyna się od zarezerwowanych liter, zostanie potraktowana jako inny rodzaj dokumentu, bez żadnego ostrzeżenia.

   • Seria WZORCOWA zaczyna się od WZ → w Subiekcie powstanie wydanie zewnętrzne, a nie faktura.
   • Seria EXPRESS zaczyna się od EX → powstanie faktura z oznaczeniem eksportu.
   • Seria FMOJA zaczyna się od FM → powstanie faktura marża.

   Zanim założysz nową serię w OMS, sprawdź na liście powyżej, czy jej nazwa nie zaczyna się od jednego z zarezerwowanych prefiksów.

   Znaczniki BEZSKUT i SUBT działają inaczej — wystarczy, że pojawią się gdziekolwiek w numerze. Nie używaj ich jako fragmentu zwykłej nazwy serii.

6. W OMS twórz zawsze serie FAKTUR — nigdy serie paragonów

   To najważniejsza zasada tej całej mechaniki. Prefiksy z listy powyżej działają wyłącznie dla serii faktur.

   Jeśli w OMS założysz serię paragonów, integrator w ogóle nie będzie sprawdzał prefiksu — w Subiekcie powstanie zwykły, nie-imienny paragon, a Twój prefiks zostanie po cichu zignorowany.

   Dlatego także wtedy, gdy chcesz otrzymywać paragony imienne, w OMS zakładasz serię faktur i nadajesz jej prefiks PAi.

7. Sprawdź również

   • Wystawianie faktury sprzedaży — jak włączyć moduł i co ustawić dla zwykłej faktury.
   • Paragony imienne i faktura do paragonu — szczegóły serii PAi i PAiFSd.
   • Wydania zewnętrzne (WZ) i WZ wartościowa — ustawienia specyficzne dla serii WZ i VWZ.
   • Dokument nie chce się wystawić — co robić, gdy zamówienie zatrzymuje się na błędzie.