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.

Emissor aprovado

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

ENDPOINT

/issuer_management/issuer/ISSUER-KEY/auto_signature

MÉTODO

POST

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

STATUS

201

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.

Solicitação da Auto-assinatura (POST)​

Request​

Path Params​

Request Body​

Response​

Erros​