Documentos
Listar, criar, consultar e duplicar documentos; enviar em PDF (até 25 MB).
API LoopSign
API de Assinatura Digital LoopSign
Crie documentos, gerencie signatários, envie para assinatura e consulte o status a partir do seu ERP, portal ou aplicativo — usando a API REST do LoopSign.
- REST com resposta JSON padronizada
- Autenticação por token + CNPJ
- PDF de até 25 MB
Integre o LoopSign ao seu sistema
Seu sistema
API LoopSign
Documentos e signatários
Processo de assinatura
Consulta de status e auditoria
Seu sistema cria o documento e os signatários pela API, dispara o processo de assinatura e depois consulta o andamento pelos endpoints de documento e de auditoria, até baixar o arquivo final e as evidências.
Autenticação
- Access token — obtido pelo Supabase Auth e enviado em
Authorization: Bearer. - CNPJ da empresa — enviado no cabeçalho
X-CNPJ-Empresa; o usuário do token precisa estar vinculado a esse CNPJ. - Licença ativa — as rotas privadas exigem licença ativa do LoopSign para o CNPJ; licença
ausente ou expirada retorna
403. - Resposta padrão —
{ "success": true, "message": "...", "data": {} }; erros usamsuccess: falsee status HTTP apropriado.
O que a API cobre
Signatários e grupos
Cadastrar signatários, montar grupos e reutilizá-los em vários documentos.
Pontos de assinatura
Posicionar pontos e campos sobre as páginas do documento.
Envio e reenvio
Enviar para assinatura e reenviar o convite apenas para quem ainda não assinou.
Modelos
Criar documentos a partir de modelos com campos e pontos já definidos.
Auditoria e downloads
Consultar eventos de auditoria e baixar o documento concluído e as evidências.
Assinatura pública
Fluxo de assinatura por token: visualizar, confirmar e baixar o PDF pelo link do signatário.
Configurações administrativas
Identidade da empresa, certificado e modelos de e-mail (perfil admin).
Integração com ERP e sistemas próprios
A API foi pensada para disparar a assinatura de dentro das ferramentas que a equipe já usa.
Sankhya
Além da API REST, há um plugin opcional de integração com o Sankhya. Usar um ERP não é requisito para a API nem para o LoopSign.
Portais e aplicativos
Gere documentos e colete assinaturas a partir do seu portal do cliente ou app interno.
Boas práticas
Use idempotência na criação de documentos e retentativa exponencial apenas para respostas
429, 502 ou 503.
Perguntas frequentes sobre a API
O LoopSign tem API de assinatura digital?
Sim. É uma API REST de integração que permite criar documentos, gerenciar signatários e grupos, definir pontos de assinatura, enviar e reenviar para assinatura, consultar auditoria e baixar o documento concluído.
Como funciona a autenticação da API?
Usa um access token obtido pelo Supabase Auth, enviado em Authorization: Bearer, junto do
cabeçalho X-CNPJ-Empresa. O usuário do token precisa estar vinculado ao CNPJ, e as rotas privadas
exigem licença ativa do LoopSign para aquele CNPJ.
O que dá para fazer pela API?
Listar e criar documentos, consultar um documento, gerenciar signatários e grupos, definir pontos de assinatura, enviar e reenviar para assinatura, duplicar documentos, usar modelos, consultar auditoria, baixar arquivos e acessar o fluxo de assinatura pública por token.
A API tem webhook?
Nesta versão não há webhook público para clientes. O acompanhamento é feito consultando os endpoints de documento e de auditoria. Novos webhooks só serão anunciados quando estiverem implementados e versionados.
Qual o tamanho máximo de PDF na API?
Os PDFs aceitam até 25 MB por arquivo.
Onde vejo a documentação da API?
Na página /api-docs, com os endpoints, o formato de resposta padrão, os status HTTP e o histórico de versões.
Coloque a assinatura dentro do seu sistema
Crie a conta da empresa, gere um access token e comece pela documentação da API.
Ver a documentação da API