Zum Inhalt
ONE LOOP / Dokumentation / Apps & Verbindungen

Apps & Verbindungen

Auftragsbestätigung mit sevdesk erstellen

Verwende die technische ID eines passenden angenommenen Angebots für eine sevdesk-Auftragsbestätigung.

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.

Zweck und Eingaben

Verwende quotationId eines passenden angenommenen Angebots. Keine neue manuelle Positionsliste und keine sichtbare Angebotsnummer anstelle der ID. Die Beziehung zum Ursprungsangebot wird geprüft.

Ergebnis und vollständige Variablen

Prüfe finalen Beleg, offizielle Datei, Bezug zum Ursprungsdokument und Beträge. Ein Teil- oder unbekanntes Ergebnis ist kein neuer Create-Auftrag.

Variable

Typ

Bedeutung / sichere Verwendung

success

Wahr/Falsch

Erfolg des Schritts; vor Folgeaktionen prüfen.

status

Text

Ergebnisstatus; bei Teilergebnis keine neue Erstellung auslösen.

errorCode

Text; optional/leer möglich

Fehlerkennung.

errorMessage

Text; optional/leer möglich

Fehlermeldung.

retryable

Wahr/Falsch

Hinweis auf mögliche Wiederholung; externe Wirkung zuerst abgleichen.

warnings

Liste

Zusätzliche Hinweise.

sourceMode

Text

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

sourceReferenceType

Text

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

sourceReferenceId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

sevdeskContactId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

quotationId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

quotationNumber

Text

Sichtbare Beleg-/Kundennummer.

quotationStatus

Text

accepted oder rejected als fachlicher Angebotsstatus.

providerQuotationStatus

Text

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

orderConfirmationId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

orderConfirmationNumber

Text

Sichtbare Beleg-/Kundennummer.

orderConfirmationStatus

Text

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

providerOrderConfirmationStatus

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.

isFinalized

Wahr/Falsch

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

orderConfirmationDate

Text

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

orderConfirmationDateFormatted

Text

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

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.

orderConfirmationDocumentId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

orderConfirmationFileUrl

Text

Link zum zugeordneten Objekt oder Dokument; Leerwert und Zugriff prüfen.

orderConfirmationFileName

Text

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

orderConfirmationMimeType

Text

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

contactDocumentStatus

Text

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.

← Zur Artikelübersicht