Cancelar Aditamento

Desiste de um aditamento em andamento. O aditamento vai para canceled com status_reason: withdrawn_by_tenant.

Request

ENDPOINT

/security_amendment/amendment/AMENDMENT-KEY/cancel

MÉTODO

PATCH

Path Params

Campo	Tipo	Descrição	Caracteres
`AMENDMENT-KEY`	string	Chave única do aditamento (UUID v4).	36

Request Body

Nenhum. A requisição não leva corpo.

Quando o cancelamento é aceito

`status`	Cancelável
`created`	Sim
`pending_manual_approval`	Sim
`pending_term_generation`	Sim
`pending_charge_settlement`	Sim
`pending_signature`	Sim
`pending_signature_confirmation`	Sim
`pending_application`	Não
`applied` · `canceled` · `validation_failed` · `application_failed`	Não

Ponto sem volta

A partir de pending_application o cancelamento deixa de ser aceito — a recusa é AMD000012, com o status atual na mensagem. Se precisar reverter um aditamento já aplicado, fale com o seu contato comercial na QI Tech: é um procedimento próprio, não uma chamada de API.

Efeitos fora do aditamento

O cancelamento não se limita a mudar o status. Ele também:

Baixa o boleto da taxa, se houver um em aberto. Um boleto já compensado não é baixado — nesse caso, o estorno segue o seu contrato comercial.
Cancela o envelope de assinatura, se o termo já tiver sido enviado. Links de assinatura já distribuídos deixam de funcionar.

Response

STATUS

200

A resposta é o objeto completo do aditamento, já com status: canceled.

Response Body

{
  "amendment_key": "7f1c9a20-6c3e-4a51-9f0b-2d8e5b4c1a33",
  "status": "canceled",
  "security_key": "2d35b5a7-4cd1-4960-b1d7-4a53668e85b5",
  "amendment_number": 2,
  "operation_key": "8e2b4f10-77a1-4c3d-b9e5-1f6a0c9d2e47",
  "operation_type": "commercial_paper",
  "financial_base_date": "2026-09-20",
  "outstanding_balance": 152340.55,
  "created_by": "integration",
  "created_at": "2026-09-14T10:22:41",
  "applied_at": null,
  "envelope_key": null,
  "signature_method": "certifiqi",
  "changes": ["..."],
  "documents": ["..."],
  "charges": [
    {
      "amendment_charge_key": "9f8e7d6c-5b4a-4938-8271-6a5b4c3d2e1f",
      "charge_status": "canceled",
      "amount": 500.00,
      "settled_at": null,
      "charge_status_history": ["..."]
    }
  ],
  "status_history": [
    { "status": "created", "status_reason": null, "reason": null, "event_actor": "integration", "event_datetime": "2026-09-14T10:22:41" },
    { "status": "pending_charge_settlement", "status_reason": null, "reason": null, "event_actor": "system", "event_datetime": "2026-09-14T10:23:02" },
    { "status": "canceled", "status_reason": "withdrawn_by_tenant", "reason": null, "event_actor": "integration", "event_datetime": "2026-09-14T14:08:55" }
  ]
}

Erros

Status	Código	Descrição
404	`AMD000017`	Aditamento não encontrado.
403	`AMD000018`	O aditamento não pertence ao seu tenant.
409	`AMD000012`	O `status` atual não permite o cancelamento.

Request​

Path Params​

Request Body​

Quando o cancelamento é aceito​

Efeitos fora do aditamento​

Response​

Erros​

Veja também​