O aplikacji
JPK MAG to struktura z danymi o ruchach magazynowych, którą firma przekazuje na żądanie organu podatkowego. Termin wskazuje wezwanie i nie jest krótszy niż 3 dni. Aplikacja JPK Magazyn tworzy dane do pliku z dokumentów ERPNext, więc nie trzeba ich składać ręcznie pod presją terminu.
Jeden plik obejmuje jeden magazyn. Wartości są w PLN, a dokumenty walutowe zostają przeliczone na złote. Plik zawiera tylko dokumenty zatwierdzone, więc robocze wersje w ERPNext nie trafiają do JPK.
Aplikacja działa na Frappe i ERPNext 16. Jest częścią lokalizacji ERPNextPL, obok integracji z KSeF i GUS.
Dwie wersje schematu
Wersja schematu zależy od okresu raportu, a nie od dnia generowania pliku. Aplikacja sama wybiera właściwą i pilnuje granicy między nimi.
| Okres raportu | Schemat | Najważniejsze różnice |
|---|---|---|
| do 31.12.2026 | JPK MAG(1) | Metoda ilościowo-wartościowa, dowody PZ, WZ, RW i MM. |
| od 01.01.2027 | JPK MAG(2) | Cztery metody ewidencji, dowody PW, MMWE, MMWY i INW, numery KSeF. |
Okres, który przecina 1 stycznia 2027, trzeba podzielić na dwa pliki.
Co można skonfigurować
Zasady, według których ERPNext zamienia ruchy magazynowe na dowody JPK, ustawia się w systemie. Domyślne wartości są instalowane razem z aplikacją.
Profile magazynów
Każdy magazyn ma własny profil i metodę ewidencji: ilościowo-wartościową, ilościową, wartościową albo odpisywanie w koszty w dniu zakupu (JPK MAG(2)).
Reguły klasyfikacji dokumentów
Przyjęcie zakupu to PZ, wydanie klientowi to WZ, ruchy wewnętrzne to PW, RW albo przesunięcia. Reguły można zmienić. Ruch bez dopasowanej reguły zatrzymuje raport z komunikatem, a nie znika po cichu.
Mapowanie pól opisowych
Dostawca, odbiorca, numer i data faktury oraz numer KSeF pobierane są z pól wskazanych przez Ciebie. Edytor wizualny, import i eksport JSON ułatwiają przeniesienie ustawień.
Dane firmy i urzędu
Dane siedziby JPK, słownik urzędów skarbowych i walidacja polskiego adresu. Błędy wychodzą przed wysyłką, nie po niej.
Role i uprawnienia
JPK Manager konfiguruje i przygotowuje raporty, JPK Viewer ma wgląd. Osoby bez roli nie zobaczą ustawień JPK.
Inwentaryzacja ze Stock Reconciliation
Zatwierdzony spis z natury trafia do sekcji INW w JPK MAG(2), także wtedy, gdy nie wykazał różnic. Spis bez różnic wymaga jawnej zgody przy zapisie.
Proces: od wezwania do UPO
Panel gotowości
Sprawdza profil magazynu, dane firmy, okres, wersję schematu i klasyfikację ruchów, zanim powstanie raport.
Raport JPK MAG
Dane z zatwierdzonych dokumentów magazynowych za wskazany okres i magazyn, zapisane jako XML w odpowiedniej wersji schematu.
Walidacja XSD
Plik jest sprawdzany ze schematem Ministerstwa Finansów. Błąd widać od razu, a nie po odrzuceniu przez bramkę.
Paczka i podpis
Kompresja, podział na części do 60 MB i szyfrowanie. Podpis metadanych zgodnie ze specyfikacją bramki jest w przygotowaniu w interfejsie.
Wysyłka i UPO W przygotowaniu
Planowane: przekazanie do bramki JPK Ministerstwa Finansów i odbiór urzędowego poświadczenia odbioru.
Łączność z bramką JPK Ministerstwa Finansów
Aplikacja przygotowuje przesyłkę tak, jak wymaga specyfikacja bramki JPK Ministerstwa Finansów. Przekazywanie przesyłki do bramki i odbiór UPO z poziomu ERPNext są w przygotowaniu, co oznaczamy przy poszczególnych funkcjach.
Szyfrowanie przesyłki
Części pliku są szyfrowane algorytmem AES-256, a klucz publicznym certyfikatem MF. Certyfikaty publiczne MF, testowy i produkcyjny, są częścią aplikacji.
Podpis kwalifikowany lub profil zaufany W przygotowaniu
Podpis XAdES z certyfikatu PKCS#12 albo ścieżka zewnętrzna: pobierasz plik metadanych, podpisujesz go profilem zaufanym na gov.pl i wgrywasz z powrotem.
Status i UPO W przygotowaniu
Planowane: stan wysyłki i poświadczenie odbioru widoczne w ERPNext oraz ostrzeżenie, jeśli UPO nie pojawi się w ciągu 24 godzin.
Klucze pod kontrolą
Plik certyfikatu leży w prywatnych plikach Frappe, hasło w polu Password. Użycie PKCS#12 na produkcji trzeba świadomie włączyć.
Dostępność
Aplikacja jest rozwijana etapami. Stan na październik 2026:
- Gotowe: konfiguracja profili, reguł i mapowań, panel gotowości, raporty z kontrolą okresu i wersji schematu, generowanie XML obu wersji, walidacja XSD, przygotowanie i szyfrowanie paczki.
- W przygotowaniu: generowanie raportów i wysyłka do bramki MF z poziomu interfejsu ERPNext.
Uwaga: bramka MF w obecnej specyfikacji wymienia JPK MAG(1). Obsługę JPK MAG(2) potwierdzimy przed 2027 rokiem na podstawie nowszej specyfikacji.
Cena i model licencji zostaną podane po zakończeniu prac. Napisz do nas, a damy znać o starcie i zaproponujemy wdrożenie w ramach lokalizacji PL.
Sprawdzi się jeśli
- prowadzisz ERPNext 16 z modułem magazynowym i księgi w formie elektronicznej
- chcesz być gotowy na wezwanie o JPK MAG, zanim przyjdzie
- masz kilka magazynów i potrzebujesz osobnego pliku dla każdego
- przygotowujesz się do JPK MAG(2) od 2027 roku i chcesz sprawdzić, czy ruchy magazynowe się klasyfikują
- zależy Ci na regułach, które można zmienić bez pisania kodu
Najczęstsze pytania
Czy JPK MAG składa się cyklicznie?
Nie. JPK MAG przekazuje się na żądanie organu podatkowego, w terminie wskazanym w wezwaniu, nie krótszym niż 3 dni.
Co zrobić, gdy firma ma kilka magazynów?
Dla każdego magazynu przygotowuje się osobny plik. W aplikacji każdy magazyn ma własny profil.
Jak poprawić błąd w przesłanym pliku?
Struktury JPK na żądanie nie podlegają korekcie. Błąd poprawia się przez uzgodnienie z organem i przekazanie nowego pliku. W aplikacji raport anuluje się i poprawia, a poprzedni zostaje w historii.
Kto może podpisać przesyłkę?
Podpisem kwalifikowanym albo profilem zaufanym. Osoba podpisująca w imieniu firmy musi mieć pełnomocnictwo UPL-1 złożone w urzędzie skarbowym.
Jakie są wymagania techniczne?
Frappe Framework 16 i ERPNext 16 w tym samym benchu oraz Python 3.14. Instalacja jest standardowa: bench get-app i bench install-app. W ramach wdrożenia robimy ją za Ciebie.