e-Belge ayarları (EDM entegratör)

Rehber

Modül

Yönetim

Menü yolu

Yönetim › Özelleştirme › Finans › e-Belge Ayarları

Ekran adresi

/erp/edocuments/settings

Gereken izin

erp-edocuments-settings.view (görme) · erp-edocuments-settings.edit (kaydetme, parola, Bağlantıyı Sına)

erp-edocuments-settings.activate (e-Belgeyi açmak ve Canlı ortama almak — ayrı yetki)

CoreX ERP e-Fatura, e-Arşiv ve e-İrsaliyeyi GİB'e özel entegratör EDM Bilişim üzerinden gönderir ve alır. e-Belge Ayarları bu bağlantının tek ekranıdır: "e-Fatura, e-Arşiv ve e-İrsaliye entegratör (EDM) bağlantısı. Kurulum kapalı başlar; kapalıyken hiçbir belge gönderilmez ve entegratöre çağrı yapılmaz".

Kimlik bilgisi

Entegratör kullanıcı adı ve parolası kurumunuza aittir; yalnız bu ekrana, yetkili kişi tarafından girilir. Parola şifreli saklanır, ekrana ve dışa aktarıma hiç gelmez. Belgedeki görüntülerde kimlik alanları bilerek boştur.

Ekranın yedi sekmesi

Genel · Bağlantı · Etiketler ve Seriler · Belgeler · Zamanlama · Durum · Canlıya Geçiş. Sekmeler arasında geçmek kaydedilmemiş alanı kaybettirmez. Kaydet pencerenin dibindedir ve bütün sekmeleri birlikte kaydeder (parola hariç — "Parola bu düğmeyle gitmez — Bağlantı sekmesinde ayrı kaydedilir."). Kayıt öncesi denetim hatalı alanın sekmesini söyler ("… (Bağlantı sekmesi)") ve Alana git ile o alana götürür.

Ekranın üstünde iki kalıcı uyarı çıkabilir:

Uyarı	Anlamı
"Acil durdurma açık (sunucu ortam değişkeni). Buradaki şalter ne olursa olsun e-Belge KAPALI çalışır; bayrak kaldırılınca kayıtlı ayar geri gelir."	Sunucu yöneticisi `EDocuments__ForceDisabled` bayrağıyla bütün entegratör çağrılarını durdurmuştur. Bağlantıyı Sına da çalışmaz: "Acil durdurma açıkken entegratöre çağrı yapılmaz."
"Bu kurulum TEST ortamı: canlı e-Belge ortamı kapalı. Canlı seçilemez ve canlı parola burada kaydedilmez; entegratöre yalnız Test ortamıyla bağlanılır."	Kurulum test kurulumudur (canlı veritabanının kopyası buraya yüklenebilir). Ortam listesinde Canlı kapalıdır.

Canlı kapısı sunucudadır. Kaydetmeye ya da canlı parolayı girmeye çalışılırsa sunucu şu iletilerden birini verir:

"Bu kurulumda canlı e-Belge ortamı kapalı (EDocuments__LiveAllowed=false): test ortamı canlı entegratöre bağlanmaz."
"Bu kurulumun lisansı TEST ortamı için: canlı e-Belge ortamına bağlanılamaz. Test ortamında e-Belge entegratörün test hesabıyla denenir; canlı fatura için canlı lisans gerekir."

Genel

Alan	Değerler	Açıklama
e-Belge etkin	Açık / Kapalı (varsayılan kapalı)	"Ana şalter. Kapalıyken belge gönderilmez, gelen kutusu çekilmez." Açmak e-Belge Ayarları · Etkinleştir yetkisi ister; yetkisi olmayan kapatabilir, açamaz ("Açmak "e-Belge Ayarları · Etkinleştir" yetkisi ister."). Açmadan önce seçili ortamın kullanıcı adı ve parolası kayıtlı olmalı ("e-Belgeyi açmadan önce seçili ortamın parolasını kaydedin.").
Ortam	Test · Canlı	"Kimlik ve numara sayacı ortam başına ayrı; test gönderimi canlı seriyi tüketmez." Canlıya almak da Etkinleştir yetkisi ister ve onay penceresi açar (aşağıda).
Entegratör	EDM Bilişim (salt okunur)	Kurulumun entegratörü.
e-Fatura başlangıcı	Tarih	"Bu tarihten itibaren fatura CoreX'te kesilir; öncesi fatura referansıyla kapanır." Bu tarihten sonraki teslimata dış fatura referansı yazılamaz. Canlıya geçişin engelleyici maddesidir.

Bağlantı

Test ve Canlı için iki ayrı bölüm vardır; seçili ortamın başlığında "· seçili" yazar.

Alan	Açıklama
e-Fatura / e-Arşiv adresi	Entegratörün fatura servis adresi. `https://` ile başlamalı ("… https ile başlayan geçerli bir adres olmalı."). Kurulumda EDM'nin test ve canlı adresleri dolu gelir.
e-İrsaliye adresi	Entegratörün irsaliye servis adresi; aynı kural.
Kullanıcı adı	Ortamın entegratör kullanıcısı. e-Belge açıkken seçili ortamınki zorunlu; canlı ortamda canlı kullanıcı zorunlu.
Test göndereni VKN	Yalnız Test: "Yalnız Test ortamında faturada/irsaliyede gönderen VKN. Test hesabının VKN'si; canlıda okunmaz, şirket profili değişmez." 10 hane.
Test göndereni unvanı	Yalnız Test: "Boşsa şirket unvanı kullanılır." VKN olmadan girilemez.
Parola	"••••• kayıtlı · tarih · kişi" ya da "Parola kayıtlı değil". Parola gir / Parolayı değiştir alanı açar, Parolayı kaydet kaydeder ve temizler. Formun Kaydet'iyle gitmez. "Parola boş olamaz."
Bağlantı › Bağlantıyı Sına	Kayıtlı kimlikle entegratöre giriş yapar, kalan kontörü ve şirketin GİB kaydını (etiketlerini) sorar; belge üretmez. Kapalıysa sebebi yanında yazar: "Önce değişiklikleri kaydedin — sınama kayıtlı ayarla yapılır.", "Önce kullanıcı adını girip kaydedin.", "Önce parolayı kaydedin.", "Acil durdurma açıkken entegratöre çağrı yapılmaz." Zaman aşımında "EDM … saniye içinde yanıt vermedi."

Canlı ortamda başarılı bir Bağlantıyı Sına, canlıya geçiş kontrol listesinin engelleyici maddesidir.

Etiketler ve Seriler

Alan	Biçim	Açıklama
e-Fatura gönderici etiketi (GB)	`urn:mail:ad@alan` (ör. `urn:mail:defaultgb@…`)	Şirketin GİB'deki fatura gönderici birim etiketi. Canlı ortamda zorunlu.
e-İrsaliye gönderici etiketi (GB)	`urn:mail:…`	İrsaliye gönderici etiketi. Canlıda e-İrsaliye açıkken zorunlu.
Posta kutusu etiketi (PK)	`urn:mail:defaultpk@…`	Gelen belgelerin posta kutusu etiketi.
e-Fatura serisi	3 büyük harf ya da rakam (ör. `KRN`)	Canlıda e-Fatura açıkken zorunlu.
e-Arşiv serisi	3 harf/rakam (ör. `KRA`)	Canlıda e-Arşiv açıkken zorunlu.
e-İrsaliye serisi	3 harf/rakam (ör. `KRI`)	Canlıda e-İrsaliye açıkken zorunlu.
İhracat serisi	3 harf/rakam	İhracat faturalarının serisi. "Seri 3 büyük harf ya da rakam ve entegratör portalında tanımlı olmalı. Fatura numarasını entegratör verir."

Etiket biçimi yanlışsa "… 'urn:mail:ad@alan' biçiminde olmalı.", seri yanlışsa "… 3 büyük harf ya da rakam olmalı (ör. KRN)." Fatura numarası kesinleşmede değil, entegratöre gönderimde verilir.

Belgeler

Şalter	Açıklama
e-Fatura	"Kayıtlı mükellefe giden fatura."
e-Arşiv	"Kayıtlı olmayan alıcıya ve nihai tüketiciye fatura."
e-Arşivi e-postayla ilet	"Entegratör alıcıya e-posta gönderir." (Kurulumun SMTP'sinden bağımsız.) Varsayılan açık.
e-İrsaliye	"Teslimatta giden irsaliye."
Gelen e-Faturaları çek	Gelen kutusundaki faturalar Gelen e-Faturalar'a alınır.
Gelen e-İrsaliyeleri çek	Tedarikçi irsaliyeleri Gelen e-İrsaliyeler'e alınır (gelen teslimatla eşleştirilir).
Gelen kutusu başka yazılımla paylaşılıyor	"Aynı EDM hesabını eski programınız da çekiyorsa açın: CoreX belgeleri EDM'de okundu işaretlemez ve her turda okunmuşlar dâhil sorar — iki program da her belgeyi alır."
Dışarıda kesilen giden belgeleri (e-Fatura, e-Arşiv, e-İrsaliye) arşive çek	"EDM portalında ya da eski programda kesilen faturalar Giden e-Faturalar'da, e-İrsaliyeler Giden e-İrsaliyeler'de salt okunur arşiv olarak görünür; cari hesaba, stoğa ve teslimata işlemez."
Kesinleşince gönder	"Kapalıyken kesinleştirilen fatura ayrı bir "Gönder" onayı bekler (önerilen)."
Varsayılan senaryo	Temel fatura · Ticari fatura — "Kayıtlı alıcıya kesilen e-Faturanın senaryosu." Ticari faturada alıcı kabul/red yanıtı verir.

Zamanlama

Alan	Değer	Açıklama
Yoklama aralığı (dk)	5–1440, varsayılan 15	"Gelen kutusu 5–1440 dakikada bir çekilir."
İlk çekim başlangıcı	Tarih	"Boşsa ilk açık kayıt döneminin başı; hiç dönem kapatılmadıysa yalnız son 7 gün. Daha eski bir tarih seçmek ilk yüklemeyi o tarihten yeniden başlatır." Gelen fatura, gelen e-İrsaliye ve giden arşivin ortak başlangıcıdır.
Kontör uyarı eşiği	0 ya da pozitif tam sayı, varsayılan 500	Kalan kontör bu sayının altındaysa Canlıya Geçiş listesinin Kontör maddesi Uyarı olur.
İstek başlığı › Kanal adı	Metin	Entegratöre giden isteğin kanal adı. "Boşsa şirket unvanı gönderilir."
İstek başlığı › İşlem nedeni	Metin	İsteğin işlem nedeni (varsayılan "CoreX ERP e-belge işlemi").
İstek başlığı › Uygulama adı	Salt okunur	Programın adı ve sürümü (ör. "CoreX ERP 4.3.0").

Sistem ayrıca arka planda GİB kayıtlı kullanıcı listesini (alıcının e-Fatura mükellefi olup olmadığını) 15 dakikalık turlarla günceller ve gönderilen belgelerin durumunu dakikada bir sorar. Bu turlar yalnız e-Belge etkinken çalışır.

Durum

Satır	Açıklama
Durum	"Etkin" / "Kapalı" · seçili ortam.
Bağlantı	"Henüz sınanmadı" · "Bağlantı çalışıyor" · "Kimlik reddedildi — ayar değişene kadar yeniden denenmez" · "Entegratöre ulaşılamadı".
Son sınama	Son Bağlantıyı Sına zamanı ve yapan.
Sınama sonucu	Son sınamanın sonucu.
Son başarılı çağrı	Entegratöre son başarılı çağrının zamanı.
Kalan kontör	Son sorulan kontör ve zamanı.

Canlıya Geçiş

Kontrol listesi her açılışta yeniden denetlenir; Yeniden denetle elle yeniler. Özet "Engelleyici madde yok — canlıya geçilebilir." ya da "N engelleyici madde var — canlıya geçiş kapalı." Madde durumları: Tamam, Uyarı, Engelleyici, Elle teyit.

Grup	Madde	Nasıl ölçülür
Sözleşme ve hesap	EDM özel entegratör sözleşmesi ve mali mühür	Elle teyit
Sözleşme ve hesap	GİB etiket yönlendirmesi	Elle teyit (GB/PK etiketleri EDM'ye yönlendirilmiş; eski entegratör aynı seriyi kullanmıyor)
Sözleşme ve hesap	Canlı kullanıcı ve parola	Engelleyici: "e-Belge Ayarları › Bağlantı › Canlı: kullanıcı adı ve parola girilmeli."
Sözleşme ve hesap	Canlı ortamda bağlantı sınaması	Engelleyici: "Canlı kimlikle "Bağlantıyı Sına" henüz başarılı olmadı (ya da kimlik sonradan değişti)."
Sözleşme ve hesap	Etiket ve seriler	Engelleyici: eksik etiket ve seriler listelenir.
Sözleşme ve hesap	Kontör	Uyarı: kalan kontör eşiğin altındaysa ya da henüz sorulmadıysa.
Veri	Şirket profili	Engelleyici: geçerli VKN, vergi dairesi, il/ilçe.
Veri	Müşteri kartlarının kimliği ve adresi	Uyarı: kimlik türü, VKN/TCKN ya da il/ilçesi eksik aktif müşteri sayısı — "bu kartlara fatura kesinleşmez".
Veri	Birimlerin UN/ECE kodu	Uyarı: UN/ECE kodu olmayan aktif birimler.
Veri	İstisna ve tevkifat kodları	Uyarı: güncel GİB listesi girilmeli; %0 ve tevkifatlı satır kodsuz kesinleşmez.
Veri	GİB kayıtlı kullanıcı önbelleği (canlı)	Uyarı: canlı ortamda ilk turda (15 dk) dolar; o sürede fatura kesinleşmez.
Test kanıtı	Test ortamında teslim edilmiş fatura	Uyarı yoksa.
Test kanıtı	Test ortamında gelen fatura	Uyarı yoksa.
Test kanıtı	Mali müşavir onayı	Elle teyit
Geçiş	e-Fatura başlangıç tarihi	Engelleyici: "Tanımlı değil — dış platformdan CoreX'e hangi günden geçildiği belirsiz kalır."
Geçiş	Dış platformda kesimin durdurulması	Elle teyit (çifte kesim yasağı)
Geçiş	Canlıya alma yetkisi	Etkinleştir yetkili kullanıcı sayısı — "yalnız yetkili kişide olmalı".
Geçiş	Geri dönüş planı	Elle teyit: şalter kapatılır, bekleyen belgeler kuyrukta kalır; acil durdurma bayrağı.

Ortam: Canlı seçilip Kaydet'e basılınca "Canlı ortama geçilsin mi?" penceresi açılır: "Canlı ortamda gönderilen her belge GİB'e gerçek belge olarak gider ve geri alınamaz. Muhasebe programında fatura kesiminin durdurulduğundan ve aynı seri ile etiketin başka bir yerde kullanılmadığından emin olun (çifte fatura yasağı)." Pencere engelleyici maddeleri "Canlıya geçmeden kapatılması gerekenler:" başlığıyla listeler; engelleyici madde varken Canlıya geç ve kaydet kapalıdır.

Giden faturanın yaşam döngüsü

Taslak ──Kesinleştir──► Kesinleşti ──(Kesinleşince gönder açık ya da GİB'e Gönder)──► Gönderim kuyruğunda
                          │ taraf, senaryo, tip ve toplamlar DONAR;                       │ arka plan işçisi
                          │ GİB numarası henüz yok                                        ▼
                          │                                                         Entegratörde (numara verildi)
                          │                                     ┌──────────────────────────┼──────────────────────┐
                          │                                     ▼                          ▼                      ▼
                          │                          Alıcıya ulaştı (son)      Yanıt bekleniyor (ticari)   Gönderilemedi
                          │                          temel fatura, e-Arşiv      ├─► Kabul edildi            (şema/veri hatası)
                          │                                                     └─► Reddedildi
                          └─ e-Arşiv: İptal edildi · numara almış ama düşmüş belge: Geçersiz sayıldı · Doğrulanamadı

Durum	Anlamı
Taslak	Düzenlenebilir; GİB'e hiçbir şey gitmedi.
Kesinleşti	Taraf bilgileri, kanal (e-Fatura / e-Arşiv), senaryo, tip ve toplamlar dondu. GİB numarası henüz yok — entegratör gönderimde verir. Kesinleşen fatura düzenlenemez, silinemez.
Gönderim kuyruğunda	Arka plan işçisi entegratöre iletecek.
Entegratörde	Entegratör aldı ve numara verdi; GİB ya da alıcı sonucu bekleniyor.
Alıcıya ulaştı	Temel fatura ve e-Arşivde son durum.
Yanıt bekleniyor	Ticari fatura: alıcının kabul/red yanıtı bekleniyor (8 gün).
Kabul edildi / Reddedildi	Alıcının yanıtı.
Gönderilemedi	Şema, veri ya da zarflama hatası. GİB numarası almamışsa taslağa geri alınıp düzeltilebilir; almışsa aynı numarayla yeniden gönderilir.
İptal edildi	e-Arşiv iptali.
Geçersiz sayıldı	Numara almış ama entegratörde kesin düşmüş ve yeniden gönderimi sonuç vermemiş belge gerekçeyle kapatılır; kaynak belgeler serbest kalır, yeni fatura kesilir.
Doğrulanamadı	Entegratör "daha önce gönderildi" dedi ama durum sorgusu belgeyi bulamıyor. Gönderildi de gönderilemedi de sayılmaz; kendiliğinden yeniden gönderilmez, durum sınırlı takvimle sorulur.

Gönderilen e-Fatura geri çekilemez: düzeltme iade faturasıyla, e-Arşivde iptalle yapılır. Faturanın oluşturulması için: Fatura oluşturmak.

e-İrsaliye teslimattan doğar (teslimat detayında e-İrsaliye Oluştur) ve Giden e-İrsaliyeler'de izlenir. Gelen faturalar ve irsaliyeler yoklama aralığıyla çekilir: Finans › e-Belge › Gelen e-Faturalar ve Gelen e-İrsaliyeler. Dört belge ailesinin iş sayaçları Finans › e-Belge › e-Belge Kokpiti'nde toplanır.

Önerilen kurulum sırası

Genel: Ortam Test, e-Fatura başlangıcı boş ya da planlanan tarih.
Bağlantı › Test ortamı: kullanıcı adı ve test göndereni VKN; Kaydet; Parola gir › Parolayı kaydet; Bağlantıyı Sına.
Etiketler ve Seriler ve Belgeler: test hesabının etiketleri, seriler, açılacak belge türleri.
e-Belge etkin (Etkinleştir yetkisiyle) › Kaydet; test faturaları ve gelen kutusu denenir.
Canlıya Geçiş listesindeki engelleyici maddeler kapanınca Bağlantı › Canlı ortamı kimliği, sınama, Ortam: Canlı › Kaydet › Canlıya geç ve kaydet.

Adım adım: e-Belgeyi etkinleştirmek.

Kayıt iletileri

İleti	Neden
e-Belgeyi açmak ya da canlı ortama almak ayrı yetki ister (e-Belge Ayarları · Etkinleştir).	Etkinleştir yetkisi yok. Bu değişiklik olmadan öteki alanlar kaydedilebilir.
e-Belgeyi açmadan önce seçili ortamın parolasını kaydedin.	Şalter açılırken parola yok.
e-Belgeyi açmadan önce seçili ortamın kullanıcı adını girin.	Şalter açılırken kullanıcı adı yok.
Canlı ortam için kullanıcı adı zorunlu. · Canlı ortam için e-Fatura gönderici etiketi zorunlu.	Canlıda eksik alan.
Canlıda e-Fatura açıkken e-Fatura serisi zorunlu. (e-Arşiv, e-İrsaliye için aynı)	Açık belge türünün serisi yok.
Gelen kutusu yoklama aralığı 5–1440 dakika olmalı.	Zamanlama alanı sınır dışında.
Ayarlar siz düzenlerken başka biri tarafından değiştirildi. Sayfayı yenileyip yeniden deneyin.	Eşzamanlı kayıt.

Ekranın yedi sekmesi​

Genel​

Bağlantı​

Etiketler ve Seriler​

Belgeler​

Zamanlama​

Durum​

Canlıya Geçiş​

Giden faturanın yaşam döngüsü​

Önerilen kurulum sırası​

Kayıt iletileri​

İlgili​