Pokaż spis treści

Eksporty urzędowe

JPK i archiwum

JPK i archiwum okresu są wydzielone, bo mają inny ciężar niż zwykły raport: muszą być spójne, kompletne i bezpieczne do przekazania dalej. Eksport XML zależy od danych spółki, planu kont, mapowań, dekretów i walidacji, a archiwum ZIP zbiera materiał kontrolny dla okresu.

Workflow

Na ekranie raportów operator może pobrać archiwum ZIP oraz JPK XML dla wybranego okresu. Link JPK jest obsługiwany z dodatkowym skryptem: jeżeli endpoint zwróci błąd walidacji XML, użytkownik nie dostaje pustego pobrania, tylko wraca do raportów z czytelnym parametrem błędu.

Akcje

  • Archiwum ZIP. Pobiera /api/reports/archive.zip z bieżącymi parametrami zakresu.

  • JPK_KR_PD XML. Pobiera /api/reports/jpk.xml i obsługuje odpowiedź błędną bez utraty kontekstu strony.

  • Eksport raportów. Pozwala dołączyć CSV/XLSX jako materiał kontrolny do archiwum okresu.

Eksport JPK i archiwum z kontrolą błędów

flowchart TD
  A["Operator wybiera okres"] --> B["Dane spółki + plan kont + mapowania"]
  B --> C["Dekrety i raporty okresu"]
  C --> D{"Eksport JPK XML"}
  D --> E["Walidacja XML"]
  E -->|OK| F["Pobranie JPK_KR_PD"]
  E -->|Błąd| G["Powrót do raportów z komunikatem"]
  C --> H["Archiwum ZIP"]
  H --> I["Raporty, dokumenty i materiały kontrolne"]

Decyzje projektowe

Eksport JPK nie jest zwykłym przyciskiem. Wymaga poprawnego planu kont, mapowań, danych spółki i okresu. Dlatego portal opisuje go osobno, a nie jako punkt w stronie raportów.