Enviar una plantilla de diseño de ancho fijo del operador
Valida y almacena una plantilla de diseño de ancho fijo por tenant (con espacio de nombres región/familia/variante). El diseño pasa por la compuerta de buena formación ANTES del almacenamiento: desbordamiento, solapamiento, requerido faltante, campo cero o una columna de dinero mal marcada (el dinero DEBE ser kind=decimal) rechaza con 422 y la plantilla nunca se almacena. Una plantilla aprobada se resuelve por la ruta de parseo como una fuente de diseño aditiva. Tenant desde el JWT; nunca del cuerpo.
Autorizaciones
Autenticación con token Bearer (formato: "Bearer {token}")
Cuerpo
Ancho del discriminador en bytes
x >= 11
Desplazamiento de bytes (base cero) del discriminador de tipo de registro
x >= 00
Familia de formato bajo la que se agrupa la plantilla
1"cnab400"
Tipos de registro declarados por el diseño
1Región ISO alpha-2 (en mayúsculas) o XX
1"BR"
Eje de variante de operador/marca
1"acme-cobranca"
Nombres de campo que la variante debe declarar
Respuesta
Creado
Marca de tiempo de creación (RFC 3339, UTC)
"2025-01-15T10:30:00Z"
Rango de bytes del discriminador de tipo de registro que el parser lee para seleccionar un tipo de registro
Clave de descriptor de formato canónico (región/familia/variante) bajo la que se registra la plantilla
"br/cnab400/acme-cobranca"
Identificador de la plantilla
"550e8400-e29b-41d4-a716-446655440000"
Número de tipos de registro que declara el diseño
1
Ancho fijo en bytes por tipo de registro, indexado por tipo de registro
Tipos de registro que declara el diseño, cada uno con su ancho fijo y campos de rango de bytes ordenados, ordenados por tipo de registro
Nombres de campo que la variante debe declarar en sus tipos de registro
Clave de variante en el archivo por la que se indexa el diseño
"acme-cobranca"

