Schriftliche Anleitung

Was Sie erreichen

Sie wählen ein Unternehmen in den KSeFGPT-Einstellungen aus und verbinden es mit KSeF. Dafür stehen zwei Arten von Zugangsdaten zur Verfügung: Token oder Zertifikat.

Für ein Zertifikat können Sie ein vorhandenes Paar aus privatem Schlüssel und Zertifikat hochladen oder einen von KSeFGPT heruntergeladenen einmaligen Antrag mit Profil Zaufany signieren und anschließend als XML-Datei hochladen.

Nach dem Speichern der Zugangsdaten kann KSeFGPT im Kontext dieses Unternehmens Vorgänge in KSeF ausführen, soweit die erteilten Berechtigungen dies zulassen.

Voraussetzungen

Bevor Sie beginnen

Die Verbindung wird für jedes Unternehmen separat gespeichert. Stellen Sie vor Beginn sicher, dass das richtige Unternehmen bereits in KSeFGPT angelegt ist.

Element	Anforderung
Zugriff	Berechtigung zum Öffnen der Einstellungen und zum Verwalten der KSeF-Autorisierung.
Unternehmen	Ein in KSeFGPT angelegtes Unternehmen mit einer gültigen NIP-Steueridentifikationsnummer.
Ausgangspunkt	Öffnen Sie nach der Anmeldung die Einstellungen und anschließend den Tab KSeF-Verbindung.
Verbindungsdaten	Ein KSeF-Token, ein vorhandenes Paar aus privatem Schlüssel und Zertifikat oder Zugriff auf das Profil Zaufany einer Person, die den Zertifikatsantrag für die angegebene NIP signieren darf.

Prozessvideo

Das Video zeigt, wie ein Zertifikat für die Verbindung mit KSeF erstellt wird.

2:42

KSeF-Zertifikate erstellen und eine Anwendung in der Testumgebung verbinden

01Schritt

Unternehmen auswählen

Suchen Sie im Tab KSeF-Verbindung den Bereich KSeF-Zugangsdaten. KSeFGPT zeigt für jedes zum Konto hinzugefügte Unternehmen eine eigene Karte an.

Prüfen Sie auf der richtigen Karte den Unternehmensnamen und die NIP. Besteht noch keine Verbindung, sehen Sie einen Hinweis, dass für dieses Unternehmen keine Zugangsdaten vorhanden sind, sowie Schaltflächen zum Starten der Einrichtung.

02Schritt

Art der Zugangsdaten auswählen

KSeFGPT verbindet sich per Token oder Zertifikat mit KSeF. Beim Zertifikat können Sie vorhandene Dateien hochladen oder über die separate Schaltfläche für Profil Zaufany einen einmaligen Zertifikatsantrag signieren und hochladen.

Zugangsdaten	Was Sie benötigen	So funktioniert die Einrichtung
Token	Ein in der KSeF-Anwendung erzeugtes Zugriffstoken.	Sie fügen das Token in KSeFGPT ein und speichern die Zugangsdaten.
Zertifikat - vorhandene Dateien	Einen privaten Schlüssel als .key oder .pem, ein Zertifikat als .crt, .cer oder .pem und gegebenenfalls das Schlüsselpasswort.	Sie laden den privaten Schlüssel und die Zertifikatsdatei hoch.
Zertifikat - Profil-Zaufany-Ablauf	Zugriff auf das Profil Zaufany einer Person, die für die NIP des Unternehmens handeln darf.	Sie laden einen einmaligen Antrag herunter, signieren ihn auf gov.pl und laden die signierte XML-Datei hoch, damit KSeFGPT das Zertifikat einrichten kann.

KSeF-Verbindungseinstellungen in KSeFGPT mit den Optionen Zertifikat und Token — Schritt 2

Option 1. KSeF-Token

Wählen Sie auf der Unternehmenskarte Zugangsdaten hinzufügen und anschließend Token. Fügen Sie in das Feld KSeF-Token das zuvor in der KSeF-Anwendung erzeugte Zugriffstoken ein.

Wählen Sie Hinzufügen. KSeFGPT prüft das Token vor dem Speichern. Ist es ungültig oder wurde es widerrufen, erscheint eine entsprechende Fehlermeldung.

Option 2A. KSeF-Zertifikat aus Dateien

Wählen Sie auf der Unternehmenskarte Zugangsdaten hinzufügen und anschließend Zertifikat. Diese Methode ist in KSeFGPT als Standard gekennzeichnet.

Fügen Sie einen privaten Schlüssel im Format .key oder .pem und ein Zertifikat im Format .crt, .cer oder .pem hinzu. Ist der Schlüssel verschlüsselt, tragen Sie außerdem das Passwort in das optionale Feld Schlüsselpasswort ein.

Wählen Sie PEM-Zertifikat speichern. Nach erfolgreicher Prüfung sehen Sie in der Liste der Zugangsdaten den Zertifikatsinhaber und das Ablaufdatum.

Option 2B. KSeF-Zertifikat mit Profil Zaufany

Profil Zaufany ist in diesem Ablauf keine separate KSeF-Zugangsmethode. Es dient zum Signieren des einmaligen Antrags für die Zertifikatsverbindung. Wählen Sie auf der Unternehmenskarte Mit Profil Zaufany verbinden. KSeFGPT erstellt einen mit dem Unternehmen und seiner NIP verknüpften Antrag.

Speichern Sie im Schritt Antrag herunterladen die vorbereitete Datei. Wählen Sie danach gov.pl öffnen und Antrag signieren, melden Sie sich mit Profil Zaufany an, signieren Sie das Dokument und speichern Sie die signierte Datei auf Ihrem Gerät.

Kehren Sie zu KSeFGPT zurück, öffnen Sie den Schritt Datei hochladen und wählen Sie die signierte XML-Datei. Wählen Sie abschließend Fertigstellen und verbinden. KSeFGPT verwendet den signierten Antrag, um die zertifikatbasierte KSeF-Verbindung einzurichten.

KSeFGPT-Dialog zum Herunterladen eines einmaligen, mit Profil Zaufany zu signierenden Antrags — Option 2B. KSeF-Zertifikat mit Profil Zaufany

Endzustand

Ergebnis prüfen

Nach dem Speichern eines Tokens oder Zertifikats erscheint der neue Eintrag auf der Karte des richtigen Unternehmens. Beim Zertifikat zeigt KSeFGPT den Inhaber und das Ablaufdatum, beim Token einen maskierten Teil des Wertes.

Schließen Sie nach dem Hochladen des mit Profil Zaufany signierten Antrags das Fenster und prüfen Sie, ob die Zertifikatszugangsdaten auf der Unternehmenskarte sichtbar sind.

Fehlerdiagnose

Wenn etwas nicht funktioniert

Vergleichen Sie die in KSeFGPT angezeigte Meldung mit den häufigsten Ursachen für eine abgelehnte Verbindung.

Symptom	Wahrscheinliche Ursache	Lösung
Das Token wurde abgelehnt	Das Token ist ungültig oder wurde in KSeF widerrufen.	Erzeugen oder kopieren Sie das richtige Token und versuchen Sie es erneut.
Das Zertifikat lässt sich nicht speichern	Schlüssel oder Zertifikat fehlen, oder das Passwort des verschlüsselten Schlüssels ist falsch.	Prüfen Sie das .key/.crt-Dateipaar und das Schlüsselpasswort.
Die NIP im Zertifikat passt nicht zum Unternehmen	Das Zertifikat gehört zu einem anderen Rechtsträger.	Verwenden Sie ein Zertifikat für das Unternehmen, das Sie in KSeFGPT konfigurieren.
Der Zertifikatsantrag ist abgelaufen	Der Antrag wurde nicht rechtzeitig mit Profil Zaufany signiert und hochgeladen.	Wählen Sie Erneut erzeugen und signieren Sie den neuen Antrag.
Der signierte Antrag wurde abgelehnt	Die signierende Person darf in KSeF nicht für die angegebene NIP handeln.	Prüfen Sie ihre Berechtigungen einschließlich der erforderlichen ZAW-FA-Vollmacht.