Solicitação da Auto-assinatura
Este endpoint solicita a habilitação da auto-assinatura para um emissor aprovado. Na mesma chamada, a QI Tech gera o termo de adesão e abre o envelope de assinatura, de modo que a resposta já volta com a habilitação pronta para ser assinada.
Consulte o fluxo da auto-assinatura para o encadeamento completo.
A solicitação só é aceita quando o cadastro do emissor está no status approved e o cliente está habilitado para auto-assinatura. Não há criação automática — nada acontece até que este endpoint seja chamado.
Solicitação da Auto-assinatura (POST)
Request
Path Params
| Campo | Tipo | Descrição | Caracteres |
|---|---|---|---|
ISSUER-KEY | string | Chave única do emissor (UUID v4). | 36 |
Request Body
Este endpoint não recebe corpo. O grupo de assinantes e o template do termo de adesão são resolvidos pela QI Tech a partir do cadastro do emissor e da configuração do cliente.
Response
Response Body
{
"issuer_auto_signature_key": "9c3f0f1e-6a2b-4c58-9c9c-0f6b1d2a7e34",
"status": "pending_signature",
"signed_at": null,
"enabled_at": null,
"issuer_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e",
"term_document_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e/adhesion_auto_signature_term/5d1c8b30-2f44-4a9e-8c7b-1e0a6f2d9b55",
"envelope_key": "5b930d3d-3713-4c42-85d5-f8e9e44e30ce",
"created_at": "2026-02-10T09:15:44",
"event_list": [
{
"event_type": "auto_signature_creation",
"status": "pending_term_generation",
"event_data": {
"tenant_key": "5e3045af-8be8-4cbd-9aab-9e15c4e92154"
},
"created_at": "2026-02-10T09:15:44"
},
{
"event_type": "adhesion_term_generation",
"status": "pending_term_generation",
"event_data": {
"term_document_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e/adhesion_auto_signature_term/5d1c8b30-2f44-4a9e-8c7b-1e0a6f2d9b55",
"template_key": "b71f1a2c-9e44-4c1d-8f3a-6d2c0b5e7a19"
},
"created_at": "2026-02-10T09:15:46"
},
{
"event_type": "envelope_creation",
"status": "pending_signature",
"event_data": {
"envelope_key": "5b930d3d-3713-4c42-85d5-f8e9e44e30ce"
},
"created_at": "2026-02-10T09:15:47"
}
]
}
A resposta é o mesmo objeto da consulta da auto-assinatura, normalmente já em pending_signature, com term_document_key e envelope_key preenchidos. Em seguida, consulte os links de assinatura para obter o link de cada assinante.
Erros
| HTTP | Código | Quando ocorre |
|---|---|---|
| 400 | ISS0000032 (IssuerNotApproved) | O emissor não está no status approved. |
| 400 | ISS0000033 (AutoSignatureNotEnabledForTenant) | O cliente não está habilitado para auto-assinatura. |
| 403 | ISS000011 (TenantForbidden) | O cliente não possui acesso completo ao cadastro do emissor informado. |
| 404 | ISS000009 (IssuerNotFound) | Não existe emissor para a chave informada. |
| 404 | ISS0000026 (TenantConfigurationNotFound) | O cliente não possui configuração de auto-assinatura cadastrada. |
| 409 | ISS0000029 (AutoSignatureAlreadyExists) | O emissor já possui uma auto-assinatura ativa em pending_signature ou enabled. Cancele a atual antes de solicitar outra. |