Schriftliche Anleitung

Was Sie tun werden

Sie verbinden ein Fakturownia.pl-Konto mit dem ausgewählten Unternehmen in KSeFGPT. Vor dem Speichern prüfen Sie, ob KSeFGPT mit der angegebenen Subdomain und dem API-Token auf das richtige Konto zugreifen kann.

Die fertige Verbindung ist im Modul Integrationen verfügbar. Damit können Sie Rechnungen aus Fakturownia abrufen und an KSeF übermitteln sowie Rechnungen in die andere Richtung aus KSeF an Fakturownia senden.

Voraussetzungen

Bevor Sie beginnen

Prüfen Sie, ob in KSeFGPT das Unternehmen ausgewählt ist, das Sie mit dem Fakturownia.pl-Konto verknüpfen möchten. Die Integration wird für genau dieses Unternehmen gespeichert.

Behandeln Sie den API-Token wie ein Passwort. Fügen Sie ihn nicht in Nachrichten, Supportanfragen oder Screenshots ein. KSeFGPT verdeckt den Token im Formular und speichert ihn anschließend verschlüsselt.

Element	Voraussetzung
Zugriff in KSeFGPT	Unternehmensinhaber oder Organisationsmitglied mit der Berechtigung integrations:manage. Die Funktion Automatisierung muss im Tarif verfügbar sein.
Externes Konto	Ein aktives Fakturownia.pl-Konto, das Sie mit dem ausgewählten Unternehmen verbinden möchten.
Subdomain	Der Teil der Adresse vor .fakturownia.pl, zum Beispiel firma-demo aus firma-demo.fakturownia.pl.
API-Token	Ein Token aus Fakturownia.pl: Einstellungen → API → Autorisierungs-API-Token.
Ausgangspunkt	Wählen Sie nach der Anmeldung das richtige Unternehmen und öffnen Sie Integrationen.
Dauer	Etwa 3 Minuten.

Prozessvideo

PT31.8S

Das Video zeigt die Auswahl von Fakturownia, die Eingabe von Subdomain und API-Token, den Verbindungstest und das Speichern der aktiven Integration.

Fakturownia.pl-Integration in KSeFGPT hinzufügen

01Schritt

API-Token aus Fakturownia.pl vorbereiten

Melden Sie sich bei Fakturownia.pl an und öffnen Sie Einstellungen → API → Autorisierungs-API-Token. Kopieren Sie den Token des Kontos, das Sie mit KSeFGPT verbinden möchten.

Notieren Sie auch die Subdomain des Kontos. Lautet die Adresse firma-demo.fakturownia.pl, geben Sie in KSeFGPT nur firma-demo ein - ohne https:// und ohne die Endung .fakturownia.pl.

02Schritt

Fakturownia-Integration auswählen

Wählen Sie im Modul Integrationen die Schaltfläche Integration hinzufügen. Wenn noch keine Verbindung vorhanden ist, können Sie in der Seitenmitte Erste Integration hinzufügen wählen.

Wählen Sie im Dialog Integration hinzufügen den Typ Fakturownia. Das Formular Konfigurieren Fakturownia mit den Feldern Name, Fakturownia.pl-Subdomain und API-Token wird geöffnet.

03Schritt

Verbindungsdaten eingeben

Behalten Sie im Feld Name den Wert Fakturownia bei oder geben Sie eine Bezeichnung ein, anhand derer Sie das Konto erkennen, zum Beispiel Fakturownia - Inlandsverkäufe.

Geben Sie im Feld Fakturownia.pl-Subdomain nur den Teil der Adresse vor .fakturownia.pl ein. Die Subdomain darf Kleinbuchstaben, Ziffern und Bindestriche enthalten. Ein Bindestrich darf jedoch nicht am Anfang oder Ende stehen. Fügen Sie anschließend den kopierten API-Token ein.

Sobald alle drei Felder ausgefüllt sind, werden Verbindung testen und Speichern verfügbar.

04Schritt

Verbindung testen

Wählen Sie Verbindung testen. KSeFGPT prüft die Subdomain und den Token, ohne eine neue Integration zu speichern.

Bei korrekten Daten wechselt die Schaltfläche zu Verbunden. Die Bestätigung des Backends kann auch in der deutschen Oberfläche auf Polnisch als Połączono z Fakturownią. erscheinen. Wenn Sie die Subdomain oder den Token ändern, wird das Testergebnis gelöscht. Führen Sie den Test dann mit den neuen Daten erneut aus.

05Schritt

Integration speichern

Wählen Sie nach einem erfolgreichen Test Speichern. Während des Vorgangs zeigt die Schaltfläche Speichern... an. Nach erfolgreichem Abschluss wird der Konfigurationsdialog geschlossen.

Die Meldung Die Integration wurde erfolgreich hinzugefügt. erscheint. Außerdem sehen Sie eine Karte mit dem gewählten Namen, dem Typ Fakturownia und dem Status Aktiv.

Endzustand

Ergebnis prüfen

Suchen Sie die neue Karte im Modul Integrationen. Sie sollte den vergebenen Namen, die Bezeichnung Fakturownia und den Status Aktiv enthalten.

Über Bearbeiten können Sie später Name, Subdomain oder Token ändern. Test auf der gespeicherten Karte bestätigt die allgemeine Konfiguration. Prüfen Sie die Zugangsdaten verlässlich im Formular mit Verbindung testen.

Fehlerdiagnose

Wenn etwas nicht funktioniert

Vergleichen Sie die angezeigte Meldung oder das Verhalten des Formulars mit der folgenden Tabelle.

Symptom	Wahrscheinliche Ursache	Lösung
Integrationen ist nicht sichtbar oder der Bildschirm ist gesperrt	Die Funktion Automatisierung ist im Tarif nicht verfügbar oder ein Organisationsmitglied hat nicht die Berechtigung integrations:manage.	Prüfen Sie den Tarif oder bitten Sie den Organisationsinhaber, eine Gruppe mit der Berechtigung integrations:manage zuzuweisen.
KSeFGPT fordert Sie auf, ein Unternehmen auszuwählen	Im Kontowechsler ist kein Unternehmen aktiv.	Wählen Sie das Unternehmen aus, für das Sie die Integration erstellen möchten, und öffnen Sie Integrationen erneut.
Sie sehen Ungültige Subdomain	Sie haben die vollständige Adresse eingegeben, unzulässige Zeichen verwendet oder einen Bindestrich an den Anfang oder das Ende gesetzt.	Geben Sie nur den Teil vor .fakturownia.pl ein und verwenden Sie Kleinbuchstaben, Ziffern und gegebenenfalls Bindestriche.
Speichern ist nicht verfügbar	Name, gültige Subdomain oder API-Token fehlen.	Füllen Sie alle drei Felder aus. Korrigieren Sie eine ungültige Subdomain entsprechend der Meldung unter dem Formular.
Sie sehen Nie udało się połączyć z Fakturownią. und Unauthorized - check API token	Fakturownia.pl hat den API-Token abgelehnt. Diese Backend-Meldungen können auch in der deutschen Oberfläche auf Polnisch beziehungsweise Englisch erscheinen.	Kopieren Sie den aktuellen Token unter Einstellungen → API aus dem richtigen Konto und führen Sie den Test erneut aus.
Der Test endet mit Verbindungstest konnte nicht ausgeführt werden.	KSeFGPT hat keine Antwort vom Dienst für den Verbindungstest erhalten.	Speichern Sie die Integration nicht ungeprüft. Warten Sie kurz und wiederholen Sie den Test. Bleibt das Problem bestehen, wenden Sie sich an den Support, ohne den Token zu übermitteln.
Nach dem Speichern erscheint keine neue Karte	Der Speichervorgang wurde nicht erfolgreich abgeschlossen oder die Ansicht wurde nicht aktualisiert.	Prüfen Sie die Meldung oben rechts. Wurde der Erfolg nicht bestätigt, öffnen Sie das Formular erneut. Senden Sie den Token nicht in einer Supportanfrage.

Wie geht es weiter?

Um Dokumente aus Fakturownia abzurufen, öffnen Sie Rechnungen → Import und wählen Sie Integrationen. Wählen Sie die gespeicherte Integration, den Dokumenttyp und den Zeitraum aus und rufen Sie anschließend die Rechnungsliste ab. Sie können die Vorschau prüfen, XML herunterladen oder ausgewählte Dokumente an KSeF senden.

Um Rechnungen in die andere Richtung zu übertragen, öffnen Sie den Rechnungsexport und wählen Sie An Fakturownia als Ziel. KSeFGPT unterstützt Verkaufs- und Einkaufsdokumente und zeigt das Ergebnis für jede Rechnung getrennt an.

Wenn Sie den Token in Fakturownia.pl ändern, kehren Sie zu Integrationen zurück, wählen Sie Bearbeiten auf der richtigen Karte, fügen Sie den neuen Token ein, testen Sie die Verbindung und speichern Sie die Änderung.

Fakturownia.pl mit KSeFGPT verbinden

Melden Sie sich an, wählen Sie ein Unternehmen und fügen Sie die Verbindung mit Subdomain und API-Token hinzu.

Bei KSeFGPT anmelden

Wie füge ich eine Fakturownia.pl-Integration hinzu?