Faktura przed wysyłką do KSeF
Widok Wychodzące obsługuje faktury sprzedażowe, które nie są jeszcze finalnie przyjęte przez KSeF. To roboczy bufor procesu: dokument może być dopracowywany, walidowany, zaakceptowany do wysyłki, wysłany i ponownie sprawdzony po stronie KSeF.
Lista nie jest zwykłym rejestrem dokumentów. Status steruje tym, co użytkownik może zrobić z fakturą, a uprawnienia roli dodatkowo ograniczają widoczność przycisków i akcji. Dzięki temu operator nie widzi przypadkowych operacji dla dokumentu, który jest już po wysłaniu albo wymaga poprawy po odrzuceniu.
Jak przebiega praca
Użytkownik tworzy fakturę na podstawie danych kontrahenta, pozycji, stawek VAT, warunków płatności i numeracji skonfigurowanej w administracji.
Dokument pozostaje edytowalny, dopóki status pozwala na poprawki. System rozdziela etap zapisu szkicu od przygotowania do wysyłki.
Po sprawdzeniu danych faktura przechodzi do stanu gotowego do KSeF. Dopiero wtedy dostępne są akcje wysyłki pojedynczej albo wsadowej.
Po wysłaniu aplikacja zapisuje stan sesji i pozwala odświeżać wynik przetwarzania. Odpowiedź KSeF może zakończyć proces przyjęciem albo odrzuceniem.
Faktury przyjęte przez KSeF przechodzą do oddzielnego widoku faktur sprzedażowych wystawionych, gdzie dostępne są UPO, XML, PDF, korekty i rozliczenia.
Statusy faktury sprzedażowej
Faktura sprzedażowa może wystąpić w następujących statusach:
Szkic - dokument zapisany roboczo. Można go dalej edytować, uzupełniać pozycje i dane nabywcy.
Do walidacji - dokument jest przygotowany do sprawdzenia. To etap pośredni między szkicem a dokumentem technicznie poprawnym.
Zwalidowana - faktura przeszła walidację i może zostać doprowadzona do stanu gotowego do wysyłki.
Gotowa - dokument jest gotowy do przekazania do KSeF. Tylko z tego stanu działa wysyłka pojedyncza i wsadowa.
Wysłana - faktura została przekazana do KSeF, ale wynik przetwarzania nie jest jeszcze finalny. Dla tego statusu ma sens odświeżanie statusu KSeF.
Przyjęta - KSeF zaakceptował fakturę. To status końcowy dla obiegu wysyłki, pokazywany głównie na stronie faktur wystawionych.
Odrzucona - KSeF odrzucił dokument. Fakturę można poprawić, sprawdzić powód odrzucenia albo, w szczególnym przypadku duplikatu, wyrównać z dokumentem już przyjętym.
Najważniejsze akcje
Dodaj fakturę otwiera formularz wystawiania dokumentu sprzedażowego.
Edytuj jest dostępne dla statusów, które nadal mogą być poprawiane: od szkicu do gotowej oraz dla faktury odrzuconej.
Wyślij do KSeF działa dla faktur gotowych i korzysta z tokenu KSeF zalogowanego operatora oraz NIP firmy z kontekstu aplikacji.
Wyślij wsadowo obsługuje wiele faktur gotowych w jednym przebiegu i zwraca podsumowanie przyjętych, wysłanych, odrzuconych i pominiętych pozycji.
Odśwież status KSeF sprawdza wynik dla faktur wysłanych i aktualizuje dokument do stanu przyjętego albo odrzuconego.
Pobierz XML, PDF lub drukuj działa dla dokumentów, które mają wygenerowaną treść XML.
Dlaczego to jest ważne
Sprzedażowa faktura KSeF jest dokumentem prawnym, więc ekran musi pilnować procesu mocniej niż klasyczny CRUD. Aplikacja łączy formularz, numerację, słowniki pozycji, walidację XML, status domenowy, token operatora, odpowiedź KSeF, role użytkownika i późniejsze przejście do rejestru faktur wystawionych.
To pokazuje architekturę, w której UI jest prosty dla operatora, ale decyzje biznesowe są oparte na regułach domenowych. Ten sam model statusów steruje listą, przyciskami, endpointami API, use case'ami i schedulerami odpowiedzialnymi za wysyłkę oraz odświeżanie statusów.