Rehber
API Entegrasyonu Nedir? E-Fatura, Kargo, Ödeme, SMS ve Muhasebe Programı Bağlantıları
API, yazılımların birbirine veri gönderdiği kapıdır. E-fatura, kargo, ödeme, SMS ve muhasebe bağlantıları, başlamadan önce sorulacaklar, bağlantı koptuğunda olması gerekenler ve API yoksa ara yollar.
· 4 dk okuma · Mood Reklam
Bir sipariş geliyor; faturası ayrı bir programda kesiliyor, kargo kaydı kargo firmasının sitesine elle giriliyor, takip numarası müşteriye mesajla yazılıyor, ay sonunda hepsi muhasebeciye bir tabloyla gönderiliyor. Bu düzende her adım tek başına çalışır; sorun, adımlar arasında bir insanın veri taşımasıdır. Taşıyan kişi yorulur, bir rakamı yanlış yazar, bir gönderiyi atlar. API entegrasyonu bu taşıma işini yazılıma devretmenin adıdır.
API nedir, bir benzetmeyle
API (uygulama programlama arayüzü), bir yazılımın başka yazılımlara açtığı resmî kapıdır. Bir lokantadaki garson gibi düşünün: mutfağa girmezsiniz, siparişinizi garsona belirli bir biçimde söylersiniz, o da yanıtı getirir. Kargo firmasının API’sine “şu adrese, şu ağırlıkta bir gönderi oluştur” dersiniz; yanıt olarak takip numarası ve barkod gelir. Entegrasyon, sizin yazılımınızın bu kapılarla düzenli ve güvenli biçimde konuşacak şekilde kurulmasıdır.
Konuşma iki yönlü olabilir. Bazen sizin yazılımınız sorar: “Bu gönderi nerede?” Bazen de karşı taraf, bir şey olduğunda size kendiliğinden haber verir: ödeme onaylandı, gönderi teslim edildi. Bu ikinci yönteme webhook denir ve durumu sürekli sormaktan daha verimlidir. Hangi servisin hangi yöntemi desteklediği, entegrasyonun nasıl kurulacağını belirler.
En sık istenen beş bağlantı
E-fatura ve e-arşiv
E-fatura genellikle bir entegratör firmanın ya da kullandığınız fatura programının sunduğu servis üzerinden düzenlenir. İşletme yazılımı faturanın bilgilerini hazırlayıp bu servise gönderir, belgenin numarası ve durumu geri döner. Hangi belge türünü düzenlemeniz gerektiği ve hangi bilgilerin zorunlu olduğu bir mevzuat konusudur; bunu mali müşavirinizle teyit edin, yazılım bu kararı uygular.
Kargo
Kargo firmalarının çoğu gönderi oluşturma, barkod alma ve takip sorgulama için servis sunar. İskenderun’dan yurt içine ürün gönderen bir üretici ya da internetten satış yapan bir mağaza için bu bağlantı, her gönderide yapılan elle girişi ortadan kaldırır ve takip numarasını müşteriye kendiliğinden iletir.
Ödeme
İnternetten kartla ödeme, bir ödeme kuruluşunun ya da bankanın sanal POS servisiyle alınır. Doğru kurulumda kart bilgisi sizin sisteminizden hiç geçmez; müşteri ödeme kuruluşunun güvenli sayfasında ya da formunda ödemesini yapar, sizin yazılımınıza yalnızca “ödendi” ya da “başarısız” bilgisi döner. Kart bilgisini kendi veritabanında saklayan bir yazılım istemeyin.
SMS ve bildirim
Randevu hatırlatması, sipariş durumu ya da doğrulama kodu bir SMS sağlayıcısının API’siyle gönderilir. Bilgilendirme mesajı ile kampanya mesajı aynı şey değildir; ticari ileti göndermeden önce alıcı onayına ilişkin yükümlülükleri ilgili düzenlemeden teyit edin.
Muhasebe programı
En değişken bağlantı budur. Bazı muhasebe ve ön muhasebe programları API sunar, bazıları yalnızca belirli biçimde hazırlanmış dosyaları içe alır, bazıları ise dışarıya hiç kapı açmaz. Kullandığınız programın bu üç gruptan hangisinde olduğu, entegrasyonun mümkün olup olmadığını belirler; bunu programın sağlayıcısına sormak, işe başlamadan yapılacak ilk iştir.
Bağlantıdan önce sorulacaklar
- Servis bir API sunuyor mu, belgeleri açık ve güncel mi?
- Gerçek işlem yapmadan denemeye yarayan bir test ortamı var mı?
- Hesap kimin adına açılacak? Erişim anahtarları işletmenin kendi hesabından mı alınacak?
- Servisin kendi kullanım koşulları ve ücretlendirmesi nasıl? Bu bedel yazılım işinden ayrı mı ödenecek?
- Servis yarın değişirse ya da kapanırsa başka bir sağlayıcıya geçmek ne kadar zor olur?
Bağlantı koptuğunda ne olur?
Dış servisler zaman zaman yavaşlar, bakıma girer ya da hata döndürür. İyi kurulmuş bir entegrasyon bu durumda işi durdurmaz: gönderilemeyen kayıt bir kuyrukta bekler, belirli aralıklarla yeniden denenir ve ısrarla başarısız olursa sorumlu kişiye haber verilir. Aynı faturanın iki kez kesilmemesi, aynı gönderinin iki kez oluşturulmaması için her işlemin kendine özgü bir numarayla izlenmesi gerekir. Servisler sürümlerini değiştirdiğinde entegrasyonun da güncellenmesi bakımın parçasıdır; bunu yazılım bakımı ve güncelleme yazısında anlattık.
Kapı yoksa ne yapılır?
Her programın API’si yoktur. Bu durumda ara çözümler devreye girer: programın içe aldığı biçimde dosya hazırlamak, belirli saatlerde dışa aktarılan dosyayı okumak ya da ilgili adımı yarı otomatik bırakmak. Bunlar tam entegrasyon kadar akıcı değildir ama elle yapılan girişi azaltır. Hazır bir programla işletmeye özel bir yazılım arasında seçim yapıyorsanız hangi bağlantıların hazır olduğu da bir ölçüttür; ayrıntısı hazır program mı, özel yazılım mı yazısında.
Kapsamda nasıl yer almalı?
Yeni bir yazılım ya da site yaptırırken bağlanması gereken her servisi kapsamda ayrı bir madde olarak yazın: hangi servis, verinin hangi yönde akacağı, ne sıklıkla, hata olursa kime bildirileceği. İskenderun’da sipariş, sevkiyat ve faturayı tek akışta toplamak isteyen bir işletmeyseniz işletmeye özel yazılım sayfasına, sitenizdeki formdan gelen talebin doğrudan programa düşmesini istiyorsanız web tasarım sayfasına bakın. Kullandığınız programların listesiyle arayın; bağlantıların mümkün olup olmadığı ilk görüşmede konuşulur.
