GİB UBL-TR e-belgelerini (e-Fatura, e-Arşiv, e-İrsaliye, zarf) GİB'in kendi XSD ve şematron kurallarıyla kontrol eder, hatayı Türkçe açıklar — CLI ve MCP sunucusu. Validates Turkish UBL-TR e-invoices with the tax authority's own rules.
Server has 5 tools with complete schemas and descriptions. Tool names use Turkish verbs (belge_dogrula, belge_ozeti, bulgu_acikla, kod_listesi, kod_listeleri) which are domain-specific but lack English action verbs (get_, list_, validate_). Descriptions are detailed (100-300 chars) and explain WHAT and WHEN, but parameter descriptions are minimal or absent. All tools are read-only (toolAnnotations present). Input schemas visible with types, but parameter descriptions in schema are sparse. Output schemas not formally documented. Error handling returns structured dicts but lacks recovery guidance.
UBL-TR belgesini denetler: XML biçimi, OASIS UBL 2.1 XSD, GİB e-Fatura şematronu (498 kural, kod listeleri dahil), satır/vergi/tevkifat/dip toplam aritmetiği, imza yapısı. Her bulgu: kod, seviye (hata/uyari/bilgi), GİB'in özgün mesajı, satır numarası, Türkçe açıklama ve düzeltme. `dosya` yerel yol ya da `xml` belge metni; `tur` fatura|earsiv|irsaliye|irsaliye-yaniti|uygulama-yaniti|zarf (verilmezse kök elemandan ve ProfileID'den bulunur). Validates a Turkish UBL-TR e-invoice with the tax authority's own schematron and returns findings.
Belgenin kimliği: senaryo, fatura tipi, numara, UUID, tarih, para birimi, satıcı/alıcı (VKN/TCKN, unvan), satırlar (ilk 50), vergiler, dip toplamlar, imzalı mı. Summary of a UBL-TR document: parties, lines, taxes and totals.
Bir bulgu kodunun (örn. sch-GeneralUnitCodeCheck-1, hesap-dip-odenecek) Türkçe açıklaması, hangi alanın neden reddedildiği ve nasıl düzeltileceği. Explains a finding code.
Mevcut GİB kod listelerinin adları ve Türkçe açıklamaları; kaynak paket sürümleri. Names of the available code lists and the GİB package versions this build uses.
GİB kod listesinin değerleri (şematronun fiilen uyguladığı liste): UnitCodeList, TaxType, InvoiceTypeCodeList, ProfileIDType, CurrencyCodeList, WithholdingTaxTypeWithPercent, TaxExemptionReasonCodeType, PaymentMeansCodeTypeList... `ara` ile alt dize filtresi. Values of a GİB code list as enforced by the schematron.
Tool names use Turkish verbs instead of English action verbs (belge_dogrula vs validate_document). LLMs trained on English patterns may struggle to infer intent from non-English names.
Parameter descriptions in input schemas are minimal. 'dosya' and 'xml' in belge_dogrula lack guidance on mutual exclusivity or format expectations. LLMs cannot infer constraints from names alone.
Output schemas not formally documented. Tools return dict[str, Any] with no schema definition visible. LLMs cannot plan downstream calls or extract fields reliably without knowing response structure.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2026-07-28+ | v2 |
Error handling returns structured dicts but lacks recovery guidance. belge_ozeti catches BelgeHatasi and returns {hata, mesaj, satir}, but does not suggest next steps (e.g., 'Try belge_dogrula() to see detailed validation errors').
kod_listesi accepts 'ara' (substring filter) but does not document valid list names or filtering behavior. LLMs must guess which lists exist or call kod_listeleri first as a discovery step.