Apps & Verbindungen
Einrichtungs-Checkliste
Mit dieser Checkliste prüfst du nicht nur, ob alle Felder gefüllt sind, sondern ob der gesamte Ablauf im richtigen ONE LOOP Standort funktioniert.
Mit dieser Checkliste prüfst du nicht nur, ob alle Felder gefüllt sind, sondern ob der gesamte Ablauf im richtigen ONE LOOP Standort funktioniert. Arbeite sie vor dem ersten produktiven Workflow einmal vollständig durch.
1. App und Verbindung
☐ Die App ist im richtigen ONE LOOP Standort installiert. Öffne vor jeder Einrichtung den Standort, in dem die Kontakte, Zahlungen und Workflows tatsächlich liegen.
☐ Die App-Seite ist erreichbar. Dort wird die Verbindung verwaltet; eine App ohne Verbindung kann keine Dokumente erstellen und keine externen Ereignisse verarbeiten.
☐ Der API-Schlüssel wurde in Lexware Office erzeugt und unmittelbar gesichert. Er wird später möglicherweise nicht mehr vollständig angezeigt.
☐ Der Schlüssel wurde ausschließlich auf der App-Seite hinterlegt. Er gehört nicht in Notizen, Textfelder oder Workflow-Schritte.
☐ Der Status zeigt „Verbunden“. Erst dann kann die App das Fachkonto erreichen.
☐ Du weißt, wer den Schlüssel bei Bedarf ersetzen darf. So vermeidest du eine unterbrochene Verbindung, wenn sich Zuständigkeiten ändern.
2. Kontakt- und Rechnungsdaten
☐ Der Kontakt hat einen Vor- und Nachnamen oder einen Firmenname. Die App benötigt eine eindeutige Grundlage für die Kundenzuordnung.
☐ Die Rechnungs-E-Mail ist korrekt. Sie ist wichtig für die Belegdaten und für spätere Kommunikation.
☐ Straße, Postleitzahl, Ort und Land sind geprüft. Unvollständige Anschriften führen häufig zu einem kontrollierten Fehler oder zu einem fachlich unbrauchbaren Dokument.
☐ Der Kundentyp ist bewusst gewählt. Bei automatischer Erkennung wird ein vorhandener Firmenname als Unternehmenslogik interpretiert; ohne Firmenname wird die Privatpersonenlogik verwendet.
☐ Bei einem Unternehmen ist der Firmenname im Kontakt gepflegt. Trage ihn nicht nur in eine freie Notiz ein.
3. Workflow richtig aufbauen
☐ Der Trigger passt zum Anlass. Eine Rechnung nach Zahlung benötigt einen Zahlungsauslöser; eine Auftragsbestätigung setzt ein angenommenes Angebot voraus.
☐ Filter sind bewusst gesetzt. Prüfe beispielsweise, ob ein Trigger bei jeder Teilzahlung oder nur bei der Schlusszahlung starten soll.
☐ Die Action liegt im richtigen Workflow-Zweig. Bei unterschiedlichen Steuer- oder Kundenszenarien gehören die Actions hinter die passende Bedingung.
☐ Dynamische Werte wurden über den Variablen-Picker ausgewählt. So verwendest du Werte aus genau dem Vorgang, der den Workflow ausgelöst hat.
☐ Pflichtfelder und Positionsquelle sind vollständig. Eine Transaktions-ID ersetzt keine frei definierte Positionsliste – und umgekehrt.
☐ Der Steuerfall wurde mit den erwarteten Daten getestet. Ein Steuersatz allein reicht nicht, um einen rechtlichen Fall zu beschreiben.
☐ Folgeschritte verwenden die Ausgaben der richtigen Action. Bei mehreren Dokument-Actions müssen Nummer und PDF-Link aus der passenden Instanz kommen.
☐ Der Workflow ist gespeichert und veröffentlicht. Erst dann reagiert er auf neue Ereignisse.
4. Ergebnis mit einem Testvorgang prüfen
☐ Das Dokument ist in Lexware Office vorhanden.
☐ Dokumentnummer, Summen, Kundentyp und Anschrift stimmen.
☐ Die Steuerdarstellung entspricht deinem vorgesehenen Fall.
☐ Das offizielle PDF liegt im Kontaktfeld „Lexware Documents“.
☐ Die Workflow-Ausführung zeigt die Action als erfolgreich und enthält die erwarteten Ausgabevariablen.
☐ Eine Folgeaction oder interne Benachrichtigung erhält Rechnungsnummer, Betrag und Datei-Link.
Warnung:
Teste mit einem neuen Vorgang. Alte Zahlungen oder bereits verarbeitete Statuswechsel liefern nicht immer dasselbe Ereignis noch einmal.
Wenn etwas nicht stimmt
Prüfe zuerst den Standort, die Verbindung und die Variable, die an die Action übergeben wird. Erst danach solltest du Preise, Steuerwerte oder die Reihenfolge des Workflows verändern. So grenzt du den Fehler ein, ohne gleichzeitig mehrere Ursachen einzuführen.
Zusätzliche Abschlussprüfungen
Nach einer Neuinstallation benötigte Trigger neu auswählen; Filter, Zweige und Variablen erneut binden. Für Zahlungsnachrichten die Werte des Zahlungstriggers verwenden. Ein Zahlungseingang darf nicht versehentlich in einen Angebotszweig fallen.
Prüfe auch bestehende PDFs vor dem Test. Das Kontaktfeld „Lexware Documents“ ist eine mehrdateifähige Sammlung mit höchstens 20 PDFs je Kontakt. Vorhandene Dateien müssen erhalten bleiben. Ein voller oder ungültiger Bestand stoppt die Ablage; keine alten Dateien unkontrolliert entfernen.
Aktuellen Zahlungstrigger und Produktquelle prüfen
Bei neuen Zahlungsworkflows Version 1.5 wählen: any umfasst Teil- und Schlusszahlungen, paymentStage bleibt partial oder final. Richtigen Standort und eindeutigen Rechnungskontakt prüfen; ältere Triggerkarten werden nicht automatisch umgestellt.
Bei CRM-Produkten den richtigen EUR-Preis, die Menge und vollständige feste Produktsteuer prüfen. Automatische Steuern ohne verbindliches Berechnungsergebnis nicht durch einen geratenen Satz ersetzen.