Cómo enviar un PDF a viafirma documents

Cuando un sistema externo necesita enviar un PDF para ser firmado a viafirma documents podrá hacerlo mediante dos mecanismos:

• enviando el PDF en base64.
• enviando una URL en la que el PDF está disponible para su descarga directa (URI).

Este comportamiento se define en las propiedades del objeto Documents, tal y como se detalla a continuación:

Document {
  templateReference (string, optional),
  templateType (string) = ['docx', 'odt', 'url', 'pdf', 'cache', 'base64'],
  policyCode (string, optional)
}

• Document.templateReference: aquí indicaremos el base64 del PDF o la URL en la que poder descargar el PDF.
• Document.templateType: usaremos los valores "base64" o "url" según corresponda.
• Document.policyCode: identificador de la política elegida para cada caso. Este identificador podrá ser gestionado desde el backend de viafirma documents; ver gestión de modelos > políticas. Este atributo es opcional, y si lo omitimos, tendremos que informar de forma explícita la política de firma deseada; para este caso consultar el uso de Políticas.

Ejemplo:

Document {
  templateReference:"https://www.viafirma.com/myPDF_sample.pdf",
  templateType:"url",
  policyCode:"myPolicyCode_sample_001"
}

El objeto Document admite otro tipo de configuración que podrá ser consultada en la definición del servicio. En este artículo sólo se han mencionado los atributos necesarios para poder enviar un PDF a viafirma documents mediante servicio.