Apps & Verbindungen
sevdesk-Rechnungszahlung empfangen
Richte Zahlungsfilter ein und unterscheide neue Teil- oder Schlusszahlungen vom historischen Ausgangsstand.
Vorbereitete Anleitung auf Basis des Implementierungsstands. Die vollständige Verbindung und Ausführung im vorgesehenen Standort sind noch nicht allgemein bestätigt. Nutze diese Schritte erst, wenn die App und ihre Funktionen für deinen Standort ausdrücklich bereitstehen.
Einrichtung und Ablauf
Wähle den Trigger sevdesk_invoice_payment_received und den Filter paymentStage: any, partial, final. Nach Speichern und Veröffentlichung beobachtet der erlaubte Pollingpfad Änderungen im gebundenen Fachkonto.
Der erste Abgleich bildet nur den Ausgangsstand. Historisch bezahlte oder angenommene Dokumente lösen dadurch keinen neuen Workflow aus. Ein allgemeiner Änderungszeitpunkt beweist keine Zahlung. Zwischen zwei Abfragen vollständig abgelaufene Zustände lassen sich nicht sicher rekonstruieren. Änderungen aus deaktivierten Zeiträumen nicht als nachträgliche Sendungen erwarten.
Daten verwenden
Teil-/Schlusszahlung beziehungsweise Annahme/Ablehnung gezielt verzweigen. Technische ID, sichtbare Nummer und Providerstatus auseinanderhalten. providerInvoiceStatus und previousProviderInvoiceStatus sind verschiedene Werte; der Angebotsstatus ist nicht der Status einer späteren Auftragsbestätigung.
Alle Trigger-Variablen
Variable | Typ | Bedeutung / sichere Verwendung |
|---|---|---|
schemaVersion | Zahl | Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen. |
eventId | Text | Ereigniskennung zur Zuordnung und Duplikatprüfung. |
event | Text | Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen. |
provider | Text | Angebundener Dienst. |
invoiceId | Text | Technische Referenz des benannten Objekts; keine sichtbare Nummer. |
invoiceNumber | Text | Sichtbare Beleg-/Kundennummer. |
invoiceStatus | Text | Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen. |
providerInvoiceStatus | Text | Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen. |
previousProviderInvoiceStatus | Text | Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen. |
paymentStage | Text | any, partial oder final als Triggerfilter; Ereignis beschreibt den beobachteten Zahlungsstand. |
isPartialPayment | Wahr/Falsch | Wahr bei Teilzahlung. |
isFullyPaid | Wahr/Falsch | Wahr bei vollständigem Ausgleich. |
invoiceDate | Text | Datums-/Zeitwert des benannten Vorgangs; vor Anzeige passend formatieren. |
invoiceDateFormatted | Text | Formatierter Anzeigewert für Nachrichten; nicht zur Berechnung verwenden. |
dueDate | Text | Datums-/Zeitwert des benannten Vorgangs; vor Anzeige passend formatieren. |
dueDateFormatted | Text | Formatierter Anzeigewert für Nachrichten; nicht zur Berechnung verwenden. |
providerUpdatedAt | Text | Datums-/Zeitwert des benannten Vorgangs; vor Anzeige passend formatieren. |
eventDate | Text | Datums-/Zeitwert des benannten Vorgangs; vor Anzeige passend formatieren. |
eventDateFormatted | Text | Formatierter Anzeigewert für Nachrichten; nicht zur Berechnung verwenden. |
sevdeskContactId | Text | Technische Referenz des benannten Objekts; keine sichtbare Nummer. |
contactId | Text | Kontaktkennung, sofern für dieses Ereignis vorhanden. |
locationId | Text | Zugeordneter Standort. |
currency | Text | Währung des Belegs oder Ereignisses. |
totalNetAmount | Zahl | Betragswert gemäß der auf dieser Seite beschriebenen Einheit. |
totalTaxAmount | Zahl | Betragswert gemäß der auf dieser Seite beschriebenen Einheit. |
totalAmount | Zahl | Betragswert gemäß der auf dieser Seite beschriebenen Einheit. |
totalAmountFormatted | Text | Formatierter Anzeigewert für Nachrichten; nicht zur Berechnung verwenden. |
wasOverdue | Wahr/Falsch | Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen. |
daysOverdue | Zahl | Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen. |
Sicher mit Variablen arbeiten
Wähle jede Variable im Variablen-Picker des konkreten Workflow-Schritts. Technische IDs sind für Verknüpfungen, sichtbare Belegnummern für Nachrichten. Keine selbst geratenen Schrittnummern oder Zugangsdaten in Felder kopieren. Prüfe leere Werte und Datentypen vor Folgeaktionen.
Fehler und Wiederholung
Prüfe bei einem Fehler zuerst Standort, Verbindung, Pflichtfelder, Kundenzuordnung, Währung und Steuerdaten. Ein Timeout beweist nicht, dass kein Dokument entstanden ist. Bei unklarem externem Ergebnis zuerst den bestehenden Lauf und den Beleg abgleichen; nicht mit neuer Vorgangskennung nochmals erstellen. Für denselben Vorgang denselben stabilen Schlüssel verwenden. Support benötigt Zeitpunkt, Standort, Action/Trigger, Request- oder Ereigniskennung und Fehlermeldung, niemals API-Schlüssel oder Tokens.