Edytor mapowania JPK w Integratorze KSeF do Symfonii

IntegratorKSeF & JPK do Symfonii — Intuiti sp. z o.o.

⚠

Instrukcja jest w fazie rozbudowy — nie wszystkie obszary programu zostały jeszcze w niej opisane.

Producent: Intuiti sp. z o.o., NIP: 7811882150 · tel. (61) 307 40 00 · e-mail: biuro@intuiti.pl · www.intuiti.pl
Niniejszy dokument stanowi wyodrębnioną część instrukcji obsługi aplikacji IntegratorKSeF & JPK do Symfonii, opisującą Edytor mapowania JPK (w menu „Ustawienia” widoczny jako „Edytor definicji pól JPK”, a w karcie „Ustawienia” i w tytule okna edycji — jako „Edytor definicji schematów JPK”) w jego aktualnym kształcie. Ilustracje mają charakter poglądowy i mogą się nieznacznie różnić od bieżącej wersji rynkowej oprogramowania.

Spis treści

Czym jest edytor mapowania JPK
Definiowanie pól pliku JPK_FA
Definiowanie pól pliku JPK_V7
Definiowanie pól pliku JPK_MAG

1. Czym jest edytor mapowania JPK

Niektóre pliki JPK_FA, JPK_VAT czy JPK_V7 (niezależnie od wersji), generowane z różnych systemów księgowych, wymagają dostosowania pod względem pobierania właściwych wartości, aby wykonać poprawny import do systemu Symfonia. Każdy plik można dostosować za pośrednictwem Edytora mapowania JPK dostępnego w ustawieniach programu.

Użytkownik może dostosować otrzymany z innego systemu plik JPK, modyfikując mapowanie pól z poniższego zakresu danych:

Parametrów głównych pliku JPK,
Danych kontrahentów,
Wartości nagłówka dokumentów,
Wartości pozycji dokumentów,
Wartości netto i VAT (JPK_FA) lub wartości nagłówka (JPK_V7).

Edytor mapowania jest podzielony na odrębne obszary w zależności od struktury plików JPK — należy wybrać rodzaj pliku (JPK_FA, JPK_V7 lub JPK_MAG), aby uzyskać dostęp do definicji pól w wybranym zakresie.

Ustawienia — Edytor definicji schematów JPK✕

edytor definicji pól JPK

Edytuj definicje dla plików z rodzaju

JPK_FA

JPK_V7

JPK_MAG

ⓘ

Edytor schematów pól plików JPK umożliwia dostosowywanie nieszablonowych formatów i pobieranie stosownych pól przy imporcie wartości plików JPK. Zakres edycji pól plików JPK uzależniony jest od obowiązującego schematu struktury.

Aktualnie obowiązujące wersje struktur JPK:

Struktura	Obowiązuje od	Status	Dane KSeF
JPK_V7M(3) (z deklaracją, miesięczny)	1 lutego 2026 r.	aktualna	✔
JPK_V7K(3) (z deklaracją, kwartalny)	1 lutego 2026 r.	aktualna	✔
JPK_FA(4)	1 stycznia 2022 r.	nadal aktualna	✘
JPK_MAG(2)	1 lutego 2026 r.	aktualna	✘

Ustawienia i dostosowanie pól będzie miało skutek tylko dla bieżącej zalogowanej firmy.

Ilustracja 001 — wybór rodzaju pliku w edytorze mapowania JPK (menu Ustawienia → Edytor definicji pól JPK; w karcie „Ustawienia” kategoria „Edytor definicji schematów JPK”)

Aktualnie obowiązujące struktury JPK (tabela w oknie edytora): JPK_V7M(3) i JPK_V7K(3) — od 1 lutego 2026 r., zawierają dane KSeF; JPK_FA(4) — od 1 stycznia 2022 r., nadal aktualna; JPK_MAG(2) — od 1 lutego 2026 r. Ustawienia mapowania dotyczą wyłącznie bieżącej, zalogowanej firmy — dla każdej firmy konfiguruje się je osobno.

2. Definiowanie pól pliku JPK_FA

Po wybraniu kafelka JPK_FA otwiera się okno z zestawem zakładek: Parametry główne, Kontrahenci, Wartości Netto, Wartości VAT, Pozycje — każda zawiera osobne mapowanie pól dla dokumentów Sprzedaży i Zakupu.

Okno edycji ma tytuł „Edytor definicji schematów JPK”, a pod nim nagłówek ze strukturą, np. „EDYTOR SCHEMATÓW [JPK FA(4)]”. Każde pole to lista rozwijana z podpowiedziami, w którą można też wpisać własną nazwę elementu. Ikona odświeżania nad zakładką („Przywróć domyślne”) przywraca wartości domyślne bieżącej zakładki. Zduplikowane wartości są podświetlane na różowo, a puste pola obramowane na czerwono; przy zapisie program pyta wtedy „Zapisać ustawienia mimo to?”. Przycisk „Zapisz” w tym oknie zapisuje mapowanie od razu.

Edytor definicji schematów JPK✕

EDYTOR SCHEMATÓW [JPK FA(4)]

Parametry główne

Kontrahenci

Wartości Netto

Wartości VAT

Pozycje

⟳

	Sprzedaż	Zakup
Nr Dokumentu	P_2A ▾	P_2A ▾
Kod Waluty	KodWaluty ▾	KodWaluty ▾
Data wystawienia	P_1 ▾	P_1 ▾
Data operacji	P_6 ▾	P_6 ▾
Kwota brutto w walucie	P_15 ▾	P_15 ▾

Ilustracja 002 — zakładka „Parametry główne” edytora mapowania JPK_FA

2.1 Parametry główne

Nazwa pola	Pole domyślne — Sprzedaż	Pole domyślne — Zakup
Nr Dokumentu	P_2A	P_2A
Kod Waluty	KodWaluty	KodWaluty
Data wystawienia	P_1	P_1
Data operacji	P_6	P_6
Kwota brutto w walucie	P_15	P_15

2.2 Kontrahenci

Nazwa pola	Pole domyślne — Sprzedaż	Pole domyślne — Zakup
Nazwa kontrahenta	P_3A	P_3A
Adres	P_3B	P_3B
Kraj	P_5A	P_5A
NIP	P_5B	P_5B

Pole adresu kontrahenta składa się z ciągu rozdzielanego przecinkami: nazwa ulicy, numer domu, numer lokalu, kod pocztowy, miejscowość. Podczas importu danych kontrahentów do kartoteki w Symfonii aplikacja rozdziela poszczególne wartości, wprowadzając je do odpowiednich pól kartoteki, o ile jest to możliwe.

2.3 Wartości Netto

Nazwa pola	Pole domyślne — Sprzedaż	Pole domyślne — Zakup
Kwota netto 23%	P_13_1	P_13_1
Kwota netto 8%	P_13_2	P_13_2
Kwota netto 5%	P_13_3	P_13_3
Kwota netto 4%	P_13_4	P_13_4
Kwota netto 0%	P_13_6	P_13_6
Kwota netto NP	P_13_5	P_13_5
Kwota netto OSS	P_13_8	P_13_8
Kwota netto ZW	P_13_7	P_13_7

2.4 Wartości VAT

Nazwa pola	Pole domyślne — Sprzedaż	Pole domyślne — Zakup
Kwota VAT 23%	P_14_1	P_14_1
Kwota VAT 8%	P_14_2	P_14_2
Kwota VAT 5%	P_14_3	P_14_3
Kwota VAT 4%	P_14_4	P_14_4
Kwota VAT OSS	P_14_5	P_14_5
Kwota VAT 0%	P_14_6	P_14_6
Kwota VAT 23% PLN	P_14_1W	P_14_1W
Kwota VAT 8% PLN	P_14_2W	P_14_2W
Kwota VAT 5% PLN	P_14_3W	P_14_3W
Kwota VAT 4% PLN	P_14_4W	P_14_4W
Kwota VAT 0% PLN	P_14_6W	P_14_6W

2.5 Pozycje

Nazwa pola	Pole domyślne — Sprzedaż	Pole domyślne — Zakup
Nazwa pozycji	P_7	P_7
jm	P_8A	P_8A
Ilość	P_8B	P_8B
Cena netto	P_9A	P_9A
Wartość netto	P_11	P_11
Stawka VAT	P_12	P_12
Stawka VAT OSS	P_12_XII	P_12_XII

Wartości pozycji dokumentu prezentowane są w walucie dokumentu z nagłówka.

3. Definiowanie pól pliku JPK_V7

Po wybraniu kafelka JPK_V7 dostępne są zakładki Parametry główne, Kontrahenci, Wartości nagłówka — z osobnym mapowaniem dla ewidencji Sprzedaży (VAT należny) i Zakupu (VAT naliczony).

3.1 Parametry główne

Nazwa pola	Pole domyślne — Sprzedaż (VAT należny)	Pole domyślne — Zakup (VAT naliczony)
LP	LpSprzedazy	LpZakupu
Nr dokumentu	DowodSprzedazy	DowodZakupu
Data wystawienia	DataWystawienia	DataWplywu
Data operacji	DataSprzedazy	DataZakupu
Termin płatności	TerminPlatnosci	—
Data Zapłaty	DataZaplaty	—

Pola TerminPlatnosci i DataZaplaty obowiązują od wersji (2) struktury JPK_V7 wzwyż (w tym JPK_V7(3)/(4)). W przypadku wystąpienia wartości dla tych pól aplikacja utworzy nową transakcję z zastosowaniem daty terminu płatności.

3.2 Kontrahenci

Nazwa pola	Pole domyślne — Sprzedaż (VAT należny)	Pole domyślne — Zakup (VAT naliczony)
Nazwa kontrahenta	NazwaKontrahenta	NazwaDostawcy
NIP	NrKontrahenta	NrDostawcy
Adres	AdresKontrahenta	AdresDostawcy
Kraj	KodKrajuNadaniaTIN	KodKrajuNadaniaTIN

3.3 Wartości rejestrów / nagłówka

Nazwa pola	Pole domyślne — Sprzedaż (VAT należny)	Pole domyślne — Zakup (VAT naliczony)
Kwota netto 23%	K_19	K_42
Kwota VAT 23%	K_20	K_43
Kwota netto 8%	K_17	K_45
Kwota VAT 8%	K_18	K_46
Kwota netto 5%	K_15	K_47
Kwota VAT 5%	K_16	K_48
Kwota netto 0%	K_13	K_49
Kwota VAT 0%	K_14	K_50
Kwota netto ZW	K_10	—

Wartości domyślne dotyczą struktury JPK_V7(2)/JPK_VAT(3); dla struktur JPK_V7(3)/(4) niektóre numery pól ewidencyjnych mogą się różnić w zależności od aktualnego wzoru opublikowanego przez Ministerstwo Finansów — w razie potrzeby zweryfikuj przypisanie pola przed importem dużej partii dokumentów.

4. Definiowanie pól pliku JPK_MAG

Po wybraniu kafelka JPK_MAG dostępne są zakładki Parametry główne, Kontrahenci, Pozycje — z osobnym mapowaniem dla każdego rodzaju dokumentu magazynowego: PZ, WZ i RW.

4.1 Parametry główne

Nazwa pola	Pole domyślne — PZ	Pole domyślne — WZ	Pole domyślne — RW
Nr Dokumentu	NumerPZ	NumerWZ	NumerRW
Data	DataPZ	DataWZ	DataRW
Data otrzymania	DataOtrzymaniaPZ	n/d	n/d
Data wydania	n/d	DataWydaniaWZ	DataWydaniaRW
Wartość	WartoscPZ	WartoscWZ	WartoscRW

4.2 Kontrahenci

Nazwa pola	Pole domyślne — PZ	Pole domyślne — WZ	Pole domyślne — RW
Nazwa kontrahenta	Dostawca	OdbiorcaWZ	n/d
Numer Fa	NumerFaPZ	n/d	n/d
Data Fa	DataFaPZ	n/d	n/d

4.3 Pozycje dokumentu magazynowego

Nazwa pola	Pole domyślne — PZ	Pole domyślne — WZ	Pole domyślne — RW
Nr dokumentu	Numer2PZ	Numer2WZ	Numer2RW
Kod towaru	KodTowaruPZ	KodTowaruWZ	KodTowaruRW
Nazwa towaru	NazwaTowaruPZ	NazwaTowaruWZ	NazwaTowaruRW
Ilość	IloscPrzyjetaPZ	IloscWydanaWZ	IloscWydanaRW
Jednostka miary	JednostkaMiaryPZ	JednostkaMiaryWZ	JednostkaMiaryRW
Cena jednostkowa	CenaJednPZ	CenaJednWZ	CenaJednRW
Wartość pozycji	WartoscPozycjiPZ	WartoscPozycjiWZ	WartoscPozycjiRW

Po zmianie mapowania pól kliknij „Zapisz” — zmiana obowiązuje tylko dla bieżącej, zalogowanej firmy. Pliki JPK zaimportowane przed zmianą mapowania trzeba wczytać ponownie, aby zastosować nowe ustawienia.