Kapsamlar ve kişisel veri

siparis.app API yetkisi, işletmeye ait bağlantının kapsamları ve marka sınırından oluşur. İstekler https://api.siparis.app/v1 adresine Bearer anahtarıyla gönderilir; panel çerezi veya kişinin ekip rolü API kapsamı yerine geçmez. /v1/me geçerli kapsam ve markaları gösterir.

orders:read, customers:read, products:read, inventory:read ilgili kaynakları açar. Siparişin ödeme, iade, gönderi ve fatura alt uçları orders:read yanında sırasıyla payments:read, returns:read, shipments:read, invoices:read ister. Yazma kapsamı okuma izni vermez. Her ucun gerekli ve isteğe bağlı kapsamları kendi sayfasında listelenir (Bütün uçlar).

events:read tek başına tüm olayları açmaz; olayın kaynağını okuma kapsamı da gerekir. Dışa aktarma exports:write yanında kaynağın okuma kapsamını ister. Webhook yönetimi webhooks:manage, seçilen olayların okunması da kaynak kapsamlarını ister.

Kişisel alanlar için kaynak iznine ek olarak personal_data:read gerekir; kapsam yokken alanlar yanıttan atlanır. İşletme sahibi KVKK uyarısını görerek açıkça seçer; varsayılan kapalıdır. E-posta/telefon eşitlik araması da bu izni ister. Alış fiyatı, KDV seçimi ve tedarikçi yazmak inventory:write yanında costs:write ister; yazma izni maliyeti okuma izni vermez. Maliyet costs:read, iç not internal_notes:read ile açılır; kişisel kaynaktaki iç not için iki kapsam da gerekir. Verileri yalnız izin verilen amaçla kullanın; yurt dışına aktarım dahil KVKK yükümlülüklerini değerlendirin.

customers:erase geri alınamaz KVKK anonimleştirmesi için ayrı hassas kapsamdır. İşletme sahibi yalnız Özel şablonda kendisi seçer; hiçbir hazır şablonda açık değildir. POST /v1/customers/{id}/anonymize ayrıca customers:write ve personal_data:write, Idempotency-Key ve {"confirm":"anonymize"} onayı ister. Kayıtlar silinmez; kişisel alanlar anonimleşir, sipariş, kesilmiş fatura ve muhasebe kayıtları kalır. KVKK silme isteği.

Bir markaya bağlı anahtar başka markanın verisini okuyamaz. Tek markada açılan sınırlı anahtar, ikinci marka eklenince genişlemez. İşletme kapsamlı anahtar izinli tüm markaları okur; tek ve çok markalı kullanım aynı uçları kullanır.

Anahtar yönetimi yalnız işletme sahibindedir. Yönetici, sipariş görevlisi, satış temsilcisi ve markayla sınırlı ekip üyesi anahtar oluşturamaz/yönetemez. Paneldeki AI erişimleri ve durumları listeler, onayla iptal eder; anahtar/sır üretmez veya göstermez. Anahtar döndürmede eski anahtarın geçiş süresi 24 saat–7 gün arasında seçilir. Bağlantının iptali bütün anahtarlarını kapatır.

money_out:write para çıkışı doğuran iade ve iptal için ayrı hassas kapsamdır; hazır şablonlarda açık değildir. İade başlatma ve gerçekten verilen iadeyi kaydetme returns:write ile birlikte ister. Yan etkisiz önizleme ve kodsuz onay/ret kararı returns:write ister. Açık seçimle geri gönderim kodu açılması ayrıca shipments:write ister ve BasitKargo bakiyenizden ücretlidir. İade yazma ve tekrar yanıtlarında ödeme listesi/özeti yalnız payments:read ile görünür. İade almak ve para iadesi.

Bütün kapsamlar

İşletme sahibi anahtar veya uygulama onayı verirken seçer; yazma kapsamı okuma izni vermez. Alan: scopes.

Kod	Türkçe adı	Ne zaman
`orders:read`	Siparişler · Gör	Siparişleri, satırlarını ve durum geçmişini okumak.
`orders:write`	Siparişler · Değiştir	Sipariş açmak, onaylamak, teslim etmek, düzeltmek, iptal etmek; başka kanaldaki satışı bildirmek.
`products:read`	Ürünler · Gör	Ürün, seçenek, kategori, ürün markası ve marka fiyatlarını okumak.
`products:write`	Ürünler · Değiştir	Ürün, seçenek, kategori, ürün markası ve marka fiyatı yazmak; toplu fiyat güncellemek.
`inventory:read`	Stok · Gör	Depoları, stok miktarlarını, stok hareketlerini ve belgelerini okumak.
`inventory:write`	Stok · Değiştir	Stok girişi, sayım, fire ve depolar arası taşıma; ürün açarken ilk stok; toplu stok sayımı.
`customers:read`	Müşteriler · Gör	Müşteri kartlarını okumak; ad, telefon, e-posta ve adres için ayrıca personal_data:read gerekir.
`customers:write`	Müşteriler · Değiştir	Müşteri eklemek, güncellemek, arşivlemek ve geri getirmek.
`shipments:read`	Gönderiler · Gör	Gönderileri okumak ve kargo etiketini indirmek.
`shipments:write`	Gönderiler · Değiştir	Kargo fiyatı sormak, gönderi açmak ve iptal etmek; iadede ücretli geri gönderim kodu açmak.
`returns:read`	İadeler · Gör	Siparişin iade ve değişim kayıtlarını okumak.
`returns:write`	İadeler · Değiştir	İade talebini onaylamak veya reddetmek, iadeyi önizlemek ve başlatmak.
`invoices:read`	Faturalar · Gör	Faturaları okumak ve fatura belgesini indirmek.
`invoices:write`	Faturalar · Değiştir	Fatura kesmek ve iptal etmek.
`coupons:read`	Kuponlar · Gör	Kuponları okumak.
`coupons:write`	Kuponlar · Değiştir	Kupon eklemek ve güncellemek.
`campaigns:read`	Kampanyalar · Gör	Kampanyaları okumak. Bu sürümde bu kapsamı isteyen uç yok.
`campaigns:write`	Kampanyalar · Değiştir	Kampanyaları değiştirmek. Bu sürümde bu kapsamı isteyen uç yok.
`subscriptions:read`	Abonelikler · Gör	Abonelikleri okumak.
`subscriptions:write`	Abonelikler · Değiştir	Abonelikleri değiştirmek. Bu sürümde bu kapsamı isteyen uç yok.
`payments:read`	Ödemeleri gör	Siparişin tahsilat ve geri ödemelerini, para özetini okumak.
`channels:read`	Kanalları gör	Satış kanallarını okumak.
`events:read`	Olayları gör	Olay akışını okumak; olayın kaynağının okuma kapsamı da gerekir (ör. sipariş olayı için orders:read).
`webhooks:manage`	Webhook yönet	Bu bağlantının webhook adreslerini eklemek, değiştirmek ve kapatmak.
`exports:write`	Dışa aktar	Dışa aktarma dosyası hazırlamak ve indirmek; kaynağın okuma kapsamı da gerekir.
`personal_data:read`	Kişisel verileri gör	Müşteri adı, telefonu, e-postası ve adresini görmek; e-posta veya telefonla aramak. İşletme sahibi KVKK uyarısını okuyarak seçer.
`personal_data:write`	Kişisel verileri değiştir	Müşteri adı, telefonu, e-postası ve adresini yazmak.
`costs:read`	Maliyet ve tedarikçiyi gör	Alış fiyatını, maliyeti ve tedarikçiyi görmek.
`costs:write`	Alış fiyatı ve tedarikçiyi yaz	Alış fiyatı, maliyet, KDV seçimi ve tedarikçi yazmak.
`money_out:write`	Para çıkışı	Müşteriye para iadesi doğuran iade, iptal ve düzeltmeler. Hazır şablonlarda kapalıdır.
`internal_notes:read`	İç notları gör	Sipariş, müşteri ve stoktaki iç notları görmek.
`internal_notes:write`	İç notları değiştir	İç not yazmak.
`archive:write`	Arşivle ve geri getir	Kayıtları arşivlemek ve arşivden geri getirmek.
`customers:erase`	KVKK anonimleştirmesi	Müşteriyi KVKK kapsamında geri alınamaz biçimde anonimleştirmek. Yalnız Özel şablonda seçilir.

OAuth uygulamalarında izinler

Davetli uygulamalar aynı kapsamları kullanır. İstenen izinler uygulama kaydının alt kümesidir; yalnız işletme sahibi, tek bir marka için onaylar. Kişisel veri izinleri onay ekranında kırmızı başlıkla ve ayrı onay kutusuyla sunulur. Barındırma ülkesi Türkiye dışındaysa KVKK m.9 uyarısı gösterilir. Bağlantı ve izinler Entegrasyonlar > Bağlı uygulamalar'dadır. Yenileme izinleri büyütmez; yeni kapsam yeni onay gerektirir. Akış.