Oneflow
Buďte efektivnější díky skutečně digitálním kontraktem, které usnadňují práci a usnadňují život. Automatizace procesu správy kontraktů pomocí Oneflow
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logic Apps | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Power Automate | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Oneflow AB |
| URL | https://support.oneflow.com/ |
| support@oneflow.com |
| Metadata konektoru | |
|---|---|
| Vydavatel | Oneflow |
| Internetová stránka | https://oneflow.com |
| Zásady ochrany osobních údajů | https://oneflow.com/privacy-notice/ |
| Kategorie | Prodej a CRM; Produktivita |
Oneflow
Buďte efektivnější s skutečně digitálními kontrakty, které usnadňují práci a usnadňují život. Automatizujte proces správy kontraktů pomocí Oneflow.
Vydavatel: Oneflow AB
Požadavky
Pokud chcete používat konektor Oneflow, potřebujete aktivní účet správce Oneflow. Pokud ještě účet nemáte, pokračujte vytvořením zkušebního účtu.
Podporované operace
Akce
Vytvoření kontraktu
Vytvoří kontrakt z vybrané šablony.
Přidání účastníka ke smlouvě
Přidejte jednotlivce nebo účastníka založeného na společnosti do existující smlouvy.
Odstranění kontraktu
Odstraňte kontrakt.
Přidání příloh ke smlouvě
Přidejte do existujícího kontraktu rozbalený soubor PDF nebo běžnou přílohu.
Publikování kontraktu
Pošlete smlouvu všem signatářům prostřednictvím zadaného dodacího kanálu.
Stažení souborů kontraktů
Stáhněte si kopii podepsané smlouvy ve formátu PDF a všechny přílohy nebo ověřovací soubory existující smlouvy.
Ping Oneflow API
Zkontrolujte dostupnost rozhraní API Oneflow.
Triggers
Při aktualizaci kontraktu
Aktivujte tok na základě předem rozlišených událostí kontraktu.
Získání přihlašovacích údajů
Získání přihlašovacích údajů konektoru Oneflow:
Přihlaste se ke svému účtu Oneflow a přejděte k tokenům rozhraní API pro rozšíření > účtu > správce>.
V tomto rozšíření klikněte na Vygenerovat nový token a vložte ho do průvodce připojením ve vašem toku Power Automate.
Známé problémy a omezení
Registrace webhooku se v testovacím prostředí neodstraní.
Pokud se rozhodnete použít testovací prostředí Oneflow, existuje známý problém, když se webhook neodstraní ve vašem testovacím účtu Oneflow po odstranění toku nebo odebrání triggeru z toku. Webhooky by se měly ručně odstranit v testovacím účtu Oneflow jako alternativní řešení.
Kontaktujte nás
Naše webové stránky: https://oneflow.com/
Zákaznická podpora: https://support.oneflow.com
Prodej a ceny: https://oneflow.com/contact/
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| výchozí | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Klíč rozhraní API oneflow | securestring | Klíč rozhraní API pro toto rozhraní API | Pravdivé |
| E-mailová adresa | řetězec | E-mailová adresa uživatele Oneflow | Pravdivé |
| API URL | řetězec | Vyberte prostředí, ke kterému se chcete připojit. | Pravdivé |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
Akce
| Aktualizace datového pole |
Aktualizujte datové pole v konkrétní smlouvě podle jeho ID. |
| Nahrání příloh |
Přidání přílohy nebo dokumentu PDF ke smlouvě |
| Odstranění kontraktu |
Odstraňte konkrétní kontrakt podle jeho ID. |
| Ping |
Pomocí tohoto koncového bodu zkontrolujte, jestli je rozhraní API Oneflow k dispozici. |
| Publikování kontraktu |
Odešle smlouvu účastníkům pro podepsání. |
| Přidat účastníka |
Přidání účastníka do smlouvy |
| Přidání produktu do smlouvy |
Přidejte produkt do existující skupiny produktů ve smlouvě. |
| Stažení souboru kontraktu |
Načtěte konkrétní soubor kontraktu podle jeho ID. |
| Vytvoření kontraktu |
Vytvořte nový kontrakt založený na vybrané šabloně. |
| Získání podrobností o smlouvě |
Načtěte podrobnosti kontraktu podle jeho ID. |
| Získání stavu kontraktu |
Načtěte stav konkrétního kontraktu podle jeho ID. |
Aktualizace datového pole
Aktualizujte datové pole v konkrétní smlouvě podle jeho ID.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID smlouvy
|
contract_id | True | string |
ID smlouvy |
|
Vlastní ID
|
data_field_id | True | string |
Vlastní ID (externí klíč) datového pole |
|
Aktualizovat jako
|
x-oneflow-user-email-override | string |
Vyberte uživatele, který má tuto akci provést, nebo zadejte vlastní e-mail. |
|
|
Hodnota
|
value | string |
Hodnota, která se má nastavit pro datové pole |
|
|
Vlastní ID
|
custom_id | True | string |
Vlastní ID datového pole |
Návraty
- Body
- Datafield
Nahrání příloh
Přidání přílohy nebo dokumentu PDF ke smlouvě
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID smlouvy
|
contract_id | True | string |
ID smlouvy |
|
File
|
file | True | binary |
Soubor k nahrání Název souboru by měl být ve formátu file.ext. |
|
Nahrát jako
|
upload_as | string |
výběr typu přílohy k nahrání |
|
|
Spustit jako
|
x-oneflow-user-email-override | string |
Vyberte uživatele, který má tuto akci provést, nebo zadejte vlastní e-mail. |
Návraty
- response
- object
Odstranění kontraktu
Odstraňte konkrétní kontrakt podle jeho ID.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID smlouvy
|
contract_id | True | string |
ID smlouvy |
|
Odstranit jako
|
x-oneflow-user-email-override | string |
Vyberte uživatele, který má tuto akci provést, nebo zadejte vlastní e-mail. |
Návraty
- response
- string
Ping
Pomocí tohoto koncového bodu zkontrolujte, jestli je rozhraní API Oneflow k dispozici.
Návraty
- response
- object
Publikování kontraktu
Odešle smlouvu účastníkům pro podepsání.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID smlouvy
|
contract_id | True | string |
ID smlouvy |
|
Předmět
|
subject | string |
Předmět oznámení |
|
|
Message
|
message | string |
Zpráva s oznámením |
|
|
Publikovat jako
|
x-oneflow-user-email-override | string |
Vyberte uživatele, který má tuto akci provést, nebo zadejte vlastní e-mail. |
Návraty
- Body
- Contract
Přidat účastníka
Přidání účastníka do smlouvy
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID smlouvy
|
contract_id | True | string |
ID smlouvy |
|
Přidat jako
|
x-oneflow-user-email-override | string |
Vyberte uživatele, který má tuto akci provést, nebo zadejte vlastní e-mail. |
|
|
Typ účastníka
|
participant_type | True | string |
Jednotlivec nebo společnost |
|
Podpisová objednávka
|
signing_order | number |
Podepsání pořadí účastníků |
|
|
strana
|
party | True | dynamic |
Návraty
- response
- object
Přidání produktu do smlouvy
Přidejte produkt do existující skupiny produktů ve smlouvě.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID smlouvy
|
x-ms-oneflow-contract_id | True | integer |
ID smlouvy |
|
Produktová skupina
|
x-ms-oneflow-product-group-index | True | integer |
Vyberte index tabulky produktů, do které chcete produkty přidat. Objednáno shora dolů ve smlouvě. |
|
Produkt je uzamčen pro protějšky?
|
counterparty_lock | boolean |
Vyberte, jestli chcete, aby atributy produktu byly upravitelné protějšky. |
|
|
Popis produktu
|
description | string |
Přidejte podrobnosti o produktu. |
|
|
Název produktu
|
name | string |
Název produktu |
|
|
Množství
|
amount | string |
Základní částka produktu. |
|
|
Částka slevy
|
amount | string |
Diskontní částka jako číslo. |
|
|
1 Procento slevy
|
discount_percent | string |
Sleva jako procento základní částky. |
|
|
Množství
|
amount | string |
Hodnota sekundární ceny. tj. pokud má produkt poplatek za předplatné. |
|
|
Částka slevy
|
amount | string |
Sekundární diskontní částka jako číslo. |
|
|
2 Procento slevy
|
discount_percent | string |
Sekundární diskontní částka jako procento ceny 2. |
|
|
Množství
|
amount | number |
Jakékoli kladné číslo nebo 1/0, pokud je typ multiple_choice/single_choice |
|
|
Typ produktu
|
type | string |
Vyberte typ vstupního množství (tj. zaškrtávací políčko, číslo, jeden výběr). |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Stav kontraktu
|
state | string |
koncept, čeká na vyřízení, přesáhne, podepsáno/ odmítnuto |
|
Doba aktualizace stavu kontraktu
|
state_updated_time | string | |
|
Doba aktualizace kontraktu
|
updated_time | string |
Stažení souboru kontraktu
Načtěte konkrétní soubor kontraktu podle jeho ID.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Stáhnout jako
|
x-oneflow-user-email-override | string |
Vyberte uživatele, který má tuto akci provést, nebo zadejte vlastní e-mail. |
|
|
ID smlouvy
|
contract_id | True | string |
ID smlouvy |
|
ID souboru
|
file_id | True | string |
Typ souboru: * 1 - Smlouva PDF * 2 - Ověření |
Návraty
- Obsah souboru
- binary
Vytvoření kontraktu
Vytvořte nový kontrakt založený na vybrané šabloně.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Vytvořit jako
|
x-oneflow-user-email |
Zadejte e-mail uživatele Oneflow. Akce vytvoří kontrakt jako tento uživatel. |
||
|
Název smlouvy
|
name | string | ||
|
Název pracovního prostoru
|
workspace_id | True | integer |
Výběr pracovního prostoru pro kontrakt |
|
Název šablony
|
template_id | True | integer |
Vyberte šablonu, ze které chcete vytvořit kontrakt. |
|
Datové pole
|
custom_id | True | string |
Vyberte datové pole, které chcete naplnit. |
|
Hodnota
|
value | string |
Hodnota datového pole |
Návraty
- Body
- Contract
Získání podrobností o smlouvě
Načtěte podrobnosti kontraktu podle jeho ID.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID smlouvy
|
contract_id | True | string |
ID smlouvy |
Návraty
- Body
- Contract
Získání stavu kontraktu
Načtěte stav konkrétního kontraktu podle jeho ID.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID smlouvy
|
contract_id | True | string |
ID smlouvy |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Stav kontraktu
|
state | string |
koncept, čeká na vyřízení, přesáhne, podepsáno/ odmítnuto |
|
Doba aktualizace stavu kontraktu
|
state_updated_time | string | |
|
Doba aktualizace kontraktu
|
updated_time | string |
Aktivační události
| Při aktualizaci kontraktu |
Registrace webhooku pro zadanou událost aktualizace kontraktu |
Při aktualizaci kontraktu
Registrace webhooku pro zadanou událost aktualizace kontraktu
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Typ aktualizace
|
filters | True | array of string | |
|
ID skupiny šablon
|
template_group_id | integer |
(Volitelné) Filtrování kontraktů podle skupiny šablon |
Návraty
- Body
- Webhook_Event
Definice
Contract
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Oprávnění k odstranění smlouvy
|
_permissions.contract:delete | boolean |
Uživatel může odstranit kontrakt |
|
Název smlouvy
|
_private.name | string | |
|
Hodnota kontraktu
|
_private.value.amount | string | |
|
Měna
|
_private.value.currency | string | |
|
ID pracovního prostoru
|
_private.workspace_id | integer | |
|
Čas vytvoření kontraktu
|
_private_ownerside.created_time | string | |
|
ID šablony
|
_private_ownerside.template_id | integer | |
|
Může přijímat přílohy
|
available_options.can_receive_attachments | boolean |
Smlouva může přijímat přílohy |
|
Může přijímat rozbalené PDF
|
available_options.can_receive_expanded_pdf | boolean |
Kontrakt může dostat rozbalený PDF |
|
Datové pole
|
data_fields | array of object |
Shromažďování datových polí |
|
čas vytvoření
|
data_fields._private_ownerside.created_time | string |
Datové pole created_time |
|
vlastní ID
|
data_fields._private_ownerside.custom_id | string |
Custom_id datového pole |
|
Aktualizovaný čas
|
data_fields._private_ownerside.updated_time | string |
Updated_time datového pole |
|
popis
|
data_fields.description | string |
Popis datového pole |
|
identifikační číslo
|
data_fields.id | integer |
ID datového pole |
|
název
|
data_fields.name | string |
Název datového pole |
|
zástupný symbol
|
data_fields.placeholder | string |
Zástupný symbol datového pole |
|
value
|
data_fields.value | string |
Hodnota datového pole |
|
ID smlouvy
|
id | integer |
ID smlouvy |
|
Čas ukončení smlouvy
|
lifecycle_state.contract_end_time | string | |
|
Čas zahájení smlouvy
|
lifecycle_state.contract_start_time | string | |
|
Čas zrušení smlouvy
|
lifecycle_state.cancel_time | string | |
|
Smlouva skončila ukončením?
|
lifecycle_state.has_ended_by_termination | boolean | |
|
Uplynul čas zahájení období oznámení?
|
lifecycle_state.has_passed_notice_period_start_time | boolean | |
|
Je zrušena smlouva.
|
lifecycle_state.is_canceled | boolean | |
|
Je opakované kontrakty
|
lifecycle_state.is_recurring | boolean | |
|
Stav životního cyklu
|
lifecycle_state.lifecycle_state | string |
čekání/ aktivní/ukončeno |
|
Čas aktualizace stavu životního cyklu
|
lifecycle_state.lifecycle_state_updated_time | string | |
|
strany
|
parties | array of Party |
Kolekce party |
|
Skupiny produktů
|
product_groups | array of Product_Group |
kolekce product_groups |
|
Doba publikování kontraktu
|
published_time | string | |
|
Doba vypršení platnosti podpisu smlouvy
|
signing_period_expiry_time | string | |
|
Stav kontraktu
|
state | string |
koncept, čeká na vyřízení, přesáhne, podepsáno/ odmítnuto |
|
Doba aktualizace stavu kontraktu
|
state_updated_time | string | |
|
Doba aktualizace kontraktu
|
updated_time | string |
Strana
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Kód země strany
|
country_code | string | |
|
Identifikační číslo strany
|
identification_number | string |
Identifikační číslo strany |
|
Je můj večírek
|
my_party | boolean |
Smluvní strana je my_party |
|
Název strany
|
name | string | |
|
účastníci
|
participants | array of Participant |
Kolekce účastníků |
|
Typ strany
|
type | string |
společnost nebo jednotlivec |
|
účastník
|
participant | Individual_Participant |
Objekt jednotlivého účastníka |
Účastník
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Může účastník aktualizovat smlouvu?
|
_permissions.contract:update | boolean | |
|
Čas první návštěvy účastníka
|
_private_ownerside.first_visited_time | string | |
|
Čas poslední návštěvy účastníka
|
_private_ownerside.last_visited_time | string | |
|
Počet návštěv účastníků
|
_private_ownerside.visits | integer | |
|
Kanál pro doručování účastníků
|
delivery_channel | string |
email/none/same_device/sms |
|
Stav doručení účastníka
|
delivery_status | string |
not_sent/pending/failure/bounce/success/opened |
|
E-mail účastníka
|
string | ||
|
Identifikační číslo účastníka
|
identification_number | string |
Identifikační číslo účastníka |
|
Účastník je my_participant
|
my_participant | boolean | |
|
Jméno účastníka
|
name | string | |
|
Účastník je organizátor
|
organizer | boolean | |
|
Telefonní číslo účastníka
|
phone_number | string | |
|
Metoda podpisu účastníka
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
Stav znaménka účastníka
|
sign_state | string |
nedecided/signed/declined |
|
Čas aktualizace stavu podpisu účastníka
|
sign_state_updated_time | string |
sign_state_updated_time |
|
Účastník je signatář
|
signatory | boolean | |
|
Název účastníka
|
title | string | |
|
Metoda 2FA účastníka
|
two_step_authentication_method | string |
e-mail/sms/none |
Individual_Participant
Objekt jednotlivého účastníka
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Individuální účastník může aktualizovat smlouvu
|
_permissions.contract:update | boolean |
contract:update permissions for Individual Participant |
|
Individuální účastník poprvé navštíví
|
_private_ownerside.first_visited_time | string | |
|
Čas poslední návštěvy jednotlivého účastníka
|
_private_ownerside.last_visited_time | string | |
|
Individuální účastník aktualizoval čas
|
_private_ownerside.updated_time | string | |
|
Počet návštěv jednotlivých účastníků
|
_private_ownerside.visits | integer | |
|
Kanál doručování jednotlivých účastníků
|
delivery_channel | string |
email/none/same_device/sms |
|
Stav doručení jednotlivých účastníků
|
delivery_status | string |
not_sent/pending/failure/bounce/success/opened |
|
E-mail jednotlivých účastníků
|
string | ||
|
Identifikační číslo jednotlivého účastníka
|
identification_number | string | |
|
Individuální účastník je my_participant
|
my_participant | boolean | |
|
Jméno jednotlivého účastníka
|
name | string | |
|
Individuální účastník je organizátor
|
organizer | boolean | |
|
Telefonní číslo jednotlivého účastníka
|
phone_number | string | |
|
Metoda podepisování jednotlivých účastníků
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
Stav podpisu jednotlivého účastníka
|
sign_state | string |
nedecided/signed/declined |
|
Čas aktualizace stavu podepsání jednotlivého účastníka
|
sign_state_updated_time | string | |
|
Jednotlivý účastník je signatářem
|
signatory | boolean | |
|
Název jednotlivého účastníka
|
title | string | |
|
Metoda 2FA jednotlivého účastníka
|
two_step_authentication_method | string |
e-mail/sms/none |
Product_Group
položka product_group v kolekci product_groups
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID produktové skupiny
|
id | integer | |
|
Products
|
products | array of Product |
kolekce produktů |
Product
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
uzamčeno pro protistrany?
|
counterparty_lock | boolean |
counterparty_lock |
|
popis
|
description | string | |
|
identifikační číslo
|
id | integer | |
|
název
|
name | string | |
|
částky
|
price_1.amount.amount | string |
Hodnota částky ceny 1 |
|
základní částka
|
price_1.base_amount.amount | string |
Hodnota částky ceny 1 |
|
diskontní částka
|
price_1.discount_amount.amount | string |
Diskontní částka ceny 1 |
|
discount percent
|
price_1.discount_percent | string |
Procento slevy z ceny 1 |
|
částky
|
price_2.amount.amount | string |
Hodnota částky ceny 2 |
|
základní částka
|
price_2.base_amount.amount | string |
Základní hodnota částky ceny 2 |
|
diskontní částka
|
price_2.discount_amount.amount | string |
Diskontní částka ceny 2 |
|
discount Percent
|
price_2.discount_percent | string |
Procento slevy z ceny 2 |
|
částky
|
quantity.amount | number | |
|
typ
|
quantity.type | string |
quantity/multiple_choice/single_choice |
Datové pole
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID datového pole
|
id | number |
ID datového pole |
|
Hodnota
|
value | string |
Hodnota datového pole |
|
Popis datového pole
|
description | string |
Popis datového pole |
|
Název datového pole
|
name | string |
Název datového pole |
|
Zástupný symbol datafieldu
|
placeholder | string | |
|
Vlastní ID
|
_private_ownerside.custom_id | string |
Vlastní ID datového pole |
|
Čas vytvoření datafieldu
|
_private_ownerside.created_time | string | |
|
Aktualizovaný čas datafieldu
|
_private_ownerside.updated_time | string |
Webhook_Event
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID smlouvy
|
contract.id | number |
ID smlouvy |
|
ID zpětného volání
|
callback_id | string |
ID zpětného volání |
|
events
|
events | array of object | |
|
Čas vytvoření události
|
events.created_time | date-time | |
|
ID události
|
events.id | number | |
|
Typ události
|
events.type | string | |
|
Signature
|
events.signature | string |
objekt
Toto je typ "object".
řetězec
Toto je základní datový typ String.
binární
Toto je základní datový typ Binary.