查询临时文件

通过键查询临时 CNAB 文件，可返回有关该文件的详细信息，例如已处理的记录数量以及文件中发现的可能错误。

Request

ENDPOINT

/account/ACCOUNT_KEY/requester_profile/REQUESTER_PROFILE_KEY/temporary_cnab_file/TEMPORARY_CNAB_FILE_KEY

MÉTODO

GET

Path parameters

字段	类型	描述	字符数
`account_key`	uuidv4	账户唯一标识键，uuid v4 格式	36
`requester_profile_key`	uuidv4	钱包唯一标识键，uuid v4 格式	36
`temporary_cnab_file_key`	uuidv4	临时 CNAB 文件唯一标识键，uuid v4 格式	36

Response

STATUS

200

Response Body: 文件已接受（无错误）

{
  "temporary_cnab_file_key": "fa4f094d-8475-4828-9105-99756914e14f",
  "temporary_cnab_file_name": "240827463_t.REM",
  "temporary_cnab_file_status": "read",
  "occurrence_quantity": 6,
  "total_processed_occurrences": 6,
  "created_at": "2024-08-28T15:09:30Z"
}

Response Body: 文件已拒绝（有错误）

{
  "temporary_cnab_file_key": "c16baa13-0969-46a7-a85f-6f975d266d9f",
  "temporary_cnab_file_name": "240905623.REM",
  "temporary_cnab_file_status": "rejected",
  "occurrence_quantity": 0,
  "total_processed_occurrences": 0,
  "created_at": "2024-09-10T15:59:25Z",
  "error_data": [
    {
      "code": "BKS000063",
      "title": "Bad Request",
      "description": "Invalid file code.",
      "translation": "Codigo de arquivo invalido.",
      "extra_fields": {
        "details": "Invalid file code. Expected: '1'. Got: '0'.",
        "file_line": 1,
        "details_pt_br": "Código de arquivo inválido. Esperado: '1'. Recebido: '0'.",
        "cnab_file_name": "240905623.REM",
        "cnab_inline_end_position": 2,
        "cnab_inline_start_position": 2
      }
    },
    {
      "code": "BKS000069",
      "title": "Bad Request",
      "description": "Invalid beneficiary account: beneficiary account is not the one that the requester profiles belongs to.",
      "translation": "Conta do beneficiario invalida: a conta do beneficiario nao e aquela a qual a carteira de boletos pertence.",
      "extra_fields": {
        "details": "Invalid beneficiary account header on header. Expected: '1927400'. Got: '3;53179'.",
        "file_line": 1,
        "details_pt_br": "Conta do beneficiário inválida no header. Esperado: '1927400'. Recebido: '3;53179'.",
        "cnab_file_name": "240905623.REM",
        "cnab_inline_end_position": 46,
        "cnab_inline_start_position": 40
      }
    },
    {
      "code": "BKS000064",
      "title": "Bad Request",
      "description": "Invalid bank code (014).",
      "translation": "Codigo do banco invalido (014).",
      "extra_fields": {
        "details": "Invalid bank code. Expected: '329'. Got: '014'",
        "bank_code": "014",
        "details_pt_br": "Código do banco inválido. Esperado: '329'. Recebido: '014'",
        "cnab_file_name": "240905623.REM"
      }
    },
    {
      "code": "BKS000056",
      "title": "Bad Request",
      "description": "Invalid record sequence.",
      "translation": "Sequencia invalida de registros.",
      "extra_fields": {
        "cnab_line": 1,
        "cnab_file_name": "240905623.REM"
      }
    },
    {
      "code": "BKS000056",
      "title": "Bad Request",
      "description": "Invalid record sequence.",
      "translation": "Sequencia invalida de registros.",
      "extra_fields": {
        "cnab_line": 2,
        "cnab_file_name": "240905623.REM"
      }
    },
    {
      "code": "BKS000086",
      "title": "Bad Request",
      "description": "File missing trailler record.",
      "translation": "Arquivo sem registro trailler.",
      "extra_fields": {
        "file_line": 3,
        "cnab_file_name": "240905623.REM"
      }
    }
  ]
}

Response Body Params

字段	类型	描述	字符数
`temporary_cnab_file_key` *	uuidv4	临时 CNAB 文件唯一标识键，uuid v4 格式	36
`temporary_cnab_file_name` *	uuidv4	文件名	100
`temporary_cnab_file_status` *	string	临时 CNAB 文件状态	Enumeradores temporary_cnab_file_status
`occurrence_quantity` *	integer	文件中的记录数量	-
`total_processed_occurrences` *	integer	已处理的记录数量	-
`error_data`	object array	文件中发现的错误对象（JSON 格式），与 API 返回格式相同	Objeto error_data
`created_at` *	string	文件在数据库中创建的时间戳，ISO Zulu 格式	20

Enumeradores temporary_cnab_file_status

枚举值	描述
uploaded	上传成功，但文件尚未开始处理
processing	文件正在读取中
read	文件已读取并接受
rejected	文件已读取并因语法错误被拒绝

Objeto error_data

字段	类型	描述	字符数
`code` *	string	错误代码	9
`title` *	string	错误标题	100
`description` *	string	错误描述（英文）	100
`translation` *	integer	错误描述翻译	100
`extra_fields`	object	关于错误的附加信息	-

重要

extra_fields 对象中返回的字段用于提供关于错误的附加信息，可能有所不同。因此，不应以严格限定的方式进行映射。

Error Response

STATUS

4xx

Response Body: Error

{
  "title": "titulo",
  "description": "description in English",
  "translation": "descrição em portugues",
  "code": "codigo",
  "extra_fields": {}
}

HTTP 状态码 `status`	QI 代码 `code`	标题 `title`	描述（英文） `description`	描述（葡文） `translation`
400	QIT000001	Bad Request	Schema Error	Schema Inválido
404	BKS000006	Not Found	The source account key was not found.	A chave da conta de origem não foi encontrada.
400	BKS000007	Bad Request	It was not possible to consult the source account at this time. Please try again in a few minutes.	Não foi possível consultar a conta de origem neste momento. Por favor, tente novamente em alguns minutos.
400	BKS000008	Bad Request	The source account is closed.	A conta de origem está fechada.
400	BKS000009	Bad Request	The source account is blocked.	A conta de origem está bloqueada.
404	BKS000013	Not Found	Requester profile not found	Carteira não encontrada
404	BKS000054	Not Found	Remittance not found with key: `{temporary_cnab_file_key}`	Remessa não encontrada com a chave: `{temporary_cnab_file_key}`

Request​

Path parameters​

Response​

Response Body Params​

Enumeradores temporary_cnab_file_status​

Objeto error_data​

Error Response​