Integracja z KSeF - wprowadzenie
Integrator WfSync wysyła faktury sprzedaży z WAPRO Mag bezpośrednio do Krajowego Systemu e-Faktur (KSeF). Nie potrzebujesz do tego zewnętrznego pośrednika, np. Businesslink.
Zakres działania:
- WfSync wysyła wyłącznie dokumenty sprzedaży powiązane z zamówieniami zaimportowanymi przez integrator.
- Dokumenty wystawione w WAPRO Mag ręcznie, bez zamówienia z platformy e-commerce, nie pojawią się na liście KSeF w WfSync. Takie dokumenty wysyłasz bezpośrednio z WAPRO Mag.
- Wysyłkę możesz uruchamiać ręcznie (przyciskiem) lub automatycznie (zadaniem w harmonogramie).
Wymagania i konfiguracja
Przed pierwszą wysyłką wykonaj trzy kroki:
- Zaktualizuj WfSync do wersji 2.4.7.0 beta lub nowszej.
- Skonfiguruj certyfikat lub token dostępowy KSeF.
- Włącz integrację: Program > Konfiguracja (F9) > KSeF > Włącz integrację z KSeF (beta). Po zapisaniu w panelu głównym, obok zakładki Zamówienia, pojawi się zakładka KSeF.
Środowisko produkcyjne i testowe
| Środowisko | Do czego służy | Skutki prawne | Co ustawić |
|---|---|---|---|
| Produkcyjne | Docelowa, rzeczywista wysyłka do systemu Ministerstwa Finansów | Tak – dokument jest fakturą w obrocie prawnym | Certyfikat lub token produkcyjny |
| Testowe | Nauka i sprawdzenie konfiguracji | Nie | Pole NIP (testowy) zgodne z tokenem lub certyfikatem testowym |
Dane podmiotów w środowisku testowym są anonimizowane, więc w podglądzie KSeF nie zobaczysz prawdziwych nazw kontrahentów.
Sekcja KSeF - omówienie okna
Zakładka KSeF pokazuje faktury utworzone na podstawie zamówień zaimportowanych przez integrator, które można wysłać do KSeF.

Okno dzieli się na cztery obszary.
| Obszar | Położenie | Zawartość |
|---|---|---|
| Pasek narzędzi | Góra okna | Po lewej akcje: Odśwież listę, Eksportuj do KSeF (n). Po prawej filtry: Pokaż tylko nowe / Pokaż wszystkie, Dokumenty (+n parametrów), pole Filtruj. |
| Lista dokumentów | Środek | Faktury z polem wyboru w pierwszej kolumnie i kolumnami opisanymi niżej. |
| Informacje o zamówieniu | Dół, lewa strona | Dane zamówienia podświetlonego na liście: numer (link), data utworzenia, powiązane dokumenty, płatnik i odbiorca, pozycje. |
| Aktywność | Dół, prawa strona | Log operacji integratora, np. [KSeF] Sprawdzanie statusów dokumentów oczekujących na wynik z KSeF, z linkiem Szczegóły. |
Przyciski
| Element | Działanie |
|---|---|
| Odśwież listę | Pobiera aktualny stan dokumentów z WAPRO Mag i dodaje nowe faktury do listy. |
| Eksportuj do KSeF (n) | Wysyła do KSeF zaznaczone faktury. Liczba w nawiasie to liczba zaznaczonych dokumentów, więc przed kliknięciem widać, ile faktur zostanie wysłanych. |
Kolumny listy
| Kolumna | Co pokazuje |
|---|---|
| Pole wyboru | Zaznaczenie dokumentu do wysyłki ręcznej. |
| ID zamówienia | Numer zamówienia w platformie e-commerce. |
| Numer dokumentu sprzedaży | Numer faktury w WAPRO Mag, np. F/000135/26. |
| Data rejestracji w ERP | Data utworzenia dokumentu w WAPRO Mag. |
| Wartość brutto (PLN) | Wartość brutto faktury w WAPRO Mag. |
| Kontrahent | Kontrahent przypisany do faktury w WAPRO Mag. |
| Numer dokumentu KSeF | Przed wysyłką puste. Po poprawnej wysyłce zawiera numer nadany przez KSeF. Ten sam numer integrator zapisuje w polu Numer KSeF na fakturze w WAPRO Mag. |
| Czy pobrano UPO | Tak lub Nie. Przy wartości Tak UPO jest dostępne także z poziomu dokumentu w WAPRO Mag. |
| Wysłane przez integrator | Informuje, czy dokument wysłał WfSync. Wartość Nie przy uzupełnionym numerze KSeF oznacza zwykle, że dokument wysłano innym narzędziem, np. bezpośrednio z WAPRO Mag. |
| Status wysyłki | Etap wysyłki – opis statusów poniżej. |
| Szczegóły | Ikona (i). Po kliknięciu pokazuje dodatkowe informacje zwrócone przez KSeF, np. treść błędu przy odrzuceniu. |
Statusy wysyłki
| Status | Znaczenie | Co zrobić |
|---|---|---|
| Do wysłania | Dokument czeka na wysyłkę. | Wyślij ręcznie lub poczekaj na harmonogram. |
| Wysłano | KSeF przyjął dokument i nadał numer KSeF. | Sprawdź tylko, czy pobrano UPO. |
| Odrzucono | KSeF nie przyjął dokumentu. | Kliknij ikonę (i) w kolumnie Szczegóły, popraw dokument w WAPRO Mag i wyślij ponownie. |
| Pomiń | Dokument został ręcznie wyłączony z wysyłki. | Ustawiasz go prawym przyciskiem myszy (PPM) na dokumencie > Pomiń. Integrator nie będzie go wysyłał. |
KSeF przetwarza dokumenty asynchronicznie. Jeśli dokument czeka na wynik, integrator sprawdza jego status w kolejnym przebiegu i dopiero wtedy uzupełnia numer KSeF i UPO. Przebieg tej operacji widać w panelu Aktywność.
Filtrowanie dokumentów
Ustaw filtry przed pierwszą wysyłką. Zapisany filtr domyślny decyduje, które dokumenty widać na liście i które zostaną wysłane. Bez niego wysyłka może objąć wszystkie faktury powiązane z zamówieniami.
Lista zawiera wyłącznie dokumenty powiązane z zamówieniami zaimportowanymi przez integrator. Opcje filtrowania są po prawej stronie paska narzędzi.

Pokaż tylko nowe / Pokaż wszystkie - przełącza widok między dokumentami do wysłania a wszystkimi dokumentami, łącznie z wysłanymi.
Dokumenty (+ n parametrów) - otwiera okno Filtry dla tabeli KSeF. Liczba w nawiasie to liczba aktywnych parametrów.
Filtruj - szybkie wyszukiwanie na liście, np. po ID zamówienia, by sprawdzić, czy dokument trafił do KSeF.
Okno „Filtry dla tabeli KSeF”
W oknie ustawisz magazyny, zakres dat, maksymalną liczbę dokumentów, typy dokumentów (FV, FUE, FW, FM) oraz opcję uwzględniania tylko dokumentów oznaczonych „do księgowania”.

Jak łączą się warunki
- Warunki w jednej sekcji łączy operator LUB, np. magazyn 6 lub magazyn 9, typ FV lub FUE.
- Warunki między sekcjami łączy operator I.
Przykład ze zrzutu: zaznaczone magazyny 6 – Magazyn Poznań i 9 – allegro, Z ostatnich 30 dni, Max. 100 dokumentów, typ FV oraz tylko oznaczone do księgowania. Integrator pokaże maksymalnie 100 faktur FV z magazynu 6 lub 9, i wystawionych w ciągu ostatnich 30 dni, i oznaczonych do księgowania.
Po skonfigurowaniu filtrowania zaznacz pole Zapisz jako domyślny filtr i zatwierdź klikając OK. Od tej chwili filtr działa automatycznie przy każdym otwarciu zakładki i w wysyłce z harmonogramu.
Wysyłka faktur do KSeF - tryb ręczny
Zacznij od trybu ręcznego. Wyślij kilka pojedynczych dokumentów i sprawdź wynik, zanim włączysz harmonogram.

- Otwórz zakładkę KSeF i kliknij Odśwież listę.
- Zaznacz faktury w polu wyboru w pierwszej kolumnie (na zrzucie: 1). Przy pierwszych testach wybierz jedną.
- Sprawdź, czy faktury są gotowe do wysyłki (na zrzucie: 2):
- Numer dokumentu KSeF jest pusty,
- Czy pobrano UPO = Nie,
- Wysłane przez integrator = Nie,
- Status wysyłki = Do wysłania.
- Kliknij Eksportuj do KSeF (n) (na zrzucie: 3).
- Śledź przebieg w panelu Aktywność. Po zakończeniu sprawdź na liście:
- Status wysyłki = Wysłano,
- Numer dokumentu KSeF jest uzupełniony,
- Wysłane przez integrator = Tak.
- Po chwili kliknij Odśwież listę i sprawdź, czy Czy pobrano UPO = Tak.
- W WAPRO Mag otwórz fakturę i potwierdź, że pole Numer KSeF jest uzupełnione, a UPO jest dostępne.
Gdy KSeF odrzuci dokument kliknij ikonę (i) i odczytaj przyczynę w kolumnie Szczegóły i odczytaj przyczynę. Popraw dokument w WAPRO Mag, kliknij Odśwież listę i wyślij go ponownie.
Jeśli dokument nie powinien trafić do KSeF przez WfSync (np. wyślesz go inaczej), kliknij go prawym przyciskiem myszy i wybierz Pomiń.
Wysyłka faktur do KSeF - tryb automatyczny
Po przetestowaniu wysyłki faktur do KSeF w trybie ręcznym można dodać zadanie automatyczne zadanie do harmonogramu.
Nazwa akcji: KSeF

Po dodaniu zadania należy zrestartować usługę WfSyncServive:
Zatrzymaj > Uruchom
Usługa wczyta zaktualizowane ustawienia i uruchomi wysyłkę faktur zgodnie z harmonogramem. Wysyłane są dokumenty zgodne z zapisanym filtrem domyślnym.