Skip to content
ONE LOOP / Documentation / Apps & connections

The source documentation is currently available in German. No English translation is implied.

Apps & connections

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.

← Back to articles