Receive and parse a remittance file
A caller POSTs the object key of a file already present in the shared inbound bucket, the institution id, and the SISBAJUD file-type code; the service runs the receive and parse pipeline synchronously. A bad body maps to 422; a missing inbound object to 404. A benign skip returns 200 with status ‘skipped’ and an attributable reason: ‘lock_held’ when another worker holds the file lock and is processing it, or ‘skipped’ for an idempotent re-delivery.
Accepted fileType codes. The field takes a literal SISBAJUD numeric code, never a descriptive label such as REMESSA. Any code outside this table is rejected with 422 / SBJ-0006.
| Code | Environment | File kind | Parsed as |
|---|---|---|---|
5301 | PRODUCTION | Remessa de bloqueio (CNJ, 684 chars/line) | remessa |
5303 | PRODUCTION | Resultado de validação sintática (24 chars/line, layout 03) | remessa |
5308 | PRODUCTION | Requisição de informações AJUD308 (723 chars/line, layout 03) | requisição |
5311 | HOMOLOGATION | Remessa de bloqueio (CNJ, 684 chars/line) | remessa |
5313 | HOMOLOGATION | Resultado de validação sintática (24 chars/line, layout 03) | remessa |
5318 | HOMOLOGATION | Requisição de informações AJUD308 (723 chars/line, layout 03) | requisição |
The code alone selects the execution environment reported back in the environment response field, and 5308/5318 are the only codes routed to the requisição parser. The return file (5302/5312) is produced by this service, never accepted here.
Authorizations
JWT bearer token issued by the identity provider.
Body
The literal SISBAJUD file-type code — a 4-digit numeric code, NOT a descriptive label such as "REMESSA". Production: 5301 (remessa de bloqueio, 684-wide), 5303 (resultado de validação sintática, 24-wide), 5308 (requisição de informações AJUD308, 723-wide). Homologation: 5311, 5313, 5318 (same three kinds, in that order). Any other value is rejected with 422 / SBJ-0006.
"5301"
The institution's BACEN CNPJ code (8 digits) used for file header validation.
"12345678"
The institution id the file belongs to.
"44444444-4444-4444-4444-444444444444"
The object key of the file already present in the shared inbound bucket.
"inbound/2026/07/14/remessa-001.txt"
Response
OK
The reception outcome (processed or skipped).
"processed"
The resolved SISBAJUD environment (processed outcomes only).
"production"
The persisted file id (processed outcomes only).
"dddddddd-dddd-dddd-dddd-dddddddddddd"
The skip reason (skipped outcomes only): 'lock_held' when another worker holds the file lock and is processing it, or 'skipped' for an idempotent re-delivery.
"lock_held"

