Mersel.EBelge.XsltService 0.5.10

Mersel.EBelge.XsltService

Türkiye e-Belge (e-Fatura / e-Arşiv / e-İrsaliye / e-Defter) için:

• XSD doğrulama (JAXP, xs:include / HTTP-import çözümlemesiyle)
• Schematron doğrulama (Saxon HE 11.6, ISO 3-step pipeline)
• XSLT 3.0 dönüşüm + HTML sanitization (No-Exfiltration Sandbox) + filigran
• Belge tipi otomatik tespiti (UBL-TR / e-Arşiv / e-Defter Yevmiye/Kebir/Berat / Envanter)
• GİB paket sync (resmi ZIP'leri indir + aç)
• Validation profile + suppression (programmatic API)

C# native API, IKVM köprüsü, JRE gerekmez. Mersel.DssSigner'dan tamamen bağımsız.

Hedef çerçeveler

• .NET Framework 4.8 (net48)
• .NET 8 (net8.0)

Hızlı başlangıç

using Mersel.EBelge.XsltService;

var svc = new XsltService();
var type = svc.DetectType(File.ReadAllBytes("yevmiye-2026-05.xbrl"));
// → DocumentType.EDefterYevmiye

GİB paket sync + DiskAssetSource akışı (e-Defter için)

// 1. Resmi GİB paketlerini diske aç
var sync = new GibPackageSync();
var results = sync.SyncAll(@"C:\opt\gib-validator");
foreach (var r in results)
    Console.WriteLine($"{r.PackageId}: {(r.Success ? "OK" : "FAIL " + r.Error)} ({r.FilesExtracted} dosya)");

// 2. AssetSource'u o dizine yönelt
var svc = new XsltService().UseDiskAssets(@"C:\opt\gib-validator");

// 3. Yevmiye'yi XSD + Schematron ile birlikte doğrula
var resp = svc.ValidateAllByPath(
    xsdPath: "validator/eledger/schema/edefter.xsd",
    schPath: "validator/eledger/schematron/edefter_yevmiye.sch",
    xml:     File.ReadAllBytes("yevmiye-2026-05.xbrl"));

if (!resp.IsFullyValid)
{
    foreach (var e in resp.SchemaErrors)     Console.WriteLine("XSD: "  + e);
    foreach (var e in resp.SchematronErrors) Console.WriteLine($"SCH [{e.RuleId}]: {e.Message}");
}

In-memory asset source (embedded resource)

var assets = new InMemoryAssetSource()
    .Put("e-defter/yevmiye.sch", embeddedYevmiyeSch)
    .Put("e-defter/yevmiye.xsd", embeddedYevmiyeXsd);

var svc = new XsltService().UseAssetSource(assets);
var resp = svc.ValidateAllByPath("e-defter/yevmiye.xsd", "e-defter/yevmiye.sch", xml);

Profile + suppression (imzasız e-Fatura uyarılarını bastırma)

var registry = new ProfileRegistry();
registry.Register(new ProfileBuilder("unsigned")
    .Description("Imza zorunlulugu uyarilarini bastir")
    .AddSuppression("ruleId", "UBLTR-CO-01")                    // tam eşleşme
    .AddSuppression("text", ".*cac:Signature.*")                // regex
    .AddSuppression("text", ".*UUID.*", "INVOICE", "CREDIT_NOTE") // sadece bu tiplerde
    .Build());

var svc = new XsltService()
    .UseDiskAssets(@"C:\opt\gib-validator")
    .UseProfileRegistry(registry);

var resp = svc.ValidateSchematronWithProfile(
    schematronSource: File.ReadAllBytes(@"C:\opt\gib-validator\validator\ubl-tr-package\schematron\UBL-TR_Main_Schematron.xml"),
    xml:              File.ReadAllBytes("fatura.xml"),
    profileName:      "unsigned");

Console.WriteLine($"Active: {resp.SchematronErrors.Count}, suppressed: {resp.SuppressionInfo?["suppressedCount"]}");

XSLT dönüşüm — sanitize + filigran

var tr = svc.Transform(
    xml: File.ReadAllBytes("fatura.xml"),
    xslt: File.ReadAllBytes("ubl-to-html.xslt"),
    type: TransformType.Invoice,
    useEmbeddedXslt: false,
    watermark: "MUSTERI KOPYASI");

File.WriteAllBytes("fatura.html", tr.HtmlContent);
Console.WriteLine($"{tr.RemovedScriptCount} script engellendi, " +
                  $"{tr.AllowedScriptHashes.Count} script CSP listesinde");

UseEmbeddedXslt=true ile UBL belgesindeki cac:AdditionalDocumentReference/EmbeddedDocumentBinaryObject içindeki XSLT otomatik çıkarılır.

Faz dışı / sonraki sürümler için

• Custom Schematron rule injection (caller-tanımlı <sch:assert> öğelerini SCH XML'e gömme)
• AssetVersioning hot-reload watcher
• SuppressionImpactAnalyzer (asset diff regresyon analizi)
• YAML profile loader (şu an programmatic API)

Lisans

MIT (Saxon HE: MPL 2.0).