Force a return-file generation
Forces one return-file generation for the institution supplied in the body (institutionId) and returns the generated file’s summary. A missing/invalid institutionId is rejected with 422; an institution not configured with an institution_code is 422; a missing reception flow fails closed with 503.
Authorizations
JWT bearer token issued by the identity provider.
Body
The institution the return file is generated for (UUID).
"44444444-4444-4444-4444-444444444444"
Response
OK
Whether this run created a new return file.
true
The number of records in the generated file.
42
The resolved SISBAJUD environment.
"production"
The file content hash.
"sha256:abc123..."
The generated file name.
"retorno-2026-07-14.txt"
The SISBAJUD file-type code.
"RETORNO"
The RFC3339 generation timestamp.
"2026-07-14T12:00:00Z"
The generated file id.
"dddddddd-dddd-dddd-dddd-dddddddddddd"
The file status.
"GENERATED"

