Salla veya Zid'i İç Sistemlerinize Entegre Etmek Ne Anlama Gelir?

Salla veya Zid mağazanızı bir API aracılığıyla iç sistemlerinize bağlamak, mağazanın diğer sistemlerinizle —stok, muhasebe, ERP, CRM ve kargo firmaları— hiçbir manuel giriş olmadan otomatik olarak veri alışverişi yapması demektir. Bir çalışanın her siparişi mağaza panelinden muhasebe sistemine kopyalaması yerine, sipariş verildiği anda doğru sisteme akar, stok her iki yönde güncellenir, fatura kesilir ve gönderi hazırlanır; hepsi saniyeler içinde ve kopyalama hatası olmadan.

Bu makale, işletme sahipleri için Salla ve Zid API'lerinin neler sunduğunu, temel entegrasyon senaryolarını ve günlük operasyona dayanacak sağlam bir entegrasyonun nasıl kurulduğunu açıklıyor.

Bu Entegrasyona Neden İhtiyacınız Var?

Satışlar büyüdükçe manuel giriş en tehlikeli darboğaza dönüşür: elle kopyalanan ve geç ya da hatalı ulaşan siparişler, depoda aslında tükenmişken mağazada mevcut görünen stok ve ay sonunda mağaza ile muhasebe arasında tutmayan satış rakamları. Bu sorunların hepsinin kökü aynıdır: birbiriyle konuşmayan izole sistemler. API entegrasyonu bu ayrı adaları tek bir sisteme dönüştürür; böylece mükerrer iş ortadan kalkar ve rakamlar otomatik olarak mutabık olur.

  • Zaman tasarrufu: günlük saatler süren veri girişi, insan müdahalesi gerektirmeyen anlık senkronizasyona dönüşür.
  • Stok doğruluğu: mağazada ve depoda tek ve doğru bir bakiye görünür; ne tükenmiş bir ürün satılır ne de mevcut bir ürün dondurulur.
  • Düzenli muhasebe: her sipariş tutarı, vergisi ve fatura verileri hazır şekilde muhasebeye ulaşır.
  • Daha iyi müşteri deneyimi: süreç uçtan uca otomatik olduğu için onaylar ve kargo bildirimleri daha hızlı gelir.

Salla ve Zid API'leri Geliştiricilere Ne Sunuyor?

Hem Salla hem de Zid, geliştiricilere ve iş ortaklarına özel bir platformla birlikte modern REST API'ler sunar. Başlıca olanaklar:

  • REST API'ler: ürünlere, siparişlere, müşterilere, stoka ve kategorilere programatik erişim; okuma ve yazma.
  • OAuth kimlik doğrulaması: uygulamayı parola paylaşmadan, tanımlı yetki kapsamlarıyla (scope) yetkilendiren güvenli bir bağlantı.
  • Webhook'lar: sisteminizin mağazaya sürekli sormasına gerek kalmadan, bir olay gerçekleştiğinde —yeni sipariş, durum güncellemesi, müşteri kaydı— platformun sisteminize gönderdiği gerçek zamanlı bildirimler.
  • Uygulama mağazası: entegrasyonunuzu bir ürüne dönüştürmek isterseniz, uygulamanızı diğer satıcıların kullanımına sunma imkânı.

Bu araçlar, dikkatle tasarlandığı sürece neredeyse her entegrasyon senaryosunu kurmaya yeter.

En Pratik Entegrasyon Senaryoları

Pratikte satıcıların çoğu şu entegrasyonlardan birine veya birkaçına ihtiyaç duyar:

  • Siparişleri muhasebe veya ERP ile senkronize etmek: her yeni sipariş, finans sisteminizde otomatik olarak bir kayıt ve fatura oluşturur.
  • Çift yönlü stok senkronizasyonu: mağazadaki satış depo bakiyesini düşürür, yeni mal girişi ise mağazadaki stok durumunu anında günceller.
  • Ürünleri sisteminizden mağazaya aktarmak: ürünleri ve fiyatları tek bir merkezi sistemden yönetin, ardından otomatik olarak Salla veya Zid'de yayınlayın.
  • Müşterileri bir CRM ile senkronize etmek: her yeni müşteri, pazarlama ve takibi başlatmak için müşteri ilişkileri sisteminize girer.
  • Kargo ve lojistiği bağlamak: kargo etiketini otomatik oluşturup takip numarasını müşteriye gönderin.
  • E-fatura: her işlem için Zekât, Vergi ve Gümrük Kurumu (ZATCA) gerekliliklerine uygun bir fatura oluşturun.

Webhook'lar ve Polling Karşılaştırması

Mağazada yeni bir olay gerçekleştiğini öğrenmenin iki yolu vardır. Birincisi polling: sisteminiz birkaç dakikada bir mağazaya "Yeni sipariş var mı?" diye sorar; basittir ama yavaştır ve kaynak israf eder. İkincisi ve daha iyisi webhook'lar: platforma sisteminizin adresini bir kez bildirirsiniz ve platform her olayı gerçekleştiği anda size iletir. Webhook'lar daha hızlı ve hafiftir, ancak sisteminizin bildirimleri almak için her zaman erişilebilir olmasını ve bir teslimat geçici olarak başarısız olursa yeniden deneme mekanizmasını gerektirir.

Sağlam ve Kalıcı Bir Entegrasyon Nasıl Kurulur?

Başarılı bir entegrasyon yalnızca bir API çağrısı değildir; özenle tasarlanmış bir ara katmandır (middleware). Sağlaması gereken en önemli şeyler:

  • Doğru alan eşleme: mağazadaki ürünleri ve kodları iç sisteminizdeki karşılıklarıyla eşleştirmek, böylece veriler asla karışmaz.
  • Idempotency (tekrarlanabilirlik güvencesi): bildirim birden fazla kez gelse bile aynı siparişin asla iki kez kaydedilmemesini sağlamak.
  • Akıllı yeniden denemeler: bir bağlantı geçici olarak başarısız olursa sistem olayı kaybetmek yerine otomatik olarak yeniden dener.
  • İstek limitlerine uymak: platformlar dakika başına istek sayısını sınırlar ve entegrasyon bu sınırlara bozulmadan uymalıdır.
  • Kayıt ve mutabakat: neyin senkronize olduğunu ve neyin başarısız olduğunu gösteren bir panel ile hiçbir siparişin sessizce kaybolmamasını sağlayan günlük bir rapor.

Bu ayrıntıları ihmal etmek, demoda çalışıp bir hafta sonra çöken bir entegrasyon ile yıllarca sessizce çalışan bir entegrasyon arasındaki farktır.

Kaçınılması Gereken Yaygın Hatalar

Entegrasyon projelerini en sık batıran şeyler: tek yönlü senkronizasyonla yetinip ters yönü unutmak, hata durumlarını göz ardı edip siparişlerin kimse fark etmeden kaybolmasına yol açmak ya da test ortamı olmadığı için değişiklikleri gerçek siparişlerin olduğu canlı bir mağazada denemek. Altın kural: entegrasyonu başarıyı ele aldığı kadar başarısızlığı da ele alacak şekilde kurun ve yayına almadan önce ayrı bir ortamda test edin.

Origami'nin Rolü

Origami olarak Salla ve Zid üzerinde güvenilir entegrasyonlar geliştiren bir teknoloji şirketiyiz: mağazanızı muhasebenize, ERP'nize, CRM'inize veya kargo firmalarınıza bağlıyor, ara katmanı yeniden denemeler, mutabakat ve eksiksiz kayıt ile tasarlıyoruz. Hazır bir platform ile özel bir mağaza arasında henüz karar vermediyseniz, Özel Mağaza mı, Salla/Zid mi? makalemiz entegrasyona başlamadan önce karar vermenize yardımcı olur.

İyi bir entegrasyon görünmezdir; yalnızca sonucu görünür: tutan rakamlar, doğru stok ve önemli işlere odaklanabilen bir ekip.

Kaynaklar

  • Salla Geliştirici platformu: salla.dev
  • Zid — online mağaza platformu: zid.sa
  • Zekât, Vergi ve Gümrük Kurumu (ZATCA) — e-fatura: zatca.gov.sa