E-Dönüştür (BirFatura) Entegratörü ile Çalışma

Şirket bazında entegratör seçimi

Sağlayıcı tercihi, e-Dönüşüm bölümündeki Parametreler ekranının düzenleme formunda yer alan Entegratör listesinden yapılır. Burada E-LOGO ve VBT'nin yanında E-Dönüştür de seçilebilir. Seçim yalnızca üzerinde çalıştığınız şirket için geçerlidir; aynı veritabanındaki diğer şirketler kendi sağlayıcılarıyla çalışmaya devam eder. Böylece birden çok şirketi yöneten işletmeler, her şirketi kendi anlaşmalı entegratörüne bağlayabilir ve geçişi tek tek, kontrollü biçimde yapabilir.

Üç anahtarın üretilmesi ve girilmesi

Bağlantı için gereken bilgiler E-Dönüştür panelinden alınır. Panelde uygulama adresi altındaki dış bağlantı bilgileri sayfasına girilir, yeni bilgi oluşturma akışında sırasıyla "Kendim Kullanacağım" ve "EFaturaV2 Belge İşlemleri" seçilir. Bu adımların sonunda üç anahtar üretilir: X-Api-Key, X-Secret-Key ve X-Integration-Key. Üretilen değerler, parametre ekranındaki E-Dönüştür bölümüne ilgili alanlara yazılır ve kaydedilir. Anahtarlar şirketin kimlik bilgisi niteliğindedir; yalnızca yetkili kullanıcıların erişebileceği ekranda tutulur.

Anahtar alanları parola gibi davranır

Kaydedilmiş anahtarlar ekranda açık biçimde gösterilmez. Parametreleri güncellerken anahtar alanlarını boş bırakırsanız daha önce kayıtlı olan değerler olduğu gibi korunur; yani sadece ön ek veya etiket gibi başka bir ayarı değiştirmek için anahtarları yeniden yazmanız gerekmez. Bir anahtarı değiştirmek istediğinizde yeni değeri açıkça girmeniz yeterlidir. Bu davranış, rutin düzenlemelerde çalışan bir bağlantının yanlışlıkla bozulmasını önler.

Test Modu bir gönderim kilididir

E-Dönüştür'ün ayrı bir test sunucusu bulunmaz; test ile canlı ayrımı, girdiğiniz anahtarların hangi hesaba ait olduğuna göre yapılır. Bu nedenle Test Modu açıkken belge oluşturan tüm işlemler güvenlik amacıyla engellenir: fatura ve irsaliye gönderimi, gelen belgelerde kabul ve red, iptal işlemleri çalışmaz. Buna karşılık sorgulama tarafı serbesttir; belge durumu sorgulama, gelen kutusunu çekme, mükellef sorgulama ve kontör sorgulama yapılabilir. Gerçek gönderime başlamak için Test Modu kapatılır.

Kalan kontörü anında görme

Entegratör olarak E-Dönüştür seçildiğinde parametre ekranında Kontör Sorgula seçeneği görünür hale gelir. Bu sorgu, hesabınızda kalan kontör miktarını beklemeden ekrana getirir; böylece yoğun fatura kesim günlerinde kontörün bitip bitmediğini sağlayıcı paneline girmeden öğrenirsiniz. E-LOGO tarafında aynı sorgulama sağlayıcı tarafından desteklenmediği için bu seçenek yalnızca E-Dönüştür kullanıldığında sunulur.

Adım adım

1. 1e-Dönüşüm bölümünde Parametreler ekranını açın ve ilgili şirket için düzenleme formuna geçin.
2. 2Entegratör listesinden E-Dönüştür seçeneğini belirleyin.
3. 3E-Dönüştür panelinde dış bağlantı bilgileri sayfasına girin.
4. 4Yeni bilgi oluşturma akışında "Kendim Kullanacağım" ve ardından "EFaturaV2 Belge İşlemleri" seçimlerini yapın.
5. 5Üretilen X-Api-Key, X-Secret-Key ve X-Integration-Key değerlerini parametre ekranındaki E-Dönüştür alanlarına girip kaydedin.
6. 6Test Modu açıkken durum, gelen kutusu, mükellef ve kontör sorgularıyla kurulumu doğrulayın.
7. 7Gerçek gönderime başlamak için Test Modu'nu kapatın.
8. 8Kontör Sorgula ile hesabınızdaki kalan kontörü kontrol edin.

Ekrandaki alanlar

Entegratör

Şirketin hangi e-belge sağlayıcısıyla çalışacağını belirler; E-Dönüştür seçimi yalnızca o şirketi etkiler.

Test Modu

Açıkken belge oluşturan işlemler engellenir, yalnızca sorgulamalar çalışır; gönderim için kapatılır.

X-Api-Key

E-Dönüştür panelinde üretilen bağlantı anahtarı; boş bırakılırsa kayıtlı değer korunur.

X-Secret-Key

E-Dönüştür panelinden alınan gizli anahtar; boş bırakılırsa mevcut değer değişmez.

X-Integration-Key

E-Dönüştür entegrasyon anahtarı; parametre ekranındaki E-Dönüştür bölümüne girilir.

İpuçları ve dikkat edilecekler

• Test Modu açıkken fatura/irsaliye gönderimi, kabul, red ve iptal işlemleri çalışmaz; yalnızca sorgulamalar serbesttir.
• Anahtar alanını boş bırakırsanız kayıtlı değer korunur; değiştirmek istiyorsanız yeni değeri açıkça yazın.
• Bir şirketin entegratörünü değiştirmek diğer şirketlerin ayarlarını etkilemez.
• Kontör sorgulama yalnızca E-Dönüştür ile kullanılabilir; E-LOGO bu sorguyu desteklemez.
• Sistem yöneticisi acil durumda sunucu ayarıyla tüm GİB gönderimlerini geçici olarak durdurabilir; bu sırada gönderim denemeleri başarısız olur.

İlgili özellikler

• e-Dönüşüm Programı Sağlayıcı (Entegratör) Ayarları

  Ayarlar sayfasındaki E-Devlet Parametreleri kartında entegratörünüzü seçer, test modu, belge serileri ve otomatik gelen belge çekimi tercihlerinizi belirler, bağlantıyı anında doğrularsınız.

• e-Fatura Programı ile e-Arşiv Kesme ve GİB'e Gönderme

  Satış ekranında hazırlanan fatura onaylandığında elektronik belge içeriği hazırlanır ve tek tıkla entegratör üzerinden GİB'e iletilir. Gönderim sonrası durum sorgusu, PDF, karekod ve gönderim kayıtları aynı sayfadan izlenir.

• e-İrsaliye Programı ile Giden İrsaliye Düzenleme

  Sevkiyata çıkan malın irsaliyesini alıcı, taşıma ve stok kalemi bilgileriyle hazırlayıp taslak olarak kaydedin; onayladıktan sonra GİB'e gönderin ve dilerseniz aynı belgeyi satış faturasına aktarın.