Campos de Carregamento de Ficheiros: Recolha Documentos Durante a Assinatura

Iniciar sessão

Inscrição

Início

Documentação

Perspectivas

Preços

Comparação

Iniciar sessão

Inscrição

Funcionalidades: Campos de Upload de Ficheiros

Suporte de Assinatura Multilíngue

Recolher Documentos e Assinaturas Juntos

Obter chave API

Classificação de 4,8 estrelas no g2.com

A Coleta de Documentos Não Deve Ser um Fluxo de Trabalho Separado

A maioria dos fluxos de trabalho de assinatura eletrónica tratam a recolha de documentos como um passo completamente diferente. Assine o contrato numa ferramenta, depois peça ao cliente para enviar por email o seu documento de identificação ou carregar a prova de seguro através de um formulário diferente. Dois fluxos de trabalho, dois pontos de atrito e uma boa probabilidade de que algo se perca.

Campos de Upload de Ficheiros: Tudo num só lugar, uma chamada de API

Os campos de envio de ficheiros da Firma.dev permitem-lhe recolher documentos de apoio dentro do próprio fluxo de assinatura. Os signatários podem carregar imagens ou PDFs diretamente ao lado da sua assinatura, iniciais e outros campos de formulário. Uma experiência, uma chamada API, tudo num só lugar.

Os campos de envio de ficheiros foram lançados na versão 1.11.0 e estão disponíveis em todas as contas.

O que são campos de carregamento de ficheiros?

Colocação e Configuração de Campos de Upload de Ficheiros

O tipo de campo file funciona como qualquer outro campo na Firma.dev. Você coloca-o em um documento, atribui-o a um destinatário e marca-o como obrigatório ou opcional.

Quando o assinante abre o documento, eles veem uma área de carregamento onde podem anexar um ficheiro.

Tipos de Ficheiros Aceites

A diferença é o que ele coleta. Em vez de capturar uma assinatura ou entrada de texto, um campo de ficheiro aceita uploads de imagens (JPG, PNG) e ficheiros PDF. O assinante escolhe um ficheiro do seu dispositivo, a Firma.dev valida-o no servidor e o anexo torna-se parte do pedido de assinatura concluído.

tudo numa única submissão

Isso significa que pode criar fluxos de trabalho onde o acordo assinado e a sua documentação de apoio chegam juntos, não como submissões separadas com dias de intervalo.

Obter chave API

Como funciona

Cada campo de upload de ficheiros tem um objeto format_rules que controla quais tipos de ficheiros são aceites. Existem três modos:

imagem_e_pdf

Aceita tanto imagens (JPG, PNG) como ficheiros PDF. Este é o padrão.

imagem

Aceita apenas JPG e PNG.

pdf

Aceita apenas ficheiros PDF.

O tamanho máximo de ficheiro é de 10MB por carregamento. Os ficheiros são processados do lado do servidor através de funções de ponta, não são armazenados do lado do cliente.

Aqui está como adicionar um campo de carregamento de ficheiro a um pedido de assinatura:

const response = await fetch(
  'https://api.firma.dev/functions/v1/signing-request-api/signing-requests',
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.FIRMA_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      workspace_id: workspaceId,
      template_id: templateId,
      recipients: [
        {
          id: 'temp_1',
          first_name: 'Sarah',
          last_name: 'Chen',
          email: 'sarah@example.com',
          designation: 'Assinante',
          order: 1
        }
      ],
      fields: [
        {
          type: 'assinatura',
          position: { x: 15, y: 80, width: 30, height: 8 },
          page_number: 1,
          required: true,
          recipient_id: 'temp_1'
        },
        {
          type: 'ficheiro',
          position: { x: 15, y: 60, width: 30, height: 12 },
          page_number: 1,
          required: true,
          recipient_id: 'temp_1',
          format_rules: {
            acceptedFileTypes: 'imagem'
          }
        }
      ]
    })
  }
);

Isto cria um pedido de assinatura com um campo de assinatura e um campo de upload de arquivo na mesma página. O campo de arquivo está configurado para aceitar apenas imagens, o que faz sentido para algo como uma foto de identificação.

Validação de byte mágico

Firma.dev valida ficheiros carregados inspecionando o seu conteúdo real (bytes mágicos), não apenas a extensão do ficheiro. Se alguém renomear um .exe para .jpg e tentar carregá-lo, a validação deteta-o.

Esta é uma camada de segurança significativa que a maioria das plataformas de assinatura eletrónica ignora, confiando em vez disso em verificações baseadas em extensões que são fáceis de contornar.

A validação acontece no lado do servidor antes de o ficheiro ser aceite, portanto, ficheiros inválidos nunca chegam aos dados de solicitação de assinatura.

Casos de Uso

Campos de carregamento de ficheiros são úteis em qualquer lugar onde precise de documentação de apoio juntamente com um acordo assinado.

Integração de colaboradores

Colete uma carta de oferta assinada e uma foto do documento de identidade emitido pelo governo do novo contratado no mesmo fluxo. Defina acceptedFileTypes para image no campo de upload do ID, e o signatário tira uma foto ou seleciona uma do seu dispositivo.

Fluxos de trabalho de seguros

Exigir prova de seguro como um upload de PDF junto com o acordo de política assinado. Uma experiência de assinatura captura tanto o compromisso quanto a evidência.

Aprovações de despesas

Anexe imagens de recibos a um relatório de despesas assinado. Marque o campo do ficheiro como opcional se os recibos não forem sempre exigidos, ou obrigatório se a sua política os exigir.

Conformidade e inspeções

Recolha provas fotográficas (inspeções de segurança, relatórios de condição da propriedade) juntamente com o formulário de conformidade assinado. O arquivo e a assinatura estão ligados ao mesmo pedido de assinatura, portanto, não há ambiguidade sobre a que documento pertencem as fotos.

Em cada caso, a alternativa sem campos de upload de ficheiros é um processo de vários passos: assinar o documento, depois recolher separadamente anexos através de email, um construtor de formulários ou um link de partilha de ficheiros. Isso significa mais trabalho de integração para si e mais fricção para o signatário.

Referência de API

O tipo de campo file está disponível em todos os lugares onde os campos são definidos: criação de pedido de assinatura (POST /signing-requests), criação de modelo (POST /templates) e atualizações de campo via operações PATCH.

O esquema do campo segue a mesma estrutura que outros tipos de campo, com a adição de format_rules para configuração do tipo de ficheiro:

{
  "type": "ficheiro",
  "position": { "x": 15, "y": 60, "width": 30, "height": 12 },
  "page_number": 1,
  "required": verdadeiro,
  "recipient_id": "recipient-uuid",
  "format_rules": {
    "acceptedFileTypes": "imagem_e_pdf"

Os valores de acceptedFileTypes são image_and_pdf (padrão), image, ou pdf. Se omitir format_rules completamente, o campo será por padrão aceitar tanto imagens como PDFs.

Os campos de upload de arquivos funcionam juntamente com todos os outros tipos de campos no mesmo pedido de assinatura. Pode combiná-los com assinaturas, iniciais, entradas de texto, caixas de seleção, etiquetas de ancoragem, e qualquer outro tipo de campo sem restrições.

Veja o registo de alterações da API para o esquema completo de FileFormatRules.

Porque isso é importante

O Atrito Oculto Após a Assinatura

A maioria das plataformas de assinatura eletrônica tratam a coleta de documentos como um problema de outra pessoa. Você assina o contrato em uma ferramenta, depois persegue anexos por e-mail, Slack ou um portal de upload separado. Cada transferência é uma chance de abandono, atrasos e arquivos perdidos.

Tudo em uma única resposta de API

Firma.dev colapsa isso em um único fluxo. O assinante abre o documento, preenche seus campos, envia seus arquivos de suporte e assina. Tudo chega junto em uma resposta de API. Para os desenvolvedores, isso significa menos trabalho de integração e menos casos extremos. Para os assinantes, isso significa uma coisa a fazer em vez de duas.

Sem Custo Extra

A €0,029 por envelope, adicionar a recolha de ficheiros ao seu fluxo de assinatura não custa extra. O campo de carregamento de ficheiros é apenas outro tipo de campo, incluído no mesmo envelope.

Pronto para adicionar assinaturas eletrónicas à sua aplicação?

Comece gratuitamente. Não é necessário cartão de crédito. Pague apenas €0,029 por envelope quando estiver pronto para entrar em funcionamento.

Obter chave API

Pronto para adicionar assinaturas eletrónicas à sua aplicação?

Comece gratuitamente. Não é necessário cartão de crédito. Pague apenas €0,029 por envelope quando estiver pronto para entrar em funcionamento.

Obter chave API

Pronto para adicionar assinaturas eletrónicas à sua aplicação?

Comece gratuitamente. Não é necessário cartão de crédito. Pague apenas €0,029 por envelope quando estiver pronto para entrar em funcionamento.

Obter chave API