Posicionar firma (opcional)
Last updated
Was this helpful?
Last updated
Was this helpful?
Was this helpful?
Al crear documentos a través de la API de ZapSign, es posible posicionar automáticamente las firmas y rúbricas en el contenido del archivo PDF o DOCX utilizando anclas de texto.
Crear documento vía Upload: https://docs.zapsign.com.br/documentos/criar-documento
Es posible definir la posición exacta de cada firma o rúbrica utilizando coordenadas manuales.
POST https://api.zapsign.com.br/api/v1/docs/{{doc_token}}/place-signatures/
Authorization*
string
API token prefijo con la palabra "Bearer". Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23
rubricas[type]
string
Hay dos tipos de rubricas: la firma "signature" o las iniciales "visto".
Valor por defecto: "signature".
rubricas[page]
integer
Página donde se posicionará la firma o iniciales. Empieza en 0.
rubricas[relative_size_x]
number
El tamaño de la firma o iniciales. Mayor explicación a continuación
rubricas[relative_size_y]
number
El tamaño de la firma o iniciales. Mayor explicación a continuación
rubricas[relative_position_bottom]
number
Posición en la página de la firma o iniciales. Mayor explicación a continuación
rubricas[relative_position_left]
number
Posición en la página de la firma o iniciales. Mayor explicación a continuación
rubricas[signer_token]
string
Token del firmante (signer_toke) para posicionar la firma o iniciales.
ZapSign calcula dónde se posicionarán las firmas basándose en las coordenadas definidas en el JSON. A continuación, te explicamos cómo funciona:
El eje x y el eje y comienzan desde la esquina inferior izquierda de cada página del documento. Por ejemplo, la posición de la firma de "Fulano Silveira" en el lado derecho del documento correspondería al siguiente JSON:
{
"page": 0, //1st document page
"relative_position_bottom": 42.50, //distance from 0 to 100 from the bottom edge of the page
"relative_position_left": 65.71, //distance from 0 to 100 from the left edge of the page
"relative_size_x": 19.55, //size from 0 to 100 of signature compared to page width
"relative_size_y": 9.42, //size from 0 to 100 of signature compared to page height
"signer_token": "cf1c0b7a-03d3-468b-97ce-3061e3abcdefg" //signer token of "Fulano Silveira"
}A continuación, se detallan los campos:
relative_position_left y relative_position_bottomReglas matemáticas a seguir:
Estos valores determinan dónde aparecerá la firma en el documento. Es importante asegurarse de que la firma no quede fuera de los límites del documento. Por ejemplo, si relative_position_left es 80, entonces relative_size_x no debe ser mayor a 20, ya que la suma total (100 en el eje X) excedería los límites y la firma quedaría cortada.
Reglas matemáticas a seguir: 0 <= relative_size_y <= 100 0 <= relative_size_x <= 100 0 <= relative_position_bottom <= 100 0 <= relative_position_left <= 100
Y también 0 <= (relative_size_y + relative_position_bottom) <= 100 0 <= (relative_size_x + relative_position_left) <= 100
relative_size_x y relative_size_yPara documentos en formato vertical A4 (el más común), se recomienda usar
Firma: relative_size_x: 19.55 y relative_size_y: 9.42
Iniciales: relative_size_x: 13.76 y relative_size_y: 9.42
Para documentos en formato horizontal A4, se recomienda usar:
Firma: relative_size_x: 15.05 y relative_size_y: 12.13
Iniciales: relative_size_x: 10.58 y relative_size_y: 12.13
Si deseas ajustar el tamaño, asegúrate de mantener la proporción multiplicando ambos valores por el mismo número.
page)El campo page corresponde al número de la página donde se colocará la firma, comenzando desde 0 (la primera página). Si deseas posicionar la firma en la misma posición en varias páginas, debes incluir un objeto por cada página en el JSON.
Por ejemplo:
{
"rubricas":[
{
"page": 0, //1st document page
"relative_position_bottom": 42.50,
"relative_position_left": 65.71,
"relative_size_x": 19.55,
"relative_size_y": 9.42,
"signer_token": "cf1c0b7a-03d3-468b-97ce-3061e3abcdefg"
},
{
"page": 1, //2nd document page
"relative_position_bottom": 42.50,
"relative_position_left": 65.71,
"relative_size_x": 19.55,
"relative_size_y": 9.42,
"signer_token": "cf1c0b7a-03d3-468b-97ce-3061e3abcdefg"
}
]
}¿Cómo puedo verificar si la colocación de las firmas funcionó?
Puedes verificarlo directamente en el PDF después de que el documento haya sido firmado. Las validaciones deben hacerse de tu lado.
Si el posicionamiento fue incorrecta, ¿puedo corregirla?
Sí. Para reemplazar las firmas colocadas anteriormente, solo necesitas hacer un nuevo POST en esta ruta. Esto eliminará las firmas anteriores y las reemplazará con las nuevas.
¿Cómo cancelo el posicionamiento de firmas?
Puedes enviar un POST con el objeto rubricas vacío, por ejemplo: { "rubricas": [] }.
¿El documento firmado se actualiza cada vez que cambio la posición de las firmas?
¡No! Los cambios en la posición solo se aplicarán cuando un firmante firme el documento nuevamente. Por lo tanto, el documento no se actualizará automáticamente, sino después de una nueva firma.