📋 JPK Tax Declarations

Moduł wysyłania deklaracji podatkowych JPK do Ministerstwa Finansów

Wersja 18.1.0 dla Odoo 18

1. Wprowadzenie

Moduł JPK Tax Declarations umożliwia generowanie i wysyłanie deklaracji podatkowych w formacie JPK (Jednolity Plik Kontrolny) bezpośrednio z systemu Odoo do Ministerstwa Finansów.

ℹ️ Czym jest JPK?

Jednolity Plik Kontrolny (JPK) to zestaw danych księgowych i podatkowych w formacie XML, który przedsiębiorcy są zobowiązani przesyłać do organów podatkowych. Od 2018 roku JPK_VAT jest obowiązkowy dla wszystkich podatników VAT.

2. Obsługiwane typy deklaracji

3. Instalacja

1 Skopiuj moduł
Rozpakuj archiwum jpk_tax_declarations.zip do katalogu addons Odoo

2 Zaktualizuj listę aplikacji
Aplikacje → Zaktualizuj listę aplikacji

3 Zainstaluj moduł
Wyszukaj "JPK Tax Declarations" i kliknij Zainstaluj

4. Konfiguracja firmy

Przed wysyłką deklaracji należy skonfigurować dane firmy:

Ustawienia → Użytkownicy i firmy → Firmy → [Twoja firma] → zakładka "JPK Tax"

4.1 Środowisko i autoryzacja

​
⚠️ Ważne!
Do wysyłki deklaracji wymagany jest kwalifikowany podpis elektroniczny. Wgraj certyfikat w formacie .p12 lub .pfx i podaj hasło.
​

4.3 Osoba upoważniona

5. Tworzenie deklaracji

5.1 Kreator nowej deklaracji

Księgowość → JPK Declarations → Nowa deklaracja

1 Wybierz typ deklaracji
Zaznacz odpowiedni typ: JPK_VAT, JPK_CIT, JPK_FA, itp.

2 Określ okres rozliczeniowy

Wybierz:
- Miesięczny - wybierz rok i miesiąc
- Kwartalny - wybierz rok i kwartał
- Roczny - wybierz rok
- Własny okres - podaj daty ręcznie

3 Opcje automatyzacji
- Automatycznie oblicz kwoty - oblicza VAT z zaksięgowanych faktur
- Automatycznie generuj XML - od razu generuje plik XML

4 Utwórz deklarację
Kliknij "Utwórz deklarację"

6. Proces wysyłki

 1. Oblicz kwoty → 2. Generuj XML → 3. Podpisz → 4. Wyślij do MF → 5. Pobierz UPO ​

6.1 Oblicz VAT (dla JPK_VAT)

Przycisk "Oblicz VAT" automatycznie sumuje:

• Sprzedaż VAT - z faktur sprzedaży (out_invoice, out_refund)
• Zakupy VAT - z faktur zakupu (in_invoice, in_refund)
• VAT należny i naliczony
• VAT do zapłaty/zwrotu

6.2 Generuj XML

Przycisk "Generuj XML" tworzy plik XML zgodny ze schematem MF:

• Nagłówek z danymi firmy
• Wiersze sprzedaży i zakupów
• Sumy kontrolne

6.3 Podpisz XML

Przycisk "Podpisz XML" podpisuje plik certyfikatem kwalifikowanym.

ℹ️ Uwaga: Pełne podpisywanie wymaga integracji z zewnętrznym dostawcą podpisu kwalifikowanego lub kartą kryptograficzną.

6.4 Wyślij do MF

Przycisk "Wyślij do MF" przesyła deklarację przez API e-Dokumenty.

✅ Po wysłaniu:
- System zapisuje numer referencyjny
- Zapisuje datę wysłania
- Zmienia status na "Wysłano"

7. Statusy deklaracji

8. Korekty deklaracji

Aby złożyć korektę zaakceptowanej deklaracji:

1. Otwórz oryginalną deklarację
Znajdź zaakceptowaną deklarację, którą chcesz skorygować

2. Utwórz korektę
Kliknij przycisk "Utwórz korektę"

3. Wprowadź zmiany
System utworzy kopię z oznaczeniem "Korekta". Wprowadź poprawki.

4. Wyślij korektę
Przejdź standardowy proces: Generuj XML → Podpisz → Wyślij

ℹ️ Numeracja korekt:

System automatycznie numeruje korekty (Korekta 1, Korekta 2, itd.) i zachowuje powiązanie z oryginalną deklaracją.

9. Pobieranie UPO

UPO (Urzędowe Poświadczenie Odbioru) to oficjalny dokument potwierdzający przyjęcie deklaracji przez Ministerstwo Finansów.

Jak pobrać UPO:

1. Poczekaj na status Zaakceptowano
2. Kliknij przycisk "Pobierz UPO"
3. Plik XML z UPO zostanie pobrany i zapisany przy deklaracji

✅ UPO zawiera:
- Numer referencyjny
- Datę i godzinę przyjęcia
- Potwierdzenie integralności danych
- Podpis elektroniczny MF

10. FAQ - Często zadawane pytania

❓ Jaki certyfikat jest wymagany do podpisu?

Wymagany jest kwalifikowany certyfikat podpisu elektronicznego wydany przez akredytowany podmiot (np. Certum, KIR, PWPW).

❓ Czy mogę testować wysyłkę bez prawdziwego certyfikatu?

Tak, ustaw środowisko na "Środowisko testowe" w konfiguracji firmy. Środowisko testowe MF przyjmuje deklaracje bez weryfikacji podpisu.

❓ Co oznacza błąd "Nieprawidłowa struktura XML"?

Wygenerowany XML nie jest zgodny ze schematem MF. Upewnij się, że:

• Wszystkie wymagane pola firmy są wypełnione (NIP, REGON)
• Faktury mają poprawne daty i numery
• Kontrahenci mają przypisane NIP-y

❓ Jak długo trwa przetwarzanie deklaracji?

Zazwyczaj od kilku minut do kilku godzin. W okresach wzmożonego ruchu (np. koniec miesiąca) może trwać dłużej.

❓ Czy mogę anulować wysłaną deklarację?

Nie można anulować wysłanej deklaracji. Jedyną opcją jest złożenie korekty.

❓ Gdzie znajdę listę kodów Urzędów Skarbowych?

Lista kodów dostępna jest na stronie Ministerstwa Finansów oraz w systemie e-Deklaracje.

⚠️ Pamiętaj o terminach!

- JPK_VAT miesięczny - do 25. dnia następnego miesiąca
- JPK_VAT kwartalny - do 25. dnia miesiąca po zakończeniu kwartału
- JPK_CIT - zgodnie z terminami CIT