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
| Pole | Opis | Przykład |
| Środowisko JPK | Wybór środowiska: testowe lub produkcyjne | Środowisko testowe (do testów) |
| Kod Urzędu Skarbowego | 4-cyfrowy kod właściwego US | 1471 (US Warszawa-Śródmieście) |
| Token autoryzacyjny | Token do API e-Deklaracje (opcjonalnie) | - |
| REGON | Numer REGON firmy | 123456789 |
| KRS | Numer KRS (jeśli dotyczy) | 0000123456 |
4.2 Certyfikat podpisu elektronicznego
⚠️ Ważne!
Do wysyłki deklaracji wymagany jest kwalifikowany podpis elektroniczny. Wgraj certyfikat w formacie .p12 lub .pfx i podaj hasło.
| Pole | Opis |
| Certyfikat podpisu | Plik certyfikatu (.p12 lub .pfx) |
| Hasło certyfikatu | Hasło do pliku certyfikatu |
4.3 Osoba upoważniona
| Pole | Opis |
| Imię | Imię osoby upoważnionej do podpisywania |
| Nazwisko | Nazwisko osoby upoważnionej |
| PESEL | Numer PESEL osoby upoważnionej |
| Data urodzenia | Data urodzenia osoby upoważnionej |
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"
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:
- Poczekaj na status Zaakceptowano
- Kliknij przycisk "Pobierz UPO"
- 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
