Freigeben über


Oneflow

Seien Sie effektiver mit wirklich digitalen Verträgen, die Arbeit schneller machen und das Leben einfacher machen. Automatisieren Des Vertragsverwaltungsprozesses mit Oneflow

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Oneflow AB
URL https://support.oneflow.com/
Email support@oneflow.com
Connectormetadaten
Herausgeber Oneflow
Webseite https://oneflow.com
Datenschutzrichtlinie https://oneflow.com/privacy-notice/
Kategorien Vertrieb und CRM; Produktivität

Oneflow

Seien Sie effektiver mit wirklich digitalen Verträgen, die Arbeit schneller und einfacher machen. Automatisieren Sie Ihren Vertragsverwaltungsprozess mit Oneflow.

Herausgeber: Oneflow AB

Voraussetzungen

Um den Oneflow-Connector zu verwenden, benötigen Sie ein aktives Oneflow-Administratorkonto. Wenn Sie noch kein Konto haben, fahren Sie fort, und erstellen Sie ein Testkonto.

Unterstützte Vorgänge

Aktionen

Erstellen eines Vertrags

Erstellen Sie einen Vertrag aus einer ausgewählten Vorlage.

Hinzufügen eines Teilnehmers zum Vertrag

Fügen Sie einen einzelnen oder einen unternehmensbasierten Teilnehmer zu einem vorhandenen Vertrag hinzu.

Vertrag löschen

Löschen sie einen Vertrag.

Hinzufügen von Anlagen zum Vertrag

Hinzufügen einer erweiterten PDF-Datei oder einer regulären Anlage zu einem vorhandenen Vertrag.

Vertrag veröffentlichen

Senden Sie einen Vertrag an alle Unterzeichner über einen angegebenen Übermittlungskanal.

Herunterladen von Vertragsdateien

Laden Sie eine PDF-Kopie eines signierten Vertrags und eine Anlage- oder Überprüfungsdatei eines bestehenden Vertrags herunter.

Ping-Oneflow-API

Überprüfen Sie die Verfügbarkeit der Oneflow-API.

Auslöser

Wenn ein Vertrag aktualisiert wird

Lösen Sie Ihren Fluss basierend auf vordefinierten Vertragsereignissen aus.

Abrufen von Anmeldeinformationen

So rufen Sie die Anmeldeinformationen des Oneflow-Connectors ab:

  1. Melden Sie sich bei Ihrem Oneflow-Konto an, und fahren Sie mit den API-Token der Administratorkontoerweiterung >>> fort.

  2. Klicken Sie in dieser Erweiterung auf "Neues Token generieren", und fügen Sie das Token in Ihren Power Automate Flow in den Verbindungs-Assistenten ein.

Bekannte Probleme und Einschränkungen

Die Webhook-Registrierung wird in der Testumgebung nicht gelöscht.

Wenn Sie sich für die Verwendung der Oneflow-Testumgebung entscheiden, gibt es ein bekanntes Problem, wenn ein Webhook nicht in Ihrem Oneflow-Testkonto gelöscht wird, nachdem Sie einen Fluss gelöscht oder einen Trigger aus einem Fluss entfernt haben. Webhooks sollten manuell in Ihrem Oneflow-Testkonto als Problemumgehung gelöscht werden.

Kontaktieren Sie uns

Unsere Website: https://oneflow.com/

Kundensupport: https://support.oneflow.com

Vertrieb und Preise: https://oneflow.com/contact/

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
Oneflow-API-Schlüssel securestring Der API-Schlüssel für diese API Richtig
E-Mail-Adresse Schnur E-Mail-Adresse des Oneflow-Benutzers Richtig
API-URL Schnur Wählen Sie die Umgebung aus, mit der Sie eine Verbindung herstellen möchten. Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abrufen des Status eines Vertrags

Rufen Sie den Status eines bestimmten Vertrags anhand ihrer ID ab.

Abrufen von Vertragsdetails

Rufen Sie die Details eines Vertrags anhand der ID ab.

Aktualisieren eines Datenfelds

Aktualisieren Eines Datenfelds im spezifischen Vertrag anhand seiner ID.

Erstellen eines Vertrags

Erstellen Sie einen neuen Vertrag basierend auf der ausgewählten Vorlage.

Herunterladen einer Vertragsdatei

Rufen Sie eine bestimmte Vertragsdatei anhand ihrer ID ab.

Hinzufügen eines Produkts zu einem Vertrag

Fügen Sie ein Produkt zu einer vorhandenen Produktgruppe in einem Vertrag hinzu.

Hochladen von Anlagen

Hinzufügen einer Anlage oder eines PDF-Dokuments zu einem Vertrag.

Löschen eines Vertrags

Löschen Sie einen bestimmten Vertrag anhand ihrer ID.

Ping

Verwenden Sie diesen Endpunkt, um zu überprüfen, ob die Oneflow-API verfügbar ist.

Teilnehmer hinzufügen

Hinzufügen eines Teilnehmers zum Vertrag

Veröffentlichen eines Vertrags

Sendet vertrag an Teilnehmer zur Unterzeichnung.

Abrufen des Status eines Vertrags

Rufen Sie den Status eines bestimmten Vertrags anhand ihrer ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vertrags-ID
contract_id True string

Vertrags-ID

Gibt zurück

Name Pfad Typ Beschreibung
Vertragsstatus
state string

Entwurf/ausstehend/überfällig/signiert/abgelehnt

Vertragsstatusaktualisierungszeit
state_updated_time string
Vertragsaktualisierungszeit
updated_time string

Abrufen von Vertragsdetails

Rufen Sie die Details eines Vertrags anhand der ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vertrags-ID
contract_id True string

Vertrags-ID

Gibt zurück

Body
Contract

Aktualisieren eines Datenfelds

Aktualisieren Eines Datenfelds im spezifischen Vertrag anhand seiner ID.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vertrags-ID
contract_id True string

Vertrags-ID

Benutzerdefinierte ID
data_field_id True string

Benutzerdefinierte ID (externer Schlüssel) des Datenfelds.

Aktualisieren unter
x-oneflow-user-email-override string

Wählen Sie den Benutzer aus, um diese Aktion auszuführen, oder geben Sie eine benutzerdefinierte E-Mail ein.

Wert
value string

Wert, der für das Datenfeld festgelegt werden soll.

Benutzerdefinierte ID
custom_id True string

Benutzerdefinierte ID des Datenfelds

Gibt zurück

Body
Datafield

Erstellen eines Vertrags

Erstellen Sie einen neuen Vertrag basierend auf der ausgewählten Vorlage.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Erstellen als
x-oneflow-user-email email

Geben Sie die E-Mail-Adresse des Oneflow-Benutzers an. Die Aktion erstellt einen Vertrag als dieser Benutzer.

Vertragsname
name string
Arbeitsbereichsname
workspace_id True integer

Auswählen eines Arbeitsbereichs für Ihren Vertrag

Vorlagenname
template_id True integer

Wählen Sie eine Vorlage aus, aus der Sie Ihren Vertrag erstellen möchten.

Datenfeld
custom_id True string

Auswählen des zu füllenden Datenfelds

Wert
value string

Datafield-Wert

Gibt zurück

Body
Contract

Herunterladen einer Vertragsdatei

Rufen Sie eine bestimmte Vertragsdatei anhand ihrer ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Herunterladen als
x-oneflow-user-email-override string

Wählen Sie den Benutzer aus, um diese Aktion auszuführen, oder geben Sie eine benutzerdefinierte E-Mail ein.

Vertrags-ID
contract_id True string

Vertrags-ID

Datei-ID
file_id True string

Dateityp: * 1 - Vertrags-PDF * 2 - Überprüfung

Gibt zurück

Inhalt der Datei
binary

Hinzufügen eines Produkts zu einem Vertrag

Fügen Sie ein Produkt zu einer vorhandenen Produktgruppe in einem Vertrag hinzu.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vertrags-ID
x-ms-oneflow-contract_id True integer

Vertrags-ID

Produktgruppe
x-ms-oneflow-product-group-index True integer

Wählen Sie den Produkttabellenindex aus, dem die Produkte hinzugefügt werden sollen. Sortiert von oben nach unten im Vertrag.

Produkt gesperrt für Gegenparteien?
counterparty_lock boolean

Wählen Sie aus, ob die Produktattribute von Gegenparteien bearbeitet werden sollen.

Produktbeschreibung
description string

Fügen Sie Details zum Produkt hinzu.

Produktname
name string

Name des Produkts.

Betrag
amount string

Basisbetrag für das Produkt.

Rabattbetrag
amount string

Rabattbetrag als Zahl.

1 Rabatt prozent
discount_percent string

Rabatt als Prozentsatz des Basisbetrags.

Betrag
amount string

Sekundärer Preiswert. d. h., wenn das Produkt über eine Abonnementgebühr verfügt.

Rabattbetrag
amount string

Sekundärer Rabattbetrag als Zahl.

2 Rabatt prozent
discount_percent string

Sekundärer Rabattbetrag als Prozentsatz des Preises 2.

Betrag
amount number

Beliebige positive Zahl oder 1/0, wenn der Typ multiple_choice/single_choice

Produkttyp
type string

Wählen Sie einen Eingabetyp der Menge aus (z. B. ein Kontrollkästchen, eine Zahl, einzelne Auswahl).

Gibt zurück

Name Pfad Typ Beschreibung
Vertragsstatus
state string

Entwurf/ausstehend/überfällig/signiert/abgelehnt

Vertragsstatusaktualisierungszeit
state_updated_time string
Vertragsaktualisierungszeit
updated_time string

Hochladen von Anlagen

Hinzufügen einer Anlage oder eines PDF-Dokuments zu einem Vertrag.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vertrags-ID
contract_id True string

Vertrags-ID

Datei
file True binary

Datei hochzuladen. Der Dateiname sollte sich im Format "file.ext" befinden.

Hochladen als
upload_as string

Wählen Sie den Typ der Anlage aus, die hochgeladen werden soll.

Ausführen unter
x-oneflow-user-email-override string

Wählen Sie den Benutzer aus, um diese Aktion auszuführen, oder geben Sie eine benutzerdefinierte E-Mail ein.

Gibt zurück

response
object

Löschen eines Vertrags

Löschen Sie einen bestimmten Vertrag anhand ihrer ID.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vertrags-ID
contract_id True string

Vertrags-ID

Löschen unter
x-oneflow-user-email-override string

Wählen Sie den Benutzer aus, um diese Aktion auszuführen, oder geben Sie eine benutzerdefinierte E-Mail ein.

Gibt zurück

response
string

Ping

Verwenden Sie diesen Endpunkt, um zu überprüfen, ob die Oneflow-API verfügbar ist.

Gibt zurück

response
object

Teilnehmer hinzufügen

Hinzufügen eines Teilnehmers zum Vertrag

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vertrags-ID
contract_id True string

Vertrags-ID

Hinzufügen unter
x-oneflow-user-email-override string

Wählen Sie den Benutzer aus, um diese Aktion auszuführen, oder geben Sie eine benutzerdefinierte E-Mail ein.

Teilnehmertyp
participant_type True string

Einzel-/Unternehmen

Signierreihenfolge
signing_order number

Signierreihenfolge des Teilnehmers

Partei
party True dynamic

Gibt zurück

response
object

Veröffentlichen eines Vertrags

Sendet vertrag an Teilnehmer zur Unterzeichnung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vertrags-ID
contract_id True string

Vertrags-ID

Betreff
subject string

Benachrichtigungsbetreff

Nachricht
message string

Benachrichtigung

Veröffentlichen unter
x-oneflow-user-email-override string

Wählen Sie den Benutzer aus, um diese Aktion auszuführen, oder geben Sie eine benutzerdefinierte E-Mail ein.

Gibt zurück

Body
Contract

Auslöser

Wenn ein Vertrag aktualisiert wird

Registrieren eines Webhooks für ein angegebenes Vertragsaktualisierungsereignis

Wenn ein Vertrag aktualisiert wird

Registrieren eines Webhooks für ein angegebenes Vertragsaktualisierungsereignis

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aktualisierungstyp
filters True array of string
Vorlagengruppen-ID
template_group_id integer

(Optional) Filtern von Verträgen nach einer Vorlagengruppe.

Gibt zurück

Definitionen

Vertrag

Name Pfad Typ Beschreibung
Berechtigung zum Löschen eines Vertrags
_permissions.contract:delete boolean

Der Benutzer kann vertrag löschen

Vertragsname
_private.name string
Vertragswert
_private.value.amount string
Währung
_private.value.currency string
Arbeitsbereichs-ID
_private.workspace_id integer
Vertragserstellungszeit
_private_ownerside.created_time string
Vorlagen-ID
_private_ownerside.template_id integer
Kann Anlagen empfangen
available_options.can_receive_attachments boolean

Vertrag kann Anlagen empfangen

Erweiterte PDF-Datei empfangen
available_options.can_receive_expanded_pdf boolean

Vertrag kann erweiterte PDF empfangen

Datenfeld
data_fields array of object

Datenfeldersammlung

Erstellungszeit
data_fields._private_ownerside.created_time string

Datenfeld created_time

Benutzerdefinierte ID
data_fields._private_ownerside.custom_id string

Datenfeld custom_id

Aktualisierte Zeit
data_fields._private_ownerside.updated_time string

Datenfeld updated_time

Beschreibung
data_fields.description string

Beschreibung des Datenfelds

id
data_fields.id integer

Datenfeld-ID

name
data_fields.name string

Name des Datenfelds

Platzhalter
data_fields.placeholder string

Platzhalter für Datenfelder

value
data_fields.value string

Datenfeldwert

Vertrags-ID
id integer

Vertrags-ID

Vertragsendzeit
lifecycle_state.contract_end_time string
Vertragsanfangszeit
lifecycle_state.contract_start_time string
Kündigungszeit des Vertrags
lifecycle_state.cancel_time string
Der Vertrag wurde durch Kündigung beendet?
lifecycle_state.has_ended_by_termination boolean
Ist die Kündigungsfrist abgelaufen?
lifecycle_state.has_passed_notice_period_start_time boolean
Der Vertrag wird storniert.
lifecycle_state.is_canceled boolean
Ist Vertragsserie
lifecycle_state.is_recurring boolean
Lebenszyklusstatus
lifecycle_state.lifecycle_state string

awaiting/active/ended

Aktualisierungszeit des Lebenszyklusstatus
lifecycle_state.lifecycle_state_updated_time string
Parteien
parties array of Party

Party-Sammlung

Produktgruppen
product_groups array of Product_Group

product_groups Sammlung

Vertragsveröffentlichungszeit
published_time string
Ablaufzeit der Vertragsunterzeichnung
signing_period_expiry_time string
Vertragsstatus
state string

Entwurf/ausstehend/überfällig/signiert/abgelehnt

Vertragsstatusaktualisierungszeit
state_updated_time string
Vertragsaktualisierungszeit
updated_time string

Partei

Name Pfad Typ Beschreibung
Ländercode der Partei
country_code string
Parteiidentifikationsnummer
identification_number string

Identifikationsnummer der Partei

Ist meine Partei
my_party boolean

Vertragspartner ist my_party

Parteiname
name string
Teilnehmer
participants array of Participant

Participants-Sammlung

Partytyp
type string

Firma/Einzelperson

Teilnehmer
participant Individual_Participant

Einzelnes Teilnehmerobjekt

Teilnehmer

Name Pfad Typ Beschreibung
Kann der Vertrag für die Teilnehmeraktualisierung abgeschlossen werden?
_permissions.contract:update boolean
Erstmaliger Besuch des Teilnehmers
_private_ownerside.first_visited_time string
Zeitpunkt des letzten Besuchs des Teilnehmers
_private_ownerside.last_visited_time string
Anzahl der Teilnehmerbesuche
_private_ownerside.visits integer
Teilnehmerübermittlungskanal
delivery_channel string

email/none/same_device/sms

Status der Teilnehmerzustellung
delivery_status string

not_sent/ausstehend/fehler/unzustellbarkeit/erfolg/geöffnet

Teilnehmer-E-Mail
email string
Teilnehmeridentifikationsnummer
identification_number string

Teilnehmeridentifikationsnummer

Teilnehmer ist my_participant
my_participant boolean
Teilnehmername
name string
Teilnehmer ist Organisator
organizer boolean
Telefonnummer des Teilnehmers
phone_number string
Teilnehmerzeichenmethode
sign_method string

standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid

Teilnehmerzeichenstatus
sign_state string

nicht aktiviert/signiert/abgelehnt

Aktualisierungszeit des Teilnehmeranmeldungsstatus
sign_state_updated_time string

sign_state_updated_time

Teilnehmer ist signativ
signatory boolean
Teilnehmertitel
title string
Teilnehmer 2FA-Methode
two_step_authentication_method string

email/sms/none

Individual_Participant

Einzelnes Teilnehmerobjekt

Name Pfad Typ Beschreibung
Einzelner Teilnehmer kann vertrag aktualisieren
_permissions.contract:update boolean

contract:update permissions for Individual Participant

Erstmaliger Besuch eines einzelnen Teilnehmers
_private_ownerside.first_visited_time string
Letzter Besuchszeit eines einzelnen Teilnehmers
_private_ownerside.last_visited_time string
Aktualisierungszeit einzelner Teilnehmer
_private_ownerside.updated_time string
Anzahl der Besuche einzelner Teilnehmer
_private_ownerside.visits integer
Übermittlungskanal einzelner Teilnehmer
delivery_channel string

email/none/same_device/sms

Zustellungsstatus einzelner Teilnehmer
delivery_status string

not_sent/ausstehend/fehler/unzustellbarkeit/erfolg/geöffnet

E-Mail-Adresse einzelner Teilnehmer
email string
Identifikationsnummer eines einzelnen Teilnehmers
identification_number string
Einzelner Teilnehmer ist my_participant
my_participant boolean
Name einzelner Teilnehmer
name string
Einzelner Teilnehmer ist Organisator
organizer boolean
Telefonnummer einzelner Teilnehmer
phone_number string
Signiermethode für einzelne Teilnehmer
sign_method string

standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid

Anmeldestatus eines einzelnen Teilnehmers
sign_state string

nicht aktiviert/signiert/abgelehnt

Aktualisierungszeit des Status des einzelnen Teilnehmerzeichens
sign_state_updated_time string
Einzelner Teilnehmer ist signativ
signatory boolean
Titel einzelner Teilnehmer
title string
Einzelteilnehmer 2FA-Methode
two_step_authentication_method string

email/sms/none

Product_Group

product_group Element in product_groups Sammlung

Name Pfad Typ Beschreibung
Produktgruppen-ID
id integer
Products
products array of Product

Produktsammlung

Produkt

Name Pfad Typ Beschreibung
für Gegenparteien gesperrt?
counterparty_lock boolean

counterparty_lock

Beschreibung
description string
id
id integer
name
name string
Menge
price_1.amount.amount string

Betragswert des Preises 1

Basisbetrag
price_1.base_amount.amount string

Betragswert des Preises 1

Rabattbetrag
price_1.discount_amount.amount string

Rabattbetrag von Preis 1

Rabatt prozent
price_1.discount_percent string

Rabatt prozent des Preises 1

Menge
price_2.amount.amount string

Betragswert des Preises 2

Basisbetrag
price_2.base_amount.amount string

Grundbetragswert des Preises 2

Rabattbetrag
price_2.discount_amount.amount string

Rabattbetrag 2

Rabatt prozent
price_2.discount_percent string

Rabatt prozent des Preises 2

Menge
quantity.amount number
type
quantity.type string

Menge/multiple_choice/single_choice

Datenfeld

Name Pfad Typ Beschreibung
Datenfeld-ID
id number

Datenfeld-ID

Wert
value string

Datafield-Wert

Beschreibung des Datenfelds
description string

Beschreibung des Datenfelds

Name des Datenfelds
name string

Name des Datenfelds

Platzhalter für Datenfelder
placeholder string
Benutzerdefinierte ID
_private_ownerside.custom_id string

Benutzerdefinierte ID des Datenfelds

Erstellungszeit des Datenfelds
_private_ownerside.created_time string
Datenfeld wurde aktualisiert
_private_ownerside.updated_time string

Webhook_Event

Name Pfad Typ Beschreibung
Vertrags-ID
contract.id number

Vertrags-ID

Rückruf-ID
callback_id string

Rückruf-ID

events
events array of object
Erstellungszeit des Ereignisses
events.created_time date-time
Ereignis-ID
events.id number
Ereignistyp
events.type string
Signature
events.signature string

Objekt

Dies ist der Typ 'object'.

Schnur

Dies ist der grundlegende Datentyp "string".

binär

Dies ist der grundlegende Datentyp "binary".