Açık API ve webhook'larla sistemlerinizi bağlayın
REST, gRPC ve imzalı webhook'larla e-ticaret sitenizi, B2B portalınızı ya da kendi yazılımınızı NetHesap Bulut'a bağlayın.
NetHesap Bulut, dış sistemlere kapalı bir kutu değil. Ticari, Hızlı Satış ve Mobil uygulamalarının her gün kullandığı aynı geçit, entegratörlere ve geliştiricilere de açık. Bu yazıda API'nin neler sunduğunu özetliyoruz.
REST API
REST API /api/v1 altında çalışır ve şu kaynakları kapsar:
- Ürün, müşteri ve tedarikçi
- Fatura, irsaliye ve teklif
- Sipariş: içe aktarma, doğrulama ve mutabakat
- Stok
- Kanal kataloğu: anlık görüntü ve değişiklik akışı
- POS: satış, askı, vardiya, Z raporu, iptal ve barkod sorgusu
Pazaryeri ve internet sitesi siparişleri, REST sipariş içe aktarımıyla NetHesap'a alınır. Ürün kataloğunu satış kanalınıza aktarmak için kanal kataloğunun anlık görüntüsünü bir kez alıp ardından yalnızca değişiklik akışını izlemeniz yeterlidir.
gRPC ve gRPC-Web
Yüksek hacimli entegrasyonlar için gRPC, tarayıcıdan doğrudan erişim için gRPC-Web desteği bulunur.
İmzalı webhook'lar
Bir fatura kesildiğinde ya da sipariş durumu değiştiğinde sisteminize haber verilmesini istiyorsanız Ayarlar › Dış Servisler › Webhook'lar ekranından bir adres tanımlayın. Webhook'lar imzalıdır; gelen isteğin gerçekten NetHesap'tan geldiğini doğrulayabilirsiniz. Teslimat en az bir kez garantisiyle yapılır, bu yüzden alıcı tarafın aynı olayı iki kez işlememesi için olay kimliğini kontrol etmesi önerilir.
API anahtarları
API anahtarları Ayarlar › Dış Servisler › API Anahtarları ekranından üretilir. Her anahtar şu kurallarla kısıtlanabilir:
- Yetki: Anahtarın hangi kaynaklara erişebileceği
- Mağaza / kanal: Yalnızca belirli bir mağaza ya da satış kanalı
- Süre: Anahtarın geçerlilik süresi
- Hız sınırı: Belirli bir zaman aralığındaki en fazla istek sayısı
Bir entegrasyon firmasına yalnızca ihtiyacı olan yetkiyi, yalnızca ilgili mağaza için ve sınırlı bir süreyle vermek bu sayede kolaydır.
Paylaşılabilir fatura PDF'i
Kendi müşteri portalınızda faturaları göstermek istiyorsanız API üzerinden paylaşılabilir fatura PDF linki alabilirsiniz.
Belgeler
Tüm uç noktalar ve örnekler geliştirici belgelerinde yer alır: docs.nethesapbulut.com. Entegrasyon projeniz için iş ortaklığı seçeneklerini merak ediyorsanız İş Ortaklığı sayfasına göz atın.