Enviar arquivo CNAB 240

Endpoint: POST /hb/cnab/240/files

Formato padrao de resposta

Envelope de sucesso (interceptor global):

{
  "status_code": 200,
  "success": true,
  "message": "OK",
  "data": {}
}

Envelope de erro (filtro global):

{
  "status_code": 400,
  "code": "VALIDATION_ERROR",
  "message": "Erro de validacao",
  "timestamp": "2026-02-13T00:00:00.000Z",
  "path": "/exemplo",
  "details": []
}

POST /hb/cnab/240/files

• Autenticacao: Bearer JWT obrigatorio
• Contexto de conta: Exige conta ativa quando aplicavel
• Roles: Nao declarado
• Scopes: Nao declarado

Request

Path params

Nao possui.

Query params

Nao possui.

Body

Nao possui body tipado via DTO.

Upload de arquivo: multipart/form-data, campo file.

Headers

• Authorization: Bearer <jwt>: obrigatorio.

Exemplos de requisicao

curl -X POST "https://api.seudominio.com/hb/cnab/240/files" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer SEU_JWT" \
  -F "file=@/caminho/arquivo.png"

Response

Data (schema)

Nao tipado no retorno do controller. Informe um tipo de retorno para documentar automaticamente.

Sucesso (201):

{
  "status_code": 201,
  "success": true,
  "message": "Created",
  "data": "<resultado da operacao>"
}

Erro (contrato padrao):

{
  "status_code": 400,
  "code": "VALIDATION_ERROR",
  "message": "Erro de validacao",
  "timestamp": "2026-02-13T00:00:00.000Z",
  "path": "/hb/cnab/240/files",
  "details": []
}