API de assinatura eletrônica para integrar ao seu sistema
A API do Firmou permite que um ERP, sistema de gestão ou software próprio envie documentos para assinatura eletrônica sem passar pela tela do Firmou. O sistema envia o PDF e os signatários, cada pessoa assina pelo link seguro e um webhook avisa quando o documento está pronto. A API está disponível em todos os planos, inclusive no Free.
Atualizado em · Por equipe Firmou (KEMIS)
Quando usar uma API de assinatura eletrônica
Quando o documento nasce dentro de um sistema — contrato gerado pelo ERP, termo de matrícula, proposta emitida pelo CRM, aditivo do RH —, baixar o PDF e subir em outra plataforma é retrabalho e abre espaço para erro. Pela API, o próprio sistema envia o documento para assinatura e recebe de volta o arquivo assinado.
- ERPs e sistemas de gestão que geram contratos e termos;
- software houses que querem oferecer assinatura dentro do próprio produto;
- plataformas com muitos documentos por mês, em que o fluxo manual não escala.
Como funciona a integração com o Firmou
- Em Configurações, o administrador emite um token de API, amarrado a um workspace — assim cada área ou cliente do seu sistema fica separado.
- O seu sistema envia o PDF e os signatários pela API.
- Cada signatário recebe o link seguro e passa pela mesma cerimônia da plataforma: verificação de identidade, consentimento registrado e assinatura.
- O Firmou sela o PDF em PAdES com certificado ICP-Brasil da KEMIS e guarda a trilha de auditoria.
- Um webhook avisa o seu sistema quando o documento fica pronto (`document_completed`), e o sistema baixa o arquivo assinado.
Endpoints, exemplos e o formato de cada evento estão na documentação da API.
Webhooks com verificação de origem
Em vez de consultar o Firmou de tempos em tempos, o seu sistema recebe um aviso a cada etapa relevante do documento. Cada entrega pode ser verificada pela assinatura enviada junto, para o seu sistema ter certeza de que o aviso veio do Firmou — o passo a passo está em verificando a assinatura do webhook.
Os destinos de webhook e o histórico de entregas ficam visíveis no painel, o que facilita investigar uma integração que parou de receber avisos.
Validade jurídica e ICP-Brasil na assinatura por API
O documento assinado pela API tem o mesmo valor do assinado pela tela: assinatura eletrônica avançada (Lei 14.063/2020, art. 4º, II), com o PDF selado por certificado ICP-Brasil da KEMIS. Entre particulares, vale quando o meio é admitido pelas partes (MP 2.200-2/2001, art. 10, § 2º) — e o consentimento fica registrado na trilha. Veja quando a assinatura eletrônica tem validade jurídica.
E a assinatura qualificada?
Atos que exigem o certificado ICP-Brasil do próprio signatário pedem assinatura qualificada, que não é o que o Firmou produz. Para esses casos, cada parte precisa de um certificado digital e-CPF ou e-CNPJ.
Quanto custa: franquia por documento, não por signatário
| Plano | Franquia mensal | Preço |
|---|---|---|
| Free | Volume inicial gratuito | R$ 0, sem cartão |
| Start | Até 250 arquivos | R$ 40/mês |
| Flow | 500 arquivos | R$ 75/mês |
| Enterprise | A partir de 1.000 arquivos, com SLA | Sob consulta |
A franquia conta documentos enviados: signatários e usuários não têm limite. Para volumes altos e recorrentes, o Enterprise tem volume e SLA sob medida — fale com a equipe pelo contato. Valores vigentes em planos.
Conteúdo informativo, revisado pela equipe do Firmou. Não substitui a orientação de um advogado para o seu caso concreto.
Perguntas frequentes
O Firmou tem API de assinatura eletrônica?
Sim. O Firmou tem API para enviar documentos para assinatura a partir de um ERP ou sistema próprio, com tokens por workspace e webhooks que avisam quando o documento fica pronto. A documentação está em docs.firmou.app, e a API está disponível em todos os planos.
Preciso de plano pago para usar a API do Firmou?
Não. A API de integração do Firmou faz parte do plano Free, que não exige cartão de crédito. Quando o volume de documentos cresce, os planos Start, Flow e Enterprise aumentam a franquia mensal sem cobrar por signatário.
A API do Firmou cobra por documento ou por signatário?
A API do Firmou segue a franquia mensal do plano, que conta documentos enviados. Signatários por documento e usuários por empresa não têm limite em nenhum plano. Para volumes altos, o plano Enterprise tem volume e SLA definidos sob medida.
A assinatura feita pela API do Firmou usa ICP-Brasil?
Sim, o PDF assinado pela API do Firmou é selado em PAdES com certificado ICP-Brasil da KEMIS, como na plataforma. A assinatura é eletrônica avançada, não qualificada: atos que exigem o certificado ICP-Brasil do próprio signatário seguem outra regra.
Leia também
- Melhor plataforma de assinatura eletrônica: como escolher em 2026Como comparar plataformas de assinatura eletrônica em 2026: identidade, prova, PDF selado, API, preço por documento, plano grátis e avaliações.
- O que é PAdES, a assinatura que fica dentro do PDFPAdES é o padrão europeu de assinatura avançada em PDF. Entenda como funciona, por que preserva assinaturas anteriores e como conferir no leitor de PDF.
- Segurança e privacidade no FirmouComo o Firmou confere a identidade de quem assina, registra cada evento, protege o PDF assinado e permite a conferência pública sem enviar o arquivo.
- Assinatura eletrônica para vendas: propostas e contratos comerciaisPropostas, contratos de serviço e pedidos assinados pelo cliente no celular, com prazo, lembrete e marca da sua empresa. Feche vendas com prova no Firmou.