Zum Inhalt
ONE LOOP / Dokumentation / Apps & Verbindungen

Apps & Verbindungen

sevdesk-Angebotsstatus geändert

Bereite Workflows für Annahme oder Ablehnung vor und verwende die passenden Angebots- und Providerstatusfelder.

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_quotation_status_changed und den Filter quotationStatus: accepted, rejected. 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.

quotationId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

quotationNumber

Text

Sichtbare Beleg-/Kundennummer.

quotationStatus

Text

accepted oder rejected als fachlicher Angebotsstatus.

previousQuotationStatus

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

providerQuotationStatus

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

previousProviderQuotationStatus

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

providerOrderType

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

quotationDate

Text

Datums-/Zeitwert des benannten Vorgangs; vor Anzeige passend formatieren.

quotationDateFormatted

Text

Formatierter Anzeigewert für Nachrichten; nicht zur Berechnung verwenden.

sentDate

Text

Datums-/Zeitwert des benannten Vorgangs; vor Anzeige passend formatieren.

sentDateFormatted

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.

netAmount

Zahl

Nettobetrag des Belegs.

taxAmount

Zahl

Steuerbetrag des Belegs.

grossAmount

Zahl

Bruttobetrag des Belegs.

grossAmountFormatted

Text

Formatierter Anzeigewert für Nachrichten; nicht zur Berechnung verwenden.

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.

← Zur Artikelübersicht