Zum Inhalt
ONE LOOP / Dokumentation / Apps & Verbindungen

Apps & Verbindungen

Angebot mit bexio erstellen

Konfiguriere Angebote aus Produkten oder eigenen Positionen mit gültiger Währung, Steuerbehandlung und stabiler Vorgangskennung.

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.

Erstelle ein Angebot aus Standortprodukten oder eigenen Positionen. Eine Zahlung wird dafür nicht vorausgesetzt.

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 je Quelle

sourceMode wählt die Quelle; Produkt-Auswahl und manuelle Felder nicht vermischen.

product

Feld

Pflicht

Typ

Auswahl

idempotencyKey

Ja

string

Wert oder passende Workflow-Variable

title

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

introduction

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

remark

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

expirationDate

Ja

string

Wert oder passende Workflow-Variable

customerEntityType

Ja

radio

auto, company, person

product1Selection

Ja

select

Wert oder passende Workflow-Variable

product1Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

product2Selection

Nein; falls verwendet fachlich prüfen

select

Wert oder passende Workflow-Variable

product2Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

product3Selection

Nein; falls verwendet fachlich prüfen

select

Wert oder passende Workflow-Variable

product3Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

product4Selection

Nein; falls verwendet fachlich prüfen

select

Wert oder passende Workflow-Variable

product4Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

product5Selection

Nein; falls verwendet fachlich prüfen

select

Wert oder passende Workflow-Variable

product5Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

product6Selection

Nein; falls verwendet fachlich prüfen

select

Wert oder passende Workflow-Variable

product6Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

product7Selection

Nein; falls verwendet fachlich prüfen

select

Wert oder passende Workflow-Variable

product7Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

product8Selection

Nein; falls verwendet fachlich prüfen

select

Wert oder passende Workflow-Variable

product8Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

product9Selection

Nein; falls verwendet fachlich prüfen

select

Wert oder passende Workflow-Variable

product9Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

product10Selection

Nein; falls verwendet fachlich prüfen

select

Wert oder passende Workflow-Variable

product10Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

manual

Feld

Pflicht

Typ

Auswahl

idempotencyKey

Ja

string

Wert oder passende Workflow-Variable

title

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

introduction

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

remark

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

expirationDate

Ja

string

Wert oder passende Workflow-Variable

customerEntityType

Ja

radio

auto, company, person

currency

Ja

select

CHF, EUR

taxType

Ja

select

net, gross, vatfree

item1Name

Ja

string

Wert oder passende Workflow-Variable

item1Description

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

item1Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item1Unit

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item1UnitPrice

Ja

string

Wert oder passende Workflow-Variable

item1TaxRate

Ja

string

Wert oder passende Workflow-Variable

item1Discount

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item2Name

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item2Description

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

item2Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item2Unit

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item2UnitPrice

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item2TaxRate

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item2Discount

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item3Name

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item3Description

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

item3Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item3Unit

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item3UnitPrice

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item3TaxRate

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item3Discount

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item4Name

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item4Description

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

item4Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item4Unit

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item4UnitPrice

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item4TaxRate

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item4Discount

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item5Name

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item5Description

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

item5Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item5Unit

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item5UnitPrice

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item5TaxRate

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item5Discount

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item6Name

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item6Description

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

item6Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item6Unit

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item6UnitPrice

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item6TaxRate

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item6Discount

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item7Name

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item7Description

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

item7Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item7Unit

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item7UnitPrice

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item7TaxRate

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item7Discount

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item8Name

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item8Description

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

item8Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item8Unit

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item8UnitPrice

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item8TaxRate

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item8Discount

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item9Name

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item9Description

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

item9Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item9Unit

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item9UnitPrice

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item9TaxRate

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item9Discount

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item10Name

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item10Description

Nein; falls verwendet fachlich prüfen

textarea

Wert oder passende Workflow-Variable

item10Quantity

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item10Unit

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item10UnitPrice

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item10TaxRate

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

item10Discount

Nein; falls verwendet fachlich prüfen

string

Wert oder passende Workflow-Variable

Fachliche Grenzen

Maximal zehn Positionen. CHF/EUR aus der tatsächlichen Quelle verwenden. Manuell nur net, gross oder vatfree; vatfree verlangt passende 0%-Positionen. Lexware-Sondersteuerarten, freie Steuerunterarten oder VAT-ID-Overrides werden nicht übernommen. Mengen und Einzelpreise unterstützen bis zu sechs Dezimalstellen; Währung und Summen müssen nach Abbildung übereinstimmen. Beleg-/Fristtage richten sich nach Europe/Zurich.

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.

← Zur Artikelübersicht