Oneflow
Будьте более эффективными с действительно цифровыми контрактами, которые делают работу быстрее, и жизнь проще. Автоматизация процесса управления контрактами с помощью Oneflow
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Oneflow AB |
| URL | https://support.oneflow.com/ |
| Адрес электронной почты | support@oneflow.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Oneflow |
| Веб-сайт | https://oneflow.com |
| Политика конфиденциальности | https://oneflow.com/privacy-notice/ |
| Категории | Продажи и CRM; Продуктивность |
Oneflow
Будьте более эффективными с действительно цифровыми контрактами, которые упрощают работу быстрее и жизнь. Автоматизация процесса управления контрактами с помощью Oneflow.
Издатель: Oneflow AB
Предпосылки
Чтобы использовать соединитель Oneflow, требуется активная учетная запись администратора Oneflow. Если у вас еще нет учетной записи, создайте пробную учетную запись.
Поддерживаемые операции
Действия
Создание контракта
Создайте контракт из выбранного шаблона.
Добавление участника в контракт
Добавьте отдельного или корпоративного участника в существующий контракт.
Удаление контракта
Удаление контракта.
Добавление вложений в контракт
Добавьте развернутый PDF-файл или регулярное вложение в существующий контракт.
Публикация контракта
Отправьте контракт всем подписавшим через указанный канал доставки.
Скачивание файлов контракта
Скачайте PDF-копию подписанного контракта и любой файл вложения или файла проверки существующего контракта.
Ping Oneflow API
Проверьте доступность API Oneflow.
Triggers
При обновлении контракта
Активируйте поток на основе предопределенных событий контракта.
Получение учетных данных
Чтобы получить учетные данные соединителя Oneflow, выполните следующие действия.
Войдите в учетную запись Oneflow и перейдите к маркерам API расширения > учетной записи > администратора>.
Нажмите кнопку "Создать новый маркер" в этом расширении и вставьте маркер в мастер подключения в Power Automate Flow.
Известные проблемы и ограничения
Регистрация веб-перехватчика не удаляется в тестовой среде
Если вы решили использовать тестовую среду Oneflow, существует известная проблема, когда веб-перехватчик не удаляется в учетной записи теста Oneflow после удаления потока или удаления триггера из потока. Веб-перехватчики должны быть удалены вручную в учетной записи тестирования Oneflow в качестве обходного решения.
Свяжитесь с нами
Наш веб-сайт: https://oneflow.com/
Поддержка клиентов: https://support.oneflow.com
Продажи и цены: https://oneflow.com/contact/
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API Oneflow | securestring | Ключ API для этого API | True |
| Адрес электронной почты | струна | Адрес электронной почты пользователя Oneflow | True |
| URL-адрес API | струна | Выберите среду, к которой нужно подключиться. | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Ping |
Используйте эту конечную точку для проверки доступности API Oneflow. |
| Добавить участника |
Добавление участника в контракт |
| Добавление продукта в контракт |
Добавьте продукт в существующую группу продуктов в контракте. |
| Обновление поля данных |
Обновите поле данных в определенном контракте по его идентификатору. |
| Отправка вложений |
Добавьте вложение или PDF-документ в контракт. |
| Получение сведений о контракте |
Получение сведений о контракте по идентификатору. |
| Получение состояния контракта |
Получение состояния определенного контракта по идентификатору. |
| Публикация контракта |
Отправляет контракт участникам для подписания. |
| Скачивание файла контракта |
Получение определенного файла контракта по идентификатору. |
| Создание контракта |
Создайте контракт на основе выбранного шаблона. |
| Удаление контракта |
Удалите определенный контракт по идентификатору. |
Ping
Используйте эту конечную точку для проверки доступности API Oneflow.
Возвращаемое значение
- response
- object
Добавить участника
Добавление участника в контракт
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор контракта
|
contract_id | True | string |
Идентификатор контракта |
|
Добавление как
|
x-oneflow-user-email-override | string |
Выберите пользователя, чтобы выполнить это действие как или ввести настраиваемое сообщение электронной почты |
|
|
Тип участника
|
participant_type | True | string |
Индивидуальный или корпоративный |
|
Порядок подписывания
|
signing_order | number |
Порядок подписывания участника |
|
|
партия
|
party | True | dynamic |
Возвращаемое значение
- response
- object
Добавление продукта в контракт
Добавьте продукт в существующую группу продуктов в контракте.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор контракта
|
x-ms-oneflow-contract_id | True | integer |
Идентификатор контракта |
|
Группа продуктов
|
x-ms-oneflow-product-group-index | True | integer |
Выберите индекс таблицы продуктов, чтобы добавить в нее продукты. Упорядочено сверху вниз в контракте. |
|
Продукт заблокирован для коллег?
|
counterparty_lock | boolean |
Выберите, нужно ли изменять атрибуты продукта коллегами. |
|
|
Описание продукта
|
description | string |
Добавьте сведения о продукте. |
|
|
Название продукта
|
name | string |
Имя продукта. |
|
|
Сумма
|
amount | string |
Базовая сумма для продукта. |
|
|
Сумма скидки
|
amount | string |
Сумма скидки в виде числа. |
|
|
1 процент скидки
|
discount_percent | string |
Скидка в процентах от базовой суммы. |
|
|
Сумма
|
amount | string |
Вторичная цена. т. е. если у продукта есть плата за подписку. |
|
|
Сумма скидки
|
amount | string |
Вторичная сумма скидки в виде числа. |
|
|
2 процента скидки
|
discount_percent | string |
Дополнительная сумма скидки в процентах от цены 2. |
|
|
Сумма
|
amount | number |
Любое положительное число или 1/0, если тип multiple_choice/single_choice |
|
|
Тип продукта
|
type | string |
Выберите входной тип количества (т. е. флажок, число, одиночный выбор). |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Состояние контракта
|
state | string |
draft/pending/overdue/signed/отклонить |
|
Время обновления состояния контракта
|
state_updated_time | string | |
|
Время обновления контракта
|
updated_time | string |
Обновление поля данных
Обновите поле данных в определенном контракте по его идентификатору.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор контракта
|
contract_id | True | string |
Идентификатор контракта |
|
Пользовательский идентификатор
|
data_field_id | True | string |
Пользовательский идентификатор (внешний ключ) поля данных. |
|
Обновление как
|
x-oneflow-user-email-override | string |
Выберите пользователя, чтобы выполнить это действие как или ввести настраиваемое сообщение электронной почты |
|
|
Ценность
|
value | string |
Значение, заданное для поля данных. |
|
|
Пользовательский идентификатор
|
custom_id | True | string |
Пользовательский идентификатор поля данных |
Возвращаемое значение
- Тело
- Datafield
Отправка вложений
Добавьте вложение или PDF-документ в контракт.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор контракта
|
contract_id | True | string |
Идентификатор контракта |
|
Файл
|
file | True | binary |
Файл для отправки. Имя файла должно быть в формате file.ext |
|
Отправка как
|
upload_as | string |
выбор типа вложения для отправки |
|
|
Выполнение как
|
x-oneflow-user-email-override | string |
Выберите пользователя, чтобы выполнить это действие как или ввести настраиваемое сообщение электронной почты |
Возвращаемое значение
- response
- object
Получение сведений о контракте
Получение сведений о контракте по идентификатору.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор контракта
|
contract_id | True | string |
Идентификатор контракта |
Возвращаемое значение
- Тело
- Contract
Получение состояния контракта
Получение состояния определенного контракта по идентификатору.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор контракта
|
contract_id | True | string |
Идентификатор контракта |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Состояние контракта
|
state | string |
draft/pending/overdue/signed/отклонить |
|
Время обновления состояния контракта
|
state_updated_time | string | |
|
Время обновления контракта
|
updated_time | string |
Публикация контракта
Отправляет контракт участникам для подписания.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор контракта
|
contract_id | True | string |
Идентификатор контракта |
|
Тема
|
subject | string |
Тема уведомления |
|
|
Message
|
message | string |
Сообщение об уведомлении |
|
|
Публикация как
|
x-oneflow-user-email-override | string |
Выберите пользователя, чтобы выполнить это действие как или ввести настраиваемое сообщение электронной почты |
Возвращаемое значение
- Тело
- Contract
Скачивание файла контракта
Получение определенного файла контракта по идентификатору.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Скачивание как
|
x-oneflow-user-email-override | string |
Выберите пользователя, чтобы выполнить это действие как или ввести настраиваемое сообщение электронной почты |
|
|
Идентификатор контракта
|
contract_id | True | string |
Идентификатор контракта |
|
Идентификатор файла
|
file_id | True | string |
Тип файла: * 1 - Contract PDF * 2 — проверка |
Возвращаемое значение
- Содержимое файла
- binary
Создание контракта
Создайте контракт на основе выбранного шаблона.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Создание как
|
x-oneflow-user-email |
Укажите электронную почту пользователя Oneflow. Действие создаст контракт в качестве этого пользователя. |
||
|
Имя контракта
|
name | string | ||
|
Имя рабочей области
|
workspace_id | True | integer |
Выберите рабочую область для контракта |
|
Имя шаблона
|
template_id | True | integer |
Выберите шаблон для создания контракта из |
|
Datafield
|
custom_id | True | string |
Выбор поля данных для заполнения |
|
Ценность
|
value | string |
Значение поля данных |
Возвращаемое значение
- Тело
- Contract
Удаление контракта
Удалите определенный контракт по идентификатору.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор контракта
|
contract_id | True | string |
Идентификатор контракта |
|
Удаление как
|
x-oneflow-user-email-override | string |
Выберите пользователя, чтобы выполнить это действие как или ввести настраиваемое сообщение электронной почты |
Возвращаемое значение
- response
- string
Триггеры
| При обновлении контракта |
Регистрация веб-перехватчика для указанного события обновления контракта |
При обновлении контракта
Регистрация веб-перехватчика для указанного события обновления контракта
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Тип обновления
|
filters | True | array of string | |
|
Идентификатор группы шаблонов
|
template_group_id | integer |
(Необязательно) Фильтрация контрактов по группе шаблонов. |
Возвращаемое значение
- Тело
- Webhook_Event
Определения
Контракт
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Разрешение на удаление контракта
|
_permissions.contract:delete | boolean |
Пользователь может удалить контракт |
|
Имя контракта
|
_private.name | string | |
|
Значение контракта
|
_private.value.amount | string | |
|
Валюта
|
_private.value.currency | string | |
|
Идентификатор рабочей области
|
_private.workspace_id | integer | |
|
Время создания контракта
|
_private_ownerside.created_time | string | |
|
Идентификатор шаблона
|
_private_ownerside.template_id | integer | |
|
Может получать вложения
|
available_options.can_receive_attachments | boolean |
Контракт может получать вложения |
|
Может получать расширенный PDF-файл
|
available_options.can_receive_expanded_pdf | boolean |
Контракт может получить расширенный PDF-файл |
|
Поле данных
|
data_fields | array of object |
Сбор полей данных |
|
время создания
|
data_fields._private_ownerside.created_time | string |
Поле данных created_time |
|
пользовательский идентификатор
|
data_fields._private_ownerside.custom_id | string |
Поле данных custom_id |
|
Обновлено время
|
data_fields._private_ownerside.updated_time | string |
Поле данных updated_time |
|
описание
|
data_fields.description | string |
Описание поля данных |
|
id
|
data_fields.id | integer |
Идентификатор поля данных |
|
имя
|
data_fields.name | string |
Имя поля данных |
|
placeholder
|
data_fields.placeholder | string |
Заполнитель поля данных |
|
value
|
data_fields.value | string |
Значение поля данных |
|
Идентификатор контракта
|
id | integer |
Идентификатор контракта |
|
Время окончания контракта
|
lifecycle_state.contract_end_time | string | |
|
Время начала контракта
|
lifecycle_state.contract_start_time | string | |
|
Время отмены контракта
|
lifecycle_state.cancel_time | string | |
|
Контракт закончился прекращением?
|
lifecycle_state.has_ended_by_termination | boolean | |
|
Прошло ли время начала периода уведомления?
|
lifecycle_state.has_passed_notice_period_start_time | boolean | |
|
Отмена контракта
|
lifecycle_state.is_canceled | boolean | |
|
Повторяющиеся контракты
|
lifecycle_state.is_recurring | boolean | |
|
Состояние жизненного цикла
|
lifecycle_state.lifecycle_state | string |
awaiting/active/ended |
|
Время обновления состояния жизненного цикла
|
lifecycle_state.lifecycle_state_updated_time | string | |
|
Сторон
|
parties | array of Party |
Коллекция "Стороны" |
|
Группы продуктов
|
product_groups | array of Product_Group |
коллекция product_groups |
|
Время публикации контракта
|
published_time | string | |
|
Срок действия подписывания контракта
|
signing_period_expiry_time | string | |
|
Состояние контракта
|
state | string |
draft/pending/overdue/signed/отклонить |
|
Время обновления состояния контракта
|
state_updated_time | string | |
|
Время обновления контракта
|
updated_time | string |
Партия
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Код страны-участника
|
country_code | string | |
|
Идентификационный номер стороны
|
identification_number | string |
Идентификационный номер стороны |
|
Моя партия
|
my_party | boolean |
Сторона контракта my_party |
|
Имя стороны
|
name | string | |
|
Участники
|
participants | array of Participant |
Коллекция участников |
|
Тип участника
|
type | string |
компания или отдельный |
|
участник
|
participant | Individual_Participant |
Отдельный объект участника |
Участник
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Может ли участник обновить контракт?
|
_permissions.contract:update | boolean | |
|
Первый визит участника
|
_private_ownerside.first_visited_time | string | |
|
Время последнего посещения участника
|
_private_ownerside.last_visited_time | string | |
|
Количество посещений участника
|
_private_ownerside.visits | integer | |
|
Канал доставки участников
|
delivery_channel | string |
email/none/same_device/sms |
|
Состояние доставки участника
|
delivery_status | string |
not_sent/ожидание/сбой/отказ/успех/открытие |
|
Электронная почта участника
|
string | ||
|
Идентификационный номер участника
|
identification_number | string |
Идентификационный номер участника |
|
Участник my_participant
|
my_participant | boolean | |
|
Имя участника
|
name | string | |
|
Участник является организатором
|
organizer | boolean | |
|
Номер телефона участника
|
phone_number | string | |
|
Метод подписи участника
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
Состояние подписи участника
|
sign_state | string |
неубедимый/подписанный/отклоненный |
|
Время обновления состояния подписи участника
|
sign_state_updated_time | string |
sign_state_updated_time |
|
Участник подписан
|
signatory | boolean | |
|
Название участника
|
title | string | |
|
Метод Участника 2FA
|
two_step_authentication_method | string |
email/sms/none |
Individual_Participant
Отдельный объект участника
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Отдельный участник может обновить контракт
|
_permissions.contract:update | boolean |
contract:update permissions for Individual Participant |
|
Первый визит отдельного участника
|
_private_ownerside.first_visited_time | string | |
|
Время последнего посещения отдельного участника
|
_private_ownerside.last_visited_time | string | |
|
Время обновления отдельного участника
|
_private_ownerside.updated_time | string | |
|
Количество посещений отдельных участников
|
_private_ownerside.visits | integer | |
|
Канал доставки отдельных участников
|
delivery_channel | string |
email/none/same_device/sms |
|
Состояние доставки отдельных участников
|
delivery_status | string |
not_sent/ожидание/сбой/отказ/успех/открытие |
|
Электронная почта отдельного участника
|
string | ||
|
Идентификационный номер отдельного участника
|
identification_number | string | |
|
Отдельный участник my_participant
|
my_participant | boolean | |
|
Имя отдельного участника
|
name | string | |
|
Отдельный участник является организатором
|
organizer | boolean | |
|
Номер телефона отдельного участника
|
phone_number | string | |
|
Метод подписи отдельного участника
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
Состояние подписи отдельного участника
|
sign_state | string |
неубедимый/подписанный/отклоненный |
|
Время обновления состояния подписи отдельного участника
|
sign_state_updated_time | string | |
|
Отдельный участник подписан
|
signatory | boolean | |
|
Название отдельного участника
|
title | string | |
|
Метод 2FA для отдельных участников
|
two_step_authentication_method | string |
email/sms/none |
Product_Group
элемент product_group в коллекции product_groups
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор группы продуктов
|
id | integer | |
|
Products
|
products | array of Product |
Коллекция продуктов |
Продукт
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
заблокирован для коллег?
|
counterparty_lock | boolean |
counterparty_lock |
|
описание
|
description | string | |
|
id
|
id | integer | |
|
имя
|
name | string | |
|
количество
|
price_1.amount.amount | string |
Сумма цены 1 |
|
базовый объем
|
price_1.base_amount.amount | string |
Сумма цены 1 |
|
сумма скидки
|
price_1.discount_amount.amount | string |
Скидка на цену 1 |
|
процент скидки
|
price_1.discount_percent | string |
Процент скидки от цены 1 |
|
количество
|
price_2.amount.amount | string |
Сумма цены 2 |
|
базовый объем
|
price_2.base_amount.amount | string |
Базовое значение цены 2 |
|
сумма скидки
|
price_2.discount_amount.amount | string |
Скидка на цену 2 |
|
процент скидки
|
price_2.discount_percent | string |
Процент скидки от цены 2 |
|
количество
|
quantity.amount | number | |
|
type
|
quantity.type | string |
количество/multiple_choice/single_choice |
Datafield
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор поля данных
|
id | number |
Идентификатор datafield |
|
Ценность
|
value | string |
Значение поля данных |
|
Описание поля данных
|
description | string |
Описание поля данных |
|
Имя поля данных
|
name | string |
Имя поля данных |
|
Заполнитель datafield
|
placeholder | string | |
|
Пользовательский идентификатор
|
_private_ownerside.custom_id | string |
Пользовательский идентификатор поля данных |
|
Время создания поля данных
|
_private_ownerside.created_time | string | |
|
Время обновления поля данных
|
_private_ownerside.updated_time | string |
Webhook_Event
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор контракта
|
contract.id | number |
Идентификатор контракта |
|
Идентификатор обратного вызова
|
callback_id | string |
Идентификатор обратного вызова |
|
events
|
events | array of object | |
|
Время создания события
|
events.created_time | date-time | |
|
Идентификатор события
|
events.id | number | |
|
Тип события
|
events.type | string | |
|
Signature
|
events.signature | string |
объект
Это тип object.
струна
Это базовый тип данных string.
бинарный
Это базовый тип данных binary.