Importar Operação

Realiza o envio de uma operação (remessa) para processamento na base do Qgestora.

O campo operationFile aceita duas famílias de arquivo:

CNAB 400 ou 444, conforme o layout do Custodiante do fundo;

XML no layout de remessa da Hemera.

No envio por XML são processados os blocos Aquisicoes e Recompras do arquivo.

Não é necessário sinalizar qual dos dois está sendo enviado — o Qgestora identifica o formato pelo conteúdo do arquivo. Quem já envia CNAB não precisa alterar nada na integração.

Limites da chamada. Arquivo de até 100 MB; remessas grandes podem levar até 10 minutos para responder.

O que a resposta 200 significa. O arquivo foi aceito e a operação foi criada — não que ela foi aprovada. Pendências de cadastro identificadas na conferência não impedem a criação da operação: elas ficam registradas nela para tratamento dentro do Qgestora, e a resposta ainda é 200. Já os erros de leitura do arquivo — layout incompatível, campo obrigatório ausente, dado inválido — recusam o envio e retornam 400.

curl --location 'https://dominio-do-cliente-ws.qgestora.com.br/v1/import-cnab' \ --header 'Content-Type: application/json' \ --data '{ "token": "###############################################", "fundCnpj": "99999999999999", "operationFile": "", "fileName": "NOME_ARQUIVO.REM", "additiveNumber": 999999 }'

Importar Operação

Requisição

Respostas