1. Raiz
API RESTFul Qgestora
  • API RESTful Qgestora
    • Raiz
      • Importar Pessoa/Limite de Crédito
      • Validar Remessa de Operações
      • Realizar Envio de Operações (Remessas)
      • Envio de Documentação de Lastro
      • Receber Notificação de Operações (Remessas) — Webhook
      • Importar Cedente/Limite de Crédito
    • Schemas
      • ValidateImportCnabRequest
      • ImportCnabRequest
      • ImportReceivableDocumentationRequest
      • ReceivableDocumentationFile
      • ReturnCnabSituationRequest
      • CnabInformation
      • ExceptionResponse
      • ExceptionResponseError
      • TransferorData
      • TransferorCreditLimit
      • ImportTransferorLimitRequest
      • ImportTransferorLimitResponse
      • PersonData
      • PersonCreditLimit
      • ImportPersonLimitRequest
      • ImportPersonLimitResponse
      • ImportMessage
  • API RESTful Qgestora - Cancelamento de Operações (Estorno e Rejeição)
    • Raiz
      • Cancelar Operação
        POST
    • Schemas
      • OperationCancellationRequest
      • ApiResponseSuccess
      • ApiResponseError
      • ApiResponseFail
  1. Raiz

Cancelar Operação

POST
/v1/operation-cancellations
Realiza o cancelamento de uma operação no Qgestora, contemplando estorno e rejeição, garantindo rastreabilidade e validações de segurança.
Através dessa rota é possível cancelar uma operação aprovada (Liquidada) no Qgestora. O processo executa o estorno da operação e a marca como rejeitada, registrando o motivo e o usuário responsável.

Parâmetros#

AtributoTipoObrigTamOcorrDescrição
tokenAlfaSim641:1Token gerado no Qgestora. Mesmo token utilizado pelo Qcertifica e Qprof.
fundCnpjAlfaSim181:1CNPJ do fundo, com ou sem máscara (ex: 00.000.000/0001-00 ou 00000000000100).
additiveNumberAlfaSim-1:1Número do aditivo (Identificador da operação dentro do sistema do cliente).
reasonAlfaSim-1:1Motivo do cancelamento da operação.
userNameAlfaSim-1:1Login do usuário responsável pelo cancelamento.

Regras de Negócio#

A operação deve estar com situação Aprovada (Liquidada) para ser cancelada.
O fundo informado deve existir e estar ativo na base do Qgestora.
Caso a operação já possua integração com custodiante (transmissão ou aprovação de liquidação), o cancelamento não poderá ser realizado via sistema.
O motivo e o usuário responsável serão registrados e exibidos nas telas de Consulta Remessa, Monitor de Operações e Operação.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Sucesso. A operação foi cancelada com sucesso.
Bodyapplication/json

🟠400
🟠401
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/operation-cancellations' \
--header 'Content-Type: application/json' \
--data '{
    "token": "###############################################",
    "fundCnpj": "99999999999999",
    "additiveNumber": "999999",
    "reason": "Motivo do cancelamento",
    "userName": "usuario.responsavel"
}'
Response Response Example
200 - response
{
    "Code": 200,
    "Status": "success",
    "TraceIdentifier": "EBA71AC7C2B",
    "Data": "Aditivo cancelado com sucesso.",
    "Message": null
}
Modified at 2026-06-03 22:08:56
Previous
ImportMessage
Next
OperationCancellationRequest
Built with