Skip to content

Integracja z KSeF

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.

Bez dodatkowych opłat. Integracja z KSeF jest dodatkiem do WfSync, dostępnym bezpłatnie dla wszystkich aktywnych abonamentów.
Wersja beta. Integracja z KSeF jest dostępna od wersji 2.4.7.0 beta integratora WfSync. Funkcja jest w fazie testów, dlatego na bieżąco sprawdzaj, czy przesłane dane są poprawne i zgodne ze stanem faktycznym

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:

  1. Zaktualizuj WfSync do wersji 2.4.7.0 beta lub nowszej.
  2. Skonfiguruj certyfikat lub token dostępowy KSeF.
  3. 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
Uwaga – produkcja. Dokumentów wysłanych do KSeF produkcyjnego nie da się wycofać. Można je wyłącznie skorygować fakturą korygującą.
Uwaga – test. Po wysyłce do środowiska testowego numer KSeF zapisuje się na dokumencie w bazie WAPRO Mag. Takiego dokumentu nie wyślesz już później na produkcję. Do testów używaj dokumentów próbnych (szkiców) albo osobnej bazy testowej.

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.

  1. Otwórz zakładkę KSeF i kliknij Odśwież listę.
  2. Zaznacz faktury w polu wyboru w pierwszej kolumnie (na zrzucie: 1). Przy pierwszych testach wybierz jedną.
  3. 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.
  4. Kliknij Eksportuj do KSeF (n) (na zrzucie: 3).
  5. Ś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.
  6. Po chwili kliknij Odśwież listę i sprawdź, czy Czy pobrano UPO = Tak.
  7. 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.

Limity KSeF. KSeF ogranicza liczbę zapytań do API. Częste przekraczanie limitów może zablokować dostęp. Dlatego akcja KSeF w harmonogramie nie powinna uruchamiać się częściej niż raz na godzinę.