Tüm Açık Kaynak Projeler
Java
MIT License
Spring Boot 3.4

e-Belge Doğrulama
& Dönüşüm Servisi

GİB UBL-TR belge doğrulama ve XSLT dönüşüm mikroservisi. e-Fatura, e-İrsaliye, e-Arşiv ve e-Defter belgelerinizi doğrulayın, XML'den HTML'e dönüştürün.

5stars0forks
GitHub'da İncele
Docker ile Başlangıç
# Docker ile Çalıştırma
docker compose up --build

# Veya sadece image oluştur
docker build -t mersel-xslt-service .
docker run -p 8080:8080 mersel-xslt-service
API Endpoints
POST/v1/validate
POST/v1/transform
POST/v1/admin/packages/sync
GET/actuator/health

Özellikler

e-Belge doğrulama ve dönüşüm için ihtiyacınız olan her şey

GİB UBL-TR Doğrulama

XSD + Schematron ile e-Fatura, e-İrsaliye, e-Arşiv, e-Defter belge doğrulama

XSLT Dönüşüm

XML belgelerden HTML görüntüleme, gömülü XSLT desteği ile otomatik dönüşüm

Doğrulama Profilleri

İmzasız belge doğrulama, kural bastırma ve özelleştirilebilir profiller

GİB Paket Sync

Resmi GİB paketlerini API ile otomatik indirme ve güncelleme

Hot-Reload

Dosya değişikliğinde veya API ile restart gerektirmeden yeniden yükleme

Web Arayüzü

React + TailwindCSS + shadcn/ui ile doğrulama ve dönüşüm arayüzü

Kullanım Örnekleri

Birkaç komutla belge doğrulama ve dönüşüm yapın

XML Doğrulama
# e-Fatura XML Doğrulama (belge türü otomatik tespit edilir)
curl -X POST http://localhost:8080/v1/validate \
  -F "source=@fatura.xml"

# Profil ile doğrulama (imzasız belge)
curl -X POST http://localhost:8080/v1/validate \
  -F "source=@fatura.xml" \
  -F "profile=unsigned"
XSLT Dönüşüm
# XSLT Dönüşüm (XML → HTML)
curl -v -X POST http://localhost:8080/v1/transform \
  -F "document=@fatura.xml" \
  -F "transformType=INVOICE"

# Gömülü XSLT ile dönüşüm
curl -v -X POST http://localhost:8080/v1/transform \
  -F "document=@fatura.xml" \
  -F "transformType=INVOICE" \
  -F "useEmbeddedXslt=true"
GİB Paket Sync
# GİB Paketlerini Güncelle
curl -X POST http://localhost:8080/v1/admin/packages/sync

# Belirli bir paketi sync et
curl -X POST http://localhost:8080/v1/admin/packages/sync?package=efatura

# Paket listesini gör
curl http://localhost:8080/v1/admin/packages

Gereksinimler

Java
21+
Gradle
8.12+
Docker
Opsiyonel
Doğrulama Profilleri

Esnek Doğrulama Yapılandırması

Farklı kullanım senaryoları için özelleştirilebilir doğrulama profilleri. İmzasız belge doğrulama, kural bastırma ve özel profil tanımlama desteği.

  • e-Fatura, e-İrsaliye, e-Arşiv, e-Defter belge tipleri
  • XSD şema doğrulama + Schematron kural doğrulama
  • İmzasız belge doğrulama modu
  • Kural bastırma ile esnek doğrulama
# Desteklenen Belge Tipleri
TICARIFATURA · TEMELFATURA · IHRACAT · EARSIV
# Hot-Reload Desteği
Dosya değişikliğinde otomatik yeniden yükleme
# Monitoring
Prometheus + Grafana dashboard hazır

Hemen Başlayın

Docker ile birkaç dakikada e-Belge doğrulama ve dönüşüm servisi kurun.

GitHub RepositoryTüm Projeler