Artigos especializados sobre assinatura digital, documentos eletrônicos e tecnologia jurídica.
Mantenha-se atualizado com as últimas tendências e regulamentações.
Seis mensagens distintas de 401 ligadas ao token do signatário, cada uma com causa e correção próprias — e a mais comum de todas, que é chamar com Bearer uma rota que só aceita o token de embed.
"None of the requested scopes are authorized" chega no passo da autenticação e parece credencial errada. É a string de escopos — e há um caso pior, o escopo inválido que não gera erro nenhum.
Duas famílias com causas opostas: o documento chegou e não serve, ou o recurso existe e não está habilitado para a conta. Repetir não resolve nenhuma das duas — e a cota já foi debitada antes.
Três causas produzem 429 com correções opostas: limite de requisições por tempo, tentativas esgotadas de uma etapa e cota do plano. Esperar resolve uma e é inútil nas outras duas.
Operação certa na hora errada: sessão encerrada, transação terminal, signatário repetido. Repetir nunca resolve — e o dano mais comum é recriar por engano e gastar um documento do plano.
Assinar o PDF é a parte fácil e 100% da estimativa inicial. O inventário do que vem depois — cadeia de certificação, múltiplos signatários, evidência, entrega, retenção, disponibilidade — e quando construir é a decisão certa.
Uma biblioteca de assinatura não é o meio-termo entre contratar e construir: é construir, com o item mais fácil já pronto. As três abordagens comparadas contra as nove linhas de um sistema real.
A maior parte de quem procura uma API de assinatura não precisa de uma. Os quatro sinais que realmente indicam integração — e os casos em que o aplicativo entrega o mesmo resultado sem escrever uma linha.
Minutos para a primeira chamada, dias para o fluxo completo, semanas para produção. Onde o tempo realmente vai — e por que a maior parte das semanas não é de engenharia.
Se a sua aplicação faz HTTPS e entende JSON, o essencial está atendido. Os dois requisitos que travam projetos na véspera: endereço público para webhooks e CPF ou CNPJ de cada signatário.
O orçamento cobre o caminho feliz e o projeto gasta nas exceções. Os sete itens que aparecem depois da aprovação — segundo signatário, reenvio de link, reprovação, exclusão, entrega, ambientes e observabilidade.
Citar duas pessoas numa frase não é escolher uma sequência, mas a ordem do pedido vira a ordem de assinatura — e um signatário com certificado digital força o envelope inteiro a ser sequencial.
O servidor é um pacote npm sobre stdio: comando, argumentos e três variáveis de ambiente funcionam em qualquer cliente compatível. E há um transporte HTTP para servir vários agentes com uma implantação só.
Publicado no registro oficial sob namespace verificado por DNS: o nome prova o domínio de quem publicou. O que o registro garante, o que não garante e como instalar a partir dele.
O segredo novo aparece uma vez e o antigo continua aceito por 24 horas — não há nada a revogar. Mas a rotação não derruba tokens já emitidos, e só o client_secret tem janela de sobreposição.
Credenciais, consumo com previsão de estouro de cota, logs das últimas 24 horas com explicação de cada erro em português e um explorador que faz a chamada de verdade. A tela que responde à maior parte dos chamados.
Seu próprio CPF pode ir para o sandbox; o de um cliente não, mesmo com consentimento. A tabela do que é aceitável, os geradores sintéticos que resolvem cada caso e os cinco bugs de roteamento que vazam dado real.
Não é só trocar a URL: a biometria deixa de ser simulada, as evidências passam a valer, os e-mails chegam a pessoas reais, os dados param de expirar em 7 dias e a cota deixa de ter padrão.
Chaves de desligamento por tenant e por método devolvem 503 previsível em vez de falha imprevisível. Quais existem, os 60 segundos de propagação e como a integração deveria reagir.
Base64 cresce um terço sobre o binário e esbarra no limite do corpo da requisição. O fluxo presign → PUT direto no armazenamento → confirm envia o arquivo sem passar pela API, com a mesma validação e o mesmo hash.
Existem seis escopos, e nenhum se chama envelopes. As rotas de envelopes, sessões e usuários autorizam todas em transactions — e pedir um escopo que não existe devolve um 400 que parece credencial errada.
Três pontos de entrada que parecem fazer o mesmo. Transação é um signatário e um documento, e não há campo para acrescentar o segundo — escolher errado custa refatoração em cinco pontos do código.
Seis rotas da API recusam o seu token de aplicação e só aceitam o token do signatário. O mapa completo, por que a separação existe e como emitir um link novo quando o anterior já foi consumido.
Token de 15 minutos, janela de assinatura de 72 horas por padrão (5 min a 7 dias), código de 10 minutos, captura de vivacidade de 15. A referência única de todos os prazos e de qual expira primeiro.
Um PDF com o documento original e uma página de comprovante por signatário, cada uma com id de evidência, hash e endereço do verificador. Medido com 30 signatários: 31 páginas, 49 KB, 2,2 segundos.
Campo de texto livre que se comporta como chave primária: agrupa o histórico da pessoa e endereça o cadastro biométrico dela. Trocá-lo depois não migra nada — cria um segundo usuário, vazio.
A falha mais cara de uma integração de assinatura volta 200. Cabeçalhos de limite, aviso de cota, verificação de saúde e a métrica de negócio que capta o que nenhum erro HTTP capta.
DocuSign Personal: R$ 45/mês por 5 envelopes. Standard: R$ 105 por usuário. Adobe: preço em dólar. A alternativa brasileira cobra por documento, em reais, com ICP-Brasil incluso do plano Grátis ao Enterprise — e a conta anual fica até 85% menor. Valores verificados em agosto de 2026.
Avulso, mensalidade ou créditos pré-pagos? O guia mostra o ponto de equilíbrio de cada modelo com números de agosto de 2026, o custo efetivo por documento em três cenários de volume e as cinco armadilhas que distorcem qualquer comparação de preços.
O que o plano Grátis do SignDocs inclui de verdade: 5 documentos por mês para sempre, sem cartão e com ICP-Brasil incluso. Free tiers de ZapSign, Autentique, ClickSign e D4Sign comparados com valores verificados em agosto de 2026 — incluindo onde cada um ganha.
O emolumento é por assinatura e por via, muda conforme o estado, e o custo real inclui deslocamento e tempo. A conta completa de um contrato no cartório e na assinatura digital, documento a documento — e os casos em que o cartório continua obrigatório.
Faixas de preço de agosto de 2026 para e-CPF e e-CNPJ (A1, A3 físico e em nuvem), o custo real por assinatura e os custos escondidos de mídia e reemissão. E o caso em que você não compra certificado nenhum: a assinatura ICP-Brasil inclusa até no plano Grátis.
Procurações, contratos, acordos e NDAs com o rigor que o jurídico exige: ICP-Brasil por perfil de documento, envelope sequencial entre cliente, diretor e testemunhas, evidence pack .p7m para contestações e integração com o software de gestão via webhooks.
O perfil DIGITAL_CERTIFICATE de ponta a ponta: A1 assinado na página hospedada sem a chave sair do dispositivo, A3 por token pela Assinatura Expressa e pelo app via SignDocsBrasil Assinador, erros de certificado, comparação com certificado em nuvem e o que fica como evidência.
Como o código OTP chega por e-mail ou SMS, quais perfis o exigem, o campo otpChannelSelectable que deixa o signatário escolher o canal na página hospedada e trocá-lo no reenvio, os limites de 10 minutos e 60 segundos, o que vira evidência e quando o OTP não basta.
A resposta de due diligence em dez seções: tokens ES256 assinados no KMS, WAF e mTLS opcional, segredos cifrados, webhooks com HMAC e tolerância de replay, SHA-256 e pacote .p7m, papéis sob a LGPD com DPA público, failover entre us-east-1 e sa-east-1, o que não afirmamos e o checklist do integrador.
Janela de 72 horas, varredura a cada 15 minutos, por que EXPIRED é final e a árvore de decisão entre reenviar o convite (e os seus 409), cancelar e recriar com uma chave de idempotência nova; o caso dos envelopes, o que dizer ao signatário e o worker de reconciliação.
Quando baixar (só depois do webhook de conclusão), o que signedUrl, originalUrl, signatureUrl e o .p7m significam, a validade de uma hora das URLs, a conferência de SHA-256 e por que o seu arquivo, não a plataforma, é a cópia primária do contrato.
Prompts para copiar e colar, agrupados por situação: enviar para uma pessoa ou para várias, escolher o tipo de autenticação, acompanhar e cobrar pendentes, cancelar, baixar assinado e evidências, verificar um PDF recebido e o fluxo com credencial de API (listagem, OTP, webhooks). Cada um com a ferramenta que dispara e o que consome cota.
O caminho da pessoa jurídica: plugin do Claude Code, extensão .mcpb ou conector com credencial; homologação antes da produção; as 24 ferramentas em grupos; onde a confirmação humana acontece; webhooks, cota e evidências continuam iguais aos da integração REST; checklist de implantação.
Conector em claude.ai, Claude Desktop e Claude Code com a conta do aplicativo, sem credencial de API: link de upload, primeiro envio, envelope com várias partes, status, documento assinado e evidências, o que consome cota e os limites do modo de conta pessoal.
Mesmo servidor MCP, mesmo pedido, mesmo CPF: na medição de 25/08/2026 a Claude enviou o documento e o ChatGPT não encaminhou a chamada — e, numa rodada, reportou como bloqueio um envio concluído. Tabela comparativa, para que cada cliente serve hoje e por que o transcript nunca é prova.
Claude Code e agentes próprios conectados ao servidor MCP da SignDocs: os dois modos de acesso e seus catálogos, o fluxo do template no repositório ao link de assinatura, verificação de documentos em pipelines e os guardrails que mantêm a pessoa no circuito — sem auto-aprovar ações consequentes e sem tratar o transcript como prova.
Credenciais só no backend-for-frontend, link de assinatura aberto em Custom Tab / SFSafariViewController, returnUrl como link universal com session_id, e o estado 'assinado' vindo do webhook, nunca do redirecionamento. Código Flutter (url_launcher, app_links) e React Native (Linking, InAppBrowser), cenários de navegador fechado, WebView com os cuidados certos e envelopes.
A política real de entrega (15 s por tentativa, 3 tentativas, FAILED depois) e o desenho de consumidor que sobrevive a ela: 2xx em milissegundos, tabela com event_id único, fila SQS/BullMQ/Sidekiq deduplicada, worker que só avança, reprocessamento e reconciliação com GET /v1/transactions. Com checklist de produção.
SignDocsModule com useFactory e ConfigModule, service sobre o SDK oficial, controller de criação com DTO validado, webhook com rawBody: true e verifyWebhookSignature, fila BullMQ deduplicada pelo id do evento e idempotência nas duas camadas. Inclui a tabela de sintomas específicos do Nest.
A API assina o que você envia e não monta o documento. HTML ou DOCX para PDF, o limite de 10 MB e como ficar abaixo dele, as extensões aceitas, o SHA-256 guardado na origem, base64 versus presign, por que nunca reenviar um PDF já assinado, um documento por envelope e onde o carimbo aparece.
Uma credencial, muitos clientes: como modelar o tenant em metadata e userExternalId, rotear o webhook único por tenant com dedupe e reconciliação, prefixar a idempotência, contar documentos para repassar custos e isolar dados por construção, sem inventar o que a API não oferece.
Sem SDK oficial para Ruby — e sem problema: token OAuth2 com cache thread-safe em Net::HTTP, sessão em uma chamada com idempotência, e o webhook com o esquema exato de verificação (HMAC sobre {timestamp}.{corpo}, headers X-SignDocs-Signature e Timestamp, secure_compare) em código Rails completo.
O 403 do CSRF no webhook resolvido do jeito certo (csrf_exempt + HMAC sobre request.body), cliente singleton a partir das settings, o model que ancora os envios com idempotência atômica, Celery para o trabalho pesado e as três camadas de teste — com código Django real.
Sintoma, causa e correção de cada um, na ordem em que aparecem: /oauth2/token com JSON, token cacheado por 1h, DIGITAL_SIGN_A1 como profile, link sem ?cs=, HMAC sobre JSON re-serializado, reentrega tratada como evento novo, redirect como prova e o TTL do sandbox.
A pirâmide que funciona — mock embaixo, sandbox em cima — com o smoke test de 4 chamadas para o pipeline (idempotente pelo ID do build), o webhook de teste com payload assinado sob demanda, os cinco casos que o handler precisa cobrir e o que só se valida em produção.
O padrão de três passos que funciona em qualquer plataforma com conector HTTP — segredo no backend, uma chamada REST, link hospedado, webhook — com as adaptações por plataforma, os três erros clássicos (credencial no cliente, redirect como prova, reentrega ignorada) e a portabilidade do MVP ao produto.
Cliente singleton com server-only, criação de sessão em Server Action, webhook em Route Handler lendo o corpo bruto antes do parse — e os três tropeços específicos do framework: NEXT_PUBLIC_ vazando credencial, runtime Edge sem criptografia e o timeout serverless engolindo o processamento.
Custo em dólar, ICP-Brasil como caso especial e docs em inglês são os motivos; o caminho é o mesmo modelo de envelopes que você já conhece: mapa de conceitos quase um-para-um, JWT Grant substituído por client-credentials sem assertion nem consent, e rodagem paralela com zero downtime.
Quando o R$ 2,50 por documento avulso e o certificado como adicional pesam, o plano de saída: mapa de conceitos lado a lado, token estático trocado por OAuth2 de 15 minutos, 6 etapas com rodagem paralela e o que exportar antes de encerrar a conta antiga.
De tokenAPI + cryptKey na query string para OAuth2 de 15 minutos: o mapa de conceitos lado a lado, o plano em 6 etapas com rodagem paralela e zero downtime, as diferenças de modelo para decidir cedo e o que exportar antes de encerrar o contrato antigo.
GraphQL com chave estática de um lado, REST com OAuth2 de 15 minutos do outro: SDKs comunitários vs seis oficiais, ICP-Brasil condicionado vs nativo, evidence pack verificável — com o crédito devido ao plano gratuito de 20 docs/mês do Autentique e o teste da tarde nos dois sandboxes.
Copie, cole no e-mail e exija resposta por escrito: seis blocos de perguntas — sandbox, segurança, evidências, operação, compliance e preço — com o porquê de cada uma, as cinco eliminatórias e as respostas da própria SignDocs, inclusive as desconfortáveis.
Migração sem drama, em 2 a 5 dias de dev: o mapa de conceitos lado a lado (envelope, signatário, webhook, download), o plano em 6 etapas com rodagem paralela e zero downtime, as três diferenças de modelo para decidir cedo e o que exportar antes de encerrar o contrato antigo.
Três caminhos para conectar assinatura ao seu CRM/ERP — nó n8n sem código, API REST com os endpoints reais e webhooks com payload verificado —, a matriz de integração por sistema (Salesforce, HubSpot, TOTVS, Omie) e um exemplo prático do CRM ao link de assinatura.
SignDocs, Clicksign, D4Sign, Autentique, ZapSign, DocuSign e Adobe Sign lado a lado, com preços verificados em julho de 2026: mensalidade, custo por documento, plano grátis, ICP-Brasil incluso vs add-on, apps móveis, SDKs oficiais e recomendação por perfil de empresa.
O roadmap de integração em 9 etapas, da decisão de arquitetura ao go-live: envelopes vs Assinatura Expressa, credenciais OAuth2, sandbox de homologação, primeira chamada, perfis de autenticação, webhooks, evidence pack e o checklist de produção.
O envio passo a passo com JSON real: preparar o PDF, subir inline (até 10 MB) ou por presigned URL com confirmação de hash, escolher entre sessão única e envelope multi-signatário, definir perfil de autenticação por signatário e disparar os convites.
O que é grátis de verdade para o desenvolvedor: sandbox de homologação ilimitado e sem cartão, passo a passo do OAuth2 à primeira sessão de assinatura, o plano Grátis do app para quem não programa e quando contratar produção sob medida.
O que uma API ICP-Brasil-nativa entrega frente a uma genérica estrangeira: A1 via API e A3 pelo assinador desktop, presunção legal da MP 2.200-2/2001, evidências em padrão nacional (PAdES/CAdES, .p7m) e design LGPD-first.
Mergulho técnico na anatomia dos padrões: a estrutura ASN.1 do SignedData, os níveis CAdES (BES a A) e PAdES (BES a LTV), o mapeamento para os perfis AD-RB a AD-RA da ICP-Brasil e como a API abstrai tudo isso no nível baseline.
O mapa completo de perfis e steps verificado no código: CLICK_ONLY a BIOMETRIC_SERPRO, composição CUSTOM com até 10 etapas, o protocolo A1 em duas fases (a chave privada nunca sai do titular), matriz de decisão por tipo de documento e a NT65 para consignado.
Os três pilares da integração à prova de escala: cotas diárias/mensais por tenant com cabeçalhos RateLimit-*, X-Idempotency-Key com retenção de 24h (mesmo corpo = replay, corpo diferente = 409), paginação por nextToken com filtros no servidor e retry com backoff + jitter.
O caminho infeliz bem tratado: erros RFC 7807 (problem+json), tabela de referência 400–5xx, o 403 do WAF em webhooks, 409 TransactionConflict vs. conflito de estado, retry com backoff + jitter, X-Idempotency-Key e um handler completo.
O embed de verdade: signing session + clientSecret + checkout em popup via SDK oficial (@signdocs-brasil/js), com a guarda do remetente, callbacks onComplete/onError/onClose, por que o popup substitui o iframe clássico e a confirmação por webhook.
Uma chamada POST /v1/signing-sessions, um link (url?cs=clientSecret) entregue por e-mail, WhatsApp ou QR code, e o webhook SIGNING_SESSION.COMPLETED fechando o ciclo — o caminho mais curto para assinar em produção sem construir interface.
Quickstart Node: SDK oficial @signdocs-brasil/api, sessão de Assinatura Expressa, webhook com verifyWebhookSignature, envelopes multi-signatário e download do PDF + evidence pack — do sandbox à produção.
Quickstart Python: SDK oficial signdocs-brasil (pip), modelos tipados, sessão de assinatura em uma chamada, webhooks Flask/FastAPI com HMAC e evidence pack .p7m.
Quickstart PHP: SDK oficial via Composer, integração Laravel, sessão de Assinatura Expressa, webhooks com WebhookVerifier e envelopes com política por signatário.
Quickstart Java: SDK oficial io.github.signdocsbrasil (Maven/Gradle), builder do cliente, sessão de assinatura, webhooks Spring com eventos reais e envelopes sequenciais.
Quickstart .NET: NuGet SignDocsBrasil.Api (e F#), CreateBuilder, sessão de assinatura, WebhookVerifier, envelopes com SignerIndex e download via SignedUrl.
O fluxo completo sem SDK: /oauth2/token, criação de sessão e transação, upload inline ou presign, steps, finalize, verificação pública e webhooks — cada chamada explícita em cURL.
Como qualquer terceiro — cliente, auditor ou juízo — confere um documento sem conta: GET /v1/verify/{evidenceId} público, verificação de PDFs recebidos via POST /v1/verify/document, portal verificador, QR codes e verificabilidade de longo prazo.
O ciclo de vida completo de uma transação: criação com etapas geradas pela política, upload inline ou via presign, start/complete de cada etapa, finalização com evidence pack .p7m, webhooks vs. polling e tratamento de erros com idempotência.
Envelopes com até 100 signatários: signingMode SEQUENTIAL vs PARALLEL, signerIndex, um nível de autenticação por signatário (OTP, biometria, SERPRO, ICP-Brasil), cancelamentos, lembretes e distribuição do documento final — com o JSON real dos dois modos.
O guia do sandbox: host api-hml (com hífen), TTL de 7 dias, biometria simulada, política de dados de teste, webhooks com túnel (WAF bloqueia IPs privados) e o checklist completo de promoção HML → produção.
Passo a passo real do painel: conta PJ, wizard de plano Enterprise, API Dashboard e ativação das credenciais HML — mais scopes, troca de token OAuth2, rotação de segredos e boas práticas de segurança.
Quickstart direto ao ponto: capture um token OAuth2, faça uma única chamada POST /v1/signing-sessions e compartilhe o link de assinatura hospedado — tudo no sandbox de homologação, com erros comuns e próximos passos.
O guia de partida do cluster de API: fluxo manual vs. automatizado, anatomia REST (transações, envelopes, etapas e evidências), ciclo de vida, autenticação OAuth2 e checklist completo para escolher uma solução enterprise.
Anatomia do pacote de evidências .p7m (PKCS#7/CMS): trilha de auditoria append-only, hash SHA-256, carimbo de hora do servidor, cadeia ICP-Brasil embarcada e verificação independente via OpenSSL.
TLS mútuo para integrações reguladas: como funciona, quando BACEN/Open Finance exige, PKI e gestão de certificados, e como combinar mTLS com OAuth2 em uma arquitetura de defesa em profundidade.
Guia completo sobre webhooks para APIs de assinatura digital: arquitetura de eventos em tempo real, verificação HMAC-SHA256, idempotência, retry com backoff exponencial e integração com CRM/ERP.
Guia técnico completo sobre OAuth2 Client Credentials, JWT com ECDSA (ES256/ES384), gerenciamento de chaves com KMS e boas práticas de autenticação para APIs de assinatura digital.
Comparativo técnico entre a API Clicksign e a SignDocs Brasil: ICP-Brasil A1/A3, access token vs OAuth2/JWT, webhooks HMAC, sandbox, Assinatura Expressa e evidence pack .p7m — para quem vai escrever o código.
Comparativo técnico entre a API D4Sign e a SignDocs Brasil: A3 via extensão Web PKI vs assinador desktop PKCS#11, tokenAPI/cryptKey vs OAuth2/JWT, webhooks, sandbox e evidence pack .p7m.
Comparativo técnico entre a API ZapSign e a SignDocs Brasil: ICP-Brasil A1/A3, token de API vs OAuth2/JWT, webhooks, sandbox, evidence pack .p7m e modelo de preços — com olhos de desenvolvedor.
Comparativo técnico entre a API DocuSign e a SignDocs Brasil: ICP-Brasil A1/A3 nativo vs habilitação por chamado, SDKs, OAuth2/JWT, webhooks, embedded signing, LGPD, sandbox e modelo de preços — com guia de migração.
Guia de compra com 9 critérios objetivos para escolher uma API de assinatura: ICP-Brasil (A1/A3), SDKs, OAuth2 e mTLS, webhooks, pacote de evidências .p7m, sandbox, modelos de integração, preço e LGPD.
Entenda os modelos de preço de uma API de assinatura digital (por documento, por usuário, créditos), os custos ocultos — OTP, ICP-Brasil, armazenamento — e como calcular o TCO real da sua integração antes de contratar.
Comparativo de preços verificado em agosto de 2026: SignDocs Brasil a partir de R$ 0/mês com ICP-Brasil incluso, contra ZapSign (grátis de 3 docs sem ICP; Profissional R$ 29,90), ClickSign (R$ 39, só trial) e D4Sign (R$ 39,90, só trial).
Comparativo completo entre Adobe Acrobat Sign e SignDocs Brasil: preço por usuário vs por documento (R$ 80-110/usuário/mês vs R$ 19,90/mês para o time inteiro), ICP-Brasil nativo na cloud vs fluxo híbrido com Acrobat Pro desktop, token A3 plug-and-play multi-plataforma vs Digital ID configurado.
Comparativo completo entre DocuSign e SignDocs Brasil: preços a partir de R$ 19,90/mês vs R$ 45/mês (~9x mais barato por documento), ICP-Brasil nativo em todos os planos vs habilitação via Customer Support, token A3 multi-plataforma vs Signing Agent proprietário, e adequação ao mercado brasileiro.
Comparativo honesto entre Autentique e SignDocs Brasil: planos gratuitos, preço pago a partir de R$ 19,90/mês vs R$ 99/mês, token A3 multi-plataforma (Windows, macOS e Linux) vs A3 apenas em Windows, ICP-Brasil, LGPD, API e segurança.
Comparativo completo entre D4Sign e SignDocs Brasil: preços a partir de R$ 19,90/mês vs R$ 39,90/mês, plano gratuito permanente, token A3 multi-plataforma (Windows, macOS e Linux), ICP-Brasil, LGPD, API e segurança.
Comparativo completo entre Clicksign e SignDocs Brasil: preços a partir de R$29/mês vs R$59/mês, plano gratuito, ICP-Brasil, LGPD, API, app móvel e segurança.
Comparativo completo entre ZapSign e SignDocs Brasil: preços a partir de R$19,90/mês vs R$49/mês, plano gratuito, ICP-Brasil, WhatsApp, API, app móvel e segurança.
A Lei nº 14.620/2023 revoluciona o processo civil brasileiro ao reconhecer a autoexecutoriedade dos títulos eletrônicos, dispensando testemunhas quando há provedor de assinatura.