POS kasanız, sipariş kioskunuz ve Scan & Order paneldeki tek bir ürün yelpazesi ve tek bir stokla çalışır. Narrow.TV API ile bu verileri zaten kullandığınız sistemlere bağlarsınız. Kendi sistemlerinizi bağlayın ya da entegrasyonu geliştiricinize veya iş ortağınıza kurdurun.

API dokümantasyonunu görüntüle

API'yi ne için kullanırsınız?

  • Muhasebe: günlük ciroyu KDV oranına ve ödeme yöntemine göre alın ya da Z raporlarını ve tek tek fişleri okuyun.
  • Web mağaza veya ERP: ürünleri, fiyatları ve stoğu kendi sisteminizle Narrow.TV arasında senkron tutun.
  • Raporlama ve BI: satışlarınızı ve siparişlerinizi kendi panolarınızda ve analizlerinizde kullanın.
  • Kendi sipariş işleme sürecinizi kurun: kiosk ve Scan & Order siparişlerini kendi sistemlerinize aktarın.

Nasıl başlanır

  1. Panelin hesap menüsünden API erişimini açın. Bu sayfayı yalnızca hesap sahibi görür.
  2. Bir ad ve isterseniz bir son kullanma tarihiyle bir token oluşturun.
  3. Her konum için yetkileri seçin: kasa verilerini okuma, ürünleri okuma veya yönetme, stoğu okuma veya yönetme ve siparişleri okuma.
  4. Token'ı kopyalayın. Yalnızca bir kez gösterilir. Ardından listede en son ne zaman kullanıldığını görür ve istediğiniz zaman iptal edebilirsiniz.

API neler sunar

Kasa verileri

Bir konumun fişlerini satırlar, indirimler, KDV ve ödemelerle birlikte okuyun. Z raporlarını ya da KDV oranına ve ödeme yöntemine göre ciroyu gösteren günlük özeti alın: muhasebenizin tam olarak ihtiyaç duyduğu bilgiler. POS kasanın yevmiyesi API üzerinden yalnızca okunabilir, değiştirilemez.

Ürünler

Kategorileri, ürünleri ve ürün seçeneklerini okuyun ve yönetin. Tek bir istekle, kendi ürün kodunuzla eşleştirerek 500'e kadar ürünü aynı anda güncellersiniz. Kategorileri adıyla, ürün fotoğraflarını ise bağlantı olarak verebilirsiniz: Narrow.TV bunları arka planda indirir.

Stok

Stok seviyelerini ve stok hareketlerini okuyun. Sayımları, teslimatları ve düzeltmeleri ürün bazında veya toplu olarak kaydedin.

Siparişler

Sipariş kioskunuzdan ve Scan & Order üzerinden gelen siparişleri satırlar, tutarlar, ödeme yöntemi ve durumla birlikte okuyun.

Webhook'lar: anında haberdar olun

Webhook'larla Narrow.TV, bir şey olur olmaz kendi sisteminize bir mesaj gönderir: bir satış, bir gün sonu kapanışı, bir stok değişikliği, yeni veya güncellenmiş bir sipariş ya da ürünlerde ve ürün seçeneklerinde bir değişiklik. Her mesaj imzalıdır (HMAC); böylece gerçekten Narrow.TV'den geldiğini doğrulayabilirsiniz. Bir gönderim başarısız olursa Narrow.TV otomatik olarak yeniden dener.

Güvenli ve güvenilir

  • Tüm trafik JSON ile HTTPS üzerinden geçer.
  • Her token yalnızca ona verdiğiniz konum bazlı yetkilere sahiptir ve bir son kullanma tarihi olabilir.
  • Bir idempotency anahtarı ile bir değişiklik, iki kez işlenmeden güvenle yeniden gönderilebilir.
  • Token başına istek limitleri, API'yi herkes için hızlı ve kararlı tutar.

Geliştiriciler için

connect.narrow.tv adresindeki dokümantasyon tüm endpoint'leri örneklerle, yetkileri, sayfalamayı, hata kodlarını ve webhook imzalarının nasıl doğrulanacağını anlatır. İstemci üretmek için bir OpenAPI 3.1 spesifikasyonu ve üretim ortamının yanında bir sandbox vardır.

API dokümantasyonunu görüntüle

Neye ihtiyacınız var

Neyi bağlamak istediğinizi konuşmak ister misiniz? Bizimle iletişime geçin, birlikte düşünelim.

Sıkça sorulan sorular

API'nin ücreti nedir?

API; POS kasa, sipariş kiosku ve Scan & Order ile birlikte dahildir. Bunlardan en az birine sahipseniz API token'ları oluşturabilirsiniz. Bu ürünlerin fiyatlarını fiyatlar bölümümüzde bulabilirsiniz.

Muhasebe programlarıyla hazır entegrasyonlar var mı?

Henüz yok. API, kendi sistemlerinizi bağlamanız veya geliştiricinize ya da iş ortağınıza bir entegrasyon kurdurmanız içindir. Bunun için KDV oranına ve ödeme yöntemine göre günlük ciro doğrudan alınabilir.

API üzerinden kasa satışlarını değiştirebilir miyim?

Hayır. Kasa yevmiyesi API üzerinden yalnızca okunabilir. Her satış, kasanın kendisinde olduğu gibi değiştirilemez şekilde kayıtlı kalır.

API token'larını kim oluşturabilir?

Yalnızca hesap sahibi, panelde hesap menüsündeki API erişimi sayfasından. Webhook'ları da orada yönetirsiniz.

Bir geliştiricinin nelere ihtiyacı var?

Doğru yetkilere sahip bir token ve connect.narrow.tv/docs adresindeki dokümantasyon. Orada tüm endpoint'ler örneklerle, webhook açıklamaları ve OpenAPI spesifikasyonu yer alır.