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.