# e-Belge ayarları (EDM entegratör)

> e-Fatura, e-Arşiv ve e-İrsaliye entegratör bağlantısı — ortam, kimlik, GİB etiketleri, seriler, belge şalterleri, zamanlama, durum, canlıya geçiş kontrol listesi ve giden/gelen belgenin yaşam döngüsü.

URL: https://erpdocs.corexlogic.com/ayarlar/e-belge

- **Tü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

![e-Belge Ayarları — Genel](https://erpdocs.corexlogic.com/img/screens/ayarlar/e-belge-genel.png)
1. Yedi sekme
2. Ana şalter — açmak Etkinleştir yetkisi ister
3. Ortam — Test / Canlı
4. Entegratör
5. e-Fatura başlangıcı

| 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.

![e-Belge Ayarları — Bağlantı](https://erpdocs.corexlogic.com/img/screens/ayarlar/e-belge-baglanti.png)
1. Ortam başına ayrı kimlik
2. Servis adresleri (https)
3. Kullanıcı adı
4. Yalnız Test: gönderen VKN
5. Parola ayrı kaydedilir, değeri gösterilmez

| 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

![e-Belge Ayarları — Etiketler ve Seriler](https://erpdocs.corexlogic.com/img/screens/ayarlar/e-belge-etiketler.png)
1. GİB gönderici etiketleri (GB)
2. Posta kutusu etiketi (PK)
3. Seriler — 3 harf/rakam

| 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

![e-Belge Ayarları — Belgeler](https://erpdocs.corexlogic.com/img/screens/ayarlar/e-belge-belgeler.png)
1. Belge türü şalterleri
2. Gelen kutusu çekimi
3. Kesinleşince gönder
4. Varsayılan senaryo — Temel / Ticari

| Ş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

![e-Belge Ayarları — Zamanlama](https://erpdocs.corexlogic.com/img/screens/ayarlar/e-belge-zamanlama.png)
1. Gelen kutusu yoklama aralığı
2. İlk çekim başlangıcı
3. Kontör uyarı eşiği
4. İstek başlığı

| 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

![e-Belge Ayarları — Durum](https://erpdocs.corexlogic.com/img/screens/ayarlar/e-belge-durum.png)
1. Bağlantı durumu
2. Kalan kontör

| 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**.

![e-Belge Ayarları — Canlıya Geçiş kontrol listesi](https://erpdocs.corexlogic.com/img/screens/ayarlar/e-belge-canliya-gecis.png)
1. Engelleyici madde varken canlıya geçilmez
2. Yeniden denetle

| 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](https://erpdocs.corexlogic.com/satis/islemler/fatura-olusturma).

**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ı

1. **Genel**: Ortam **Test**, e-Fatura başlangıcı boş ya da planlanan tarih.
2. **Bağlantı › Test ortamı**: kullanıcı adı ve test göndereni VKN; **Kaydet**; **Parola gir** › **Parolayı kaydet**;
   **Bağlantıyı Sına**.
3. **Etiketler ve Seriler** ve **Belgeler**: test hesabının etiketleri, seriler, açılacak belge türleri.
4. **e-Belge etkin** (Etkinleştir yetkisiyle) › **Kaydet**; test faturaları ve gelen kutusu denenir.
5. **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](https://erpdocs.corexlogic.com/ayarlar/islemler/e-belgeyi-etkinlestirme).

## 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. |

## İlgili

- [e-Belgeyi etkinleştirmek](https://erpdocs.corexlogic.com/ayarlar/islemler/e-belgeyi-etkinlestirme)
- [Faturalama](https://erpdocs.corexlogic.com/satis/ekranlar/faturalama)
- [Fatura oluşturmak](https://erpdocs.corexlogic.com/satis/islemler/fatura-olusturma)