Certyneo (versión preliminar)

Envíe documentos para firmas electrónicas compatibles con eIDAS, cree sobres a partir de plantillas y desencadene flujos en eventos de firma como enviados, firmados, completados y rechazados.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones 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 Standard 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 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 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
Name Compatibilidad con Certyneo
Dirección URL https://certyneo.com/fr/contact
Email support@certyneo.com
Metadatos del conector
Publicador Certyneo
Sitio web https://certyneo.com
Directiva de privacidad https://certyneo.com/fr/legal/privacy
Categories Operaciones de TI; Productividad

Certyneo

Certyneo es un servicio de firma electrónica compatible con eIDAS. Este conector permite que un flujo envíe documentos para la firma, reaccione en tiempo real cuando un firmante actúa y registre el PDF firmado y su archivo de evidencia donde el resto de la empresa conserve sus registros.

El flujo típico es tres pasos: un documento llega a algún lugar (una biblioteca de documentos, un buzón, un envío de formulario), el flujo crea y envía un sobre, y un segundo flujo desencadenado por envelope.completed descargas del PDF firmado y lo almacena.

Publicador

Certyneo

Prerequisites

Necesita una cuenta de Certyneo en un plan que incluya acceso a la API. Los planes gratis y personal pueden crear claves de API y suscribirse a eventos, pero solo reciben eventos para sobres de espacio aislado; consulte Los problemas conocidos y las limitaciones siguientes.

Obtención de credenciales

El conector se autentica con una clave de API certyneo.

  1. Inicie sesión en Certyneo y abra Configuración → claves de API.
  2. Cree una clave. Las claves dinámicas comienzan con sk_live_, claves de espacio aislado con sk_test_.
  3. Cuando el conector solicite la clave de API, pegue la palabra Bearer, un espacio y, a continuación, la clave ; por ejemplo Bearer sk_live_abc123, . Certyneo espera la palabra Bearer delante de la clave y se rechaza una clave pegada por sí misma con 401.

La clave contiene ámbitos. Una clave sin envelopes:write no puede crear ni enviar, y una clave sin webhooks:write no puede revertir el desencadenador. Conceda los ámbitos que realmente necesita el flujo.

Prueba sin enviar correos electrónicos a nadie

Una clave de espacio aislado (sk_test_) ejerce toda la canalización sin enviar un solo correo electrónico de invitación. Nada llega a una bandeja de entrada real, lo que también significa que nadie puede llegar a la página de firma desde un correo electrónico, por lo que Crear sobre y Enviar sobre devuelve un token de acceso para cada destinatario en su lugar. Abra https://certyneo.com/sign/<access token> para firmar el sobre de prueba usted mismo.

Tratar ese token como una credencial: cualquier persona que lo contenga puede firmar como ese destinatario. No lo registres y no lo coloques en una hoja de cálculo.

Operaciones soportadas

Trigger

Cuando se produce un evento de sobre , se desencadena en los eventos que selecciona, respaldados por un webhook real en lugar de sondear. Eventos disponibles:

envelope.created, envelope.sent, envelope.completed, envelope.declined, envelope.voided, envelope.expired, envelope.returned_to_senderenvelope.resubmitted, recipient.signed, , recipient.viewed. recipient.approved

Cada carga lleva el identificador de sobre, tanto en el sobre como en los eventos de destinatario. Ese es el valor que se va a introducir en las acciones siguientes.

Las entregas se firman con HMAC-SHA256 en el X-Certyneo-Signature encabezado: un resumen hexadecimal del cuerpo JSON sin procesar, con clave con el secreto de suscripción. Compruíbalo antes de que un flujo actúe en la carga.

Acciones

Action Qué hace
Plantillas de lista Las plantillas de sobre guardadas. Activa el selector de plantillas.
Crear sobre Crea un sobre BORRADOR a partir de una plantilla o de documentos cargados.
Envío de sobre Envía un sobre DRAFT a sus destinatarios.
Obtener sobre Estado actual y detalles del destinatario.
Sobres de lista Lista paginada, filtrable por estado.
Cargar documento Carga un PDF o una imagen y devuelve un identificador de documento.
Descargar documento firmado La página pdf firmada, certificado incluida.
Descarga de la pista de auditoría El archivo de evidencia: quién firmó, cuándo, desde qué DIRECCIÓN IP, con qué factores.
Eliminar sobre borrador Elimina un sobre que nunca se envió.

Limitaciones y problemas conocidos

No se puede recuperar un sobre enviado de un flujo.Eliminar sobre borrador solo acepta sobres todavía en BORRADOR: un flujo que produjo un error a mitad de camino, un documento incorrecto. Una vez que un sobre ha salido, devuelve 409 y hoy no hay ninguna operación de cancelación en la API.

recipient.signed se activa antes de que exista el PDF firmado, incluido para el último firmante. El montaje y el sellado del documento final se producen después de ese evento, por lo que un flujo que se desencadena en recipient.signed y llama inmediatamente a Descargar documento firmado obtiene 409 cada vez. Esta no es una carrera que se puede ganar con un retraso: desencadenador en envelope.completed su lugar, que se activa una vez que el PDF está en el disco.

Los planes gratis y personal solo reciben eventos de espacio aislado. Ambos pueden crear una suscripción y el desencadenador se mostrarán como correctos, pero los sobres dinámicos nunca llegarán a ella. Si un desencadenador parece no hacer nada en el tráfico real, compruebe el plan antes de cualquier otra cosa.

Use una plantilla o documentos, nunca ambos. Una plantilla incluye sus propios documentos y sus propios campos de firma. Al compilar a partir de documentos cargados en su lugar, también debe proporcionar Campos : un sobre cuyo firmante no tiene ninguna parte para firmar se rechaza en el momento de envío con 409 signer_without_field, no en tiempo de creación.

Prefiere el texto delimitador en las coordenadas. La colocación de un campo entrecomillando una frase del documento ("Signature du client") sobrevive a un cambio de diseño y no necesita medir. X e Y permanecen como reserva, por lo que un campo cuyo delimitador no se encuentra mantiene una posición literal en lugar de desaparecer.

Las cargas se limitan a 50 MB por documento.

Un documento purgado devuelve 410, no 409. 409 significa "aún no listo, volver después envelope.completedde ". 410 significa que el documento firmado se eliminó deliberadamente en la directiva de retención y nunca vuelve. Un bucle de reintento debe renunciar a 410.

Errores y soluciones comunes

Respuesta Causa Solución
401 Falta la clave o pegada sin Bearer delante Vuelva a escribir la conexión como Bearer sk_live_...
403 La clave carece del ámbito de esta operación. Vuelva a emitir la clave con los ámbitos que necesita el flujo.
409 en descarga El sobre aún no se ha completado Desencadenador en envelope.completed lugar de sondear
409 en envío signer_without_field : un firmante no tiene ningún campo de firma. Agregar campos o compilar a partir de una plantilla
409 al eliminar El sobre ya se ha enviado Los sobres enviados no se pueden eliminar ni recuperar
410 en descarga El documento se purgó en la directiva de retención. Detener el reintento; el archivo ha desaparecido

Los errores llevan un mensaje legible error y un estable code. Bifurcación en code : se puede volver a escribir el mensaje.

Support

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.

Name Tipo Description Required
Clave de API securestring La clave de API de esta API True

Acciones

Cargar documento

Cargue un PDF o una imagen (máximo de 50 MB). Devuelve un identificador de documento: páselo a "Crear sobre" en "Documentos".

Crear sobre

Cree un nuevo sobre en el estado BORRADOR, ya sea desde una plantilla guardada o directamente desde los documentos que cargó con "Cargar documento". Rellene exactamente una de las "plantillas" o "Documentos". Con los documentos, agregue también "Campos", por lo que cada firmante tiene en algún lugar para firmar: la manera más sencilla es citar una frase del documento en "Texto delimitador" en lugar de trabajar con coordenadas. IMPORTANTE: esta acción solo crea el sobre; aún no se envía ningún correo electrónico. Agregue la acción "Enviar sobre" justo después de esta en el flujo para enviarlo realmente a los destinatarios.

Descarga de la pista de auditoría

Obtenga el archivo de evidencia de un sobre completado, quién firmó, cuándo, desde qué dirección IP, con qué factores de autenticación. Archivarlo junto al PDF firmado: es lo que se activa una disputa de eIDAS.

Descargar documento firmado

Obtenga el PDF firmado, página de certificado incluida. Solo una vez completado el sobre , antes de que devuelva 409, así que desencadene "Sobre completado" en lugar de sondear.

Eliminar sobre borrador

Elimine un sobre que nunca se envió: un flujo que produjo un error a mitad de camino, un documento incorrecto. Solo BORRADOR: una vez que se ha salido un sobre, devuelve un error y no se puede recuperar de un flujo.

Envío de sobre

Enviar un sobre DRAFT a sus destinatarios para su firma: este es el paso que realmente envía el correo electrónico. "Crear sobre" solo lo guarda como borrador; no envía nada por sí solo. Encadene siempre esta acción justo después de "Crear sobre" en el flujo, con el identificador de sobre que devolvió.

Obtener sobre

Obtenga el estado actual y los detalles de un sobre.

Plantillas de lista

Devuelve las plantillas de sobre guardadas. Se usa para activar el selector de plantillas en "Crear sobre".

Sobres de lista

Recuperar una lista paginada de sobres.

Cargar documento

Cargue un PDF o una imagen (máximo de 50 MB). Devuelve un identificador de documento: páselo a "Crear sobre" en "Documentos".

Parámetros

Nombre Clave Requerido Tipo Description
Archivo
file True file

Pdf o imagen que se va a cargar, 50 MB como máximo.

Nombre del documento
name string

Nombre en el que se va a archivar el documento. El valor predeterminado es el propio nombre del archivo cargado.

Devoluciones

Body
Document

Crear sobre

Cree un nuevo sobre en el estado BORRADOR, ya sea desde una plantilla guardada o directamente desde los documentos que cargó con "Cargar documento". Rellene exactamente una de las "plantillas" o "Documentos". Con los documentos, agregue también "Campos", por lo que cada firmante tiene en algún lugar para firmar: la manera más sencilla es citar una frase del documento en "Texto delimitador" en lugar de trabajar con coordenadas. IMPORTANTE: esta acción solo crea el sobre; aún no se envía ningún correo electrónico. Agregue la acción "Enviar sobre" justo después de esta en el flujo para enviarlo realmente a los destinatarios.

Parámetros

Nombre Clave Requerido Tipo Description
Asunto
subject True string

Asunto de sobre/título.

Message
message string

Mensaje que se muestra a los destinatarios.

Plantilla
templateId string

Elija una plantilla guardada. Use este or "Documentos", no ambos: una plantilla aporta sus propios documentos y campos de firma.

Documents
documentIds array of string

Identificadores de documento de "Cargar documento". Use esta O "Plantilla", no ambas. Cuando se usan documentos, agregue también "Campos" ( un sobre cuyo firmante no tiene ningún campo de firma se rechaza en el momento de envío.

Correo electrónico del firmante
recipientEmail True string

Debe coincidir exactamente con uno de los destinatarios anteriores.

Número de documento
documentIndex integer

Qué documento lleva este campo, contando de 0 en el orden indicado anteriormente. Deje vacío cuando solo haya un documento.

Página
pageNumber True integer
Tipo de campo
fieldType True string
Texto delimitador (recomendado)
anchorText string

Texto que se va a buscar en el documento: el campo se coloca junto a él, por lo que no necesita coordenadas. No distingue mayúsculas de minúsculas e incluso cuando el PDF divide la frase entre ejecuciones. Deje vacío para usar X/Y en su lugar.

Selección de ubicación de anclaje
anchorPlacement string

Dónde colocar el campo en relación con el texto del delimitador.

Repetición de anclaje
anchorIndex integer

Qué repetición se va a usar, contando desde 0, cuando el texto del delimitador aparece varias veces.

X
x True number

Apunta desde el borde izquierdo. Se omite cuando se encuentra el delimitador, se mantiene como reserva para que el campo nunca desaparezca.

Y
y True number

Apunta desde el borde SUPERIOR. Se omite cuando se encuentra el delimitador, que se mantiene como reserva.

Ancho
width True number
Altura
height True number
Correo electrónico del destinatario
email True string
Nombre del destinatario
name string
Función
role string
estado
status string
signedAt
signedAt string
Token de acceso
accessToken string

Abre la página de firma de este destinatario en https://certyneo.com/sign/<el token>. En el espacio aislado no sale ningún correo electrónico de invitación, así que así es como firma un sobre de prueba usted mismo. Devuelto por "Crear sobre" y "Enviar sobre", no por "Obtener sobre", donde permanece vacío. Tratarlo como una credencial: cualquier persona que lo contenga puede firmar como este destinatario, por lo que no lo registre ni colóquelo en una hoja de cálculo.

Nivel de firma
signatureLevel string
Expira en
expiresAt date-time
Categoría
category string

Clasificación empresarial que se muestra en la lista de sobres. Deje vacío y Certyneo infiere uno del asunto.

Etiquetas
tags array of string

Etiquetas de forma libre: código de proyecto, referencia de cliente, estado interno. Hasta 10, cada uno de ellos hasta 40 caracteres. Servidor en minúsculas y desduplicados.

Idioma
locale string

Idioma de todo lo que ve el firmante: página de firma, invitación, recordatorios, correo electrónico de finalización. Código BCP-47, por ejemplo, nl, nl-BE, en-GB, de, fr. Deje vacío para heredar el idioma de la cuenta certyneo enviando el sobre. Se rechaza un código no admitido con 400.

URL de redirección
redirectUrl string

Donde se envía el firmante después de la firma. Reemplaza la llamada a la acción predeterminada de Certyneo por un solo botón "Continuar" que apunta aquí. Debe comenzar con https://: cualquier otra cosa se rechaza con un 400.

Iniciales en cada página
initialsOnEveryPage boolean

Marca automáticamente las iniciales del firmante en la parte inferior de cada página de cada documento, además de cualquier campo que coloques tú mismo. No se necesita ninguna configuración por página: el firmante rellena sus iniciales una vez y se aplica en todas partes. Omite una página donde ese firmante ya tiene un campo (por ejemplo, la firma en la última página).

Workspace
workspaceId string

Cree el sobre en un área de trabajo compartida para que todos los miembros de esa área de trabajo puedan verlo y realizar un seguimiento. Deje vacío para mantenerlo en su propia cuenta. Debe ser propietario del área de trabajo o ser miembro de él.

Devoluciones

Body
Envelope

Descarga de la pista de auditoría

Obtenga el archivo de evidencia de un sobre completado, quién firmó, cuándo, desde qué dirección IP, con qué factores de autenticación. Archivarlo junto al PDF firmado: es lo que se activa una disputa de eIDAS.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de sobre
id True string

Identificador del sobre cuya pista de auditoría desea descargar.

Devoluciones

response
binary

Descargar documento firmado

Obtenga el PDF firmado, página de certificado incluida. Solo una vez completado el sobre , antes de que devuelva 409, así que desencadene "Sobre completado" en lugar de sondear.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de sobre
id True string

Identificador del sobre cuyo documento firmado desea descargar.

Devoluciones

response
binary

Eliminar sobre borrador

Elimine un sobre que nunca se envió: un flujo que produjo un error a mitad de camino, un documento incorrecto. Solo BORRADOR: una vez que se ha salido un sobre, devuelve un error y no se puede recuperar de un flujo.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de sobre
id True string

Identificador del sobre borrador que se va a eliminar.

Devoluciones

Envío de sobre

Enviar un sobre DRAFT a sus destinatarios para su firma: este es el paso que realmente envía el correo electrónico. "Crear sobre" solo lo guarda como borrador; no envía nada por sí solo. Encadene siempre esta acción justo después de "Crear sobre" en el flujo, con el identificador de sobre que devolvió.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de sobre
id True string

Identificador del sobre borrador que se va a enviar a sus destinatarios.

Devoluciones

Body
Envelope

Obtener sobre

Obtenga el estado actual y los detalles de un sobre.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de sobre
id True string

Identificador del sobre que se va a recuperar.

Devoluciones

Body
Envelope

Plantillas de lista

Devuelve las plantillas de sobre guardadas. Se usa para activar el selector de plantillas en "Crear sobre".

Devoluciones

Sobres de lista

Recuperar una lista paginada de sobres.

Parámetros

Nombre Clave Requerido Tipo Description
Página
page integer

Página de resultados que se van a devolver. Comienza en 1.

Tamaño de página
limit integer

Cuántos sobres se van a devolver por página.

Situación
status string

Devuelve solo los sobres de este estado. Deje vacío para devolver cada estado.

Devoluciones

Desencadenadores

Cuando se produce un evento de sobre

Desencadena un flujo cada vez que se produce uno de los eventos seleccionados en cualquiera de los sobres (por ejemplo, firmado, completado, rechazado). Respaldado por un webhook en tiempo real, sin sondeo.

Cuando se produce un evento de sobre

Desencadena un flujo cada vez que se produce uno de los eventos seleccionados en cualquiera de los sobres (por ejemplo, firmado, completado, rechazado). Respaldado por un webhook en tiempo real, sin sondeo.

Parámetros

Nombre Clave Requerido Tipo Description
Events
events True array of string

Qué eventos de sobre/destinatario deben desencadenar este flujo.

Devoluciones

Entregado firmado con HMAC-SHA256 en el encabezado X-Certyneo-Signature (resumen hexadecimal del cuerpo JSON sin formato, con clave con el secreto de la suscripción). Compruébalo antes de confiar en la carga en un flujo que actúa en él (consulte /developers/webhooks).

Definiciones

DeleteResult

Nombre Ruta de acceso Tipo Description
Success
success boolean

True cuando se eliminó el recurso.

Pagination

Nombre Ruta de acceso Tipo Description
total
total integer
página
page integer
pageSize
pageSize integer
pages
pages integer

Plantilla

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
description
description string
signerCount
signerCount integer
documentCount
documentCount integer

TemplateList

Nombre Ruta de acceso Tipo Description
datos
data array of Template
paginación
pagination Pagination

Recipient

Nombre Ruta de acceso Tipo Description
Correo electrónico del destinatario
email string
Nombre del destinatario
name string
Función
role string
estado
status string
signedAt
signedAt string
Token de acceso
accessToken string

Abre la página de firma de este destinatario en https://certyneo.com/sign/<el token>. En el espacio aislado no sale ningún correo electrónico de invitación, así que así es como firma un sobre de prueba usted mismo. Devuelto por "Crear sobre" y "Enviar sobre", no por "Obtener sobre", donde permanece vacío. Tratarlo como una credencial: cualquier persona que lo contenga puede firmar como este destinatario, por lo que no lo registre ni colóquelo en una hoja de cálculo.

Documento

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
tipo MIME
mimeType string
size
size integer
estado
status string

Sobre

Nombre Ruta de acceso Tipo Description
id
id string
subject
subject string
message
message string
estado
status string
signatureLevel
signatureLevel string
recipients
recipients array of Recipient
expiresAt
expiresAt string
createdAt
createdAt string
completedAt
completedAt string

EnvelopeList

Nombre Ruta de acceso Tipo Description
datos
data array of Envelope
paginación
pagination Pagination

WebhookEventPayload

Entregado firmado con HMAC-SHA256 en el encabezado X-Certyneo-Signature (resumen hexadecimal del cuerpo JSON sin formato, con clave con el secreto de la suscripción). Compruébalo antes de confiar en la carga en un flujo que actúa en él (consulte /developers/webhooks).

Nombre Ruta de acceso Tipo Description
evento
event string
timestamp
timestamp date-time
Id. de sobre
data.envelopeId string

Siempre presente. Indítelo en "Obtener sobre" o "Descargar documento firmado".

Asunto
data.subject string

Presente solo en los eventos de sobre.

Situación
data.status string
Nivel de firma
data.signatureLevel string

Presente en envelope.completed y recipient.signed.

Firmantes de firma avanzados con una clave personal
data.aesSignerCount integer

envelope.completed solo en un sobre AVANZADO.

Serie de certificados de firma avanzada
data.aesCertificateSerial string

recipient.signed, cuando el firmante firmó con una clave de firma avanzada personal.

Certificado de firma avanzada SHA256
data.aesCertificateSha256 string

recipient.signed, cuando el firmante firmó con una clave de firma avanzada personal.

Manifiesto de firma avanzado SHA256
data.aesManifestSha256 string

recipient.signed, cuando el firmante firmó con una clave de firma avanzada personal.

Marca de tiempo de firma avanzada
data.aesTimestamped boolean

recipient.signed, cuando el firmante firmó con una clave de firma avanzada personal.

Número de destinatarios
data.recipientCount integer

Presente solo en los eventos de sobre.

Recuento firmado
data.signedCount integer

Presente solo en los eventos de sobre.

Id. del destinatario
data.recipientId string

Solo está presente en eventos de destinatario.

Correo electrónico del destinatario
data.email string

Solo está presente en eventos de destinatario.

Nombre del destinatario
data.name string

Solo está presente en eventos de destinatario.

Rol de destinatario
data.role string

Solo está presente en eventos de destinatario.

Firmado en
data.signedAt date-time

Solo está presente en eventos de destinatario.

Visto en
data.viewedAt date-time

Solo está presente en eventos de destinatario.

binary

Este es el tipo de datos básico "binary".