Penneo Sign Production (versión preliminar)

Penneo transforma procesos complejos en una experiencia sin problemas centrada en el ser humano. Al integrar firmas digitales en flujos de trabajo automatizados, nuestra plataforma hace que sea fácil validar quién aprobó qué datos y cuándo, lo que reduce las cargas administrativas al tiempo que garantiza el cumplimiento y la seguridad completos. Este conector le permite enviar documentos para la firma.

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	Compatibilidad con Penneo
DIRECCIÓN URL	https://www.support.penneo.com

Metadatos del conector
Publicador	Integración de Penneo
source	Swagger
Sitio web	https://penneo.com
Directiva de privacidad	https://penneo.com/privacy-policy
Categorías	Productividad

Penneo Sign

Prerequisites

Para usar este conector, necesitará una cuenta de Penneo activa.

Acciones soportadas

Creación de un nuevo archivo de casos

Crea un nuevo archivo de mayúsculas y minúsculas en Penneo con los documentos y firmantes especificados. El archivo case se creará en Penneo y se devolverá un UUID y una cargaHash que se puede usar para comprobar el estado de creación a través del punto de conexión de estado de la cola.

Comprobar el estado del trabajo

Recupera el estado actual de un archivo case proporcionando el UUID del trabajo y payloadHash. Este punto de conexión se usa para sondear el estado de finalización del trabajo después de enviar una solicitud de creación de archivos de caso. El punto de conexión está limitado a 20 solicitudes por minuto por combinación uuid-payloadHash.

Obtención de detalles del archivo de casos

Recupera los detalles de un archivo de caso específico de Penneo basado en casefileId. Esto incluye sus firmantes, documentos y estado actual.

Descargar documento

Descarga el contenido de un documento de Penneo como una cadena codificada en base64. De forma predeterminada, se devuelve la versión firmada del documento; Use el signed parámetro para obtener la versión sin firmar en su lugar. Si el archivo de caso incluye más documentos, asegúrese de recorrer en bucle cada documento.

Obtención de credenciales

El conector se ha configurado para usar OAuth con concesión de código de autorización. Los usuarios tendrán que iniciar sesión con sus credenciales normales cuando usen el conector.

Getting Started

Creación de un archivo de casos

Preparar los documentos:
- Convertir los documentos PDF en codificación base64
- Asegurarse de que los documentos son archivos PDF válidos
Configurar firmantes:
- Proporcione el nombre del firmante y el correo electrónico (obligatorio)
- Opcionalmente, proporcione el rol, el idioma, el orden de firma, etc.
- Configuración de notificaciones por correo electrónico y plantillas de correo electrónico personalizadas si es necesario
Cree el archivo de casos:
- Use la acción "Crear un nuevo archivo de casos"
- Rellene los detalles del archivo de casos:
  - Título
  - Documentos (ARCHIVOS PDF codificados en base64)
  - Firmantes (con nombres y detalles opcionales)
  - Configuración opcional (expiración, idioma, visibilidad, etc.)
Compruebe el estado de creación de CaseFile:
- Después de crear un archivo de caso, recibirá un UUID y payloadHash.
- Use la acción "Comprobar el estado del trabajo" para sondear la finalización del trabajo
- Respetar el límite de velocidad de 20 solicitudes por minuto por combinación uuid-hash

Nota: Puede comprobar lo que hace cada campo comprobando https://penneo.readme.io/reference/createcasefile.

Recuperación de un archivo de casos y sus documentos

Obtenga los detalles del archivo de casos:
- Use la acción "Obtener detalles del archivo de caso" con el identificador de archivo de caso.
- La respuesta incluye el estado del archivo de mayúsculas y minúsculas, los firmantes y la lista de documentos (con sus identificadores de documento).
Descargue un documento:
- Use la acción "Descargar documento" con el identificador de documento obtenido de los detalles del archivo del caso.
- La respuesta contiene el contenido del documento como una cadena codificada en base64, que puede descodificar para recuperar el archivo PDF.

Problemas conocidos y limitaciones

Limitación de velocidad: el punto de conexión comprobar el estado del trabajo está limitado a 20 solicitudes por minuto por combinación uuid-hash. Implemente la lógica de reintento adecuada con retroceso exponencial.
Procesamiento asincrónico: la creación de archivos de casos es asincrónica. Debe usar el punto de conexión de estado del trabajo para comprobar la finalización en lugar de esperar resultados inmediatos.
Codificación base64: los documentos deben estar codificados en base64. Asegúrese de que la codificación adecuada para evitar errores de solicitud (puede usar la función de cadena base64 en Power Platform para codificar los archivos PDF binarios).
Entorno de producción: este conector está configurado para el entorno de producción de Penneo (app.penneo.com).
Tamaño del documento: los documentos grandes pueden tardar más tiempo en procesarse. Considere los límites de tamaño del documento al codificar en base64.

Instrucciones de implementación

Ejecute los siguientes comandos y siga las indicaciones:

paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png --script script.csx

Acciones

Comprobar el estado del trabajo	Recupera el estado actual de un trabajo asincrónico proporcionando el UUID del trabajo y payloadHash. Este punto de conexión se usa para sondear el estado de finalización del trabajo después de enviar una solicitud de creación de archivos de caso. La acción está limitada a 20 solicitudes por minuto por combinación uuid-payloadHash.
Creación de un nuevo archivo de casos	Crea un nuevo archivo de mayúsculas y minúsculas en Penneo con los documentos y firmantes especificados. El archivo case se creará de forma asincrónica y se devolverá un UUID de trabajo y una cargaHash que se puede usar para comprobar el estado de creación a través de la acción Comprobar estado del trabajo. Puede configurar firmantes, documentos, orden de firma, notificaciones por correo electrónico, control de acceso y otras configuraciones de archivos de casos.
Descargar documento	Descarga el contenido de un documento de Penneo como una cadena codificada en base64. De forma predeterminada, se devuelve la versión firmada del documento.
Obtención de detalles del archivo de casos	Recupera los detalles de un archivo de caso específico de Penneo, incluidos sus firmantes, documentos y estado actual. Estados del archivo de casos: 0=new, 1=pending, 2=rejected, 3=deleted, 4=signed, 5=completed, 6=failed, 7=expired, 8=anonymized. Use el estado 5 (completado) como desencadenador para descargar los documentos firmados.

Comprobar el estado del trabajo

Id. de la operación:: CheckJobStatus

Recupera el estado actual de un trabajo asincrónico proporcionando el UUID del trabajo y payloadHash. Este punto de conexión se usa para sondear el estado de finalización del trabajo después de enviar una solicitud de creación de archivos de caso. La acción está limitada a 20 solicitudes por minuto por combinación uuid-payloadHash.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
uuid	uuid	True	uuid	UUID del trabajo que se va a comprobar. Esto se devuelve cuando se crea el trabajo.
payloadHash	payloadHash	True	string	Hash SHA-256 de la carga útil. Esto se devuelve cuando se crea el trabajo y se usa para comprobar la autenticidad de la solicitud.

Devoluciones

Body: QueueJob

Creación de un nuevo archivo de casos

Id. de la operación:: CreateCaseFile

Crea un nuevo archivo de mayúsculas y minúsculas en Penneo con los documentos y firmantes especificados. El archivo case se creará de forma asincrónica y se devolverá un UUID de trabajo y una cargaHash que se puede usar para comprobar el estado de creación a través de la acción Comprobar estado del trabajo. Puede configurar firmantes, documentos, orden de firma, notificaciones por correo electrónico, control de acceso y otras configuraciones de archivos de casos.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
title	title	True	string	Título del archivo de mayúsculas y minúsculas.
sendAt	sendAt		integer	Marca de tiempo cuando se debe enviar el archivo case. Null = inmediatamente
nombre	name	True	string	Nombre del firmante
role	role		string	Rol para el firmante. Permitido: letras, números, espacios, comas, subrayado, guion. Debe comenzar con una letra o número y no debe terminar con un espacio.
email	email		email	Correo electrónico del firmante. Penneo controlará todas las comunicaciones
failUrl	failUrl		uri	Dirección URL de redireccionamiento después de un error
language	language		string	Lenguaje de firmante
emailText	emailText		string	Texto personalizado para el correo electrónico de solicitud de firma. Si no se proporciona, el valor predeterminado es la plantilla de empresa.
signOrder	signOrder		integer	Orden de firma. 0 significa que no se aplica ninguna orden.
successUrl	successUrl		uri	Url de redireccionamiento después de que se ha realizado correctamente
emailSubject	emailSubject		string	Asunto del correo electrónico de solicitud de firma. Si no se proporciona, el valor predeterminado es la plantilla de empresa.
reminderInterval	reminderInterval		integer	Días antes de enviar el aviso
reminderEmailText	reminderEmailText		string	Texto personalizado para el correo electrónico del recordatorio. Si no se proporciona, el valor predeterminado es la plantilla de empresa.
completedEmailText	completedEmailText		string	Texto personalizado para el correo electrónico completado. Si no se proporciona, el valor predeterminado es la plantilla de empresa.
reminderEmailSubject	reminderEmailSubject		string	Asunto del correo electrónico del recordatorio. Si no se proporciona, el valor predeterminado es la plantilla de empresa.
completedEmailSubject	completedEmailSubject		string	Asunto del correo electrónico completado. Si no se proporciona, el valor predeterminado es la plantilla de empresa.
enableInsecureSigning	enableInsecureSigning		boolean	Si es true, el firmante puede usar firmas táctiles (dibujo, texto, carga de imágenes)
insecureSigningMethods	insecureSigningMethods		array of string	Métodos de firma no seguros permitidos. El valor predeterminado es la configuración de la empresa si está vacía.
secureSigningMethods	secureSigningMethods		array of string	Métodos de firma electrónica seguros permitidos. Invalida la configuración del archivo de casos y del cliente cuando se establece.
vatin	vatin		string	Número de identificación del IVA de la compañía del firmante
ssnType	ssnType		string	Tipo de SSN/móvil. Ejemplo 'dk:cpr', 'se:pin', 'no:nin', 'be:nrn', 'fi:pic' o 'sms'. El valor predeterminado es "heredado".
activeAt	activeAt		integer	Marca de tiempo de activación
expireAt	expireAt		integer	Marca de tiempo de expiración
control de acceso	accessControl		boolean	Si está habilitado, SSN/VATIN/phone se valida antes del acceso.
emailFormat	emailFormat		string	Define el formato de correo electrónico
onBehalfOf	onBehalfOf		string	La empresa o organización de la que este firmante inicia sesión en nombre de
storeAsContact	storeAsContact		boolean	Si es true, el firmante se almacenará como contacto en Penneo.
socialSecurityNumberPlain	socialSecurityNumberPlain		string	Número de teléfono o SSN del firmante (se recomienda el formato E.164)
expireAt	expireAt		integer	Marca de tiempo cuando expire el archivo case. Si no se proporciona, se aplican los valores predeterminados
language	language		string	El idioma del archivo case, se aplicará para cada firmante que no tenga un conjunto de idioma.
pdf	pdf	True	string	PDF codificado en Base64
signable	signable		boolean	True crea un documento que se puede firmar. False, el documento se agrega como datos adjuntos y no se puede firmar.
roles	roles		array of string	Los roles de firmante pueden firmar este documento. El valor predeterminado es todos los firmantes si están vacíos.
title	title	True	string	Título del documento
documentOrder	documentOrder		integer	Orden de firma del documento. El valor predeterminado es el orden proporcionado.
metadatos	metaData		string	Metadatos del documento, que se pueden buscar en Penneo
sensitiveData	sensitiveData		boolean	Si es true, los firmantes deben validar su identidad antes de acceder a los documentos. Deshabilita los datos adjuntos de correo electrónico para documentos firmados.
signOnMeeting	signOnMeeting		boolean	Especifica si los documentos se deben firmar durante una reunión.
visibilityMode	visibilityMode		integer	0 = Los firmantes ven todos los documentos. 1 = Los firmantes solo ven los documentos que necesitan firmar.
disableEmailAttachments	disableEmailAttachments		boolean	Deshabilita los datos adjuntos de correo electrónico para los documentos firmados en los correos electrónicos de finalización. Se invalida si sensitiveData es true.
disableNotificationsOwner	disableNotificationsOwner		boolean	Si el propietario del archivo de caso verdadero no recibirá notificaciones para el archivo de caso.
folderId	folderId		integer	Identificador de carpeta donde desea colocar el archivo case
metadatos	metaData		string	Metadatos del archivo de casos, que se pueden buscar en Penneo
referencia	reference		string	La referencia del archivo de casos, se mostrará en la aplicación web Penneo.
nombre	name	True	string	Nombre del destinatario
email	email	True	email	Correo electrónico del destinatario

Devoluciones

Body: JobResponse

Descargar documento

Id. de la operación:: DownloadDocument

Descarga el contenido de un documento de Penneo como una cadena codificada en base64. De forma predeterminada, se devuelve la versión firmada del documento.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de documento	documentId	True	integer	Identificador del documento que se va a descargar. Recupere los documentIds con la acción "Obtener detalles del archivo de mayúsculas y minúsculas".
Firmado	signed		boolean	Obtenga el documento firmado o sin firmar. De forma predeterminada, se devuelve el documento firmado si se ha firmado el documento.

Devoluciones

Body: DocumentContent

Obtención de detalles del archivo de casos

Id. de la operación:: GetCaseFileDetails

Recupera los detalles de un archivo de caso específico de Penneo, incluidos sus firmantes, documentos y estado actual. Estados del archivo de casos: 0=new, 1=pending, 2=rejected, 3=deleted, 4=signed, 5=completed, 6=failed, 7=expired, 8=anonymized. Use el estado 5 (completado) como desencadenador para descargar los documentos firmados.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de archivo de caso	caseFileId	True	integer	Identificador del archivo de caso que se va a recuperar. Recupere el identificador del archivo de caso con la acción "Comprobar estado del trabajo".

Devoluciones

Detalles de un archivo de caso recuperado del archivo seguro penneo.

Body: CaseFileDetails

Definiciones

JobResponse

Nombre	Ruta de acceso	Tipo	Description
jobs	jobs	array of Job	Matriz de trabajos creados (normalmente contiene un trabajo)
estado	status	string	Estado de la solicitud de creación de trabajos
message	message	string	Mensaje legible sobre la creación de trabajos

Job

Nombre	Ruta de acceso	Tipo	Description
uuid	uuid	uuid	Identificador único del trabajo que se puede usar para comprobar el estado
uuid	payload.uuid	uuid	UUID del archivo de caso creado
bundleUuid	payload.bundleUuid	uuid	UUID del lote que contiene el archivo case
etlVersionUuid	payload.etlVersionUuid	uuid	UUID de la versión ETL usada para el procesamiento
organizationUuid	payload.organizationUuid	uuid	UUID de la organización que posee este archivo de caso
customData	payload.customData	object	Metadatos y contexto adicionales para el trabajo
createdAt	createdAt	date-time	Marca de tiempo ISO 8601 cuando se creó el trabajo
payloadHash	payloadHash	string	Hash SHA-256 de la carga útil, usado para la comprobación al comprobar el estado del trabajo

QueueJob

Nombre	Ruta de acceso	Tipo	Description
type	type	string	Tipo del trabajo de cola (por ejemplo, "casefile_creation")
uuid	uuid	uuid	Identificador único del trabajo
result	result	object	Resultado de la ejecución del trabajo de cola, que se devuelve como JSON cuando se completa el trabajo. Contiene el resultado y los datos pertinentes.
jobStatus	jobStatus	string	Estado actual del trabajo. Valores posibles 'pendientes' (esperando a procesarse), 'processing' (actualmente ejecutados), 'completed' (completado correctamente), 'failed' (error de ejecución), 'aborted_duplicated' (anulado debido a la duplicación)
carga útil	payload	object	La carga original enviada con el trabajo, almacenada como JSON. Contiene los datos y metadatos del archivo de casos.
Reintentos	retries	integer	Número de veces que se ha reintentado el trabajo después de un error
createdAt	createdAt	date-time	Fecha y hora en que se creó el trabajo de cola
updatedAt	updatedAt	date-time	Fecha y hora en que se actualizó por última vez el trabajo de cola
maxRetries	maxRetries	integer	Número máximo de reintentos permitidos para este trabajo antes de que se marque como erróneo.
payloadHash	payloadHash	string	Hash SHA-256 de la carga útil, usado con fines de comprobación y seguridad
errorMessage	errorMessage	string	Mensaje de error que describe por qué se produjo un error en el trabajo, si procede. Solo está presente cuando jobStatus es "failed".

CcRecipient

Nombre	Ruta de acceso	Tipo	Description
nombre	name	string	Nombre del destinatario
email	email	email	Correo electrónico del destinatario

CaseFileDetails

Detalles de un archivo de caso recuperado del archivo seguro penneo.

Nombre	Ruta de acceso	Tipo	Description
userId	userId	integer	Identificador del usuario que posee el archivo case.
customerId	customerId	integer	Identificador del cliente al que pertenece el archivo case.
Firmantes	signers	array of SignerDetails	Lista de firmantes en el archivo de casos.
id	id	integer	Identificador del archivo de mayúsculas y minúsculas.
title	title	string	Título del archivo de mayúsculas y minúsculas.
estado	status	integer	Estado del archivo de mayúsculas y minúsculas.
documentos	documents	array of DocumentDetails	Lista de documentos en el archivo de casos.
expireAt	expireAt	integer	Marca de tiempo de UNIX cuando expira el archivo case.
ccRecipients	ccRecipients	array of CcRecipient	Lista de destinatarios cc que reciben una copia de los documentos firmados.
creado	created	integer	Marca de tiempo de UNIX cuando se creó el archivo case.
activado	activated	integer	Marca de tiempo de UNIX cuando se activó el archivo case.
actualizado	updated	integer	Marca de tiempo de UNIX cuando el archivo case se actualizó por última vez.
completado	completed	integer	Marca de tiempo de UNIX cuando se completó el archivo case.

SignerDetails

Un firmante de un archivo de caso.

Nombre	Ruta de acceso	Tipo	Description
nombre	name	string	Nombre del firmante.
id	id	integer	Identificador del firmante.
signingRequest	signingRequest	SigningRequestDetails	Solicitud de firma asociada a un firmante.

SigningRequestDetails

Solicitud de firma asociada a un firmante.

Nombre	Ruta de acceso	Tipo	Description
id	id	integer	Identificador de solicitud de firma.
email	email	string	Correo electrónico del firmante.
estado	status	integer	Estado de la solicitud de firma.

DocumentDetails

Un documento en un archivo de casos.

Nombre	Ruta de acceso	Tipo	Description
id	id	integer	Identificador del documento. Úselo para descargar el documento con la acción "Descargar documento".
estado	status	integer	Estado del documento.
signable	signable	boolean	True si el documento se puede firmar.

DocumentContent

Nombre	Ruta de acceso	Tipo	Description
Contenido del documento	content	byte	Contenido codificado en Base64 del documento.