Modelos de Formalização (SIAPE)

A QI suporta 5 modelos de formalização pra operações SIAPE — mesmo conjunto do Exército. Adicionalmente, pra agrupar várias operações num único envelope (recomendado em compra de dívida), use Assinatura em Lote.

Várias operações no mesmo envelope

Em compra de dívida com N duplas debt_purchase + refinancing (+ refin/refin consolidador), use Assinatura em Lote (POST /document/document_batch com type: federal_payroll_external_batch) — o servidor assina tudo de uma vez só.

Modelos disponíveis

Modelo	Quando usar
QI Sign automático (default)	QI envia link de assinatura ao borrower; nenhuma config extra
QI Sign em lote	Várias operações num único envelope; ver Assinatura em Lote
PDF assinado externamente	Parceiro tem signature provider próprio
Data-signature: opt-in	Borrower clica "concordo" em portal do parceiro
Data-signature: zip	Parceiro envia zip de evidências
Data-signature: selfie	Biometria via CaaS

QI Sign Automático

Não requer chamada adicional após /debt. QI envia URL pro borrower. Webhook debt fires com status: signature_finished.

PDF assinado externamente

POST /debt/{DEBT_KEY}/signed

{
  "signed_document_key": "<uuid retornado pelo upload do PDF>"
}

Data-signature: opt-in

{
  "data_signature": {
    "type": "opt_in",
    "evidence": { "ip_address": "...", "user_agent": "...", "timestamp": "..." }
  }
}

Data-signature: zip

{
  "data_signature": {
    "type": "zip",
    "signed_document_key": "<uuid do zip>"
  }
}

Data-signature: selfie

Requer integração CaaS (face match + liveness):

{
  "data_signature": {
    "type": "selfie",
    "signed_document_key": "<image_key do CaaS>"
  }
}

Webhook após formalização

debt com status: signature_finished — assinatura aceita pela QI. Em seguida, se reservation_method: issuing, a averbação é disparada agora; se creation, já foi disparada antes e o desembolso entra na fila quando confirmada.

Próximo passo

Após o signature_finished, a operação segue automaticamente: averbação confirmada (se issuing) → desembolso PIX/TED → webhook debt (disbursed).

Para acompanhar via webhooks: Webhooks. Para cancelar a qualquer momento: Cancelamento.