Pular para o conteúdo principal

Estampar conteúdo aos PDFs

Após o upload do documento ao envelope, é possível estampar conteúdos diretamente ao PDF como textos, imagens e etc.

info

Só é possível adicionar conteúdos ao documento enquanto o envelope está em modo draft, ou seja, depois que o envelope é enviado, não é possível fazer edições, adições ou remoções de conteúdo.

Os conteúdos que foram adicionados ao documentos serão vistos assim que o envelopes de completar, ou seja, assim que todos os destinatários realizarem suas ações.

Sobre o posicionamento

Para adicionar conteúdos ao PDF é necessário que você saiba posicionar coordenadas X e Y às páginas do PDF para que fiquem exatamente na posição que deseja, lembrando que a conversão é de 72DPI, ou seja, PDF por padrão é medido em polegadas, mas precisamos que seja enviado os valores em pixel, para isso é necessário converter a cada polegada para 72 pixels (72DPI).

Outro detalhe sobre as coordenadas é que é considerado x=0 e y=0 começando do canto superior esquerdo do documento.

Estampar texto

Para estampar um texto ou frase ao PDF, após o upload do documento podemos chamar o endpoint conforme:

POST https://apisx.assine.online/v1/envelopes/{envelope}/documents/{document}/contents
{
"type": "text",
"value": "Doloribus in officiis natus quo. Quis dolores est blanditiis et non numquam quo aut. Rerum itaque facere consequatur ipsam.",
"page": 1,
"x_axis": 100,
"y_axis": 250,
"font_size": 12
}

A resposta da requisição sendo:

{
"id": "ffc9b3d2-0955-42c0-af0a-312c072fbe9b",
"type": "text",
"value": "Doloribus in officiis natus quo. Quis dolores est blanditiis et non numquam quo aut. Rerum itaque facere consequatur ipsam.",
"page": 1,
"x_axis": 100,
"y_axis": 250,
"font_size": 12,
"width": null,
"height": null,
"rotation": 0,
"line_height": 0,
"opacity": 0,
"text_color": "#000000",
"font_family": "Helvetica",
"created_at": "2022-05-24T14:15:22Z",
"updated_at": "2022-05-24T14:15:22Z"
}

Lembrando que estes conteúdo serão vistos no documento final assim que o envelope se completar.

imagem de exemplo

Estampar imagem

Para estampar uma imagem, você deve fazer a requisição da mesma forma que é para adicionar texto, porém com o tipo de conteúdo em multipart/form-data, onde o value deve ser o binário da imagem png ou jpeg em questão. Exemplo:

POST https://apisx.assine.online/v1/envelopes/{envelope}/documents/{document}/contents
Authorization: Bearer aG1hYyBhc2RmaXV5a2xzZGZhc2RmYXNkZmFzZGZhc2Q=
Accept: application/json
Content-Type: multipart/form-data

type: image,
value: <png-binary>
page: 1,
x_axis: 100,
y_axis: 250,
height: 150
width: 150

A resposta devolverá o value como uma imagem em base64.

imagem de exemplo