Introdução

O SignXP é um serviço de assinatura eletrônica pensado para ser usado por outros softwares. Não há tela para o seu usuário final operar o sistema: o seu software envia o documento por API e o SignXP cuida de tudo o que vem depois — convite ao signatário, coleta de evidências, captura da assinatura, selagem criptográfica e verificação pública.

O que o serviço entrega

• Assinatura eletrônica com evidências: IP, dispositivo, data/hora, geolocalização, consentimento LGPD e, opcionalmente, foto do documento de identidade e selfie.
• Validação por IA das imagens: as fotos são conferidas na hora da assinatura e, se você informar o CPF/CNPJ do signatário, a IA verifica se o documento apresentado é mesmo dele — veja validação por IA.
• Selo criptográfico PAdES: o PDF final é assinado com o certificado do SignXP, o que torna qualquer alteração posterior detectável.
• Termo de Evidências: um relatório anexado ao PDF final, com uma página por signatário.
• Verificação pública: cada documento ganha uma URL e um QR Code que qualquer pessoa pode usar para conferir a autenticidade. Quem só tem o arquivo em mãos confere pelo validador público, por código ou enviando o próprio PDF.
• Assinatura dentro do seu sistema: se preferir que o seu cliente não saia da sua tela, a assinatura pode ser embutida — sem apontar domínio nenhum para nós.

Como o fluxo funciona

1. O seu sistema gera o PDF e sabe em que posição de cada página a assinatura deve aparecer.
2. O seu sistema chama POST /api/v1/documents enviando o PDF, os signatários e as coordenadas dos campos.
3. O SignXP registra os campos e cria um link de assinatura por signatário. Se o signatário tem e-mail e você não pediu o contrário, o convite sai por e-mail; senão, o link fica com você para entregar pelo canal que preferir.
4. O signatário assina pelo celular ou pelo computador, passando pelas etapas de evidência configuradas.
5. Quando todos assinam, o PDF é selado e o seu sistema recebe um callback assinado.
6. O seu sistema baixa a via final ou apenas guarda a URL de verificação.

Seu software ──POST /documents──▶ SignXP ──convite──▶ Signatário
     ▲                                  │
     └────────callback assinado─────────┘

Antes de começar

Você vai precisar de:

• Uma conta no portal, que você mesmo cria em app.signxp.com.br/criar-conta — não é preciso falar com ninguém para começar.
• Uma chave de API de teste e uma de produção, emitidas por você no portal (veja Autenticação).
• Um endpoint público no seu sistema para receber os callbacks (opcional, mas recomendado).
• As coordenadas de cada campo de assinatura. O Posicionador de campos gera esse bloco para você a partir do próprio PDF.

O ambiente de teste não envia e-mail para o signatário e não consome a sua quota contratada. Use-o à vontade durante a integração.

Enquanto a conta não tiver um plano contratado, ela não envia documentos em produção. Isso não atrapalha o começo: a integração inteira pode ser escrita e exercitada antes disso, com a chave de teste.

Testando sem escrever código

As páginas de Autenticação, Enviar um documento e Consultar o status trazem um painel Testar agora: você cola uma chave sk_test_, ajusta o corpo já preenchido com dados fictícios (inclusive o PDF) e executa a chamada de verdade, vendo a resposta na hora.

Comece pela Autenticação: a consulta da licença não cria nada e já prova que a sua chave funciona.

Integrando com um agente de IA

Toda esta documentação também é publicada em texto puro, no formato llms.txt:

Endereço	Conteúdo
/llms.txt	Índice de todas as páginas, com um resumo de cada uma.
/llms-full.txt	Toda a documentação em um único arquivo.
/{pagina}.md	Uma página específica em Markdown.

Esses endereços são públicos e não exigem login — aponte o seu agente para eles e ele lê a integração inteira sozinho.