1. Raiz
API RESTFul Qgestora
  • API RESTful Qgestora
    • Raiz
      • Importar Pessoa/Limite de Crédito
      • Validar Importação de Operação
      • 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
      • ExceptionResponse
      • ExceptionResponseError
  1. Raiz

Cancelar Operação

POST
/v1/operation-cancellations
Realiza o cancelamento de uma operação no Qgestora, garantindo rastreabilidade e validações de segurança.
Através dessa rota é possível cancelar uma operação no Qgestora. O comportamento varia conforme a situação da operação:
Operação Aprovada: executa o estorno e em seguida a rejeição, registrando o motivo e o usuário responsável.
Operação ainda não aprovada: executa a rejeição diretamente, sem estorno.

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: 99.999.999/9999-99 ou 99999999999999).
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#

O fundo informado deve existir e estar ativo na base do Qgestora.
A operação deve existir para o fundo e aditivo informados.
Operação Aprovada: verifica integração com custodiante, executa estorno e em seguida a rejeição.
Operação ainda não aprovada: executa a rejeição diretamente, sem necessidade de estorno.
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. Esta validação é aplicada apenas para operações Aprovadas.
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.

Códigos de Erro#

CódigoDescrição
InvalidTokenToken não informado ou inválido.
CancellationErrorErro de validação no cancelamento.
InternalErrorErro interno no servidor.

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": "TOKEN_GERADO_NO_QGESTORA",
    "fundCnpj": "99999999999999",
    "additiveNumber": "999999",
    "reason": "MOTIVO DO CANCELAMENTO",
    "userName": "USUARIO.RESPONSAVEL"
}'
Response Response Example
200 - response
Aditivo cancelado com sucesso.
Modified at 2026-06-09 12:07:30
Previous
ImportMessage
Next
OperationCancellationRequest
Built with