El parámetro "data" se utiliza para introducir valores en un campo de formulario. Estos campos pueden crearse con la función de "Plantillas" desde tu dashboard o los puedes introducir directamente en tu PDF por medio de un programa de edición.
Cuando el valor corresponde con un campo contenido en el PDF, este valor se estampará directamente en el documento. Es decir, no puede ser editado por el firmante.
Cuando el valor corresponde con un campo de widget de un documento plantilla, el valor se introducirá como un valor de defecto en el widget. Es decir, puede ser editado por el firmante.
Utilizar el parámetro "data" en un campo contenido en un PDF:
Es posible crear campos de formularios en un documento PDF utilizando programas de edición como PDFescape.
En este ejemplo utilizaremos la herramienta PDFescape por su facilidad de uso.
Solo tienes que abrir la herramienta online y hacer click en "Form field" para añadir un widget. Selecciona el tipo:
Una vez hayas seleccionado el tipo de widget, introdúcelo en tu documento donde mejor convenga:
Haz click derecho sobre el widget y selecciona "Object Properties". Esto te dará la opción de nombrar el widget:
Edita tu PDF como quieras utilizando tus widgets personalizados. Sigue las instrucciones de PDFescape o de tu editor de PDF y guarda el documento.
Cuando lo tengas, procede a crear tu llamada de Create Signature utilizando el parámetro "data":
recipients[0][name]:John
recipients[0][email]:admin@domain.com
data[place]:Barcelona
data[datum]:December, the 15th
data[company]:Signaturit
data[name]:John Doe
data[accept]:1
data[date_num]:10-15-2017
delivery_type:url
file:test.pdf
Cuando el firmante proceda a realizar la firma verá los campos ya rellenados, sin posibilidad de modificarlos:
Utilizar el parámetro "data" con una plantilla de Signaturit:
Para saber cómo crear una plantilla de documento con Signaturit, mira este tutorial.
Ten en cuenta que el nombre del widget que añadas en el parámetro data tiene que coincidir exactamente con el ID del widget. El ID lo encontrarás haciendo click derecho sobre el widget, en la pantalla de edición de plantillas.
Recomendamos que hagas un copiar y pegar del ID:
Cuando hayas seleccionado e insertado todos los widgets en tu documento, guarda tu plantilla y haz una llamada como esta:
recipients[0][fullname]:Francisco
recipients[0][email]:francisco.alsina@signaturit.com
data[textfield_02]:Barcelona
data[date_01]:15-12-2018
data[textfield_04]:Signaturit
data[textfield_05]:John Doe
data[checkbox_01]:1
data[date_02]:15-12-2018
delivery_type:url
templates:#data_test
El firmante recibirá el documento con los valores introducidos en "data" como valores por defecto. Podrá modificarlos si es necesario: