📦 Iso20022Library

Biblioteca modular em C# (.NET 8) para gerar, serializar e validar mensagens do padrão ISO 20022, com suporte a estrutura Clean Architecture, validação via XSD e geração de documentação automática com DocFX.

---

📚 Funcionalidades

• ✅ Geração de XML para mensagens ISO 20022 (ex: pain.001.001.03)
• ✅ Validação de mensagens com arquivos .xsd
• ✅ Serialização com UTF-8
• ✅ Estrutura baseada em Clean Architecture
• ✅ Testes automatizados com MSTest
• ✅ Geração de documentação via DocFX

---

🧱 Estrutura do Projeto

Iso20022Library/
├── src/
│   ├── Iso20022Library.Domain/          # Interfaces e enums
│   ├── Iso20022Library.Application/     # Builders, Validadores
│   ├── Iso20022Library.Infrastructure/  # Serialização XML
│   └── Iso20022Library.Messages/        # XSD e classes geradas
├── tests/
│   └── Iso20022Library.Tests/           # Testes com MSTest
└── docfx_project/                       # Geração da documentação

---

🚀 Como Usar

1. Gerar XML de uma mensagem

var doc = new Document { /* preencher dados da mensagem */ };
var factory = new MessageBuilderFactory();
var builder = factory.GetBuilder(MessageType.Pain00100103);
string xml = builder.BuildXml(doc);

2. Validar contra o XSD

bool valido = XmlValidator.Validate(xml, "caminho/pain.001.001.03.xsd", out string erros);

---

🧪 Executar Testes

dotnet test

---

📘 Gerar Documentação

cd docfx_project
docfx build

Acesse a documentação em: docfx_project/_site/index.html

---

📂 Mensagens Suportadas

• pain.001.001.03
• pain.001.001.02
• pain.002.001.09
• camt.053.001.08
• (Adicione mais via XSD em Messages/)

---

🛠️ Requisitos

• .NET 8 SDK
• DocFX (para gerar a documentação)

---

📄 Licença

MIT License © 2025

ISO 20022 Library

Project Structure

This library follows the ISO 20022 message organization structure, organizing messages by their business domains.

Setup Instructions

Creating the Folder Structure

To create the recommended folder structure for the ISO 20022 messages, run the PowerShell script:

cd c:\Users\marci\source\repos\Iso20022Library\scripts
.\Create-FolderStructure.ps1

This will create the following structure:

Iso20022Library.Messages/
│
├── Payments/
│   ├── Pacs/        # Payments Clearing and Settlement
│   └── Pain/        # Payment Initiation
│
├── CashManagement/
│   └── Camt/        # Cash Management
│
├── Securities/
│   ├── Seev/        # Securities Events
│   ├── Semt/        # Securities Management
│   ├── Sese/        # Securities Settlement
│   └── Secl/        # Securities Clearing
│
├── TradeServices/
│   └── Tsmt/        # Trade Services Management
│
├── AccountManagement/
│   └── Acmt/        # Account Management
│
├── ReferenceData/
│   └── Reda/        # Reference Data
│
├── ForeignExchange/
│   └── Fxtr/        # Foreign Exchange Trade
│
├── Authorities/
│   └── Auth/        # Authorities
│
├── Collateral/
│   └── Colr/        # Collateral Management
│
├── Cards/
│   ├── Caaa/        # Card Acceptor to Acquirer
│   ├── Caad/        # Card Transactions
│   └── Casr/        # Card Services
│
└── Treasury/
    └── Trea/        # Treasury Operations

Each folder corresponds to a specific ISO 20022 message domain and type.