1. Integra
Conecte API ou Connector JS
Use um único padrão de autenticação e payload para todos os tipos de documento.
Uma integração única para cenários médicos, fiscais, educacionais e operações em PDF. Suporte a certificado em nuvem, A3 local e A1 com rastreabilidade completa.
const connector = createSignerConnector({
apiBaseUrl: 'https://4signer.com/api',
bearerToken: 'YOUR_TOKEN'
});
const result = await connector.sign({
documentId: 'contrato-001',
documentType: 'pdf',
certificateMode: 'cloud',
documentFile: pdfBlob, // File ou Blob
providerHint: 'birdid',
requestOptions: {
metadata: {
reason: 'Assinatura de contrato',
location: 'São Paulo, BR',
name: 'Nome do responsável',
contact: 'email@exemplo.com'
}
}
});
// Documento assinado
const download = await connector.getDownloadUrl({
signatureId: result.signature_id
});
const connector = createSignerConnector({
apiBaseUrl: 'https://4signer.com/api',
bearerToken: 'YOUR_TOKEN'
});
const result = await connector.sign({
documentId: 'nfe-001',
documentType: 'xml',
certificateMode: 'cloud',
documentFile: xmlFile, // File XML
providerHint: 'serproid',
xmlProfile: 'fiscal',
xmlPolicy: 'nfe-4.00',
xmlPolicyParameters: {
signed_element_local_name: 'infNFe', // tag XML a assinar
id_attribute: 'Id'
}
});
const download = await connector.getDownloadUrl({
signatureId: result.signature_id
});
Escolha o fluxo ideal para o seu produto: PDF geral, documentos médicos, XML fiscal ou diploma digital.
Contratos, RH, jurídico e operações com assinatura digital no mesmo fluxo.
Assine prescrições, atestados e contratos em fluxo direto, com retorno rápido e validade jurídica.
Documentos fiscais
Assinatura de documentos fiscais em XML.
Diploma digital
Fluxo especializado para assinatura XML acadêmica com políticas avançadas por tag.
1. Integra
Use um único padrão de autenticação e payload para todos os tipos de documento.
2. Assina
A1, A3 local ou nuvem, com o fluxo adequado para PDF, fiscal XML ou diploma.
3. Recebe
Acompanhe assinatura, auditoria e eventos em tempo real no seu sistema.
Menos integrações, menos custo operacional e documentos com validade jurídica em um único lugar.
Nuvem, A3(token ou smart card) e A1 no mesmo endpoint. Escolha o modo por documento ou por usuário, sem trocar de fornecedor.
Assinaturas com certificado ICP-Brasil e carimbo do tempo. Documentos prontos para auditoria e compliance.
Dashboard com histórico de assinaturas, logs por conta e token, webhooks e retry automático. Você acompanha tudo.
Software de gestão que precisa assinar contratos, receitas, laudos ou documentos com certificado digital.
A API abre a sessão, o titular aprova no app do provider (ex.: BirdID, Certisign, Serpro ID) e o documento final volta assinado para seu sistema.
curl -X POST "https://4signer.com/api/v1/connector/v1/sessions" \\
-H "Authorization: Bearer TOKEN_DA_ACCOUNT" \\
-H "Content-Type: application/json" \\
-d '{
"document_id": "contrato-1001",
"document_type": "pdf",
"certificate_mode": "cloud",
"provider_hint": "birdid",
"document_content_base64": "JVBERi0x...",
"metadata": {
"reason": "Contrato comercial"
},
"request_options": {
"timestamp": {
"enabled": true,
"url": "https://tsa.exemplo.com/rfc3161",
"token": "TOKEN_TSA"
}
}
}'
curl -X POST "https://4signer.com/api/v1/connector/v1/sessions" \\
-H "Authorization: Bearer TOKEN_DA_ACCOUNT" \\
-H "Content-Type: application/json" \\
-d '{
"document_id": "nfe-1001",
"document_type": "xml",
"certificate_mode": "cloud",
"provider_hint": "serproid",
"signature_profile": "fiscal",
"signature_policy": "nfe-4.00",
"signature_policy_parameters": {
"signed_element_local_name": "infNFe",
"id_attribute": "Id"
},
"request_options": {
"timestamp": {
"enabled": true,
"url": "https://tsa.exemplo.com/rfc3161",
"token": "TOKEN_TSA"
}
},
"document_content_base64": "PD94bWwgdmVyc2lvbj0iMS4wIi4uLg=="
}'
O frontend solicita a sessão local, o agent instalado no PC do titular assina com token ou cartão e envia o resultado de volta para a API.
const connector = createSignerConnector({
apiBaseUrl: 'https://4signer.com/api',
bearerToken: 'YOUR_TOKEN'
});
const result = await connector.sign({
documentId: 'doc-001',
certificateMode: 'local',
documentFile: pdfBlob,
requestOptions: {
timestamp: {
enabled: true,
url: 'https://tsa.exemplo.com/rfc3161',
token: 'TOKEN_TSA'
}
}
});
const download = await connector.getDownloadUrl({
signatureId: result.signature_id
});
Assinatura em lote ou automatizada para PDF/XML usando certificado A1: envie o PFX no request ou cadastre uma vez e reutilize.
A1 Arquivo
Envia PFX + senha no request.
A1 Cadastrado
Reusa certificado salvo.
curl -X POST "https://4signer.com/api/v1/signatures/pdf" \\
-H "Authorization: Bearer TOKEN_DA_ACCOUNT" \\
-F "signature_method=local_pfx" \\
-F "processing_mode=sync" \\
-F "pdf=@/tmp/documento.pdf" \\
-F "pfx=@/tmp/certificado.pfx" \\
-F "pfx_password=SENHA" \\
-F "request_options[timestamp][enabled]=1" \\
-F "request_options[timestamp][url]=https://tsa.exemplo.com/rfc3161" \\
-F "request_options[timestamp][username]=tsa_user" \\
-F "request_options[timestamp][password]=tsa_pass"
curl -X POST "https://4signer.com/api/v1/signatures/xml" \\
-H "Authorization: Bearer TOKEN_DA_ACCOUNT" \\
-F "signature_method=local_pfx" \\
-F "processing_mode=sync" \\
-F "xml=@/tmp/nfe.xml" \\
-F "pfx=@/tmp/certificado.pfx" \\
-F "pfx_password=SENHA" \\
-F "request_options[timestamp][enabled]=1" \\
-F "request_options[timestamp][url]=https://tsa.exemplo.com/rfc3161" \\
-F "request_options[timestamp][token]=TOKEN_TSA"
Seu sistema é notificado quando a assinatura é concluída ou falha. Logs de request/response e retry automático reduzem suporte manual.
signature.status_changed com status_to (signed, failed, etc.).Tentativas automáticas
Até 3 tentativas, com reprocessamento manual no painel.
curl -X POST "https://4signer.com/api/v1/webhooks" \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
-d '{"url":"https://seu-site.com/webhook","max_attempts":3}'
{
"event": "signature.status_changed",
"occurred_at": "2025-02-16T14:30:00.000000Z",
"account": { "id": 1 },
"signature": {
"id": 42,
"provider": "birdid",
"processing_mode": "async",
"status_from": "processing",
"status_to": "signed",
"external_id": "doc-1001",
"error_code": null,
"error_message": null,
"started_at": "2025-02-16T14:29:58.000000Z",
"completed_at": "2025-02-16T14:30:00.000000Z",
"duration_ms": 2000
}
}
Uma API
Cloud, A3 e A1
Todos os modos de assinatura em um único integrador.
Compliance e auditoria
ICP-Brasil + carimbo do tempo
Documentos com validade jurídica, logs por assinatura e webhook para integrar ao seu fluxo de auditoria.
Suporte técnico
Docs + suporte
Documentação completa e suporte para implantação.
Assine um plano e tenha rate limit, logs por conta e dashboard operacional em produção.
Certificados suportados
Use o mesmo backend para operação em nuvem, arquivo local e certificado instalado na máquina.
Nuvem
BirdID, VIDaaS, SerproID e Certisign.
A1 arquivo digital
Envio de PFX/P12 por requisição com senha segura.
Token ou SmartCard instalado
A3 local via Agent Desktop, integrado ao conector JS.