İçeriğe geç
Entegrasyon

Kendi siteniz ve muhasebeciniz için açık kapı

Belgelenmiş API, imzalı webhook'lar ve tam veri dışa aktarma. Verileriniz sizindir; istediğiniz zaman alırsınız.

Genel bakış

Hasvero'yu kendi sistemlerinize bağlayın

Hasvero baştan API öncelikli kuruldu: web paneli, mobil uygulama ve dış sistemlere açılan programlama arayüzü (API) aynı iş kurallarını kullanır. Bu nedenle API, paneldeki işlemlerin kısıtlı bir kopyası değildir; aynı kontrollerden geçen aynı işlemlerdir. Web sitenizi, muhasebe yazılımınızı ya da kendi raporlama aracınızı bu arayüz üzerinden Hasvero'ya bağlayabilirsiniz.

Entegrasyon üç parçadan oluşur: dış uygulamanın veri okuyup işlem yapabilmesi için API anahtarları, Hasvero'da bir belge onaylandığında ya da iptal edildiğinde sisteminize haber veren webhook'lar ve tüm uçların açıklandığı OpenAPI dokümanı. API anahtarı ve webhook, API erişimi içeren paketlerde sunulur; mobil uygulama bundan bağımsız olarak her pakette çalışır.

Veriniz sizindir. Paketiniz ne olursa olsun tüm verinizi şifreli bir arşiv olarak dışa aktarabilirsiniz; aboneliğiniz sona erse de 90 gün boyunca okuma ve dışa aktarma erişiminiz sürer.

Öne çıkanlar

  • Web, mobil ve API aynı iş kurallarını kullanır; API'den yapılan işlem panelde yapılanla aynı sonucu verir.
  • API anahtarı, oluşturan kullanıcının yetkileri ve şubeleriyle sınırlıdır ve istendiği an iptal edilir.
  • Webhook olayları imzalıdır, gerektiğinde yeniden denenir ve her teslim kaydedilir.
  • Maliyet bilgisi ne webhook yüklerinde ne de yetkisiz API yanıtlarında yer alır.
  • Tüm verinizi her pakette şifreli bir arşiv olarak dışa aktarabilirsiniz.
Entegrasyon

Nasıl çalışır

01

API anahtarları

Ayarlar ▸ Entegrasyonlar bölümünde, anahtarı oluşturan kullanıcı adına bir API anahtarı üretilir. Anahtar o kullanıcının rolü, izinleri ve erişebildiği şubelerle sınırlıdır; hangi şubede çalışılacağı istekte belirtilir. Her anahtarın son kullanıldığı zaman listede görünür ve anahtar iptal edildiği anda onu kullanan uygulamaların erişimi kesilir.

02

Aynı kurallar, aynı sonuç

API'den gelen bir satış ya da tahsilat, panelden yapılanla aynı doğrulamalardan, fiyat kurallarından ve uyum kontrollerinden geçer. Anahtarın sahibinin maliyet görme yetkisi yoksa maliyet ve kâr alanları yanıtta hiç yer almaz. Çift gönderime karşı istemci her işlemle bir tekrar anahtarı (Idempotency-Key) gönderir; aynı istek iki kez gelse de işlem bir kez yapılır.

03

Webhook'lar

Bir belge onaylandığında ya da iptal edildiğinde Hasvero, tanımladığınız adrese bir olay gönderir; hangi olayları alacağınızı siz seçersiniz. Her gönderim zaman damgalı bir HMAC-SHA256 imzası taşır, böylece sisteminiz mesajın gerçekten Hasvero'dan geldiğini doğrulayabilir. Olay yüklerinde maliyet bilgisi yer almaz.

04

Teslim takibi

Adresiniz yanıt vermezse gönderim artan aralıklarla altı kez yeniden denenir. Her denemenin sonucu teslim kayıtlarında görünür; art arda 20 teslim başarısız olursa uç kapatılır ve size bildirim gelir.

05

Belgelenmiş uçlar

Tüm API uçları OpenAPI 3 biçimindeki dokümanda, istek alanları ve kurallarıyla birlikte listelenir; yeni bir uç eklendiğinde dokümana kendiliğinden girer. Uyumsuz bir değişiklik yeni bir sürüm adresiyle yapılır ve eski sürüm, duyurudan sonra en az 12 ay çalışmaya devam eder.

06

Tam dışa aktarma

Dışa aktarma paketi tüm iş tablolarınızı CSV dosyaları olarak, ekleri, e-belge dosyalarını ve defter toplamlarının bakiyelerle tuttuğunu gösteren bir özet dosyasını içerir. Paket AES-256 ile şifrelenmiş bir zip dosyasıdır ve indirme bağlantısı 7 gün geçerlidir. Şifre özetleri, erişim anahtarları ve entegratör bilgileri gibi sırlar pakete alınmaz.

Dükkânda bir gün

Web sitesine stok bağlamak isteyen bir kuyumcu

  1. 1. gün

    API anahtarı

    Siz

    Ayarlardan bir API anahtarı oluşturursunuz.

    Hasvero

    Anahtar şubeye ve yetkiye bağlıdır; istediğiniz an iptal edilir.

  2. 2. gün

    Webhook

    Siz

    Satış olduğunda sitenizin haberdar olması için webhook adresi eklersiniz.

    Hasvero

    Her onaylı belge imzalı bir olayla gönderilir; yükte maliyet bilgisi yoktur.

  3. Her gün

    Dışa aktarma

    Siz

    Tüm verinizi tek dosyada indirirsiniz.

    Hasvero

    Aboneliğiniz sona erse de 90 gün okuma ve indirme erişiminiz sürer.

Entegrasyon

Neler yapabilirsiniz

REST API

OpenAPI ile belgelenmiş; web ile aynı iş kuralları.

Webhook

İmzalı olaylar, yeniden deneme ve teslim kaydı.

Tam dışa aktarma

Her pakette tüm veri; şifreler ve sırlar hariç.

Neden böyle tasarladık

Kapıyı kilitlemiyoruz

Bir yazılımdan ayrılmak verinizi kaybetmek anlamına gelmemeli. Hasvero her pakette tam dışa aktarma sunar ve kapanıştan sonra 90 gün okuma erişimi verir.

Sık sorulanlar

Entegrasyon için API anahtarı ve webhook paketlere göre değişir (Paketler sayfası). Mobil uygulama API erişiminden bağımsız olarak her pakette çalışır.

14 gün boyunca kendi dükkânınızla deneyin

Kurulum yok, kart yok. Kayıt olun, telefonunuzu doğrulayın, ilk satışınızı bugün yapın.

Hasvero

Giriş yapın

E-posta adresiniz ve şifrenizle doğrudan hesabınıza geçin.