Kısa cevap

KolayBi'ye gönderim iki aşamalıdır. Birinci aşamada belge ticari kayıt olarak açılır ve bir belge kimliği döner; ikinci aşamada bu kimlikle GİB'e çıkış istenir. İkinci aşama olmazsa belge KolayBi'de kayıtlı kalır, belge kimliği sonuçta döner ve operatör uyarılır. Sürücü ikinci çağrıyı tekrar etmez.

Neden iki aşama?

KolayBi'de belge önce ticari kayıt olarak açılır, sonra e-İrsaliye olarak GİB'e çıkarılır. Kantar bu ayrımı olduğu gibi izler: iki ayrı istek gönderir ve her birinin sonucunu ayrı değerlendirir. Gönderime kadar olan hazırlık adımları, yani numara kararı, ayarlar, oturum, eşleştirme ve alan eşleme, hiçbir kayıt açmadan biter. Önizleme ticari kayıttan çok önce durur; ağa çıkmaz ve belge göndermez. İki isteğin sonucu ayrı değerlendirildiği için ilk isteğin başarılı olması ikincisinin de başarılı olacağı anlamına gelmez; aşağıdaki sonuç tablosunun dört satırlı olmasının nedeni budur. Sıranın tamamı ana rehberde.

İstek açılmadan önce neler denetlenir?

Yazma çağrısından önce iki grup denetim vardır. Birincisi eşleştirmedir: alıcı, taşıyıcı ve ürünlerin KolayBi kimlikleri eksiksiz çözülmelidir; her satır için bir ürün kimliği ve bir KDV oranı bulunmalıdır. İkincisi alan biçimidir: tarih, saat ve miktar KolayBi'nin beklediği biçime çevrilemezse ya da irsaliyede hiç satır yoksa istek hazırlanamaz ve işlem durur. Bu denetimlerin hiçbirinde KolayBi'ye yazma yapılmaz. Dolayısıyla yarım gönderim ya da belirsiz kayıt gibi durumlar ancak denetimler geçildikten sonra, yani gerçek bir yazma çağrısıyla doğar.

Birinci aşama: ticari kayıt

Birinci istekte eşleştirilmiş kimlikler, tarih bilgileri, para birimi ve satırlar gider. KolayBi belgeyi kaydeder ve yanıtında bir belge kimliği verir. Üç sonuç ayrılır. Belge kimliği dönerse ikinci aşamaya geçilir. Kimlik dönmezse kayıt oluşmamış sayılır ve gönderim reddedilmiş olarak bildirilir; ikinci aşama çağrılmaz. İstek hiç yanıtlanmazsa kaydın açılıp açılmadığı bilinemez; bu ayrı bir durumdur ve kayıt belirsiz kalırsa yazısında işleniyor.

İkinci aşama: GİB'e çıkış

İkinci istek belge kimliğini taşır. Belge numarası ön eki ayarlanmışsa o da bu istekte gider; ayar boşsa istekte ön ek bulunmaz ve KolayBi şirket varsayılanını kullanır. KolayBi yanıtında GİB belge kimliğini, yani ETTN'i döndürür; yanıtta atanan belge numarası varsa kayda o yazılır. İki aşama da kabul edilirse sonuç, KolayBi'ye iletildi (işleniyor) iletisiyle kaydedilir.

İkinci aşama olmazsa: yarım gönderim

İkinci istek hata verirse ya da yanıtta GİB belge kimliği yoksa belge KolayBi'de ticari kayıt olarak kalır ama GİB'e çıkmamıştır. Kantar bu durumu başarı saymaz. Sonuçta belge kimliği bulunur ve operatöre şu anlamda bir uyarı gösterilir: irsaliye KolayBi'ye kaydedildi ama GİB'e gönderilemedi, belge KolayBi'de duruyor. Sürücü ikinci isteği tekrarlamaz; GİB'e gönderilemediği uyarıda açıkça yazılır.

Yeniden göndermeden önce

Birinci aşama KolayBi'ye bir tekillik anahtarı göndermez. Aynı gönderimi yeniden yapmak, KolayBi'de ikinci bir ticari kayıt isteği anlamına gelir. Yarım kalan belgenin KolayBi'deki durumuna bakmadan yeniden göndermeyin.

İkinci aşama neden tamamlanmamış sayılır?

İkinci aşama iki durumda tamamlanmamış sayılır ve ikisinde de sonuç yarım gönderimdir:

  • GİB'e çıkış isteği hata verir.
  • İstek kabul edilir ama yanıtta GİB belge kimliği yoktur.

İkisinde de ortak olan şudur: ticari kayıt zaten açılmıştır. Bu yüzden ikinci aşamanın başarısızlığı belgenin kaybolduğu anlamına gelmez; belge KolayBi'de durur ve operatörün elinde belge kimliği vardır.

Yarım gönderimde sıra

  1. Uyarıdaki belge kimliğini not edin; belge KolayBi'de bu kayıtla durur.
  2. KolayBi'de belgenin durumuna bakın.
  3. Aynı gönderimi yeniden yapmadan önce mevcut kaydı kontrol edin; birinci aşama tekillik anahtarı taşımadığı için yeniden gönderim ikinci bir ticari kayıt isteğidir.
  4. Sonucu başarı saymayın: ETTN dönmediği sürece belge GİB'e çıkmış sayılmaz.

Belge kimliği ne işe yarar?

Belge kimliği, KolayBi'nin birinci aşamada verdiği kayıt anahtarıdır ve ikinci aşama bu anahtarla çağrılır. Yarım gönderimde de aynı kimlik sonuçta saklanır; böylece belgenin KolayBi'de hangi kayıtla eşleştiği bellidir. ETTN ise ikinci aşamanın ürünüdür: GİB'e çıkış istendikten sonra döner. Kimlik boş dönerse ikinci aşamaya hiç geçilmez. Kısacası iki kimlik iki aşamayı birbirine bağlar: belge kimliği ticari kaydın, ETTN GİB belgesinin kimliğidir.

Sonuç iletileri bir bakışta

AşamaSonuçKolayBi'de ne var?
BirinciReddedildiKayıt oluşmadı.
BirinciYanıt alınamadıKaydın açılıp açılmadığı bilinmiyor.
İkinciHata ya da ETTN yokTicari kayıt var, GİB'e çıkış yok; uyarı verilir.
İkinciİletildi (işleniyor)Ticari kayıt var, GİB'e çıkış istendi ve ETTN döndü.

Kabul, teslim değildir

Başarılı bir yanıt, belgenin GİB'de geçerli olduğunu kanıtlamaz. İletildi iletisi yalnızca iki isteğin de kabul edildiğini ve bir ETTN döndüğünü söyler. Bu aşamadan sonra belgenin gerçek durumu KolayBi'de değişir ve durum sorgusuyla izlenir. KolayBi'deki ticari kaydın kantar tarafındaki cari ve ürün eşleştirmesiyle ilişkisi için Kantar muhasebe entegrasyonu yazısı, kantardan e-İrsaliye kesim akışının genel çerçevesi için Kantardan otomatik e-İrsaliye nasıl kesilir? yazısı var.

Ticari kayıt açıldı demek GİB'e çıktı demek değildir; iki aşamayı ayrı okuyun.

Sık sorulan sorular

Yarım gönderim ne demek?

Belgenin KolayBi'ye ticari kayıt olarak kaydedildiği ama GİB'e çıkış aşamasının tamamlanmadığı durumdur. Kantar bunu başarı saymaz, belge kimliğini sonuçta tutar ve operatörü uyarır.

Yarım kalan belge nerede duruyor?

KolayBi'de, ticari kayıt olarak. Uyarı iletisi belgenin KolayBi'de durduğunu söyler ve sonuçta belge kimliği bulunur; KolayBi'deki kaydı kontrol ederken bu kimlik elinizdedir.

Yarım gönderimde ne yapmalıyım?

Önce belgenin KolayBi'deki durumuna bakın. Birinci aşama tekillik anahtarı taşımadığı için aynı gönderimi yeniden yapmak KolayBi'de ikinci bir ticari kayıt isteği olur; yeniden göndermeden önce mevcut kaydı kontrol edin.

İletildi yazıyorsa belge tamamlanmış mıdır?

Hayır. İletildi, iki aşamanın da kabul edildiğini ve GİB belge kimliğinin döndüğünü söyler. Belgenin sonraki durumu durum sorgusuyla izlenir.

Şeffaflık notu

STEQAR, KolayBi'nin yanı sıra başka e-İrsaliye entegratörleriyle de çalışır; EDM Bilişim, Turkcell e-Şirket, Orkestra e-Faturacım, Veriban, e-Logo, QNB eSolutions, eKüpSoft, Digital Planet, Nilvera ve VBT bu seçenekler arasındadır. Farkları Kantar e-İrsaliye entegratörleri yazımızda karşılaştırdık.

Kendi tartımınızda görün

Tartımdan e-İrsaliyeye otomatik akışı gösterelim.

Kantarınızda bir tartım yapalım, belgenin entegratöre gidişini birlikte izleyelim. İnterneti kapatıp kuyruğu da deneriz.