Aplikacja Latarnia jest elementem KSeF, służącym do publikowania ustrukturyzowanej informacji na temat planowanych niedostępności oraz zaistniałych awarii KSeF zgodnie z art. 106ne Ustawy z dnia 11 marca 2004 r. o podatku od towarów i usług zwaną dalej Ustawą o VAT.
Udostępnia ogólnodostępne API, aby zapewnić rynkowi stały dostęp do informacji o statusie dostępności KSeF i planowanych przerwach w jego działaniu.
Interfejsy API Latarni są ogólnodostępne i nie wymagają autoryzacji
| Właściwość | Opis |
|---|---|
| Podstawa prawna | Art. 106ne ust. 4 oraz art. 106nh Ustawy o VAT |
| Typ zdarzenia (category) | Kod MAINTENANCE |
| Typ komunikatu (type) | Ogłaszana jest jednym komunikatem: "Planowana niedostępność" (kod MAINTENANCE_ANNOUNCEMENT) |
| Czas trwania | Długość przerwy jest znana i jest określana przez datę i godzinę rozpoczęcia (start) oraz zakończenia (end) w tym samym komunikacie. Data zakończenia może ulec zmianie w trakcie trwania zdarzenia (wymaga edycji komunikatu). |
| Widoczność | Komunikat jest udostępniany z odpowiednim wyprzedzeniem. |
| Właściwość | Opis |
|---|---|
| Podstawa prawna | Art. 106ne oraz art. 106nf Ustawy o VAT |
| Typ zdarzenia (category) | Kod FAILURE |
| Typ komunikatu (type) | Wymaga dwóch oddzielnych komunikatów: 1. Rozpoczęcie awarii (kod FAILURE_START) - informuje o rozpoczęciu awarii2. Zakończenie awarii (kod FAILURE_END) - informuje o zakończeniu awarii |
| Czas trwania | Rozpoczyna się zgodnie z datą rozpoczęcia (start) i trwa do czasu ogłoszenia jej końca osobnym komunikatem. Data zakończenia (end) jest nieznana w momencie ogłaszania rozpoczęcia awarii. |
| Widoczność | Komunikat o rozpoczęciu jest udostępniany po stwierdzeniu wystąpienia awarii, a komunikat o zakończeniu jest udostępniany po stwierdzeniu zakończenia awarii. |
| Właściwość | Opis |
|---|---|
| Podstawa prawna | Art. 106ng Ustawy o VAT |
| Typ zdarzenia (category) | Kod TOTAL_FAILURE |
| Typ komunikatu (type) | Podobnie jak zwykła awaria, wymaga komunikatu: 1. Rozpoczęcie awarii (kod FAILURE_START) - informuje o rozpoczęciu awarii2. Zakończenie awarii (kod FAILURE_END) - informuje o zakończeniu awarii |
| Czas trwania | Zasady są identyczne jak dla zwykłej awarii: wymaga osobnego komunikatu kończącego, a data zakończenia jest nieznana przy starcie. |
| Widoczność | Komunikat o rozpoczęciu jest udostępniany po stwierdzeniu wystąpienia awarii, a komunikat o zakończeniu jest udostępniany po stwierdzeniu zakończenia awarii. |
Przykładowe scenariusze działania systemu Latarnia opisano w dokumencie: Przykładowe scenariusze dla Systemu Latarnia KSeF
Zestawienie środowisk Latarni zostało opisane w dokumencie: Środowiska Latarni KSeF