VBT e-İrsaliye hesabında kantardan gönderim için üç şey hazır olmalıdır: programın bağlanacağı API kullanıcısı, hesapta tanımlı bir gönderen etiketi ve belgedeki gönderen firmanın hesaptaki firmayla aynı olması. Üçünden biri eksikse sağlayıcı belgeyi kabul etmez ve açık bir hata mesajı döner.
Portal ve API ayrı kapılardır
VBT iki farklı adres sunar. Birincisi insanların tarayıcıdan girdiği portal, ikincisi programların bağlandığı API adresidir. Portalın adresine program isteği gönderildiğinde yanıt gelmez; API ise kendi adresindedir. Test ve canlı ortamların ikisinde de bu ayrım vardır.
Bu yüzden "portala giriyorum, demek ki entegrasyon hazır" düşüncesi sahada ilk yanılgıdır. Portal hesabı, belge göndermek için gereken tanımların var olduğunu göstermez. Kantar tarafında ayarlanan bağlantı bilgisi daima API adresine ve API için tanımlı kullanıcıya bakar. Genel durum için VBT e-İrsaliye ve kantar entegrasyonu yazısına bakabilirsiniz.
API kullanıcısı
Programın bağlanması için hesapta bir API kullanıcısı bulunur. Bağlantı, kullanıcı e-postası ve parolayla oturum açılarak başlar; sağlayıcı bir oturum anahtarı verir ve sonraki isteklerde bu anahtar özel bir başlıkla gönderilir. Anahtar başlığı olmayan istek reddedilir.
Bu kullanıcının bilgileri size sağlayıcı tarafından iletilir. Hesap açıldığı hâlde kullanıcı bilgisiyle oturum açılamıyorsa, çoğunlukla portal kullanıcısıyla API kullanıcısı karıştırılmıştır. Parolayı yazılı belgelere ve yazışmalara koymayın; yalnızca kantar ayarlarında saklanacak bilgi olarak ele alın.
Gönderen etiketi
E-irsaliye göndermek için hesapta bir gönderen etiketi tanımlı olmalıdır. Etiket, belgenin GİB sisteminde hangi posta kutusundan çıkacağını belirler. Alıcı için ayrıca bir posta kutusu etiketi gerekir; alıcı etiketini VBT alıcının kimliğinden kendisi çözer.
| Etiket | Kim belirler | Kantar tarafında |
|---|---|---|
| Gönderen etiketi | Hesapta tanımlıdır | Belgeye gönderen bilgisi olarak girer |
| Alıcı etiketi | Alıcının kimliğine göre çözülür | Alıcı kimliği belgeyle uyumlu verilir |
Önemli ayrıntı: etiketler sağlayıcıdan sağlayıcıya aynı değildir. Bir sağlayıcıdaki etiketi bir diğerine kopyalayarak çalıştırmak mümkün değildir; STEQAR'ın tüm entegratörlerinde etiket ilgili hesabın kendi bilgisinden okunur.
Firma bilgisi eşleşmesi
Belgenin üstündeki gönderen vergi numarası, hesabın kayıtlı firmasıyla aynı olmalıdır. Farklıysa sağlayıcı "belgedeki firma bilgisi sistemdeki firma bilgisiyle uyuşmuyor" yönünde bir hata verir. Kantarın kurulumunda gönderen firma alanları bu yüzden hesaba bakarak, elle ve dikkatle girilir; ünvan ve adres için de aynı titizlik geçerlidir.
Kurulumun genel çerçevesi diğer entegratörlerdeki sıraya benzer; örnek için kantar e-irsaliye entegratörleri yazısındaki karşılaştırma çerçevesine bakabilirsiniz.
Eksik hazırlığın belirtileri
Sağlayıcı, eksik hazırlığı belge kabulü sırasında açık mesajlarla bildirir. Çok karşılaşılan üç belirti şunlardır:
- Gönderen etiketi tanımlı değil. Hesapta gönderim için gereken etiket yoktur; hesabın sağlayıcı tarafından hazırlanması gerekir.
- Alıcı etiketi çözülemedi. Alıcının kimliğine karşılık gelen güncel bir posta kutusu bulunamamıştır; çoğunlukla alıcı kimliği hatalı ya da alıcı kayıtlı değildir.
- Firma bilgisi uyuşmuyor. Belgedeki gönderen firma ile hesaptaki firma farklıdır.
Alıcının kayıtlı olup olmadığına dair yaklaşım VBT alıcı mükellef sorgusu yazısında anlatılıyor. Hesabınız hazırsa ve bağlantı için bizimle görüşmek isterseniz iletişim sayfasından yazabilirsiniz; demo ücretsizdir.
Sık sorulan sorular
VBT portalına girebiliyorum, bu API için yeterli mi?
Hayır. Portal, insanların tarayıcıdan kullandığı ekrandır; program bağlantısı ise ayrı bir adrese yapılır. Portal hesabı çalışsa da API kullanıcısı ve gönderim için gerekli tanımlar ayrıca hazır olmalıdır.
Gönderen etiketini kim tanımlıyor?
Etiket, hesabınızın e-irsaliye gönderici tanımıdır ve sağlayıcı hesabında bulunur. Yazılı dokümantasyonda bunu kullanıcının kendisinin tanımlayacağı bir ekran görmedik; tanımın nasıl yapıldığını VBT destek hattından teyit etmenizi öneririz.
Test ve canlı hesap aynı etiketi kullanır mı?
Hayır. Etiketler hesaba ve ortama özgüdür. Bir ortamdaki etiketi diğerine kopyalamak çalışmaz; her ortamın etiketi kendi kaynağından okunmalıdır.
Firma bilgisi eşleşmesi neden aranıyor?
Belgedeki gönderen vergi numarası, hesabın kayıtlı firmasıyla aynı olmalıdır. Farklıysa sağlayıcı belgeyi kabul etmez. Bu yüzden kantar kurulumunda gönderen firma alanları hesapla birebir uyumlu girilir.
Hazırlık tamamsa kantar VBT ile çalışır mı?
Henüz değil. Bu yazı sağlayıcı hesabının hazırlığını anlatır; STEQAR tarafındaki VBT bağlantısı hazırlık aşamasındadır. Güncel durum için VBT rehber yazısına bakın.
STEQAR, SCP Bilişim ve Otomasyon Sistemleri'nin geliştirdiği kantar programıdır; Türkiye genelinde uzaktan kurulum ve destek verir.