Documentación - Integración

Un arreglo para los datos del firmante, email es obligatorio el nombre opcional, si tu cuenta está en modo DEMO puedes enviar solamente a los usuarios registrados en tu cuenta:

• email: firmante@example.com
• nombre_completo: FULANO

Puedes enviar uno o varios archivos PDF:

• nombre: Nombre del archivo, ejemplo: archivo-1.pdf
• zip_base64: Archivo PDF zipeado en base64
• firma_visual: Estos son los parámetros para la representación visual de la firma. *** 
  • ubicacion_x: Ubicación de la firma en la ubicación X, empieza desde el margen inferior izquierdo.
  • ubicacion_y: Ubicación de la firma en la ubicación Y, empieza desde el margen inferior izquierdo.
  • largo: Largo de la representación impresa de la firma.
  • alto: Alto de la representación impresa de la firma.
  • pagina: Página donde se verá la representación impresa de la firma.
  • texto: Texto de la firma, las etiquetas entre “<” y “>” serán reemplazadas con los valores del certificado que usará el Firmante. Ejemplo:  "Firmado por:<FIRMANTE>\r\n<ORGANIZACION>\r\n<TITULO>\r\n<CORREO>\r\n<DIRECCION>\r\n<FECHA>\r\n Firmado con Watana"
  • image_zip_base64: Imagen para la representación impresa Zipeada en base64 (Opcional).

Para los saltos de línea usar \r\n. 

IMPORTANTE: Consideraciones con el atributo “firma_visual”:

• Si deseas que la posición de la representación visual sea seleccionada por el firmante con Watana App manualmente, el atributo “firma_visual” debe ser “true” (Booleano).
• Si deseas una firma digital sin una representación visual de la firma puedes simplemente no enviar el atributo “firma_visual” o en su defecto enviarlo en “false” (Booleano).
• Si dentro del objeto del atributo “firma_visual” no envias el atributo “image_zip_base64” la imagen que se mostrará en la representación visual será la que el firmante tenga configurado en Watana App.
• Al enviar el atributo “image_zip_base64” la representacion visual contendra la imagen que enviaste y no la que el firmante tiene configurada.
• El atributo “firma_visual” puede comportarse como un Booleano o como un Objeto dependiendo de las consideraciones expuestas anteriormente.
  • EJ: {….., “firma_visual”:true,…..} o {….., “firma_visual”: {"ubicacion_x:0,……},….}

Si desea sellar con LLAMA.PE enviar: sello_de_tiempo: true, pero si se desea sellar con una TSA externa enviar un objeto con lo siguientes parametros:

• url: Ruta de la TSA externa que sellara el PDF
• usuario: Usuario de la TSA
• password: Password de la TSA

• ubicacion_x: Ubicación de la firma en la ubicación X, empieza desde el margen inferior izquierdo.
• ubicacion_y: Ubicación de la firma en la ubicación Y, empieza desde el margen inferior izquierdo.
• largo: Largo de la representación impresa de la firma.
• alto: Alto de la representación impresa de la firma.
• pagina: Página donde se verá la representación impresa de la firma.
• texto: Texto de la firma, las etiquetas entre “<” y “>” serán reemplazadas con los valores del certificado que usará el Firmante. Ejemplo:  "Firmado por:<FIRMANTE>\r\n<ORGANIZACION>\r\n<TITULO>\r\n<CORREO>\r\n<DIRECCION>\r\n<FECHA>\r\n Firmado con Watana"
• imagen_zip_base64: Imagen para la representación impresa Zipeada en base64 (Opcional)

Puedes enviar uno o varios archivos PDF:

• nombre: Nombre del archivo, ejemplo: archivo-1.pdf
• zip_base64: Archivo PDF zipeado en base64

Un arreglo para los firmantes, email es obligatorio el nombre opcional, si tu cuenta está en modo DEMO puedes enviar solamente a los usuarios registrados en tu cuenta:

• email: firmante@example.com
• nombre_completo: FULANO
• sello_de_tiempo: true ---- Establece si se aplica sello de tiempo de LLAMA.PE a la solicitud de firma
• solo_firma_electronica_web: false ---- El firmante puede completar la firma digital sin necesidad de que use Watana App o tenga una cuenta creada,  podra hacerlo desde la web usando un certificado de Agente Automatizado de LLAMA.PE.
• firmas: Arreglo de configuración de firmas por cada firmante. 
  • archivo: Nombre del archivo previamente cargado (El nombre del archivo debe existir). EJ: archivo.pdf
  • ubicacion_x: Ubicación de la firma en la ubicación X, empieza desde el margen inferior izquierdo.
  • ubicacion_y: Ubicación de la firma en la ubicación Y, empieza desde el margen inferior izquierdo.
  • largo: Largo de la representación impresa de la firma.
  • alto: Alto de la representación impresa de la firma.
  • pagina: Página donde se verá la representación impresa de la firma.
  • texto: Texto de la firma, las etiquetas entre “<” y “>” serán reemplazadas con los valores del certificado que usará el Firmante. Ejemplo:  "Firmado por:<FIRMANTE>\r\n<ORGANIZACION>\r\n<TITULO>\r\n<CORREO>\r\n<DIRECCION>\r\n<FECHA>\r\n Firmado con Watana"
  • image_zip_base64: Imagen para la representación impresa Zipeada en base64 (Opcional).