Completar operação

Encerra a operação manualmente. Quando você cria com manualFinish.hasManualFinish = true, a operação não fecha sozinha mesmo depois que todos assinarem — fica aguardando este comando. Ao completar, o fluxo final consolida os PDFs, aplica os carimbos de auditoria, dispara o webhook CompletedOperation e libera o download.

Quando usar

• Operação em modo manual cujos assinantes já terminaram de assinar e você controla o momento exato de fechar
• Todos assinaram e você quer disparar a finalização agora em vez de esperar

Endpoint

curl -X POST "https://example.com/api/v2/operation/0/complete"

Sem body — o operationId na URL (o ID da operação, o campo id retornado em Criar operação) já basta.

Exemplo

curl -X POST "https://api.forsign.digital/api/v2/operation/4821/complete" \
  -H "X-Api-Key: $API_KEY"

await fetch(`https://api.forsign.digital/api/v2/operation/${operationId}/complete`, {
  method: 'POST',
  headers: { 'X-Api-Key': apiKey },
});

var resp = await http.PostAsync(
    $"/api/v2/operation/{operationId}/complete",
    content: null);
resp.EnsureSuccessStatusCode();

Resposta de sucesso (200)

{ "success": true, "statusCode": 200, "messages": [{ "value": "Operação concluída com sucesso" }] }

Comportamento e gotchas

• Só finaliza em modo manual e com todos assinados. Se houver assinante pendente, ou se a operação estiver em modo automático, a chamada retorna 200 mas não tem efeito. Por isso o 200 não garante que a operação foi concluída — confirme pelo webhook CompletedOperation ou consultando a operação.
• Quando a finalização ocorre, ela acontece durante a chamada: ao receber o 200, a operação já está Completed e os PDFs assinados já foram gerados.
• O webhook CompletedOperation é enviado alguns segundos depois do 200 (mensagem com atraso) — use-o como gatilho confiável para o download, em vez de baixar imediatamente.

Erros comuns

Diferença entre Completar e Cancelar

Veja também