v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB

Ingestion

Get an operator fixed-width layout template

Retrieves one active per-tenant fixed-width layout template by its id. Returns 404 when no active template matches. Tenant from the JWT; never the body.

get/v1/imports/formats/templates/{templateId}

Path parameters

templateIdstring uuid required

Layout template ID

Response

createdAtstring date-time required

Creation timestamp (RFC 3339, UTC)

formatKeystring required

Canonical format descriptor key (region/family/variant) the template registers under

idstring uuid required

Template identifier

recordTypeCountinteger required

Number of record types the layout declares

recordWidthsobject required

Per-record-type fixed width in bytes, keyed by record type

requiredFieldsstring[] nullable required

Field names the variant must declare across its record types

variantKeystring required

In-file variant key the layout is keyed by

Example response

{
  "createdAt": "2025-01-15T10:30:00Z",
  "discriminator": {
    "length": 1
  },
  "formatKey": "br/cnab400/acme-cobranca",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "recordTypeCount": 1,
  "records": [
    {
      "fields": [
        {
          "kind": "decimal",
          "length": 12,
          "name": "amount",
          "startByte": 11
        }
      ],
      "recordType": "1",
      "width": 33
    }
  ],
  "variantKey": "acme-cobranca"
}