İşNet e-Fatura / e-Arşiv / e-İrsaliye — Turkish GİB e-invoicing for Dolibarr

Community module · Free · GPL-3.0-or-later · Not affiliated with İşNet or GİB

 Key Functions

•   
• e-Fatura or e-Arşiv sent automatically when a customer invoice is validated; the receiver is looked up in the GİB taxpayer list and the document type is chosen for you
• Scenarios: basic, commercial, public sector (KAMU), export (goods → Ministry of Trade e-Fatura, services → foreign e-Arşiv)
• Withholding (GİB codes 601–627), e-Arşiv returns, online-sale information, foreign currency with exchange rate, delivery note references, IBAN, Dolibarr PDF attachment, company XSLT/logo template
• e-İrsaliye on shipment validation (driver, plate, carrier; taxpayer check)
• Status tracking by cron, signed PDF stored in Dolibarr documents, e-Arşiv cancellation and e-mail resend
• Dedicated tab on invoice and shipment cards; e-document number and status columns in lists

• ---

    

• Müşteri faturası onaylanınca otomatik e-Fatura veya e-Arşiv; alıcı GİB mükellef listesinde sorgulanır, belge türü otomatik seçilir
• Senaryolar: temel, ticari, KAMU, ihracat (mal → Ticaret Bakanlığı e-Faturası, hizmet → yurtdışı e-Arşiv)
• Tevkifat (GİB kodları 601–627), e-Arşiv iade, internet satışı bilgileri, döviz ve kur, irsaliye referansı, IBAN, Dolibarr PDF eki, firma XSLT/logo şablonu
• Sevkiyat onaylanınca e-İrsaliye (sürücü, plaka, taşıyıcı; mükellef kontrolü)
• Cron ile durum takibi, imzalı PDF'in Dolibarr belgelerine kaydı, e-Arşiv iptali ve e-posta tekrar gönderimi
• Fatura ve sevkiyat kartında ayrı sekme; listelerde e-belge no ve durum sütunları

 Main Features

•   
• Incoming e-Faturas from suppliers listed and imported as draft supplier invoices with one click (supplier auto-created from VKN, integrator PDF attached); accept / reject replies for commercial invoices
• Incoming e-İrsaliye list and receipt advice
• GİB city / town / tax-office code lists cached locally; free-text tax office names on third parties resolved to codes
• Turkish Prof ID labels (Vergi No / Vergi Dairesi / MERSİS / Ticaret Sicil)
• Pre-flight check before every submission with human-readable messages
• Full audit trail: document events on the Events tab, setup changes in the security audit log
• 10 MCP tools for the Dolibarr 24 AI module (status, failed documents, taxpayer check, incoming invoices, credits…)
• Everything configurable from the setup page; no core modification, no hard-coded company data

• ---

    

• Gelen e-Faturalar listelenir, tek tıkla taslak tedarikçi faturasına aktarılır (cari VKN'den otomatik açılır, entegratör PDF'i eklenir); ticari faturalara kabul / red yanıtı
• Gelen e-İrsaliyeler ve alındı yanıtı
• GİB il / ilçe / vergi dairesi kod listeleri yerel önbellekte; cari kartındaki serbest metin vergi dairesi adı koda çevrilir
• Türkçe Prof ID etiketleri (Vergi No / Vergi Dairesi / MERSİS / Ticaret Sicil)
• Her gönderim öncesi insan-okur mesajlarla ön kontrol
• Tam denetim kaydı: belge olayları Olaylar sekmesinde, ayar değişiklikleri güvenlik denetim günlüğünde
• Dolibarr 24 AI modülü için 10 MCP aracı (durum, başarısız belgeler, mükellef sorgusu, gelen faturalar, kontör…)
• Her şey ayar sayfasından; çekirdek değişikliği yok, kodda şirkete özgü veri yok

How it works

1. Install and enable the module (tables, extra fields, cron jobs and Turkish Prof ID labels are created automatically)
2. Company setup: Prof ID 1 = VKN, Prof ID 2 = tax office
3. Module setup: environment Test, the test VKN given by İşNet, then Connection test
4. Validate an invoice → open the e-Fatura tab on the invoice card
5. Go live: send your server's static IP to İşNet, enter the production URLs, switch the environment to Prod

1. Modülü kurun ve aktif edin (tablolar, ek alanlar, cron görevleri ve Türkçe Prof ID etiketleri otomatik oluşur)
2. Şirket ayarları: Prof ID 1 = VKN, Prof ID 2 = vergi dairesi
3. Modül ayarları: ortam Test, İşNet'in verdiği test VKN'si, ardından Bağlantı testi
4. Bir fatura onaylayın → fatura kartındaki e-Fatura sekmesini açın
5. Canlıya geçiş: sunucunuzun sabit IP'sini İşNet'e bildirin, prod URL'lerini girin, ortamı Prod yapın

Documentation / Dokümantasyon

• Wiki (Turkish): installation, settings, daily use, MCP tools, İşNet API notes, FAQ
• Source code, releases and issues on GitHub

License / Lisans

GPL-3.0-or-later with an attribution-preservation term under GPLv3 §7(b): the author attribution must be kept in derived works. Free for personal and commercial use.
GPL-3.0-or-later; GPLv3 7(b) kapsamında yazar atfının korunması şartıyla. Kişisel ve ticari kullanım ücretsizdir.

Author / Yazar: M. Burak Şentürk — buraksenturk.net — github.com/mbrksntrk