Pokaż spis treści

ExKSeF

System operacyjny dla faktur, płatności i bankowości

  • KSeF, faktury zakupowe, faktury sprzedażowe i proformy
  • Płatności ręczne, cykliczne, opłacone, korekty i potwierdzenia
  • Pekao Connect, camt.052, pain.002, kolejka bankowa i historia rachunku
  • Role, uprawnienia, statusy danych, web, mobile i schedulery

Aplikacja pokazana jako proces, nie zbiór ekranów

ExKSeF jest projektem, w którym najważniejsze są powiązania między modułami. Faktura przychodząca nie kończy życia na liście zakupów. Może utworzyć płatność, zostać zatrzymana przez brak zaufania do kontrahenta, rozliczyć korektę, wejść do kolejki bankowej, dostać potwierdzenie z historii rachunku i wrócić jako opłacony dokument z pełnym kontekstem.

Sprzedaż działa po drugiej stronie tego samego procesu. Faktura może być robocza, walidowana, zaakceptowana, wysłana do KSeF, przyjęta z numerem KSeF, powiązana z wpływem bankowym i pokazywana z markerami płatności. Do tego dochodzą proformy, faktury cykliczne, słowniki pozycji, kontrahenci, Export Magik i administracja, która konfiguruje zachowanie systemu zamiast zostawiać je w kodzie.

Portal opisuje aplikację tak, jak warto ją pokazać potencjalnemu pracodawcy lub klientowi: przez przepływ pracy, ograniczenia, wyjątki, automatyzację, bezpieczeństwo operacyjne i integracje. To nie jest opis kilku CRUD-ów. To studium aplikacji, która obsługuje pieniądze, dokumenty i odpowiedzialność za decyzje operatora.

Co jest tu szczególnie ważne

  • Spójny model statusów - faktury, płatności i zadania w tle mają statusy, które sterują widocznością akcji i możliwymi przejściami.

  • Bezpieczna ścieżka płatności - ręcznie dodana płatność startuje jako robocza, wymaga zatwierdzenia i dopiero później trafia do eksportu albo Pekao Connect.

  • Integracje domykające proces - KSeF dostarcza dokumenty, Pekao Connect obsługuje wysyłkę i statusy, a camt.052 potwierdza realne księgowanie.

  • Role i uprawnienia - użytkownik widzi strony, przyciski i akcje zgodnie z rolami oraz uprawnieniami ograniczonymi do statusów danych.

  • Automatyzacja bez utraty kontroli - schedulery tworzą płatności cykliczne, pobierają dane, odświeżają statusy i zapisują historię, ale wyjątki wracają do operatora.

Główny przepływ biznesowy

%%{init: {"themeVariables": {"fontSize": "12px"}}}%%
flowchart TD
  A[Faktura z KSeF lub formularza] --> B[Rejestr zakupowy]
  B --> C{Decyzja operatora}
  C --> D[Płatność robocza]
  C --> E[Automatyczne rozliczenie gotówka karta sprzedawca]
  D --> F[Zatwierdzenie]
  F --> G[Plik przelewów]
  F --> H[Kolejka Pekao Connect]
  H --> I[pain.002 status banku]
  G --> J[camt.052 historia rachunku]
  I --> J
  J --> K[Płatność opłacona]
  K --> L[Potwierdzenie i podgląd]
  M[Faktura sprzedażowa] --> N[Walidacja i akceptacja]
  N --> O[Wysyłka do KSeF]
  O --> P[Faktura przyjęta]
  J --> P

Mapa obszarów aplikacji

Zakupowe

Faktury przychodzące, pełny rejestr zakupowy, dokumenty ręczne, zaufanie kontrahenta, kolejka nowych kontrahentów, korekty, automatyczne rozpoznanie opłacenia i przejście do płatności.

Przychodzące

Płatności

Płatności robocze, zatwierdzanie, eksport pliku, kolejka Pekao Connect, ręczne wiązanie transakcji, płatności opłacone, potwierdzenia i definicje cykliczne.

Nadchodzące

Sprzedaż

Faktury wychodzące, wystawianie dokumentu, wysyłka do KSeF, faktury przyjęte, płatności odbiorców, faktury cykliczne i proformy.

Wychodzące

Słowniki

Kontrahenci, pozycje, rachunki, zaufanie odbiorców i narzędzia O→M / Export Magik pomagające przenieść dane do zewnętrznego obiegu księgowego.

Kontrahenci

Pekao Connect

Integracja bankowa obejmuje wysyłkę dyspozycji, statusy pain.002, historię camt.052, potwierdzenia PDF i kontrolowaną obsługę wyjątków.

Integracja bankowa

Administracja

Konfiguracja firmy, KSeF, płatności, eksportów, ról, użytkowników, harmonogramów, historii zadań, statusu systemu i ustawień konta.

Administracja

Ścieżki użytkownika opisane w portalu

Podstrony są ułożone zgodnie z menu aplikacji, ale opisują też miejsca, w których użytkownik naprawdę rozpoczyna proces. Dzięki temu można przejść zarówno przez moduły, jak i przez konkretne czynności wykonywane w systemie.

Zakupowe

  • Faktury przychodzące - skrzynka pobrań, KSeF, ręczne dodawanie, tworzenie płatności, zaufanie kontrahenta, kolejka kontrahentów, korekty i automatyczne oznaczenia opłacenia.

  • Ręczne dodawanie faktury przychodzącej - formularz wyjątku dla faktury spoza automatycznego pobrania.

  • Faktury zakupowe - pełny rejestr dokumentów z widokami, filtrami, grupowaniem, markerami, eksportami i statusem płatności.

Płatności

Sprzedaż

Słowniki, administracja i dostęp

Decyzje techniczne widoczne w produkcie

Najciekawsze elementy ExKSeF są ukryte w codziennych zachowaniach aplikacji. Operator widzi prosty przycisk lub marker, ale pod spodem działa reguła domenowa, use case, walidacja dostępu, status danych albo job integracyjny.

Płatność nie jest tylko rekordem

Dodanie płatności zapisuje zobowiązanie jako szkic. Zatwierdzenie decyduje, czy pozycja trafi do pliku przelewów, do kolejki bankowej, czy zostanie wstrzymana przez nierozliczone korekty. Status bankowy nie jest zgadywany: pain.002 informuje o etapie dyspozycji, a camt.052 potwierdza realne księgowanie i pozwala pobrać potwierdzenie po TxId.

Faktura niesie kontekst księgowy

System rozpoznaje faktury opłacone gotówką lub kartą, dokumenty oznaczone przez sprzedawcę jako rozliczone, kwoty zerowe, MPP, załączniki, korekty i nadpłaty. Te informacje pojawiają się później na listach jako markery, wpływają na płatności i ograniczają ryzyko wykonania przelewu tam, gdzie nie powinien powstać.

Role są częścią interfejsu

Uprawnienia nie są tylko blokadą po stronie serwera. Decydują o widoczności pozycji menu, przycisków, akcji wiersza, statusów płatności i stron w aplikacji mobilnej. Dzięki temu użytkownik z ograniczoną rolą nie pracuje na ekranie, który obiecuje akcje niedostępne dla jego zakresu odpowiedzialności.

Schedulery mają ślad operacyjny

Zadania w tle nie są bezimiennym automatem. Mają konfigurację, historię, heartbeat i konkretne odpowiedzialności: synchronizację KSeF, płatności cykliczne, statusy bankowe, wysyłkę do Pekao Connect oraz powiadomienia. To pozwala diagnozować proces bez zaglądania bezpośrednio do bazy lub logów aplikacji.

Formularze, które uruchamiają obieg

Ręczna faktura przychodząca

Dodaje dokument spoza automatycznego pobrania i wprowadza go do tego samego obiegu płatności, kontrahenta i kontroli rozliczenia.

Zobacz formularz

Wystawianie faktury sprzedażowej

Buduje dokument sprzedażowy z pozycjami, nabywcą, podatkami i statusem gotowym do akceptacji oraz wysyłki do KSeF.

Zobacz formularz

Dodawanie płatności

Pozwala utworzyć ręczne zobowiązanie, ale zachowuje kontrolę: walidacja, szkic, zatwierdzenie i dopiero później bank albo eksport.

Zobacz formularz

Dodawanie płatności cyklicznej

Definiuje powtarzalne zobowiązanie, które scheduler zamienia w zwykłą płatność wychodzącą zgodnie z harmonogramem.

Zobacz formularz

Dlaczego ta aplikacja jest dobrym case study

Co odróżnia ExKSeF od prostej aplikacji fakturowej?

Proces nie kończy się na zapisaniu dokumentu. System prowadzi fakturę przez decyzje, statusy, płatności, bank, historię, korekty, potwierdzenia i role użytkowników.

Dlaczego Pekao Connect ma osobną stronę?

Integracja bankowa jest jednym z najmocniejszych elementów projektu. Obejmuje kolejkę wysyłki, statusy pain.002, historię camt.052, TxId dla potwierdzeń i obsługę wyjątków, więc warto ją pokazać jako osobny obszar kompetencji.

Czy mobile jest osobnym systemem?

Nie. Aplikacja mobilna korzysta z tego samego modelu uprawnień i tych samych ograniczeń widoczności, więc nie omija zasad z weba.

Dlaczego portal opisuje też administrację i schedulery?

Bo w aplikacji biznesowej konfiguracja, role, zadania w tle i historia wykonań są częścią produktu. Bez nich trudno utrzymać integracje, płatności i odpowiedzialność operatorów.