Com este endpoint você poderá enviar um novo arquivo ao sistema, para futuramente enviar para uma ou mais pessoas assinarem e/ou preencherem o mesmo.

ATENÇÃO! O envio do documento e dos templates possuem finalidades diferentes!

O upload de documentos é o envio simples de um arquivo, já o template precisa que no ato do envio, você defina seus campos de preenchimento e assinatura, para mais informações sobre os campos consulte a documentação dos templates ou de solicitações de assinaturas.

Para envio de documentos é necessário que o tipo da requisição seja um form-data!

Para enviar um documento para o sistema, você deverá passar alguns parâmetros conforme abaixo, porém destacamos aqui o parâmetro FILE.

Este parâmetro poderá ser de dois tipos:

Documento: Um documento nos formatos PDF, Word, Excel ou Power Point (Futuramente será necessário converte-los para PDF).
Base 64: Um código base64 exclusivo para PDF, com o início "data:application/pdf;base64,"

Conversão para PDF: Quando um documento for assinado ou uma solicitação de assinatura for realizada, a conversão de documentos Office para PDF será feita automaticamente.

As informações do documento como document_key não são alteradas, porém dados como o endpoint para download, o formato e o tamanho do mesmo serão ajustados.

Regras:

• Formatos aceitos: pdf, doc, docx, xls e xlsx (outros respondem 403). PowerPoint não é aceito.
• file pode ser enviado como arquivo (multipart/form-data) ou como string base64 com data URI (data:application/pdf;base64,...); em base64 use apenas PDF.
• pass_owner e pass_user precisam ser enviados juntos e não são aceitos para documentos Word.
• Se já existir um documento com o mesmo nome e extensão na empresa, o nome recebe um sufixo: "nome (1)", "nome (2)"...
• optimizer: omitido, PDFs na versão 1.5 são otimizados automaticamente; true otimiza sempre; false nunca. O resultado vem em pdf_optimization.
• O upload dispara o webhook FILE_UPLOADED e conta no uso mensal de arquivos; limites de disco/arquivos do plano respondem 403.