Sneaksnet · Akticaret
Sneaksnet · Akticaret, özel e-ticaret sistemini ve XML bayilik sistemini ERP Asistanı üzerinde çalıştırıyor.
- Özel e-ticaret sistemi
- XML bayilik sistemi
ERP API geliştirme
ERP API Geliştirme: ERP Verinizi Diğer Yazılımlara Güvenli Bir API ile Açın
ERP API, ERP’nizdeki stok, fiyat, cari ve sipariş bilgisinin mobil uygulama, web sitesi ya da iş ortaklarınızın yazılımı tarafından güvenli biçimde okunmasını ve gerektiğinde ERP’nize kayıt yazılmasını sağlayan arayüzdür. ERP Asistanı’nın Uygulama Yap menüsünde hangi bilginin kime açılacağını yazılı olarak iletirsiniz; ajan API uçlarını ERP’nize bağlı olarak kurar, önce demo ortamında denersiniz.
Uygulama YapERP’nize bağlı
Örnek görünüm · örnek veri
Tanım
ERP API nedir, neden gerekir?
Bir şirketin ERP’si tek başına çalışmaz. Kurumsal web sitesi güncel stoğu göstermek ister, saha ekibinin mobil uygulaması cari bakiyesine bakmak ister, bayinin kendi yazılımı fiyat listesini çekmek ister, bir iş ortağı ürün kataloğunu düzenli olarak almak ister. Bu yazılımların her biri ERP’nize aynı soruyu sorar: “Bu bilgiyi bana güvenli bir yoldan verebilir misin?” Bu yolun adı API’dir.
Bugün bu ihtiyaç genellikle iki yoldan karşılanır. Ya ERP veritabanına dışarıdan doğrudan bağlantı açılır, ki bu güvenlik açısından en riskli yoldur. Ya da her entegrasyon için ayrı bir yazılım projesi başlatılır; her yeni ihtiyaç yeni bir teklif ve yeni bir bekleme demektir.
Uygulama Yap ile API geliştirme üçüncü bir yol sunar. ERP’nizi ERP Asistanı Köprü ile bağlarsınız; Köprü sunucunuzdan yalnız dışarıya bağlanır, güvenlik duvarında port açmazsınız. Ardından ajana hangi bilginin, kime, hangi koşulla açılacağını yazılı olarak iletirsiniz: “Bayi yazılımları stok kodu verince depo miktarını ve bayinin fiyatını alsın, başka bir şey görmesin.” Ajan API uçlarını kurar, erişim anahtarıyla korur ve uçları demo ortamında kendisi de dener. Siz inceleyip onayladığınızda API kendi adresinde yayına çıkar.
Ortaya çıkan, yalnız ERP’nize bağlı bir REST API değildir; kendi veritabanı, kendi yönetim paneli ve kendi kayıtları olan bir uygulamadır. Bu sayede ERP’de karşılığı olmayan bilgileri de (bayiye özel kampanya, ürün açıklaması, görsel bağlantısı) API’ye ekleyebilirsiniz.
Bugün ve yarın
ERP verisini başka yazılımlara açarken bugün ne oluyor?
-
Bugünİş ortağının yazılımı için ERP veritabanına dışarıdan bağlantı açılıyor; kimin neyi okuduğu bilinmiyor.
Uygulama Yap ileDışarıya yalnız tanımladığınız uçlar açılır; Köprü sunucunuzdan dışarıya bağlanır, ERP veritabanınıza dışarıdan kapı açılmaz.
-
BugünHer yeni entegrasyon ihtiyacı ayrı bir yazılım projesine ve ayrı bir teklife dönüşüyor.
Uygulama Yap ileYeni uç ihtiyacınızı ajana yazılı olarak iletirsiniz; uç önce demo ortamında kurulur ve denenir.
-
BugünExcel ya da e-postayla gönderilen ürün listeleri gönderildiği anda eskiyor.
Uygulama Yap ileİş ortaklarınız güncel stok ve fiyatı API’den alır; liste hazırlayıp göndermeniz gerekmez.
-
BugünBir uç değiştiğinde onu kullanan yazılımlar haber almadan bozuluyor.
Uygulama Yap ileDeğişiklik önce demo ortamında denenir, “Yayını güncelle” ile yayına alınır; ajandan uçların güncel belgesini istersiniz.
Nasıl çalışır
ERP’nize bağlı API dört adımda
ERP’nizin kendi API lisansına, ayrı bir sunucuya ya da entegrasyon projesine ihtiyaç duymadan kurarsınız.
-
ERP’nizi bağlayın
Entegrasyonlarım menüsünden ERP’nizi ekleyin. ERP Asistanı Köprü yalnız dışarıya bağlanır; port açmanız gerekmez. Adım adım: Köprü nasıl kurulur?
-
Hangi bilginin açılacağını yazın
Uygulama Yap’ta bir uygulama açın; API’yi kimin kullanacağını, hangi bilgiyi göreceğini, ERP’ye kayıt yazıp yazmayacağını yazılı olarak iletin.
-
Demo ortamında deneyin
Ajan uçları kurar ve demo ortamında çalıştırarak dener. Siz de örnek bir istekle sonucu inceler, eksik gördüğünüz alanı yine yazarak eklersiniz.
-
Yayına alın ve anahtarı paylaşın
“Yayına al” ile API kendi adresinde, isterseniz kendi alan adınızda otomatik HTTPS ile açılır. Erişim anahtarını yalnız yetki verdiğiniz yazılımla paylaşırsınız.
Örnek uçlar
ERP API ile hangi bilgiler paylaşılır?
API’de hangi bilginin yer alacağına siz karar verirsiniz. En sık kurulan uçlar aşağıdadır; her biri ERP’nizden okunur ve yalnız yetki verilen yazılıma açılır.
Yazma gerektiren işlerde (dışarıdan gelen siparişin ERP’ye aktarılması gibi) kaydın hangi koşulla ve kimin onayıyla yazılacağını da ajana iletirsiniz. Çoğu senaryoda dışarıdan gelen kaydın önce uygulamada bir onay adımından geçmesi doğru olandır.
Örnek API uçlarıERP’nize bağlı
- Stok
- Stok kodu, ad, birim, depo bazında miktar
- Fiyat
- Fiyat listesi, bayiye ya da cari grubuna özel fiyat
- Katalog
- Ürün grubu, açıklama, görsel bağlantısı, barkod
- Cari
- Bakiye, vade, risk limiti; yalnız ilgili carinin kendi bilgisi
- Sipariş
- Sipariş alma, sipariş durumu, sevk ve kargo bilgisi
- Belge
- Fatura ve irsaliye listesi, belge ayrıntısı
Uç adları ve alanlar örnektir; API sizin ihtiyacınıza göre kurulur.
Kullanım alanları
ERP API’yi kimler ve nerede kullanır?
Mobil uygulamalar. Saha satış, servis ya da müşteri uygulamanız ERP’deki bilgiyi API üzerinden alır. Mobil uygulamayı başka bir ekip geliştiriyorsa bile ERP tarafındaki tüm iş tek bir API’de toplanır.
Kurumsal web sitesi. Ürün sayfalarınızda güncel stok durumu, fiyat ya da teslim süresi gösterilir; web sitenizi yöneten ajans ERP’nize erişmeden yalnız API’yi kullanır.
Bayilerin ve iş ortaklarının yazılımları. Bayileriniz kendi sistemlerine sizin ürün kataloğunuzu, stoğunuzu ve kendi fiyatlarını düzenli olarak alır. XML ya da JSON ürün akışı isteyen iş ortaklarına aynı bilgiyi istedikleri biçimde verirsiniz.
Pazaryerleri ve satış kanalları. Ürün, stok ve fiyat bilgisini satış kanallarının beklediği yapıya çeviren bir ara katman kurar, kanaldan gelen siparişi ERP’nize aktarılacak hâle getirirsiniz.
Raporlama ve iş zekâsı araçları. Pano ve raporlama araçlarınız ERP veritabanına doğrudan bağlanmak yerine yalnız gerekli bilgiyi veren uçları kullanır.
Şirket içi yazılımlar. Üretim, depo ya da muhasebe tarafında kullandığınız başka bir yazılım ERP’deki kartlara ve hareketlere bu API üzerinden ulaşır.
Güvenlik
API’ye kim, neye, ne kadar erişir?
ERP veritabanınıza dışarıdan kapı açılmaz. API, ERP’nize ERP Asistanı Köprü üzerinden ulaşır. Köprü sunucunuzdan yalnız dışarıya bağlanır; dışarıdaki bir yazılım ERP veritabanınızı hiçbir zaman doğrudan görmez.
Erişim anahtarı. Her yazılıma ayrı anahtar verilmesini, anahtarın uygulamanın yönetim panelinden yenilenmesini ya da iptal edilmesini ajana yazarak kurarsınız. Bir iş ortağıyla çalışmayı bıraktığınızda yalnız onun anahtarını kapatırsınız.
Uç bazında yetki. Bir yazılımın yalnız stok ve fiyatı görmesi, bir başkasının sipariş de gönderebilmesi gibi kuralları tanımlarsınız. Bayi yazılımı yalnız o bayinin cari bilgisini görür.
İstek sınırı ve kayıt. Bir yazılımın dakikada en çok kaç istek gönderebileceğini sınırlar, gelen isteklerin kaydını tutarsınız. Hangi yazılımın hangi bilgiyi ne zaman aldığı uygulamanın kayıtlarında görünür.
HTTPS. API kendi adresinde ya da kendi alan adınızda yayına alınır; sertifika kendiliğinden kurulur ve yenilenir.
Yayındaki API isteğiniz olmadan değişmez. Ajanın yaptığı her değişiklik önce demo ortamına gelir; API’yi kullanan yazılımlar “Yayını güncelle” diyene kadar aynı uçları kullanmaya devam eder.
Hız ve süreklilik
ERP sunucunuzu yormayan, belgesi güncel bir API
Sık okunan bilgi uygulamanın kendi tarafında tutulur. Stok, fiyat ve katalog gibi her dakika istenen bilgiler uygulamanın kendi veritabanında düzenli olarak eşitlenir; her istekte ERP’nize gidilmez, ERP sunucunuz yorulmaz. Cari bakiyesi gibi anlık doğruluğun öncelikli olduğu uçlar ERP’nizden doğrudan okunabilir; hangisinin nasıl çalışacağını ajana iletirsiniz.
Yayından önce denetim. Uygulamanın API uçları, yayından önce gerçek kullanımdaki gibi çağrılarak denetlenir. Ajan bir ucu kurduğunda onu demo ortamında kendisi de çalıştırır, cevabın beklenen yapıda geldiğini kontrol eder.
Belge. Uçların listesini, beklenen parametreleri ve örnek cevapları içeren bir belge sayfasını ajana yazdırırsınız; iş ortaklarınız API’yi bu belgeden öğrenir. Uç değiştiğinde belgeyi de aynı istekte güncellemesini iletirsiniz.
Sürüm geçmişi. Her değişiklik bir sürüm olarak kaydedilir; bir değişiklikten memnun kalmazsanız önceki sürüme dönersiniz.
Nerede çalışır. API varsayılan olarak bizim sunucumuzda, her gece yedeklenerek çalışır. Kendi Windows sunucunuzda çalışmasını istiyorsanız “Bilgisayarıma kur” ile oraya kurarsınız.
Referanslar
ERP verisini başka sistemlere açan firmalar
NCP Kitap
Mikro v17
NCP Kitap, B2B bayi portalını, B2C e-ticaret sitesini ve şirket içi raporlamasını aynı Mikro v17 verisiyle çalıştırıyor.
- B2B bayi portalı
- B2C e-ticaret sitesi
- Şirket içi BI raporlama
OtoDevi
OtoDevi, sektörel bir pazar yerini ERP Asistanı ile kurdu.
- Sektörel pazar yeri
Karşılaştırma
Doğrudan veritabanı bağlantısı, özel entegrasyon projesi ve Uygulama Yap
ERP verisini başka bir yazılımla paylaşmanın en sık kullanılan iki yolu ile Uygulama Yap’ta kurulan API’nin farkı.
| Konu | Özel entegrasyon projesi | Uygulama Yap ile API |
|---|---|---|
| Güvenlik | Çoğu zaman veritabanına dışarıdan erişim ya da port açılması gerekir | Köprü yalnız dışarıya bağlanır; dışarıya yalnız tanımlı uçlar açılır |
| Başlangıç | Analiz, teklif ve geliştirme süreci | İhtiyacı ajana iletirsiniz; uçlar aynı gün demo ortamında |
| Yeni uç | Her ihtiyaç için ayrı iş | Ajana yazılı olarak iletirsiniz |
| Yetki | Projeye göre değişir | Yazılım başına anahtar, uç bazında yetki |
| ERP yükü | Her istek ERP’ye gider | Sık okunan bilgi uygulamanın kendi tarafında tutulur |
| Barındırma | Sunucu, SSL ve yedek ayrıca | Barındırma, otomatik SSL ve her gece yedek dahil |
ERP’nize bağlı diğer uygulamalar için: ERP uygulama stüdyosu.
SSS
Sıkça sorulan sorular
ERP API nedir?
ERP’nizdeki stok, fiyat, cari ve sipariş bilgisinin mobil uygulama, web sitesi ya da iş ortaklarınızın yazılımı tarafından güvenli biçimde okunmasını ve gerektiğinde ERP’ye kayıt yazılmasını sağlayan arayüzdür. Uygulama Yap’ta API uçlarını ajana yazılı olarak ileterek kurarsınız.
ERP’mizin kendi API’si yoksa ya da sınırlıysa ne olur?
Uygulama Yap’ta kurulan API, ERP’nize ERP Asistanı Köprü ile bağlanır; ERP’nin kendi API lisansına ihtiyaç duymaz. Mikro, Logo, Netsis, SAP Business One ve kendi MSSQL ya da MySQL veritabanınızla çalışır.
API’yi kullanmak için port açmam gerekir mi?
Hayır. Köprü ERP sunucunuzdan yalnız dışarıya bağlanır. Dışarıdaki yazılımlar yalnız API’nin kendi adresine istek gönderir; ERP veritabanınıza doğrudan erişmez.
API ERP’ye kayıt yazabilir mi?
Evet. Dışarıdan gelen siparişin ERP’ye aktarılması gibi yazma işlerini de kurarsınız. Kaydın hangi koşulla ve kimin onayıyla yazılacağına siz karar verirsiniz; çoğu senaryoda önce bir onay adımı konması önerilir.
API’ye erişimi nasıl sınırlarım?
Her yazılıma ayrı erişim anahtarı, uç bazında yetki ve istek sınırı tanımlanmasını ajana yazılı olarak iletirsiniz. Bir iş ortağıyla çalışmayı bıraktığınızda yalnız onun anahtarını iptal edersiniz.
API’de değişiklik yaptığımda onu kullanan yazılımlar etkilenir mi?
Değişiklikler önce demo ortamına gelir; “Yayını güncelle” demeden yayındaki API değişmez. Ajandan uçların belgesini de güncellemesini istersiniz; iş ortaklarınız değişikliği yayından önce öğrenir.
Ücretsiz deneyebilir miyim?
Evet. Ücretsiz hesap açarsınız; ilk 24 saat bütün menüleri deneme kredisiyle, kendi ERP verinizle denersiniz. Uygulama Yap’ta ilk API ucunuzu kurup demo ortamında çağırabilirsiniz.
ERP verinizi ihtiyacı olan yazılıma güvenli bir API ile açın.
ERP’nizi bağlayın, hangi bilginin kime açılacağını ajana iletin; uçları demo ortamında inceleyin, beğenince yayına alın.