Kuyumcu API entegrasyonu, kuyumcu ve döviz işletmelerinin dükkandaki yazılımını dış dünyaya bağlamanın pratik bir yoludur. Kuyumcu API entegrasyonu sayesinde e-ticaret siteniz sipariş düştüğü anda fatura kesebilir, muhasebe programınız kayıtları elle giriş olmadan alabilir, ERP'niz stok ve cari bilgisini çift yönlü senkronize edebilir. EksenGOLD, bu ihtiyaç için Scalar arayüzünde gezilebilir bir public API dokümantasyonu ve OpenAPI şeması sunar; kimlik doğrulama OAuth2 / OpenID Connect ile, makineden makineye çağrılar ise API anahtarı ile yapılır.
Özet
- EksenGOLD API'si çift yönlüdür: kayıtları filtreleme, sıralama ve sayfalama ile okuyabilir; aynı uçlardan fatura kesme, cari açma, stok hareketi işleme gibi yazma işlemleri yapabilirsiniz.
- Canlı OpenAPI şemasında kapsanan alanlar arasında e-Fatura/e-Arşiv, e-İrsaliye, gider pusulası, cari (LegalEntities), envanter/stok, banka hesapları ve hareketleri, POS cihaz ve işlemleri, kimlik tespiti, raporlar, canlı kur, bildirimler, kullanıcı/rol yönetimi, KVKK rıza kayıtları ve Excel dışa aktarımlar bulunur.
- Multi-tenant veri izolasyonu ve rol/izin tabanlı yetkilendirme her API çağrısında uygulanır; dış sistem yalnızca yetkilendirildiği veriye erişir.
- Canlı kur ve bildirim gibi gerçek zamanlı veriler SignalR ile anlık akış olarak sunulur.
- EksenMS muhasebe aktarımı ve Pavo yazar kasa POS entegrasyonu, bu altyapı üzerinde geliştirdiğimiz gerçek örneklerdir.
1. E-Ticaret Sitesi Entegrasyonu: Siparişten Faturaya Tek Akış
Örnek bir işletme düşünelim: Kapalıçarşı'da tezgahı, bir de kendi e-ticaret sitesi var. Akşam saatlerinde siteden bir bilezik siparişi düşüyor. Entegrasyon olmadan yapılacak iş belli: siparişi görmek, stoktan düşmek, cariyi bulmak veya açmak, faturayı ayrıca kesmek. Her adım elle, her adımda hata payı.
API entegrasyonu ile aynı akış şöyle kurulur: e-ticaret sitesi sipariş oluştuğunda EksenGOLD API'sine bir çağrı yapar; müşteri caride yoksa cari kaydı açılır, e-Fatura veya e-Arşiv faturası oluşturulur ve ilgili stok hareketi işlenir. Ertesi sabah dükkan açıldığında satış, fatura ve stok zaten yerli yerindedir. API ile oluşturulan kayıtlar da uygulamadaki aynı izin ve kayıt düzeninden geçtiği için kimlik tespiti ve arşiv gereksinimleri açısından MASAK uyum süreçleriyle aynı çatı altında kalır.
2. Pazaryeri Satışları: API Üzerine Köprü Geliştirilebilir
Pazaryerlerinde satış yapan işletmeler için hazır bir pazaryeri konektörü sunmuyoruz; ancak API çift yönlü olduğu için pazaryeri panelinden alınan sipariş verisini EksenGOLD'a taşıyan bir köprü uygulaması geliştirilebilir. Yazılım ekibiniz veya çözüm ortağınız, pazaryerinin kendi API'sinden siparişleri çekip EksenGOLD API'si üzerinden fatura, cari ve stok kayıtlarına dönüştüren bir ara katman yazabilir. OpenAPI şeması sayesinde bu köprünün EksenGOLD tarafındaki istemci kodu hedef dilde otomatik üretilebildiği için geliştirme yükü büyük ölçüde pazaryeri tarafına kalır.
3. ERP ve CRM Entegrasyonu: Çift Yönlü Senkronizasyon
Birden fazla şubesi olan veya toptan çalışan işletmelerde genellikle bir ERP ya da CRM zaten vardır. EksenGOLD API'si bu sistemlerle iki yönde konuşur: ERP, cari ve stok kayıtlarını filtreleme, sıralama ve sayfalama ile okuyabilir; aynı uçlardan yeni kayıt oluşturabilir veya mevcut kayıtları güncelleyebilir. Banka hesapları ve hareketleri de API kapsamında olduğundan, banka entegrasyonu ile EksenGOLD'a akan hareketler ERP tarafındaki finans görünümüne taşınabilir. Rol/izin tabanlı yetkilendirme her çağrıda uygulandığı için ERP'ye yalnızca ihtiyacı olan alanlara erişim tanımlarsınız; multi-tenant izolasyon, verinin işletme sınırları dışına çıkmamasını güvence altına alır.
4. Muhasebe Entegrasyonu: EksenMS ile Gerçek Bir Örnek
Bu senaryo bir varsayım değil: EksenMS muhasebe aktarımı, bu altyapı üzerinde geliştirdiğimiz ve devreye aldığımız bir uygulamadır; EksenGOLD'daki kayıtları mali müşavirin bilgisayarındaki Zirve gibi muhasebe programına aktarır. Aktarılan kayıtların bir ucu da banka tarafındadır: hesap hareketlerinin otomatik çekilip belgelerle eşleştirilmesini banka entegrasyonu yazımızda, faturanın özel matrahla nasıl üretildiğini ise kuyumcu e-Fatura rehberimizde anlattık. İşletme ay sonunda fatura klasörü taşımak yerine, mali müşavirine aynı altyapı üzerinden düzenli veri akışı sağlar. Aynı altyapının üzerinde çalışan bir diğer gerçek örnek de Pavo yazar kasa POS entegrasyonudur: POS cihaz, hesap ve işlem uçları API kapsamında olduğundan yazar kasa tarafındaki hareketler sistemle bütünleşik ilerler.
5. Vitrin ve Kiosk Uygulamalarına Canlı Kur
Kısa ama etkili bir senaryo: dükkan vitrinine veya içerideki bir ekrana kendi kur panonuzu koymak istiyorsunuz. Canlı kur verisi SignalR ile gerçek zamanlı akış olarak sunulduğundan, kendi vitrin veya kiosk uygulamanız bu akışa abone olur ve kurlar ekranda anlık güncellenir; sayfa yenileme veya periyodik sorgu gerekmez.
Nasıl Başlarsınız?
- Scalar'ı keşfedin: https://api.eksenova.com/scalar adresindeki dokümantasyon, istek ve yanıt örnekleriyle gezilebilir durumda; hangi alanların kapsandığını buradan görebilirsiniz.
- OpenAPI şemasından istemci üretin: https://api.eksenova.com/openapi/v1.json şemasını kullanarak hedef dilinizde (C#, TypeScript, Python vb.) istemci kodu otomatik üretebilirsiniz.
- Yetkilendirme alın: Entegrasyonunuz için OAuth2 / OpenID Connect yapılandırması veya makineden makineye çağrılar için API anahtarı edinin; erişimi yalnızca ihtiyaç duyulan izinlerle sınırlandırın.
- Küçük başlayın: Önce salt okuma (örneğin cari listesi) ile bağlantıyı doğrulayın, sonra yazma senaryolarına geçin.
Sorularınız için SSS sayfamıza göz atabilir, entegrasyonu simüle demo verileriyle denemek için ücretsiz demo talep edebilirsiniz.
Kuyumcu API entegrasyonu, dükkandaki günlük işleyişi bozmadan e-ticaretten muhasebeye uzanan süreçleri tek ve denetlenebilir bir veri omurgasına bağlar.