Classificação de 4,8 estrelas no g2.com
PDF Atualizado? Não precisa reconstruir o seu template.
Se alguma vez geriu modelos de assinatura em produção, enfrentou este problema. Um advogado atualiza uma cláusula. O departamento jurídico envia um PDF revisto. O seu modelo de NDA com 14 campos agora precisa ser reconstruído do zero: reenvie o documento, substitua cada campo, reatribua cada signatário.
Para um modelo isso é uma hora de trabalho. Para dez modelos em cinquenta espaços de trabalho de clientes, torna-se um problema real.
A Substituição de Documento de Modelo resolve isso. Troque o PDF subjacente em qualquer modelo e cada campo, atribuição de signatário, e configuração permanece exatamente onde estava.
O Problema que Resolve
Os modelos são onde o verdadeiro trabalho acontece
Geralmente, eles descobrem que o acesso à API faz sentido porque já estão pagando pela plataforma. Adicionar acesso de desenvolvedor a um acordo Enterprise existente é tipicamente negociável, e o trabalho jurídico/de aprovisionamento já está concluído.
Mesma Estrutura. Mesmos Campos. Sem Forma de Os Manter… Até Agora.
Os gatilhos são comuns: uma correção de erro de digitação, uma revisão de cláusula, um cabeçalho rebatizado, uma atualização da equipa jurídica, uma alteração regulamentar. A estrutura do documento permanece a mesma, as páginas permanecem as mesmas, os campos devem permanecer os mesmos. Anteriormente não havia maneira de preservar esse trabalho. Agora há.
Como Funciona
Troque o PDF. Mantenha o resto.
Carregue um novo PDF. Firma.dev valida que a contagem de páginas corresponde ao original e que as dimensões das páginas estão dentro de uma tolerância de 1pt. Se ambos os testes forem aprovados, o documento é substituído instantaneamente. Cada posição de campo, cada atribuição de assinante, cada configuração de modelo permanece inalterada.
Por que existem as regras de validação
As regras de validação não são restrições arbitrárias, são salvaguardas. Se a contagem de páginas mudar ou as dimensões mudarem significativamente, as posições dos campos poderiam sair da página ou parar na localização errada. A tolerância de 1pt cobre diferenças de renderização menores entre exportações de PDF do mesmo arquivo de origem, ao mesmo tempo bloqueando substituições que desalinhariam seus campos.
Três superfícies suportam a substituição de documentos
Editor de modelo principal
Um botão Substituir Documento no cabeçalho do modelo. Carregar diretamente da interface do utilizador.
Editor incorporado
Validação no lado do servidor via a função edge com autenticação JWT. Funciona em qualquer integração incorporada.
API REST
POST /templates/{id}/substituir-documento
com um PDF codificado em base64.
Usando a API
O endpoint é direto. Codifique o seu PDF de substituição como base64 e envie um POST para o modelo (Referência da API: https://docs.firma.dev/api-reference/v01.09.00/templates/replace-template-document)
A resposta é o objeto de modelo atualizado. Se a validação falhar, você recebe um 400 com um erro claro indicando se o problema é incompatibilidade na contagem de páginas, incompatibilidade de dimensões ou um PDF inválido.
Regras de Validação
Os uploads de DOC e DOCX através da interface do utilizador são automaticamente convertidos em PDF antes da validação. A API aceita PDF diretamente.
Verificar
Requisito
Contagem de páginas
Deve corresponder exatamente ao original
Dimensões da página
Deve corresponder a uma tolerância de 1 ponto por página
Formato de arquivo
PDF codificado em Base64 via API; PDF, DOC ou DOCX (até 60MB) via UI
Para Quem Isto É
Equipas jurídicas e de conformidade a iterar na redação dos contratos
Quando os seus contratos padrão forem atualizados, uma chamada de API agora substitui o documento em qualquer modelo sem interromper a configuração do campo.
Plataformas SaaS a gerir templates em espaços de trabalho de clientes
Rebranding ou atualização de um documento implementado em dezenas de espaços de trabalho não significa mais reconstruções manuais em cada um. Atualize o modelo de origem e já está.
Atualizações de documentos orientadas pela conformidade
As indústrias regulamentadas às vezes exigem atualizações de documentos em um cronograma. Substituir o PDF sem perder a colocação dos campos significa que a atualização pode ser automatizada, testada e implantada sem retrabalho humano.
A substituição do documento de modelo está disponível na API v1.9.0 sem alterações significativas em relação à v1.8.0.
