Udostępnij przez


Jeden przepływ

Bądź bardziej skuteczny dzięki naprawdę kontraktom cyfrowym, które przyspieszają pracę i ułatwiają życie. Automatyzowanie procesu zarządzania kontraktami za pomocą usługi Oneflow

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Oneflow AB
adres URL https://support.oneflow.com/
Email support@oneflow.com
Metadane łącznika
Publisher Jeden przepływ
Witryna internetowa https://oneflow.com
Zasady ochrony prywatności https://oneflow.com/privacy-notice/
Kategorie Sprzedaż i CRM; Produktywność

Jeden przepływ

Bądź bardziej skuteczny dzięki naprawdę kontraktom cyfrowym, które ułatwiają pracę i życie. Zautomatyzuj proces zarządzania kontraktem za pomocą usługi Oneflow.

Wydawca: Oneflow AB

Wymagania wstępne

Aby korzystać z łącznika usługi Oneflow, potrzebujesz aktywnego konta administratora usługi Oneflow. Jeśli nie masz jeszcze konta, utwórz konto próbne.

Obsługiwane operacje

Czynności

Tworzenie kontraktu

Utwórz kontrakt na podstawie wybranego szablonu.

Dodawanie uczestnika do umowy

Dodaj osobę lub uczestnika opartego na firmie do istniejącego kontraktu.

Usuwanie kontraktu

Usuwanie kontraktu.

Dodawanie załączników do kontraktu

Dodaj rozszerzony plik PDF lub zwykły załącznik do istniejącego kontraktu.

Publikowanie kontraktu

Wyślij umowę do wszystkich sygnatariuszy za pośrednictwem określonego kanału dostarczania.

Pobieranie plików kontraktów

Pobierz kopię pliku PDF podpisanej umowy oraz dowolny załącznik lub plik weryfikacyjny istniejącego kontraktu.

Ping Oneflow API

Sprawdź dostępność interfejsu API platformy Oneflow.

Triggers

Po zaktualizowaniu kontraktu

Wyzwalaj przepływ na podstawie wstępnie określonych zdarzeń kontraktu.

Uzyskiwanie poświadczeń

Aby uzyskać poświadczenia łącznika oneflow:

  1. Zaloguj się do konta usługi Oneflow i przejdź do pozycji Tokeny interfejsu API rozszerzenia > konta > administratora>.

  2. Kliknij pozycję Wygeneruj nowy token w tym rozszerzeniu i wklej token do kreatora połączeń w usłudze Power Automate Flow.

Znane problemy i ograniczenia

Rejestracja elementu webhook nie jest usuwana w środowisku testowym

Jeśli zdecydujesz się używać środowiska testowego platformy Oneflow, występuje znany problem, gdy element webhook nie zostanie usunięty na koncie testowym platformy Oneflow po usunięciu przepływu lub usunięciu wyzwalacza z przepływu. Elementy webhook powinny zostać ręcznie usunięte na koncie testowym platformy Oneflow jako obejście problemu.

Skontaktuj się z nami

Nasza witryna internetowa: https://oneflow.com/

Obsługa klienta: https://support.oneflow.com

Sprzedaż i cennik: https://oneflow.com/contact/

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: Wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Klucz interfejsu API platformy Oneflow securestring Klucz interfejsu API dla tego interfejsu API Prawda
Adres e-mail ciąg Adres e-mail użytkownika aplikacji Oneflow Prawda
API URL ciąg Wybierz środowisko, z którym chcesz nawiązać połączenie. Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Aktualizowanie pola danych

Zaktualizuj pole danych w określonym kontrakcie według jego identyfikatora.

Dodaj uczestnika

Dodawanie uczestnika do umowy

Dodawanie produktu do kontraktu

Dodaj produkt do istniejącej grupy produktów w umowie.

Ping

Użyj tego punktu końcowego, aby sprawdzić, czy interfejs API platformy Oneflow jest dostępny.

Pobieranie pliku kontraktu

Pobierz określony plik kontraktu według jego identyfikatora.

Pobieranie stanu kontraktu

Pobierz stan określonego kontraktu według jego identyfikatora.

Pobieranie szczegółów kontraktu

Pobierz szczegóły kontraktu według jego identyfikatora.

Przekazywanie załączników

Dodaj załącznik lub dokument PDF do kontraktu.

Publikowanie kontraktu

Wysyła umowę do uczestników do podpisania.

Tworzenie kontraktu

Utwórz nowy kontrakt na podstawie wybranego szablonu.

Usuwanie kontraktu

Usuń określony kontrakt według jego identyfikatora.

Aktualizowanie pola danych

Zaktualizuj pole danych w określonym kontrakcie według jego identyfikatora.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontraktu
contract_id True string

Identyfikator kontraktu

Identyfikator niestandardowy
data_field_id True string

Identyfikator niestandardowy (klucz zewnętrzny) pola danych.

Aktualizuj jako
x-oneflow-user-email-override string

Wybierz użytkownika, aby wykonać tę akcję jako lub wprowadź niestandardową wiadomość e-mail

Wartość
value string

Wartość ustawiona dla pola danych.

Identyfikator niestandardowy
custom_id True string

Identyfikator niestandardowy pola danych

Zwraca

Body
Datafield

Dodaj uczestnika

Dodawanie uczestnika do umowy

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontraktu
contract_id True string

Identyfikator kontraktu

Dodaj jako
x-oneflow-user-email-override string

Wybierz użytkownika, aby wykonać tę akcję jako lub wprowadź niestandardową wiadomość e-mail

Typ uczestnika
participant_type True string

Osoba/firma

Kolejność podpisywania
signing_order number

Podpisanie zamówienia uczestnika

strona
party True dynamic

Zwraca

response
object

Dodawanie produktu do kontraktu

Dodaj produkt do istniejącej grupy produktów w umowie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontraktu
x-ms-oneflow-contract_id True integer

Identyfikator kontraktu

Grupa produktów
x-ms-oneflow-product-group-index True integer

Wybierz indeks tabeli produktów, aby dodać produkty do. Uporządkowane od góry do dołu w kontrakcie.

Produkt zablokowany dla odpowiedników?
counterparty_lock boolean

Określ, czy atrybuty produktu mają być edytowalne przez odpowiedniki.

Opis produktu
description string

Dodaj szczegółowe informacje o produkcie.

Nazwa produktu
name string

Nazwa produktu.

Kwota
amount string

Kwota podstawowa produktu.

Kwota rabatu
amount string

Kwota rabatu jako liczba.

1 Procent rabatu
discount_percent string

Rabat jako wartość procentowa kwoty bazowej.

Kwota
amount string

Wartość ceny pomocniczej. tj. jeśli produkt ma opłatę za subskrypcję.

Kwota rabatu
amount string

Pomocnicza kwota rabatu jako liczba.

2 procent rabatu
discount_percent string

Pomocnicza kwota rabatu jako procent ceny 2.

Kwota
amount number

Dowolna liczba dodatnia lub 1/0, jeśli typ jest multiple_choice/single_choice

Typ produktu
type string

Wybierz typ danych wejściowych ilości (tj. pole wyboru, liczba, wybór pojedynczy).

Zwraca

Nazwa Ścieżka Typ Opis
Stan kontraktu
state string

wersja robocza/oczekująca/zaległa/podpisana/odrzucona

Czas aktualizacji stanu kontraktu
state_updated_time string
Czas aktualizacji kontraktu
updated_time string

Ping

Użyj tego punktu końcowego, aby sprawdzić, czy interfejs API platformy Oneflow jest dostępny.

Zwraca

response
object

Pobieranie pliku kontraktu

Pobierz określony plik kontraktu według jego identyfikatora.

Parametry

Nazwa Klucz Wymagane Typ Opis
Pobierz jako
x-oneflow-user-email-override string

Wybierz użytkownika, aby wykonać tę akcję jako lub wprowadź niestandardową wiadomość e-mail

Identyfikator kontraktu
contract_id True string

Identyfikator kontraktu

Identyfikator pliku
file_id True string

Typ pliku: * 1 — umowa PDF * 2 — weryfikacja

Zwraca

Zawartość pliku
binary

Pobieranie stanu kontraktu

Pobierz stan określonego kontraktu według jego identyfikatora.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontraktu
contract_id True string

Identyfikator kontraktu

Zwraca

Nazwa Ścieżka Typ Opis
Stan kontraktu
state string

wersja robocza/oczekująca/zaległa/podpisana/odrzucona

Czas aktualizacji stanu kontraktu
state_updated_time string
Czas aktualizacji kontraktu
updated_time string

Pobieranie szczegółów kontraktu

Pobierz szczegóły kontraktu według jego identyfikatora.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontraktu
contract_id True string

Identyfikator kontraktu

Zwraca

Body
Contract

Przekazywanie załączników

Dodaj załącznik lub dokument PDF do kontraktu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontraktu
contract_id True string

Identyfikator kontraktu

File
file True binary

Plik do przekazania. Nazwa pliku powinna być w formacie file.ext

Przekaż jako
upload_as string

wybierz typ załącznika do przekazania

Wykonaj jako
x-oneflow-user-email-override string

Wybierz użytkownika, aby wykonać tę akcję jako lub wprowadź niestandardową wiadomość e-mail

Zwraca

response
object

Publikowanie kontraktu

Wysyła umowę do uczestników do podpisania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontraktu
contract_id True string

Identyfikator kontraktu

Temat
subject string

Temat powiadomienia

Message
message string

Wiadomość z powiadomieniem

Publikuj jako
x-oneflow-user-email-override string

Wybierz użytkownika, aby wykonać tę akcję jako lub wprowadź niestandardową wiadomość e-mail

Zwraca

Body
Contract

Tworzenie kontraktu

Utwórz nowy kontrakt na podstawie wybranego szablonu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Utwórz jako
x-oneflow-user-email email

Określ adres e-mail użytkownika aplikacji Oneflow. Akcja spowoduje utworzenie kontraktu jako tego użytkownika.

Nazwa kontraktu
name string
Nazwa obszaru roboczego
workspace_id True integer

Wybieranie obszaru roboczego dla kontraktu

Nazwa szablonu
template_id True integer

Wybierz szablon, na podstawie który chcesz utworzyć kontrakt

Pole danych
custom_id True string

Wybieranie pola danych do wypełnienia

Wartość
value string

Wartość pola danych

Zwraca

Body
Contract

Usuwanie kontraktu

Usuń określony kontrakt według jego identyfikatora.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontraktu
contract_id True string

Identyfikator kontraktu

Usuń jako
x-oneflow-user-email-override string

Wybierz użytkownika, aby wykonać tę akcję jako lub wprowadź niestandardową wiadomość e-mail

Zwraca

response
string

Wyzwalacze

Po zaktualizowaniu kontraktu

Rejestrowanie elementu webhook dla określonego zdarzenia aktualizacji kontraktu

Po zaktualizowaniu kontraktu

Rejestrowanie elementu webhook dla określonego zdarzenia aktualizacji kontraktu

Parametry

Nazwa Klucz Wymagane Typ Opis
Typ aktualizacji
filters True array of string
Identyfikator grupy szablonów
template_group_id integer

(Opcjonalnie) Filtrowanie kontraktów według grupy szablonów.

Zwraca

Definicje

Kontrakt

Nazwa Ścieżka Typ Opis
Uprawnienie do usuwania kontraktu
_permissions.contract:delete boolean

Użytkownik może usunąć kontrakt

Nazwa kontraktu
_private.name string
Wartość kontraktu
_private.value.amount string
Waluta
_private.value.currency string
Identyfikator obszaru roboczego
_private.workspace_id integer
Czas tworzenia kontraktu
_private_ownerside.created_time string
Identyfikator szablonu
_private_ownerside.template_id integer
Może odbierać załączniki
available_options.can_receive_attachments boolean

Kontrakt może odbierać załączniki

Może odbierać rozszerzony plik PDF
available_options.can_receive_expanded_pdf boolean

Kontrakt może otrzymać rozszerzony plik PDF

Pole danych
data_fields array of object

Zbieranie pól danych

godzina utworzenia
data_fields._private_ownerside.created_time string

Created_time pola danych

identyfikator niestandardowy
data_fields._private_ownerside.custom_id string

Custom_id pola danych

Czas aktualizacji
data_fields._private_ownerside.updated_time string

Updated_time pola danych

opis
data_fields.description string

Opis pola danych

id
data_fields.id integer

Identyfikator pola danych

nazwa
data_fields.name string

Nazwa pola danych

symbol zastępczy
data_fields.placeholder string

Symbol zastępczy pola danych

value
data_fields.value string

Wartość pola danych

Identyfikator kontraktu
id integer

Identyfikator kontraktu

Czas zakończenia kontraktu
lifecycle_state.contract_end_time string
Czas rozpoczęcia kontraktu
lifecycle_state.contract_start_time string
Czas anulowania kontraktu
lifecycle_state.cancel_time string
Umowa została zakończona przez zakończenie?
lifecycle_state.has_ended_by_termination boolean
Czy minął czas rozpoczęcia okresu powiadomienia?
lifecycle_state.has_passed_notice_period_start_time boolean
Czy umowa została anulowana
lifecycle_state.is_canceled boolean
Czy kontrakt jest cykliczny
lifecycle_state.is_recurring boolean
Stan cyklu życia
lifecycle_state.lifecycle_state string

oczekiwanie/aktywne/zakończone

Czas aktualizacji stanu cyklu życia
lifecycle_state.lifecycle_state_updated_time string
Strony
parties array of Party

Kolekcja stron

Grupy produktów
product_groups array of Product_Group

kolekcja product_groups

Czas publikowania kontraktu
published_time string
Czas wygaśnięcia podpisania kontraktu
signing_period_expiry_time string
Stan kontraktu
state string

wersja robocza/oczekująca/zaległa/podpisana/odrzucona

Czas aktualizacji stanu kontraktu
state_updated_time string
Czas aktualizacji kontraktu
updated_time string

Party

Nazwa Ścieżka Typ Opis
Kod kraju partii
country_code string
Numer identyfikacyjny strony
identification_number string

Numer identyfikacyjny strony

Czy moja impreza
my_party boolean

Strona kontraktowa jest my_party

Nazwa strony
name string
Uczestnicy
participants array of Participant

Kolekcja uczestników

Typ strony
type string

firma/osoba indywidualna

uczestnik
participant Individual_Participant

Obiekt pojedynczego uczestnika

Uczestnik

Nazwa Ścieżka Typ Opis
Czy uczestnik może zaktualizować umowę?
_permissions.contract:update boolean
Pierwsza wizyta uczestnika
_private_ownerside.first_visited_time string
Czas ostatniej wizyty uczestnika
_private_ownerside.last_visited_time string
Liczba wizyt uczestników
_private_ownerside.visits integer
Kanał dostarczania uczestnika
delivery_channel string

wiadomość e-mail/brak/same_device/sms

Stan dostarczania uczestnika
delivery_status string

not_sent/pending/failure/bounce/success/opened

Adres e-mail uczestnika
email string
Numer identyfikacyjny uczestnika
identification_number string

Numer identyfikacyjny uczestnika

Uczestnik jest my_participant
my_participant boolean
Nazwa uczestnika
name string
Uczestnik jest organizatorem
organizer boolean
Numer telefonu uczestnika
phone_number string
Metoda podpisywania uczestnika
sign_method string

standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid

Stan logowania uczestnika
sign_state string

niezdecydowany/podpisany/odrzucony

Czas aktualizacji stanu logowania uczestnika
sign_state_updated_time string

sign_state_updated_time

Uczestnik jest sygnatariuszem
signatory boolean
Tytuł uczestnika
title string
Metoda 2FA uczestnika
two_step_authentication_method string

wiadomość e-mail/wiadomość SMS/brak

Individual_Participant

Obiekt pojedynczego uczestnika

Nazwa Ścieżka Typ Opis
Indywidualny uczestnik może zaktualizować kontrakt
_permissions.contract:update boolean

contract:update permissions for Individual Uczestnika

Pierwsza wizyta pojedynczego uczestnika
_private_ownerside.first_visited_time string
Czas ostatniej wizyty indywidualnego uczestnika
_private_ownerside.last_visited_time string
Czas aktualizacji indywidualnego uczestnika
_private_ownerside.updated_time string
Liczba wizyt poszczególnych uczestników
_private_ownerside.visits integer
Kanał dostarczania poszczególnych uczestników
delivery_channel string

wiadomość e-mail/brak/same_device/sms

Stan dostarczania poszczególnych uczestników
delivery_status string

not_sent/pending/failure/bounce/success/opened

Adres e-mail pojedynczego uczestnika
email string
Numer identyfikacyjny pojedynczego uczestnika
identification_number string
Indywidualny uczestnik jest my_participant
my_participant boolean
Nazwa pojedynczego uczestnika
name string
Indywidualny uczestnik jest organizatorem
organizer boolean
Numer telefonu indywidualnego uczestnika
phone_number string
Metoda podpisywania indywidualnego uczestnika
sign_method string

standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid

Stan podpisania indywidualnego uczestnika
sign_state string

niezdecydowany/podpisany/odrzucony

Zaktualizowany czas rejestracji indywidualnego uczestnika
sign_state_updated_time string
Indywidualny uczestnik jest sygnatariuszem
signatory boolean
Tytuł indywidualnego uczestnika
title string
Metoda 2FA pojedynczego uczestnika
two_step_authentication_method string

wiadomość e-mail/wiadomość SMS/brak

Product_Group

element product_group w kolekcji product_groups

Nazwa Ścieżka Typ Opis
Identyfikator grupy produktów
id integer
Products
products array of Product

kolekcja produktów

Product

Nazwa Ścieżka Typ Opis
zablokowane dla odpowiedników?
counterparty_lock boolean

counterparty_lock

opis
description string
id
id integer
nazwa
name string
kwota
price_1.amount.amount string

Wartość kwoty ceny 1

kwota podstawowa
price_1.base_amount.amount string

Wartość kwoty ceny 1

kwota rabatu
price_1.discount_amount.amount string

Kwota rabatu w cenie 1

procent rabatu
price_1.discount_percent string

Procent rabatu ceny 1

kwota
price_2.amount.amount string

Wartość kwoty ceny 2

kwota podstawowa
price_2.base_amount.amount string

Wartość podstawowa ceny 2

kwota rabatu
price_2.discount_amount.amount string

Kwota rabatu w cenie 2

procent rabatu
price_2.discount_percent string

Procent rabatu ceny 2

kwota
quantity.amount number
typ
quantity.type string

quantity/multiple_choice/single_choice

Pole danych

Nazwa Ścieżka Typ Opis
Identyfikator pola danych
id number

Identyfikator pola danych

Wartość
value string

Wartość pola danych

Opis pola danych
description string

Opis pola danych

Nazwa pola danych
name string

Nazwa pola danych

Symbol zastępczy pola danych
placeholder string
Identyfikator niestandardowy
_private_ownerside.custom_id string

Identyfikator niestandardowy pola danych

Czas utworzenia pola danych
_private_ownerside.created_time string
Czas aktualizacji pola danych
_private_ownerside.updated_time string

Webhook_Event

Nazwa Ścieżka Typ Opis
Identyfikator kontraktu
contract.id number

Identyfikator kontraktu

Identyfikator wywołania zwrotnego
callback_id string

Identyfikator wywołania zwrotnego

events
events array of object
Czas utworzenia zdarzenia
events.created_time date-time
Identyfikator zdarzenia
events.id number
Typ zdarzenia
events.type string
Signature
events.signature string

obiekt

Jest to typ 'obiekt'.

ciąg

Jest to podstawowy typ danych "string".

binarny

Jest to podstawowy typ danych "binary".