İçeriğe geç
siparis.app geliştiriciAnahtarları yönet ↗

Ürünler

Seçeneği güncelle

PATCH/v1/variants/{id}

Seçeneğin stok kodunu, barkodunu, fiyatını, maliyetini, ağırlığını veya görsellerini değiştirin.

Gereken izin

Bearer anahtarı ve products:write

Koşula bağlı izin

costs:write: İstekte cost gönderirseniz gerekir. Eksikse 403 döner.

Yanıtı genişleten izin

costs:read: yanıttaki ilgili alanları açar; izin yoksa bu alanlar atlanır, istek reddedilmez.

Maliyet

1 puan (bağlantı başına 60 saniyede 600 puan)

Tekrar anahtarı

Gerekir: Idempotency-Key başlığı.

İstek

Temel adres: https://api.siparis.app/v1

Yol parametreleri

AlanTürZorunluAçıklamaÖrnek
idmetinEvetOkunacak kaynağın var_ önekli dış kimliği."var_1234567890abcdef1234567890abcdef"

Başlıklar

AlanTürZorunluAçıklamaÖrnek
Idempotency-Keymetin · null olabilirEvetZorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer."ilk-esitleme-20261016-001"
If-Matchmetin · null olabilirHayırİsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch."\"0123456789abcdef\""

Gövde (application/json)

AlanTürZorunluAçıklamaÖrnek
barcodemetin (en çok 100 karakter) · null olabilirHayırBarkod; işletmede canlı seçenekler arasında tekil. null temizler."8690000000001"
compare_pricesayı (en az 0; en çok 10000000) veya metin · null olabilirHayırÜstü çizili fiyat; null kaldırır. Üründe satış fiyatından yüksek olmalıdır."150.00"
costsayı (en az 0; en çok 10000000) veya metin · null olabilirHayırAlış maliyeti; costs:write gerekir. Panel gibi KDV hariç, muaf işletmede KDV dahil saklanır; null kaldırır."80.00"
imagesliste: metin (en çok 2000 karakter) (en çok 12 öğe) · null olabilirHayırEn çok 12 http/https görsel URL’si; [] galeriyi boşaltır. Panelin güvenli kopyalama kuyruğu kullanılır.
made_to_ordertrue/false · null olabilirHayırSipariş üzerine hazırlanırsa true; mevcut stok korunur.false
namemetin (en çok 500 karakter) · null olabilirHayırSeçeneğin görünen adı; gönderilmezse korunur."Mavi"
optionsliste: nesne (en çok 20 öğe) · null olabilirHayırSeçeneğin ad/değer çiftleri; gönderilmezse korunur.
namemetin (en çok 100 karakter)EvetSeçenek özelliğinin adı."Renk"
valuemetin (en çok 200 karakter)EvetSeçenek özelliğinin değeri."Mavi"
pricesayı (en az 0; en çok 10000000) veya metin · null olabilirHayırTRY satış fiyatı; ondalık metin. null ürünün fiyatını kaldırır, seçenekte ürün fiyatına döner."120.00"
price_rulenesne · null olabilirHayırÜrün fiyatından TL veya yüzde farkı; null ürünle aynı fiyat demektir.
kindmetin (seçenekler: tl, percent)EvetÜrün fiyatına eklenecek farkın birimi."tl"
valuesayı (en az -10000000; en çok 10000000) veya metinEvetFiyat farkı; negatif değer indirimdir. Son fiyat ortak fiyat kuralıyla doğrulanır."20.00"
skumetin (en çok 255 karakter) · null olabilirHayırStok kodu; işletmede canlı seçenekler arasında tekil. null temizler."KUPA-MAVI"
weightsayı (en az 0; en çok 100000) veya metin · null olabilirHayırKilogram cinsinden ağırlık; null kaldırır."0.350"

Örnek istek

curl --fail-with-body --silent --show-error --request PATCH \
  "${SIPARIS_API_URL:-https://api.siparis.app/v1}/variants/var_1234567890abcdef1234567890abcdef" \
  -H "Authorization: Bearer $SIPARIS_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: ornek-patch-v1-variants-var-1234567890abcdef1234567890abcdef-001' \
  --data-binary @- <<'JSON'
{
  "price_rule": {
    "kind": "percent",
    "value": "10.00"
  }
}
JSON
import json
import os
from urllib.request import Request, build_opener, HTTPRedirectHandler
from urllib.error import HTTPError

# İmzalı indirme hedefine Bearer taşımamak için yönlendirme kendiliğinden izlenmez.
class NoRedirect(HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

base = os.environ.get("SIPARIS_API_URL", "https://api.siparis.app/v1")
headers = {
    "Authorization": "Bearer " + os.environ["SIPARIS_API_KEY"],
    "Content-Type": "application/json",
    "Idempotency-Key": "ornek-patch-v1-variants-var-1234567890abcdef1234567890abcdef-001",
}
request = Request(base + "/variants/var_1234567890abcdef1234567890abcdef", headers=headers, method="PATCH",
    data="{\"price_rule\":{\"kind\":\"percent\",\"value\":\"10.00\"}}".encode("utf-8"))
try:
    with build_opener(NoRedirect).open(request, timeout=30) as response:
        print(response.read().decode("utf-8"))
except HTTPError as error:
    print(error.code, error.read().decode("utf-8"))
    raise
// Node.js 22+; anahtar yalnız sunucunun ortam değişkenindedir.
const base = process.env.SIPARIS_API_URL ?? "https://api.siparis.app/v1";
if (!process.env.SIPARIS_API_KEY) throw new Error("SIPARIS_API_KEY gerekli");
const response = await fetch(base + "/variants/var_1234567890abcdef1234567890abcdef", {
  method: "PATCH",
  headers: {
    "Authorization": `Bearer ${process.env.SIPARIS_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "ornek-patch-v1-variants-var-1234567890abcdef1234567890abcdef-001",
  },
  redirect: "manual", // 307 hedefini Bearer olmadan ayrı istekte okuyun.
  signal: AbortSignal.timeout(30_000),
  body: JSON.stringify({
  "price_rule": {
    "kind": "percent",
    "value": "10.00"
  }
}),
});
const text = await response.text();
if (!response.ok) throw new Error(`${response.status}: ${text}`);
console.log(text);

Kimlik içeren yollarda örnek kimliği kendi liste yanıtınızdan alın. SIPARIS_API_KEY sunucu ortamında tanımlı olmalı; yerelde SIPARIS_API_URL ile /v1 içeren adresi değiştirin. Üretimde tekrar kurallarını uygulayın.

Yanıt

200 İstek başarıyla tamamlandı.

İçerik türü: application/json

{
  "archived": false,
  "barcode": "8690000000001",
  "compare_price": "150.00",
  "created_at": "2026-10-16T09:00:00Z",
  "currency": "TRY",
  "expired": false,
  "id": "var_1234567890abcdef1234567890abcdef",
  "is_default": true,
  "made_to_order": false,
  "name": "Mavi",
  "options": [
    {
      "name": "Renk",
      "value": "Mavi"
    }
  ],
  "pool_quantity": "1.000",
  "price": "120.00",
  "product": "prd_1234567890abcdef1234567890abcdef",
  "sku": "KUPA-MAVI",
  "stock_uncounted": false,
  "updated_at": "2026-10-16T09:00:00Z"
}
Yanıt alanları (20)
AlanTürZorunluAçıklamaÖrnek
archivedtrue/falseEvetArşivdeki veya kapanmış kaynaksa true. archived=true süzgeci bunları da içerir.false
barcodemetin · null olabilirEvetÜrünün veya seçeneğin barkodu."8690000000001"
compare_pricemetin · null olabilirEvetKarşılaştırma fiyatı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin."150.00"
created_attarih-saatEvetOluşturulma zamanı; RFC 3339 UTC."2026-10-16T09:00:00Z"
currencysabit "TRY"EvetPara birimi; v1 tutarları Türk lirasıdır."TRY"
expiredtrue/falseEvetSeçenek emekli edilmişse true.false
idmetinEvetKaynağın dış kimliği; var_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz."var_1234567890abcdef1234567890abcdef"
is_defaulttrue/falseEvetVarsayılan seçenek veya depo ise true.true
made_to_ordertrue/falseEvetSipariş üzerine hazırlanırsa true; sayılmayan stoktan önceliklidir.false
namemetinEvetKaydın görünen adı."Mavi"
optionsliste: nesneEvetSeçeneğin ad/değer özellikleri.
namemetinEvetSeçenek özelliğinin adı."Renk"
valuemetinEvetSeçenek özelliğinin değeri."Mavi"
pool_quantitymetin · null olabilirEvetSeçeneğin ortak stoktan kullandığı miktar; birimi ilgili ürün/depo alanında verilen ondalık metin."1.000"
pricemetin · null olabilirEvetSatış fiyatı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin."120.00"
productmetinEvetÜrün kimliği (prd_ ve 32 küçük onaltılık karakter)."prd_1234567890abcdef1234567890abcdef"
skumetin · null olabilirEvetStok takip kodu; eşitlik araması normalize edilerek yapılır."KUPA-MAVI"
stock_uncountedtrue/falseEvetStok sayılmıyorsa true; stok miktarı null sunulur.false
updated_attarih-saatEvetSon değişiklik zamanı; RFC 3339 UTC."2026-10-16T09:00:00Z"
costmetin · null olabilirHayırMaliyet; yalnız costs:read ile görünür; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin."80.00"

Bu uca özgü yanıt başlıkları: ETag (Ürünün API görünümünün SHA-256 içerik özetinin ilk 16 onaltılık karakteri; stok durumu ve updated_at hariç. If-Match için tırnaklarıyla saklayın.).

Hatalar

HTTPcodeAnlamıNasıl düzelir?
403forbiddenMevcut ticari kural bu işlemi yapmanıza izin vermiyor.Gerekli kapsamları ve siparişin durumunu kontrol edin.
409conflictSipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin.
409code_takenStok kodu veya barkod başka bir kayıtta kullanılıyor.Görünür existing_variant / existing_product kimliğini okuyun veya farklı kod seçin.
400invalid_if_matchIf-Match geçerli bir güçlü ETag değil.GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.
412revision_mismatchKayıt siz okuduktan sonra değişmiş.Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.
422store_requiredÇok markalı işletmede kaydın markası eksik./me yanıtındaki sto_ kimliğini store alanına yazın.
403store_forbiddenAnahtar başka markaya yazamaz.Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez.
403reference_namespace_forbiddenDış numaranın ad alanı başka bağlantıya ait.namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.
409external_reference_conflictBu dış numarayla stok belgesi zaten açılmış.Ağ tekrarında özgün Idempotency-Key değerini ve gövdeyi kullanın.

Ortak hatalar (anahtar, izin, istek biçimi, hız sınırı, tekrar anahtarı) her uçta aynıdır: Hata kodları › Ortak hatalar.