Apps & Verbindungen
Auftragsbestätigung mit bexio erstellen
Überführe ein angenommenes bexio-Angebot über seine technische ID in eine Auftragsbestätigung und prüfe Beleg und PDF.
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.
Überführe ein angenommenes Angebot aus derselben Installation in einen Auftrag. Verwende seine documentId als quotationId, nicht die Angebotsnummer.
Bedienablauf
Action im passenden Workflowzweig auswählen.
idempotencyKey als eindeutige Geschäftsreferenz mappen: gleich bei Wiederholung, neu bei neuem Beleg. Keine globale Konstante für alle Kontakte.
Kontakt und Belegdaten prüfen, Pflichtfelder nach gewählter Quelle mappen.
Nach Erfolg documentId, documentNumber, documentFileUrl, Währung und Beträge vergleichen.
Eingaben
Feld | Pflicht | Typ | Auswahl |
|---|---|---|---|
idempotencyKey | Ja | string | Wert oder passende Workflow-Variable |
quotationId | Ja | string | Wert oder passende Workflow-Variable |
Alle Action-Ausgaben
Beträge sind Dezimaltexte in der angegebenen Hauptwährung, keine Stripe-Minorbeträge. Die PDF-Datei stammt aus dem verifizierten Kontakt-Dateikanal.
Variable | Typ | Bedeutung / sichere Verwendung |
|---|---|---|
success | Wahr/Falsch | Erfolg des Schritts; vor Folgeaktionen prüfen. |
provider | Text | Angebundener Dienst. |
documentType | Text | Belegart. |
documentId | Text; optional/leer möglich | Technische Beleg-ID; für Folgeaktionen verwenden. |
documentNumber | Text; optional/leer möglich | Sichtbare Belegnummer für Nachrichten. |
documentStatus | Zahl | Numerischer Status des Fachsystems. |
currency | Text | Währung des Belegs oder Ereignisses. |
netAmount | Text; optional/leer möglich | Nettobetrag des Belegs. |
taxAmount | Text; optional/leer möglich | Steuerbetrag des Belegs. |
grossAmount | Text; optional/leer möglich | Bruttobetrag des Belegs. |
officialDocumentMimeType | Text | Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen. |
officialDocumentFileName | Text; optional/leer möglich | Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen. |
documentFileUrl | Text; optional/leer möglich | Verifizierter Datei-Link am Kontakt; Zugriffsrechte beachten. |
readbackVerified | Wahr/Falsch | Bestätigt den geprüften Rücklesestand. |
requestId | Text; optional/leer möglich | Technische Anfragekennung für Support. |
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.