APRENDER. PRATICAR. EVOLUIR.Conceito e mecanismo
O identificador de uma definição distingue área de negócio, número da definição, variante e versão. A versão publicada no catálogo não é necessariamente a usada num esquema ou numa comunidade. As guidelines EPC de 2025, por exemplo, referem mensagens da edição de 2019. Um projeto deve guardar a combinação de definição, perfil, listas externas, extensão e data de eficácia para cada interface. O e-Repository pode incluir definições candidatas ainda em avaliação. Estar num sítio oficial não transforma um draft em contrato de produção. Atualizar apenas o namespace também não implementa as mudanças de estrutura, restrições ou interpretação exigidas pela nova versão.
Aplicação guiada
Uma variante registada restringe uma definição global e tem ciclo de manutenção próprio; não é sinónimo de qualquer XSD local reduzido. SupplementaryData exige extensão registada, qualificação para a versão aplicável e acordo das partes sobre utilização. Uma atualização da mensagem base deve rever essa dependência. Na integração por API, distinguir modelo do recurso de comportamento completo da API: JSON Schema não define sozinho autenticação, retries ou idempotência. Manter uma matriz de compatibilidade permite planear migração por comunidade e testar transformações entre contratos. Evitar transportar um prazo de outra iniciativa para todo o universo ISO 20022. Cada decisão precisa do âmbito e da fonte aplicável, além da data.
Exemplo: duas comunidades usam versões diferentes. Um modelo interno comum pode ser útil, desde que adaptadores e testes preservem as regras e o significado de cada contrato externo.
Armadilhas comuns
Mais recente como obrigatório em todo o lado; draft como versão aprovada; extensão como conteúdo arbitrário; recurso JSON como API completa.
Tópicos relacionados: Semântica e documentação do contrato · Mensagens, cabeçalhos e estados · Validação por camadas
Versionar o conjunto do contrato e acordar a migração com quem o utiliza.
Referência: Catalogue of messages · DR ISO20022 fundamentals professional assessment2026.10