Sipariş satış ekranında onaylanıyor, depoya ise elle yeniden giriliyor. Stok değiştiğinde satış ekibi eski sayıyı görüyor. API entegrasyonuna ihtiyaç tam da böyle bir iş akışında belirginleşir. Geliştirme başlamadan verilecek karar, yalnız iki programın bağlanması değil; hangi bilginin nerede doğru kabul edileceği ve aktarım aksarsa işin nasıl sürdürüleceğidir.
API, uygulamaların belirli kurallarla iletişim kurmasını sağlayan arayüzdür. Açılımı Application Programming Interface’tir. MDN’nin API tanımı, insanın kullandığı ekranla yazılımların kullandığı arayüzü ayırır. Entegrasyon ise o arayüzlerden yararlanarak sipariş gönderme, stok okuma veya durum güncelleme gibi bir işi kurar.
Mevcut program işinizi karşılıyor, yalnız başka bir araçla veri paylaşamıyorsa bütün sistemi değiştirmek gerekmeyebilir. Hazır çözüm, uyarlama ve özel yazılım arasındaki fark, eksik bağlantıyı yeni uygulama ihtiyacından ayırmanıza yardımcı olur. Bağlantı kurulacaksa aşağıdaki beş sorunun cevabını aynı çalışma dosyasında toplayın.
1. Hangi Veri için Hangi Sistem Esas Alınacak?
“Müşteri ve sipariş bilgileri eşitlensin” demek kolaydır. Müşterinin adresi iki tarafta farklıysa hangisinin korunacağını söylemek daha fazla karar gerektirir. Her alanın güncel kaynağını ve değiştirme yetkisini belirleyin. Verinin sahibi derken yalnız teknik sistemi değil, yanlış kaydı düzeltecek işletme sorumlusunu da kastediyoruz.
Varsayımsal bir mobilya satıcısında sipariş ve teslimat adresi satış sisteminden, kullanılabilir stok ise depo yazılımından gelsin. Depo çalışanının adresi kendi ekranında düzeltmesi, satış kaydını otomatik değiştirecek mi? İlk sürümde yalnız satış ekibine bildirim gönderilecekse güncelleme sınırını açıkça yazın. İki yönlü aktarım, iki tarafa da sınırsız düzenleme hakkı vermek zorunda değildir.
Aynı siparişi tanımak için kalıcı bir kayıt eşlemesi gerekir. Müşteri adı veya ekrandaki sıra numarası değişebiliyorsa tek başına güvenilir eşleştirme kabul etmeyin. Teknik ekip hangi kimliği kullanacağını belirlesin; işletme de hangi kaydın hangi gerçek işe karşılık geldiğini doğrulasın. İş akışı henüz belli değilse yazılım ihtiyaçlarını teklif öncesinde netleştirme adımları daha doğru başlangıçtır.
2. Hangi Alanlar, Hangi Yönde Aktarılacak?
Bağlantı listesine yalnız sistem adlarını yazmayın. Her aktarımın başlangıcını, hedefini ve taşıdığı alanları gösterin. “Sipariş” başlığı altında ürün kodu, miktar, teslimat adresi ve sipariş durumu gibi farklı bilgiler bulunur; hepsinin aynı anda veya aynı yönde gitmesi gerekmez.
| Bilgi | Yön | Beklenen Sonuç |
|---|---|---|
| Onaylı sipariş ve ürün satırları | Satış → Depo | Depoda aynı siparişe bağlı tek hazırlık kaydı açılır. |
| Kullanılabilir stok | Depo → Satış | Satış ekranı, depoda belirlenen stok bilgisini gösterir. |
| Sipariş iptali | Satış → Depo | Hazırlığa başlanmadıysa iptal işlenir; başladıysa sorumluya bildirilir. |
| Sevkiyat durumu | Depo → Satış | Satış ekibi ilgili siparişin sevkiyat aşamasını görür. |
Tablo gerçek müşteri kurulumu veya hazır paket değildir. Örnekteki iptal kuralı işletmeyle kararlaştırılmış varsayımdır; kendi sürecinizde farklı olabilir. Dört satır, tüm verilerin iki tarafta sürekli aynı tutulması anlamına gelmez.
Alanların adından çok anlamını karşılaştırın. Bir sistemde “stok” raftaki toplamı, diğerinde satışa ayrılabilir miktarı ifade edebilir. Ürün adetle mi koliyle mi tutuluyor? Boş değer “bilinmiyor” mu, “sil” mi demek? Microsoft’un sistemler arası anlam eşlemesi yaklaşımı, farklı veri modelleri arasında çeviri gerektiğini açıklar. Teknik yöntemi ekibe bırakabilirsiniz; işletme anlamını ekip sizin adınıza tahmin etmemeli.
3. Aktarımı Ne Başlatacak, Ne Kadar Gecikme Kabul Edilecek?
Sipariş kaydı açılınca mı, ödeme doğrulanınca mı, satış sorumlusu onaylayınca mı depoya iletilecek? Olayı kesinleştirmeden “anlık aktarım” istemek, henüz hazırlanmaması gereken siparişi depoya düşürebilir. Önce işin hangi aşamada ilerlemeye hazır olduğunu belirleyin.
Webhook, bir olay gerçekleştiğinde başka sisteme bildirim gönderme yöntemidir. Periyodik sorgulamada ise bağlantı belirli aralıklarla değişiklik arar. Seçim, sağlayıcının sunduğu imkânlara ve işletmenin gecikme ihtiyacına bağlıdır. Stok için kabul edilebilir bekleme ile gün sonu raporu için kabul edilebilir bekleme aynı olmayabilir.
“Anlık” sözcüğünü tek başına teslim ölçütü yapmayın. Hangi koşulda ne kadar gecikme kabul edildiğini, son başarılı aktarımın nereden görüleceğini ve limit aşımında ne olacağını konuşun. Stripe’ın webhook belgelerinde olayların tekrar gelebileceği ve geliş sırasının garanti edilmediği açıklanır. Kullandığınız sağlayıcının teslim kurallarını kendi belgelerinden doğrulayın.
İlk veri aktarımıyla günlük eşitlemeyi ayırın. Bağlantı açılmadan önce oluşmuş siparişler de taşınacak mı? Başlangıç tarihi, açık kayıtlar ve eski hataların kapsamı ayrı belirlenmezse bağlantı çalışsa bile ekip eksik bir listeyle işe başlayabilir.
4. Erişimleri Kim Verecek ve Kim Yönetecek?
API belgesini, kullanılan ürün sürümünü, gerekli aboneliği ve erişimi açacak kişiyi başlangıç dosyasına ekleyin. Gereken işlemin belgede bulunmasıyla mevcut hesabınıza açık olması aynı şey değildir. SaaS sağlayıcısının ve işletmenin görevlerini ayırmak, abonelikle kullanılan araçlarda kiminle hangi konuyu görüşeceğinizi netleştirir.
Entegrasyona yalnız ihtiyaç duyduğu erişimler verilmeli. Sipariş okumak için bütün hesabın yönetim yetkisini paylaşmak uygun bir başlangıç değildir. Stripe’ın kısıtlı anahtar açıklaması, izinlerin işlem kapsamına göre sınırlandırılabildiği somut bir örnek sunar. Kullanacağınız servisteki karşılığını teknik ekiple kontrol edin.
Gizli anahtarları brief’e yazmayın. Paylaşılacak belgede erişim sorumlusu ve güvenli teslim yöntemi bulunsun. Gizli anahtarın kendisi, müşteri kayıtları veya gerçek siparişlerin kişisel bilgileri örnek dosyada yer almasın.
Deneme ortamına kim erişecek, canlı erişime geçişi kim onaylayacak, bağlantıyı yapan kişi ayrılırsa erişim nasıl kaldırılacak? Hesapları tek kişinin hafızasına bırakmayın. Web formu üzerinden bağlantı kurulacaksa beklenen sonucu ve sorumluları web sitesi brief’ine de işleyin; formun görünümüyle CRM’ye kayıt gönderme işi ayrı teslim kalemleridir.
5. Aktarım Aksarsa Kim Fark Edecek, İş Nasıl Tamamlanacak?
Bir sipariş gönderildi, fakat cevap gelmedi. Kayıt hiç oluşmamış olabilir; oluşmuş ama yanıt yolda kaybolmuş da olabilir. Aynı işlemi kontrol etmeden yeniden göndermek, ikinci bir kayıt açabilir. Microsoft’un tekrar deneme açıklaması, geçici hatayla kalıcı hatanın ayrılmasını ve işlemin tekrarının etkisinin değerlendirilmesini önerir.
İşletme tarafında beklenen sonuç anlaşılır olmalı: aynı sipariş depoda iki kez hazırlanmayacak, aktarılmayan kayıt görünür kalacak, sorumlu kişi hatanın hangi siparişe ait olduğunu bulabilecek. Teknik ekip, tekrarları önlemeyi ve hataları görünür tutmayı sağlayıcının desteklediği yöntemlerle tasarlar.
- Eksik alan: Ürün kodu boşsa kayıt nerede bekleyecek, kim tamamlayacak?
- Erişim kesintisi: Yetki kaldırıldığında kim uyarılacak; bekleyen işler nasıl izlenecek?
- Tekrar gelen kayıt: Aynı sipariş yeniden gönderildiğinde ikinci hazırlık işi açılmayacak mı?
- İptal ve düzeltme: İşleme alınmış siparişteki değişiklik otomatik mi uygulanacak, görevliye mi düşecek?
Kabul toplantısında yalnız “bağlantı kuruldu” ekranını görmeyin. Deneme siparişini açın, hedefteki alanları karşılaştırın, hatalı kayıt gönderin ve yeniden işlemeyi izleyin. Beklenen sonucu işletme sorumlusu, teknik davranışı geliştirme ekibi birlikte doğrulasın. Testlerde kullanılacak gecikme ve yük koşullarını da önceden kararlaştırın.
Teslimden sonra dış hizmet değişirse uyarlama, izleme ve destek kimde kalacak? Görevleri geliştirme bedelinden ayrı konuşun. Yazılım tekliflerinde entegrasyonun maliyeti değiştiren tarafları, ilk bağlantıyla devam eden bakımın aynı kapsam olmadığını karşılaştırmanıza yardımcı olur.
Sistemlerinizi Bağlayacak Kapsamı Birlikte Netleştirelim
İlk görüşmeye kullandığınız iki sistemin adını, elle taşıdığınız kaydı ve işin nerede aksadığını getirmeniz yeterli bir başlangıç sağlar. Metazen’de bağlantıyı, veri kaynağı ve hata durumlarıyla birlikte ele alıyoruz. API ve sistem entegrasyonları üzerinde çalışan ekibimizle ihtiyacı değerlendirmek, mevcut araçları koruyarak hangi bağlantıların kurulabileceğini konuşmak için özel yazılım hizmetimizi inceleyebilirsiniz.
