Pomoc · Faktury i KSeF
Jak połączyć KomisBox z KSeF
Połączenie z Krajowym Systemem e-Faktur działa na certyfikacie KSeF. Bez niego wystawisz fakturę w programie, ale nie wyślesz jej do KSeF. Do prawdziwych faktur wybierasz środowisko „PRODUKCJA”.
W paneluUstawienia firmy → Faktury i KSeFOtwórz ten ekran
Zanim zaczniesz
- Środowisko ustawia i certyfikat wgrywa tylko właściciel. Menedżer widzi te pola zablokowane, ale może sprawdzić połączenie.
- Potrzebujesz certyfikatu KSeF do uwierzytelniania (plik .crt, .cer albo .pem) i jego klucza prywatnego (plik .key albo .pem). Certyfikat uzyskujesz w systemie KSeF Ministerstwa Finansów, poza KomisBox. Każde środowisko KSeF ma osobny certyfikat.
- NIP w danych firmy musi być taki sam jak NIP w certyfikacie.
Które środowisko wybrać
Na liście „Środowisko” są trzy pozycje: „PRODUKCJA”, „TEST” i „DEMO”. Nowa firma zaczyna na „TEST”. Prawdziwe faktury wysyłasz tylko na „PRODUKCJA”: trafiają wtedy do Ministerstwa Finansów i mają pełne skutki prawne.
Przy przełączeniu na produkcję program pyta o potwierdzenie i przypomina, że do produkcji potrzebny jest osobny certyfikat z produkcyjnej Aplikacji Podatnika KSeF. Faktur wystawionych w trybie TEST albo DEMO nie wyślesz potem na produkcję.
Środowiska „TEST” i „DEMO” służą do sprawdzenia certyfikatu i przebiegu wysyłki. Faktury wysłane do nich nie mają skutków prawnych i nie wypełniają obowiązku KSeF. Ramka nad polami pokazuje aktywne środowisko, a przy TEST także uwagę, żeby używać wyłącznie danych fikcyjnych.
Jak połączyć KomisBox z KSeF certyfikatem
W menu rozwiń „Ustawienia firmy” i wybierz „Faktury i KSeF”.
Menedżer wejdzie przez listę faktur, przyciskiem „Faktury / KSeF”. Pracownik nie ma dostępu do tego ekranu.
W części „Połączenie z KSeF” wybierz „Środowisko” i kliknij „Zapisz”.
Przy zmianie środowiska program pyta o potwierdzenie i przypomina, że każde środowisko ma osobny certyfikat. Zobaczysz komunikat „Zapisano ustawienia połączenia.”
Jeśli łączysz się w imieniu innej firmy niż Twoja, wpisz jej NIP w polu „NIP kontekstu (firma w KSeF)”.
Zwykle zostawiasz to pole puste. Program użyje wtedy NIP z danych firmy.
W formularzu „Wgraj certyfikat” wybierz plik certyfikatu i plik klucza prywatnego.
Certyfikat może być w formacie PEM albo DER, klucz w formacie PEM. Każdy plik może mieć najwyżej 20 kB.
Jeśli klucz ma hasło, wpisz je w polu „Hasło do klucza (jeśli jest)”.
Hasło służy tylko do odczytania klucza przy wgrywaniu i nie jest zapisywane. Pole czyści się po każdej próbie.
Kliknij „Zapisz certyfikat”.
Serwer sprawdza zgodność klucza z certyfikatem, daty ważności i NIP. Zobaczysz komunikat „Certyfikat zapisany i zaszyfrowany.”, czasem z uwagami, na przykład o zbliżającym się końcu ważności.
Kliknij „Sprawdź połączenie”.
Komunikat „Połączenie z KSeF działa: uwierzytelnienie certyfikatem zakończone sukcesem.” oznacza, że w tym środowisku możesz wysyłać faktury.
Otwórz w pełnym rozmiarzeCo pokazuje ramka certyfikatu
- Dla kogo i przez kogo certyfikat został wystawiony oraz odcisk SHA-256, po którym rozpoznasz plik.
- Daty ważności. Na 30 dni przed końcem pojawia się ostrzeżenie, a po terminie informacja „Certyfikat wygasł - wgraj nowy.”
- NIP kontekstu i datę ostatniego uwierzytelnienia z wynikiem: udane albo błąd z kodem.
- Przycisk „Usuń certyfikat”, widoczny dla właściciela. Po usunięciu wysyłka i pobieranie faktur przestają działać do czasu wgrania nowego.
- Gdy certyfikatu nie ma, ramka mówi, że faktury można wystawiać, ale nie można ich wysłać do KSeF. Nowy certyfikat wgrywasz tym samym formularzem, który nazywa się wtedy „Zastąp certyfikat”.
Co program robi w tle
Klucz prywatny program zapisuje zaszyfrowany i nigdy nie wysyła go do przeglądarki. Do KSeF łączy się serwer, podpisując żądanie certyfikatem, tak samo przy sprawdzeniu połączenia, wysyłce i pobieraniu faktur otrzymanych.
Każde środowisko ma swój certyfikat, swoje wysyłki i swoją listę faktur otrzymanych. Zmiana środowiska nie przenosi certyfikatu i nie miesza faktur testowych z innymi.
Na co uważać przy testach
- Faktura wystawiona po to, żeby sprawdzić wysyłkę, jest w programie zwykłym dokumentem. Dostaje kolejny numer z serii faktur, liczy się do miesięcznego limitu i nie da się jej usunąć. Zanim wystawisz fakturę testową, ustal z księgowym, czy nie zaburzy to Twojej numeracji.
- W środowisku TEST używaj wyłącznie danych fikcyjnych, bez prawdziwych nabywców.
- Certyfikat samopodpisany działa tylko w środowisku testowym KSeF. Program pokaże o tym uwagę przy wgrywaniu.
Gdy coś nie działa
- Zamiast formularza jest informacja, że „Wgrywanie certyfikatu jest wyłączone.”
- Serwer nie ma jeszcze klucza do szyfrowania certyfikatów, więc certyfikatu nie da się zapisać. Faktury możesz wystawiać. Jak przekazujesz je do KSeF, ustal z księgowym i napisz do nas.
- Na liście „Środowisko” nie ma pozycji „PRODUKCJA”.
- Serwer ma wyłączoną wysyłkę do produkcyjnego KSeF. To nie jest błąd ustawień Twojego konta: napisz do nas.
- Błąd „To certyfikat typu Offline - nie służy do uwierzytelnienia w KSeF. Wgraj certyfikat typu Authentication.”
- W systemie KSeF wystaw certyfikat do uwierzytelniania i wgraj ten plik.
- Błąd „Klucz prywatny nie pasuje do certyfikatu.”
- Wybrany klucz należy do innego certyfikatu. Wgraj parę plików pobraną razem.
- Błąd „Klucz prywatny jest zaszyfrowany - podaj hasło do klucza.” albo „Hasło do klucza prywatnego jest nieprawidłowe.”
- Wpisz hasło ustawione przy tworzeniu certyfikatu. To nie jest hasło do KomisBox.
- Błąd „NIP zapisany w certyfikacie różni się od NIP firmy, w której imieniu łączysz się z KSeF.”
- Sprawdź NIP w danych firmy: Jak wpisać dane firmy i logo. Jeśli działasz w imieniu innej firmy, wpisz jej NIP w polu „NIP kontekstu (firma w KSeF)”.
- Po kliknięciu „Sprawdź połączenie” widać „Brak połączenia z KSeF.”
- Serwer nie połączył się z KSeF. Spróbuj ponownie za kilka minut. Jeśli komunikat mówi, że KSeF odrzucił uwierzytelnienie, sprawdź uprawnienia certyfikatu w systemie KSeF.
- Pola są zablokowane i widać „Środowisko, NIP kontekstu i certyfikat zmienia właściciel firmy.”
- Masz rolę menedżera. Certyfikat wgrywa właściciel.
Co dalej
- Jak wysłać fakturę do KSeFWystawienie faktury i wysyłka do KSeF to dwa osobne kroki. Wysyłasz jednym przyciskiem ze strony faktury, a program pokazuje, co odpowiedział KSeF. Faktura wysłana do środowiska „PRODUKCJA” ma pełne skutki prawne.
- Jak pobrać faktury zakupowe z KSeFProgram pobiera z KSeF faktury wystawione na NIP Twojej firmy. Każdą obejrzysz i jednym formularzem dodasz do kosztów pojazdu. Prawdziwe faktury od dostawców pobierasz ze środowiska „PRODUKCJA”.
- Ustawienia fakturowania: numery i rachunekJednorazowa konfiguracja przed pierwszą fakturą: rachunki z białej listy VAT, wzór numeru, termin płatności i stopka. Około dziesięciu minut.
Nie znalazłeś odpowiedzi?
Opisz, co chcesz zrobić i na którym ekranie jesteś.