Importa um arquivo de retorno bancário

POST

/v1/import-bank-return/

Recebe o arquivo CNAB de retorno comprimido, identifica o fundo pelo CNPJ do
beneficiário lido do próprio arquivo e envia o retorno para processamento.

Diferente das demais rotas v1/, esta não usa token no corpo: exige
Authorization: Basic (somente Basic; os headers username/password não são
aceitos aqui) e ainda verifica se o usuário tem acesso à tela de retorno
bancário na empresa/filial do fundo.

Requisição

Authorization

Basic Auth

Envie suas requisições HTTP com um cabeçalho

Authorization

que contenha a palavra Basic seguida por um espaço e uma string codificada em base64 username:password

Exemplo:

Authorization: Basic *****************

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

Arquivo aceito e enviado para processamento.

Bodyapplication/json

🟠400

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://{dominio-cliente}-ws.qtrust.com.br/v1/import-bank-return/' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{
    "FileName": "RETORNO_20260910.ret",
    "MovementDate": "2026-09-10",
    "ReturnFileGzip": "H4sIAAAAAAAAA+3BAQ0AAADCoPdPbQ8HFAAAAAAAAAAAAAAAAAAAAIC3AYbSVKsAQAAA",
    "Regularizar": false
}'

Response Example

200 - Sucesso

{
    "success": true,
    "message": "Arquivo de retorno enviado para processamento.",
    "dataMovimento": "2026-09-10"
}

Modificado em 2026-09-22 14:04:39

Página anterior

Sua Primeira Requisição

Próxima página

Consulta a situação das operações de uma data