Turkcell e-Şirket (e-Fatura) bağlama

Turkcell e-Şirket, Turkcell'in e-dönüşüm servisidir. Panel e-Fatura ve e-Arşiv belgelerinizi buradan gönderebilir.

Bağlamak için

1. Turkcell e-Şirket panelinize girin: sağ üstteki menüden API Yönetimi > Yeni API Anahtarı deyin, anahtara bir isim verip oluşturun.
2. Entegrasyonlar > Turkcell e-Şirket (e-Fatura) > Bağla deyin ve anahtarı API anahtarı alanına yapıştırın.
3. Test ortamında çalışıyorsanız Test ortamı alanına 1 yazın (anahtarı test panelinden üretmelisiniz).
4. Faturalar > Fatura bilgileri bölümünü doldurun (unvan, VKN, vergi dairesi, adres, seri).

API anahtarı yerine servis kullanıcısı kullanmak isterseniz kullanıcı adı/şifre alanlarını doldurun; panel gerekli jetonu kendisi alır ve süresi dolunca yeniler.

⚠ Turkcell, e-belge ürünlerinde canlı ortamda entegrasyon denemesine izin vermiyor (kesilen belge GİB nezdinde resmîdir). Denemelerinizi test ortamında yapın.

Nasıl çalışır

Belgeyi panel üretir (UBL-TR 1.2) ve Turkcell'e dosya olarak gönderir. Fatura numarasını panel verir (seri + yıl + sıra); bu yüzden Turkcell'in kendi numaralandırması kullanılmaz.

• Alıcının VKN'si girilmişse panel mükellef sorgusu yapar: alıcı e-Fatura mükellefiyse e-Fatura, değilse e-Arşiv kesilir.
• Durum kodları panele Türkçe yansır: Kuyrukta → GİB'e iletildi → Onaylandı.
• e-Arşiv faturalar panelden iptal edilebilir; yalnız "Onaylandı" durumundaki belgeler (GİB'e raporlanmadan önce) iptal edilebilir. e-Fatura iptal edilemez — iade faturası gerekir.

Bilinmesi gerekenler

• Mükellef listesi toplu geliyor. Turkcell tek bir VKN'yi sorgulayan bir uç sunmuyor; panel e-Fatura kullanıcıları listesini günde bir indirip kendi içinde arar. İlk fatura kesiminde bu indirme birkaç dakika sürebilir.
• İstek sınırı var. Küçük kontör paketlerinde durum sorgusu 3 saatte 100 istekle sınırlıdır. Bu yüzden panel durumları kendiliğinden yoklamaz; Durumu güncelle düğmesiyle siz tetiklersiniz.
• Reddedilen belgeyi düzeltmeden tekrar göndermeyin. Turkcell doğrulama hatasında (422) aynı belgenin yeniden gönderilmemesini şart koşuyor; hatayı Faturalar ekranında görebilirsiniz.