Turkcell e-Şirket entegrasyonu:
siparişin faturası kendiliğinden kesilir.

Turkcell e-Şirket entegrasyonu nedir, faturayı hangi şirket düzenler?

Turkcell e-Şirket, e-Fatura, e-Arşiv Fatura, e-İrsaliye, e-Defter, e-SMM, e-MM ve e-Muhasebe ürünlerini tek kullanıcı adıyla sunan bulut tabanlı bir e-dönüşüm platformudur. Belgeyi düzenleme izni olan kuruluş, GİB'in e-Fatura özel entegratörler listesinde ePlatform Bulut Bilişim Anonim Şirketi (Turkcell e-Şirket) olarak geçer; e-Arşiv listesinde de aynı şirket yer alır. Platformun kendi sitesinde ise hizmetin Turkcell Dijital İş Servisleri A.Ş. servisi olduğu belirtilir. Ekim 2026'da GİB'in e-Fatura listesinde 93, e-Arşiv listesinde 90 özel entegratör bulunuyor.

Bağlantı kurulduğunda belgeyi imzalayan, GİB'e raporlayan ve saklayan taraf e-Şirket'tir. Yox İş Ortağım ise siparişi faturaya çevirecek veriyi hazırlar ve e-Şirket'e iletir. Veri eksik ya da hatalı giderse belge de hatalı oluşur; bu yüzden aşağıda e-Şirket'in hangi alanı nasıl beklediğini tek tek ele alıyoruz.

Resmî kayıtlarda Turkcell e-Şirket

Turkcell e-Şirket entegrasyonu ile sipariş panelde nasıl faturaya dönüşür?

Bağlantıdan sonra fatura, sipariş listesindeki aşamalardan biri olur. Entegrasyon sayfamızda listelenen kanallardan resmî API ile gelen siparişler tek listede toplanır ve şu sırayı izler:

1. Sipariş; alıcı adı, adresi, varsa vergi numarası ve ürün satırlarıyla panele düşer.
2. Sipariş, kuralınızda seçtiğiniz aşamaya geldiğinde fatura isteği oluşur; alıcı e-Fatura mükellefiyse e-Fatura, değilse e-Arşiv düzenlenir.
3. Belge UBL-TR biçiminde Turkcell e-Şirket hesabınıza gönderilir ve sizin unvanınız ile VKN/TCKN'nizle oluşur.
4. Kesilen faturanın PDF'i panele gelir; kanal destekliyorsa siparişin geldiği pazaryerine yüklenir.
5. Faturanın e-Şirket tarafındaki durumu (gönderildi, kabul, red) sorgulanır ve siparişin yanında görünür.

Kurulumda verilecek üç karar

Son kurulum adımında faturanın hangi sipariş aşamasında kesileceğini, e-Fatura ile e-Arşiv seçimini ve seri ayarını belirlersiniz. e-Şirket'te varsayılan bir fatura numarası ön eki bulunur; birden çok ön ek kullanacaksanız bunları e-Şirket destek ekibi tanımlar ve gönderimde hangisinin kullanılacağı seçilebilir. Pazaryeri faturalarını ayrı seriyle izlemek istiyorsanız ön eki kurulumdan önce açtırın. Kanalların fatura kabul biçimleri için Trendyol entegrasyonu ve Hepsiburada entegrasyonu sayfalarına bakabilirsiniz.

Bağlantı için gerekenler: servis kullanıcısı, gönderen VKN ve test ortamı

Turkcell e-Şirket'in geliştirici rehberi iki kimlik doğrulama yolu tanımlar: her istekte gönderilen API anahtarı ya da kullanıcı adı ve şifreyle alınan Bearer token. Yox İş Ortağım ikinci yolu kullanır; panele girdiğiniz kullanıcıyla e-Şirket'te oturum açıp token alır. Rehber, token ile çalışacak bağlantılar için ayrı bir servis kullanıcısı açılmasını tarif eder.

Servis kullanıcısı açma adımları

1. e-Şirket portalına girin ve sağ üstteki ayarlar sekmesinden Profilim'i açın.
2. Sol menüden Kullanıcı Yönetimi'ni, ardından Yeni Kullanıcı Ekle'yi seçin.
3. Kullanıcı Tipi alanında Servis Kullanıcısı'nı işaretleyin, şube bilgisini seçin, zorunlu alanları doldurup kaydedin.

Günlük işlerde kullandığınız kişisel hesap yerine ayrı bir servis kullanıcısı açmak, bir çalışanın şifre değişikliğinin fatura akışını durdurmasını önler.

Panelde doldurulan alanlar

• Kullanıcı adı ve şifre: servis kullanıcısına ait bilgiler.
• Gönderen VKN/TCKN: faturayı düzenleyen işletmenin numarası; şahıs işletmesinde TC kimlik numarası.
• Gönderen unvan (isteğe bağlı): faturada görünecek unvan.
• Kurulum/API adresi (isteğe bağlı): boş bırakılırsa varsayılan adres kullanılır.

İlk faturayı test ortamında denemek

Rehbere göre canlı ortamda düzenlenen e-belgeler GİB nezdinde resmî sayıldığından e-belge entegrasyon denemeleri yalnız test ortamında yapılır; sonuçlar ayrı bir test portalında izlenir. Panelde test ortamını işaretleyip ilk faturaları orada deneyebilirsiniz. Bu entegrasyon pilot aşamasında: kurulumu sizinle birlikte yapıyor, ilk faturanızı birlikte doğruluyoruz.

e-Fatura mı e-Arşiv mi: alıcıya göre belge türü ve 2026 yükümlülükleri

509 Sıra No'lu VUK Genel Tebliği'ne göre e-Fatura yalnız e-Fatura uygulamasına kayıtlı iki mükellef arasında düzenlenir; kayıtlı olmayan işletmelere ve tüketicilere e-Arşiv Fatura kesilir. Pazaryeri alıcılarının çoğu bireysel olduğundan Turkcell e-Şirket hesabınızdan çıkan belgelerin büyük kısmı e-Arşiv olur.

Kurumsal alıcı ve posta kutusu (alias) bilgisi

Alıcının kayıtlı kullanıcı olup olmadığı vergi numarasıyla GİB listesinden anlaşılır. e-Şirket API'si bu listeyi, yalnız e-Fatura kullanıcılarının posta kutusu (pk/alias) bilgilerini içeren bir dosya olarak sunar. Birden fazla posta kutusu olan bir firmaya e-Fatura gönderilirken alias belirtilmezse e-Şirket uyarı verir. Vergi numarasını siparişte yazmayan bir şirket ise bireysel alıcı gibi görünür ve faturası e-Arşiv olarak kesilir.

• 535 Sıra No'lu Tebliğ: kendi sitesinden ya da aracı platformlardan satış yapanlardan brüt satış hasılatı 500 Bin TL ve üzeri olanlar e-Fatura ve e-Arşiv'e geçer.
• 509 Sıra No'lu Tebliğ'in güncel hâli: e-Arşiv'e dahil olmayan mükellefler 1 Ocak 2026'dan itibaren faturalarını tutarına bakılmaksızın e-Arşiv olarak düzenler.
• 589 Sıra No'lu Tebliğ: basit usulde vergilendirilenler ve işletme hesabına göre defter tutanlar için bu tarih 1 Ocak 2027'dir; 2026 boyunca vergiler dahil 3 Bin TL'yi aşan faturalar e-Arşiv olarak düzenlenir.
• Vergi Usul Kanunu madde 231: fatura, malın teslimi ya da hizmetin yapıldığı tarihten itibaren azami yedi gün içinde düzenlenir.

Yalnız e-Arşiv kesecek küçük bir işletme için ücretsiz yol olan GİB e-Arşiv Portal bağlantısı da bir seçenektir; hangisinin size uyduğunu mali müşavirinizle değerlendirin.

İnternet satışı e-Arşiv faturasında e-Şirket'in beklediği alanlar

509 Sıra No'lu Tebliğ, internetten yapılan satışın e-Arşiv faturasında web adresini, ödeme şeklini ve tarihini, gönderiyi taşıyanın unvanı ile VKN/TCKN'sini ve gönderim tarihini zorunlu tutar. Turkcell e-Şirket'in e-Arşiv modelinde bu bilgilerin her biri için ayrı alan vardır ve bazı alanlar, GİB'e her gün gönderilen e-Arşiv raporunu doğrudan etkiler.

Fatura durum kodları, iptal ve ret: e-Şirket'te hangi belge nasıl geri alınır?

Turkcell e-Şirket her belgeye sayısal bir durum kodu verir; panelde gördüğünüz gönderildi, kabul ve red bilgisi bu kodlardan okunur. Kodun anlamını bilmek, hatalı belgeyi tekrar kesip mükerrer fatura üretmenin önüne geçer. API dokümanındaki başlıca kodlar:

e-Arşiv faturanın iptali

e-Şirket'in iptal servisi yalnız durumu 60 (Onaylandı) olan e-Arşiv faturaları iptal eder. GİB'in e-Arşiv iptal kılavuzuna göre iptal, faturanın alıcıya iletildiği tarihten itibaren 8 gün içinde yapılmalıdır. Panelden başlattığınız iptal bu iki kurala bağlıdır.

e-Fatura iptali ve alıcının reddi

e-Fatura'da işleyiş farklıdır: e-Şirket dokümanına göre sistem üzerinden e-Fatura iptali yapılamaz. İptal, karşı firmayla GİB'in iptal portalında yürütülür; e-Şirket'e bilgi verdiğinizde belgenin durumu onlar tarafından elle e-Fatura İptal (99) yapılır. Ticari senaryodaki faturayı ise alıcı, GİB kılavuzuna göre 8 gün içinde red yanıtıyla geri çevirebilir.

Kontör ve API istek sınırları: kampanya günlerinde neye dikkat edilir?

Turkcell'in ürün sayfasına göre e-Şirket'te kontör fatura sayısına karşılık gelir: e-Fatura'da gelen ve giden her fatura 1'er kontör, e-Arşiv'de yalnız giden fatura 1 kontör düşer. Alınan kontörler 24 ay geçerlidir; e-dönüşüm paketleri 1.000, 2.500, 5.000 ve 10.000 kontörlük seçeneklerle sunulur, yüksek adetlere özel teklif verilir. Güncel ücreti Turkcell'den alın.

Geliştirici rehberi ayrıca müşteri bazlı istek sınırı uygular. Sınır satın aldığınız kontör miktarına ve sözleşmeye göre belirlenir, aşıldığında istek 429 koduyla reddedilir ve test ortamındaki sınırlar canlıyla aynıdır. e-Fatura ve e-Arşiv için ilk dört kademe şöyledir:

• Küçük kontör kademesinde üç saatte 100 durum sorgusu kampanya gününde çabuk dolar; faturayı gün sonunda topluca değil, sipariş faturalanacak aşamaya geldikçe kesmek istekleri güne yayar.
• Rehber de belgelerin asenkron gönderilmesini ve zamanlanmış işlerin 24 saate dağıtılmasını önerir.
• Kampanyadan önce kontör bakiyenize bakın; Turkcell, kontör aşımında kontör başına aşım ücreti uygular.
• Aynı faturanın PDF'ini tekrar tekrar istemek yerine bir kez alıp saklamak dakikalık PDF sınırını korur.

Turkcell e-Şirket entegrasyonu hangi Yox İş Ortağım paketinde yer alır?

Muhasebe ve e-Fatura bağlantıları Yox İş Ortağım'da Profesyonel paketten itibaren açılır ve Turkcell e-Şirket bir program olarak sayılır. Başlangıç ve Büyüme paketlerinde fatura, e-Şirket portalından elle kesilip kanala yüklenmeye devam eder. Panelde 80 satış kanalı (48'i hazır), 57 kargo ve lojistik firması ile 51 muhasebe, e-Fatura ve ERP programı tanımlıdır.

Yıllık ödemede %20 indirim uygulanır; bütün limitleri paket karşılaştırmasında görebilirsiniz. Profesyonel pakette ürün ve kanal bazında kâr ile kesinti raporları da açılır. Toplam maliyetin iki ayrı kalem olduğunu unutmayın: Turkcell'in kontör ücreti ve Yox İş Ortağım paket ücreti; biri diğerinin yerine geçmez.

Turkcell e-Şirket bağlantısından önce kontrol listesi ve sık hatalar

Kurulumda zamanın çoğu bağlantının kendisinde değil, e-Şirket hesabındaki eksik ayarlarda geçer. Turkcell'e göre elektronik fatura için GİB başvurusu ve mali mühür şartı aranır; e-Şirket ürün başvurusu da portaldaki Başvuru İşlemleri ekranında mali mühür sertifikası ve PIN ile tamamlanır, onaylanan ürün Uygulamalarım altında görünür.

Hazırlık listesi

• e-Fatura ve e-Arşiv ürünleri Uygulamalarım altında aktif mi?
• Servis kullanıcısı açıldı mı, kullanıcı adı ve şifre elinizde mi?
• Gönderen VKN/TCKN, e-Şirket hesabındaki numarayla aynı mı?
• Ön ek ve fatura görünümü hazır mı? Logo, imza ve banka bilgisi Ayarlar > XSLT Ayarları ekranından eklenir.
• Ürünlerdeki KDV oranları doğru mu? Bir siparişin satırlarını KDV hesaplama aracıyla kontrol edebilirsiniz.
• Kontör bakiyesi kampanya dönemindeki sipariş hacmine yetiyor mu?

En sık yapılan hatalar

• Doğrudan canlıda denemek: deneme faturası resmî belge olur ve iptal işi doğar.
• Kişisel kullanıcıyla bağlanmak: o kullanıcının şifresi değiştiğinde fatura akışı durur.
• Taşıyıcı adını tek harf girmek: GİB'e giden günlük e-Arşiv raporu hata verir.
• Aynı kanalı iki yerden faturalamak: e-Şirket portalında ya da başka bir yazılımda aynı kanal için otomatik fatura açıksa siparişe iki belge kesilir.

Hazırsanız Yox İş Ortağım'a başvurun; 3 günlük ücretsiz denemede e-Şirket bilgilerinizi Muhasebe bölümüne girip bağlantıyı test ortamında deneyebilirsiniz. Önce konuşmak isterseniz iletişim sayfasından ön görüşme isteyin; kurulumu birlikte yapar, ilk faturayı birlikte doğrularız.