Oneflow
Sea más eficaz con contratos verdaderamente digitales que hacen que el trabajo sea más rápido y más fácil. Automatización del proceso de administración de contratos con Oneflow
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Oneflow AB |
| URL | https://support.oneflow.com/ |
| Correo Electrónico | support@oneflow.com |
| Metadatos del conector | |
|---|---|
| Publicador | Oneflow |
| Website | https://oneflow.com |
| Directiva de privacidad | https://oneflow.com/privacy-notice/ |
| Categorías | Ventas y CRM; Productividad |
Oneflow
Sea más eficaz con contratos verdaderamente digitales que hacen que el trabajo sea más rápido y fácil. Automatice el proceso de administración de contratos con Oneflow.
Publicador: Oneflow AB
Prerrequisitos
Para usar el conector de Oneflow, necesita una cuenta de administrador de Oneflow activa. Si aún no tiene una cuenta, continúe y cree una cuenta de prueba.
Operaciones admitidas
Acciones
Crear contrato
Cree un contrato a partir de una plantilla seleccionada.
Agregar participante al contrato
Agregue un participante individual o basado en la empresa a un contrato existente.
Eliminar contrato
Eliminar un contrato.
Agregar datos adjuntos al contrato
Agregue un PDF expandido o un archivo adjunto normal a un contrato existente.
Publicar contrato
Envíe un contrato a todos los firmantes a través de un canal de entrega especificado.
Descargar archivos de contrato
Descargue una copia en PDF de un contrato firmado y cualquier archivo adjunto o de verificación de un contrato existente.
Ping Oneflow API
Compruebe la disponibilidad de la API de Oneflow.
Desencadenadores
Cuando se actualiza un contrato
Desencadene el flujo en función de los eventos de contrato predifineds.
Obtención de credenciales
Para obtener las credenciales del conector de Oneflow:
Inicie sesión en su cuenta de Oneflow y vaya a Tokens de API de extensión > de cuenta > de administrador>.
Haga clic en Generar un nuevo token en esta extensión y pegue el token en el asistente para conexiones en el flujo de Power Automate.
Problemas y limitaciones conocidos
El registro de webhook no se elimina en el entorno de prueba
Si decide usar el entorno de prueba de Oneflow, hay un problema conocido cuando un webhook no se elimina en la cuenta de prueba de Oneflow después de eliminar un flujo o quitar un desencadenador de un flujo. Los webhooks deben eliminarse manualmente en la cuenta de prueba de Oneflow como solución alternativa.
Contáctenos
Nuestro sitio web: https://oneflow.com/
Apoyo al cliente: https://support.oneflow.com
Ventas y precios: https://oneflow.com/contact/
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API de Oneflow | securestring | La clave de API para esta API | Cierto |
| Dirección de correo electrónico | cuerda / cadena | Dirección de correo electrónico de usuario de Oneflow | Cierto |
| API URL | cuerda / cadena | Seleccione el entorno al que desea conectarse. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar un campo de datos |
Actualice un campo de datos en el contrato específico por su identificador. |
| Agregar participante |
Agregar participante al contrato |
| Agregar un producto a un contrato |
Agregue un producto a un grupo de productos existente en un contrato. |
| Cargar datos adjuntos |
Agregue datos adjuntos o un documento PDF a un contrato. |
| Creación de un contrato |
Cree un nuevo contrato basado en la plantilla seleccionada. |
| Descargar un archivo de contrato |
Recupere un archivo de contrato específico por su identificador. |
| Eliminar un contrato |
Elimine un contrato específico por su identificador. |
| Obtener detalles del contrato |
Recupere los detalles de un contrato por su identificador. |
| Obtener el estado de un contrato |
Recupere el estado de un contrato específico por su identificador. |
| Ping |
Use este punto de conexión para comprobar si la API de Oneflow está disponible. |
| Publicación de un contrato |
Envía un contrato a los participantes para firmar. |
Actualizar un campo de datos
Actualice un campo de datos en el contrato específico por su identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de contrato
|
contract_id | True | string |
Identificador de contrato |
|
Identificador personalizado
|
data_field_id | True | string |
Identificador personalizado (clave externa) del campo de datos. |
|
Actualizar como
|
x-oneflow-user-email-override | string |
Seleccione el usuario para ejecutar esta acción como o escriba un correo electrónico personalizado. |
|
|
Importancia
|
value | string |
Valor que se va a establecer para el campo de datos. |
|
|
Identificador personalizado
|
custom_id | True | string |
Identificador personalizado del campo de datos |
Devoluciones
- Body
- Datafield
Agregar participante
Agregar participante al contrato
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de contrato
|
contract_id | True | string |
Identificador de contrato |
|
Agregar como
|
x-oneflow-user-email-override | string |
Seleccione el usuario para ejecutar esta acción como o escriba un correo electrónico personalizado. |
|
|
Tipo de participante
|
participant_type | True | string |
Individual/Empresa |
|
Orden de firma
|
signing_order | number |
Orden de firma del participante |
|
|
partido
|
party | True | dynamic |
Devoluciones
- response
- object
Agregar un producto a un contrato
Agregue un producto a un grupo de productos existente en un contrato.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de contrato
|
x-ms-oneflow-contract_id | True | integer |
Identificador de contrato |
|
Grupo de productos
|
x-ms-oneflow-product-group-index | True | integer |
Seleccione el índice de la tabla de productos al que agregar los productos. Pedido de arriba abajo en el contrato. |
|
¿El producto está bloqueado para homólogos?
|
counterparty_lock | boolean |
Seleccione si desea que los atributos de producto sean editables por homólogos. |
|
|
Descripción del producto
|
description | string |
Agregue detalles sobre el producto. |
|
|
Nombre del producto
|
name | string |
Nombre del producto. |
|
|
Importe
|
amount | string |
Cantidad base del producto. |
|
|
Importe de descuento
|
amount | string |
Importe de descuento como número. |
|
|
1 Porcentaje de descuento
|
discount_percent | string |
Descuento como porcentaje del importe base. |
|
|
Importe
|
amount | string |
Valor de precio secundario. Es decir, si el producto tiene una cuota de suscripción. |
|
|
Importe de descuento
|
amount | string |
Importe de descuento secundario como número. |
|
|
2 Porcentaje de descuento
|
discount_percent | string |
Importe de descuento secundario como porcentaje del precio 2. |
|
|
Importe
|
amount | number |
Cualquier número positivo o 1/0 si el tipo es multiple_choice/single_choice |
|
|
Tipo de producto
|
type | string |
Seleccione un tipo de entrada de cantidad (es decir, una casilla, número, selección única). |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Estado del contrato
|
state | string |
draft/pending/overdued/signed/declined |
|
Hora de actualización del estado del contrato
|
state_updated_time | string | |
|
Hora de actualización del contrato
|
updated_time | string |
Cargar datos adjuntos
Agregue datos adjuntos o un documento PDF a un contrato.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de contrato
|
contract_id | True | string |
Identificador de contrato |
|
Archivo
|
file | True | binary |
Archivo que se va a cargar. El nombre de archivo debe estar en formato file.ext |
|
Cargar como
|
upload_as | string |
seleccionar el tipo de datos adjuntos que se van a cargar |
|
|
Ejecutar como
|
x-oneflow-user-email-override | string |
Seleccione el usuario para ejecutar esta acción como o escriba un correo electrónico personalizado. |
Devoluciones
- response
- object
Creación de un contrato
Cree un nuevo contrato basado en la plantilla seleccionada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Crear como
|
x-oneflow-user-email |
Especifique el correo electrónico de usuario de Oneflow. La acción creará un contrato como este usuario. |
||
|
Nombre del contrato
|
name | string | ||
|
Nombre del área de trabajo
|
workspace_id | True | integer |
Selección de un área de trabajo para el contrato |
|
Nombre de plantilla
|
template_id | True | integer |
Selección de una plantilla para crear el contrato |
|
Datafield
|
custom_id | True | string |
Selección del campo de datos que se va a rellenar |
|
Importancia
|
value | string |
Valor de Datafield |
Devoluciones
- Body
- Contract
Descargar un archivo de contrato
Recupere un archivo de contrato específico por su identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Descargar como
|
x-oneflow-user-email-override | string |
Seleccione el usuario para ejecutar esta acción como o escriba un correo electrónico personalizado. |
|
|
Identificador de contrato
|
contract_id | True | string |
Identificador de contrato |
|
Id. de archivo
|
file_id | True | string |
Tipo de archivo: * 1 - Contrato PDF * 2 - Verificación |
Devoluciones
- Contenido del archivo
- binary
Eliminar un contrato
Elimine un contrato específico por su identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de contrato
|
contract_id | True | string |
Identificador de contrato |
|
Eliminar como
|
x-oneflow-user-email-override | string |
Seleccione el usuario para ejecutar esta acción como o escriba un correo electrónico personalizado. |
Devoluciones
- response
- string
Obtener detalles del contrato
Recupere los detalles de un contrato por su identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de contrato
|
contract_id | True | string |
Identificador de contrato |
Devoluciones
- Body
- Contract
Obtener el estado de un contrato
Recupere el estado de un contrato específico por su identificador.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de contrato
|
contract_id | True | string |
Identificador de contrato |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Estado del contrato
|
state | string |
draft/pending/overdued/signed/declined |
|
Hora de actualización del estado del contrato
|
state_updated_time | string | |
|
Hora de actualización del contrato
|
updated_time | string |
Ping
Use este punto de conexión para comprobar si la API de Oneflow está disponible.
Devoluciones
- response
- object
Publicación de un contrato
Envía un contrato a los participantes para firmar.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de contrato
|
contract_id | True | string |
Identificador de contrato |
|
Asunto
|
subject | string |
Asunto de notificación |
|
|
Message
|
message | string |
Mensaje de notificación |
|
|
Publicar como
|
x-oneflow-user-email-override | string |
Seleccione el usuario para ejecutar esta acción como o escriba un correo electrónico personalizado. |
Devoluciones
- Body
- Contract
Desencadenadores
| Cuando se actualiza un contrato |
Registro de un webhook para un evento de actualización de contrato especificado |
Cuando se actualiza un contrato
Registro de un webhook para un evento de actualización de contrato especificado
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo de actualización
|
filters | True | array of string | |
|
Identificador de grupo de plantillas
|
template_group_id | integer |
(Opcional) Filtre los contratos por un grupo de plantillas. |
Devoluciones
- Body
- Webhook_Event
Definiciones
Contrato
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Permiso de eliminación de contrato
|
_permissions.contract:delete | boolean |
El usuario puede eliminar contrato |
|
Nombre del contrato
|
_private.name | string | |
|
Valor del contrato
|
_private.value.amount | string | |
|
Moneda
|
_private.value.currency | string | |
|
Id. del área de trabajo
|
_private.workspace_id | integer | |
|
Tiempo de creación del contrato
|
_private_ownerside.created_time | string | |
|
ID de plantilla
|
_private_ownerside.template_id | integer | |
|
Puede recibir datos adjuntos
|
available_options.can_receive_attachments | boolean |
El contrato puede recibir datos adjuntos |
|
Puede recibir PDF expandido
|
available_options.can_receive_expanded_pdf | boolean |
El contrato puede recibir PDF expandido |
|
Campo de datos
|
data_fields | array of object |
Recopilación de campos de datos |
|
hora de creación
|
data_fields._private_ownerside.created_time | string |
Created_time de campo de datos |
|
id. personalizado
|
data_fields._private_ownerside.custom_id | string |
Custom_id de campo de datos |
|
Hora actualizada
|
data_fields._private_ownerside.updated_time | string |
Updated_time de campo de datos |
|
descripción
|
data_fields.description | string |
Descripción del campo de datos |
|
id
|
data_fields.id | integer |
Identificador del campo de datos |
|
nombre
|
data_fields.name | string |
Nombre del campo de datos |
|
marcador
|
data_fields.placeholder | string |
Marcador de posición de campo de datos |
|
value
|
data_fields.value | string |
Valor del campo de datos |
|
Id. de contrato
|
id | integer |
Identificador de contrato |
|
Hora de finalización del contrato
|
lifecycle_state.contract_end_time | string | |
|
Hora de inicio del contrato
|
lifecycle_state.contract_start_time | string | |
|
Tiempo de cancelación del contrato
|
lifecycle_state.cancel_time | string | |
|
¿El contrato finalizó por terminación?
|
lifecycle_state.has_ended_by_termination | boolean | |
|
¿Ha pasado la hora de inicio del período de aviso?
|
lifecycle_state.has_passed_notice_period_start_time | boolean | |
|
¿Se cancela el contrato?
|
lifecycle_state.is_canceled | boolean | |
|
¿El contrato es periódico?
|
lifecycle_state.is_recurring | boolean | |
|
Estado del ciclo de vida
|
lifecycle_state.lifecycle_state | string |
awaiting/active/ended |
|
Tiempo actualizado del estado del ciclo de vida
|
lifecycle_state.lifecycle_state_updated_time | string | |
|
Partes
|
parties | array of Party |
Recopilación de partes |
|
Grupos de productos
|
product_groups | array of Product_Group |
colección product_groups |
|
Tiempo de publicación del contrato
|
published_time | string | |
|
Hora de expiración de la firma del contrato
|
signing_period_expiry_time | string | |
|
Estado del contrato
|
state | string |
draft/pending/overdued/signed/declined |
|
Hora de actualización del estado del contrato
|
state_updated_time | string | |
|
Hora de actualización del contrato
|
updated_time | string |
Party
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Código de país de la parte
|
country_code | string | |
|
Número de identificación de entidad
|
identification_number | string |
Número de identificación de entidad |
|
Es mi fiesta
|
my_party | boolean |
La parte del contrato es my_party |
|
Nombre de entidad
|
name | string | |
|
Participantes
|
participants | array of Participant |
Colección De participantes |
|
Tipo de entidad
|
type | string |
company/individual |
|
participante
|
participant | Individual_Participant |
Objeto participante individual |
Participante
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
¿Puede el contrato de actualización de participantes?
|
_permissions.contract:update | boolean | |
|
Primera visita del participante
|
_private_ownerside.first_visited_time | string | |
|
Hora de la última visita del participante
|
_private_ownerside.last_visited_time | string | |
|
Recuento de visitas de participantes
|
_private_ownerside.visits | integer | |
|
Canal de entrega de participantes
|
delivery_channel | string |
email/none/same_device/sms |
|
Estado de entrega del participante
|
delivery_status | string |
not_sent/pending/failure/bounce/success/opened |
|
Correo electrónico de participante
|
string | ||
|
Número de identificación del participante
|
identification_number | string |
Número de identificación del participante |
|
El participante es my_participant
|
my_participant | boolean | |
|
Nombre del participante
|
name | string | |
|
El participante es organizador
|
organizer | boolean | |
|
Número de teléfono del participante
|
phone_number | string | |
|
Método de signo de participante
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
Estado del signo del participante
|
sign_state | string |
undecided/signed/declined |
|
Hora actualizada del estado del signo del participante
|
sign_state_updated_time | string |
sign_state_updated_time |
|
El participante es firmante
|
signatory | boolean | |
|
Título del participante
|
title | string | |
|
Método 2FA de participante
|
two_step_authentication_method | string |
email/sms/none |
Individual_Participant
Objeto participante individual
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
El participante individual puede actualizar el contrato
|
_permissions.contract:update | boolean |
contract:update permissions for Individual Participant |
|
Primera visita al participante individual
|
_private_ownerside.first_visited_time | string | |
|
Hora de la última visita del participante individual
|
_private_ownerside.last_visited_time | string | |
|
Hora de actualización del participante individual
|
_private_ownerside.updated_time | string | |
|
Recuento de visitas de participantes individuales
|
_private_ownerside.visits | integer | |
|
Canal de entrega de participantes individuales
|
delivery_channel | string |
email/none/same_device/sms |
|
Estado de entrega de participantes individuales
|
delivery_status | string |
not_sent/pending/failure/bounce/success/opened |
|
Correo electrónico de participante individual
|
string | ||
|
Número de identificación de participante individual
|
identification_number | string | |
|
El participante individual está my_participant
|
my_participant | boolean | |
|
Nombre de participante individual
|
name | string | |
|
El participante individual es organizador
|
organizer | boolean | |
|
Número de teléfono de participante individual
|
phone_number | string | |
|
Método de firma de participante individual
|
sign_method | string |
standard_esign/sms/swedish_bankid/norwegian_bankid/danish_nemid/finnish_bankid |
|
Estado de firma de participante individual
|
sign_state | string |
undecided/signed/declined |
|
Hora actualizada del estado del signo de participante individual
|
sign_state_updated_time | string | |
|
Participante individual es firmante
|
signatory | boolean | |
|
Título de participante individual
|
title | string | |
|
Método 2FA de participante individual
|
two_step_authentication_method | string |
email/sms/none |
Product_Group
product_group elemento de product_groups colección
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de grupo de productos
|
id | integer | |
|
Products
|
products | array of Product |
colección products |
Producto
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
¿bloqueados para homólogos?
|
counterparty_lock | boolean |
counterparty_lock |
|
descripción
|
description | string | |
|
id
|
id | integer | |
|
nombre
|
name | string | |
|
importe
|
price_1.amount.amount | string |
Valor de importe del precio 1 |
|
cantidad base
|
price_1.base_amount.amount | string |
Valor de importe del precio 1 |
|
importe de descuento
|
price_1.discount_amount.amount | string |
Importe de descuento del precio 1 |
|
porcentaje de descuento
|
price_1.discount_percent | string |
Porcentaje de descuento del precio 1 |
|
importe
|
price_2.amount.amount | string |
Valor de importe del precio 2 |
|
cantidad base
|
price_2.base_amount.amount | string |
Valor de la cantidad base del precio 2 |
|
importe de descuento
|
price_2.discount_amount.amount | string |
Importe de descuento del precio 2 |
|
porcentaje de descuento
|
price_2.discount_percent | string |
Porcentaje de descuento del precio 2 |
|
importe
|
quantity.amount | number | |
|
type
|
quantity.type | string |
quantity/multiple_choice/single_choice |
Datafield
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador del campo de datos
|
id | number |
Datafield Id |
|
Importancia
|
value | string |
Valor de Datafield |
|
Descripción del campo de datos
|
description | string |
Descripción del campo de datos |
|
Nombre del campo de datos
|
name | string |
Nombre del campo de datos |
|
Marcador de posición de Datafield
|
placeholder | string | |
|
Identificador personalizado
|
_private_ownerside.custom_id | string |
Identificador personalizado del campo de datos |
|
Hora de creación de Datafield
|
_private_ownerside.created_time | string | |
|
Hora actualizada de Datafield
|
_private_ownerside.updated_time | string |
Webhook_Event
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador del contrato
|
contract.id | number |
Identificador del contrato |
|
Identificador de devolución de llamada
|
callback_id | string |
Identificador de devolución de llamada |
|
events
|
events | array of object | |
|
Hora de creación del evento
|
events.created_time | date-time | |
|
Id. de evento
|
events.id | number | |
|
Tipo de evento
|
events.type | string | |
|
Signature
|
events.signature | string |
objeto
Este es el tipo 'object'.
cuerda / cadena
Este es el tipo de datos básico "string".
binary
Este es el tipo de datos básico "binary".