Substituir um template de layout de largura fixa do operador
Substitui totalmente um template de layout de largura fixa por tenant armazenado (records/fields/discriminator/recordWidths/requiredFields) por seu id — um PUT de substituição completa, não um patch esparso, já que os invariantes de intervalo de bytes são propriedades de layout inteiro. A substituição passa pelo MESMO gate de boa-formação que o caminho de submissão impõe ANTES do armazenamento: overrun, sobreposição, faltando-obrigatório, campo-zero ou uma coluna monetária mal-marcada (dinheiro DEVE ser kind=decimal) rejeita com 422 e o template armazenado é deixado inalterado. Retorna 404 quando nenhum template ativo corresponde, 409 quando a nova chave de formato colide com outro template ativo. Tenant do JWT; nunca do corpo.
Autorizações
Autenticação por Bearer token (formato: "Bearer {token}")
Parâmetros de caminho
Layout template ID ID do template de layout
Corpo
Largura do discriminador em bytes
x >= 11
Deslocamento de byte (base zero) do discriminador de tipo de registro
x >= 00
Família de formato sob a qual o template é agrupado por namespace
1"cnab400"
Tipos de registro declarados pelo layout
1Região ISO alpha-2 (em maiúsculas) ou XX
1"BR"
Eixo de variante de operador/marca
1"acme-cobranca"
Nomes de campo que a variante deve declarar
Resposta
OK
Timestamp de criação (RFC 3339, UTC)
"2025-01-15T10:30:00Z"
Intervalo de bytes do discriminador de tipo de registro que o parser lê para selecionar um tipo de registro
Chave canônica de descritor de formato (região/família/variante) sob a qual o template é registrado
"br/cnab400/acme-cobranca"
Identificador do template
"550e8400-e29b-41d4-a716-446655440000"
Número de tipos de registro que o layout declara
1
Largura fixa em bytes por tipo de registro, chaveada por tipo de registro
Tipos de registro que o layout declara, cada um com sua largura fixa e campos de intervalo de bytes ordenados, ordenados por tipo de registro
Nomes de campo que a variante deve declarar em seus tipos de registro
Chave de variante no arquivo pela qual o layout é chaveado
"acme-cobranca"

