Pazaryeri Merkezi — API Referansı (v1) #

Temel adres: https://app.bayircommunity.com/api/v1 Kimlik doğrulama: X-Api-Key: bc_live_… başlığı (veya Authorization: Bearer bc_live_…). Gövde: JSON (Content-Type: application/json). Yanıt: JSON, her zaman success alanı içerir. Hata biçimi: {"success":false,"error":"validation|not_found|action_failed|marketplace_error|rate_limited|unauthorized","message":"…"}. Limit: üye başına dakikada 300 istek (429 + Retry-After).

Bu API, üyelerin kendi e-ticaret yazılımı, WooCommerce ve Shopify eklentileri tarafından aynı şekilde kullanılır; pazaryerine özgü hiçbir alan yoktur — tüm pazaryerleri tek biçime çevrilir.

Modüller: Katalog (ürün/stok/fiyat) · Ürün açma (pazaryerinde listeleme) · Siparişler · Sipariş işlemleri · Kargo (Yurtiçi Kargo gönderisi, takip) · İrsaliye (PDF/HTML) · Fatura (Logo İşbaşı e-Fatura/e-Arşiv, PDF yükleme, e-posta) · İadeler (stok kararı) · Raflama (depo yerleşimi: raflar, fiziksel stok, toplama, hareketler — hesap başına açılıp kapanır) · Sorular · Finans · Bildirimler · Stok olayları (çift yönlü) · Profil · Sistem.

Sistem #

Pazaryeri bağlantıları (tam yönetim) #

Panel › Pazaryerleri'nde yapılan her şey. Kimlik alanları pazaryerine göre değişir: GET /marketplaces → credential_fields[] {name, label, required, type}, extra_settings{}, default_settings{}, sku_index (v1.23.3; kod eşleme dizini olan pazaryerlerinde {label, unit, help, confirm}, yoksa null — "yenile" düğmesi buna göre gösterilir). GET /connections listesindeki her bağlantıda da sku_index: {label, unit, help, confirm, built_at, count, complete, error, error_at, missing_cached} (son tarama zamanı, taranan kod sayısı, tarama tam mı, dizin kurulamadıysa hata metni, "pazaryerinde bulunamadı" önbelleğindeki kod sayısı) ya da null.

Hepsiburada stok kodu (v1.23.3): Hepsiburada stok kodlarını (merchantSku) BÜYÜK HARFE çevirerek kaydeder ("Küçük harf olarak gönderilen merchantSku bilgisi büyük harfe dönüştürülerek … kaydedilmektedir"). Eşleşmedeki kod kataloğunuzdaki gibi kalır (ör. ynck-diger-288-soft-beyaz); stok ve fiyat Hepsiburada'daki yazımla (YNCK-DIGER-288-SOFT-BEYAZ, Türkçe büyük harfle …DİGER… de olabilir) gönderilir. Kodun karşılığı listing listesinden (GET /listings/merchantid/{mid}) kurulan dizinden bulunur; dizin settings.code_index_ttl saat (varsayılan 6) geçerlidir, yeni kod az ise tek tek (merchantSkuList) aranır. Hepsiburada'da listing'i olmayan kod gönderilmez, eşleşmeye "Listing bulunamadı: … Stok kodlarını yenile" yazılır ve settings.code_miss_ttl dakika (varsayılan 30) yeniden sorulmaz. Listing listesi okunamazsa gönderim durmaz: kod büyük harfe çevrilip gönderilir.

Pazarama / PttAVM kodunda tire (v1.23.4): bu pazaryerleri koddaki "-" işaretini kabul etmiyor: satıcı panelinde girilen ynck-diger-288-soft-beyaz "-" işaretinden sonrası silinerek ynck olarak kaydedilebiliyor. Çözüm: ürünün pazaryerindeki kodunu tiresiz yazın (YNCKDIGER288SOFTBEYAZ); kodlar sade anahtarla (harf / rakam dışı karakterler atılmış, harf duyarsız) eşleşir, katalogdaki kodunuz değişmez. Sade anahtar yalnız tam eşleşme yoksa ve iki tarafta da tek karşılığı varken kullanılır (belirsizse "bulunamadı" denir, yanlış ürüne stok yazılmaz). Pazarama'da dizin GET /product/products (onaylı + onaysız), PttAVM'de StokKontrolListesi (Barkod, UrunKodu, Gtin) ile kurulur; ikisinde de settings.code_index_ttl (saat, varsayılan 6) ve settings.code_miss_ttl (dakika, varsayılan 60) vardır. Bulunamayan kodun hata metni ve sku-index sonucu tiresiz kod önerisini verir; pazaryerinde kodu yalnız ilk parçadan oluşan ürün varsa (ynck) bu da yazılır. Kodu zaten kesilmiş ürünler match ile ürün adından eşlenebilir (by_name[]). Siparişlerde ve iadelerde gelen tiresiz kodlar da sade anahtarla ürüne bağlanır. PttAVM ek ayarları: settings.cargo_profile_id (ürün açarken kargo profili), settings.vat_rate (varsayılan KDV %, 20).

PttAVM yeni API (v1.23.12): PttAVM token tabanlı kimlik doğrulamayı zorunlu yaptı. Bağlantı kimlik alanları: credentials.api_key ve credentials.token (ikisi zorunlu; PttAVM satıcı paneli › Hesap Yönetimi › Entegrasyon Bilgileri) — girilince bağlantı https://integration-api.pttavm.com REST API'sini kullanır. username / password / shop_id isteğe bağlıdır (yalnız eski SOAP servisi; API Key + Token girilmemiş eski bağlantılar). PATCH /connections/{id} ile {"credentials": {"api_key": "…", "token": "…"}} gönderip POST /connections/{id}/test ile deneyin. Yeni API'de kod dizini GET products/search + toplu barkod araması (products/get-by-barcodes) ile kurulur; stok / fiyat partisi remote_id = PttAVM takip numarası (trackingId). GET /marketplaces → credential_fields yeni alanları (etiket, zorunluluk, help) verir.

Katalog — ürün, stok, fiyat #

POST /stock (takma adlar: /products/stock, /sync/stock, /products/sync) #

Tek istekte 1000 kaleme kadar. Veri anında kaydedilir (202), pazaryerlerine arka planda partiler hâlinde iletilir. SKU yoksa ürün oluşturulur.

{"mode":"auto", "items":[
  {"sku":"KOLTUK-01","barcode":"8680000000001","title":"3'lü Koltuk","stock":12,"price":4599.90,"list_price":5299.90}
]}

Yanıt: {"success":true,"accepted":1,"created":0,"updated":1,"unchanged":0,"skipped":0,"queued_marketplace_updates":4,"errors":[]}

• mode: auto (varsayılan) — sitenizin henüz onaylamadığı pazaryeri sipariş düşümleri gönderdiğiniz stoktan otomatik çıkarılır; exact — stok olduğu gibi yazılır.
• Kabul edilen alternatif alan adları: quantity/qty/availableStock/stockQuantity, salePrice/salesPrice, listPrice/regular_price, name/product_name.
• depo (gövdede, v1.22.1; varsayılan true): raflama açıkken yazılan satılabilir stok depo (fiziksel) kaydını da taşır — hedef fiziksel = satılabilir + stoktan düşülmüş toplanacak; artış RAFSIZ'a eklenir (rafsızda kalır), azalış önce rafsızın müsait kısmından, sonra müsait adedi en çok olan raftan düşülür (siparişe ayrılana dokunulmaz). Hareketler adjust (sayım), sellable_after: null, ref: "stok-yazimi-depo" ile yazılır ve stock.moved üretir. Yalnız yankı / toplu eşitleme gönderen istemci "depo": false ile kapatır (depo kaydı değişmez). PUT /products/{sku} gövdesinde de kabul edilir (ürün gönderimi). Hesap ayarı: PUT /settings/features {"shelves_stock_sync": false} ile tümden kapatılır.
• stock_delta (takma ad delta, imzalı tam sayı, ±1.000.000): mutlak stock yerine fark gönderin ({"sku":"KOLTUK-01","stock_delta":-1,"ref":"WC-1001"}). Yeni stok = bizdeki stok + fark (en az 0); sitenizin okuma-yazma arasında pazaryerinden düşen sipariş geri alınmaz. Her fark GET /events'e type: adjust, source: site olayı olarak düşer (stock_after = onaylanan yeni stok). ref verilirse aynı ürün + ref ikinci kez geldiğinde fark uygulanmaz (yeniden deneme güvenli), yanıtta skipped sayılır. stock ile birlikte gelirse mutlak stock geçerlidir.
• list_price: 0 (ya da "0") liste fiyatını kaldırır (null); alanı hiç göndermemek "değiştirme" demektir.
• SKU / barkod eşleşmesi büyük-küçük harf, aksan ve Türkçe harf duyarsızdır (ABC-1 = abc-1, İSTANBUL = istanbul); kayıtlı yazım korunur.

POST /price (takma ad: /sync/price) — sadece fiyat #

{"items":[{"sku":"KOLTUK-01","price":4499.00,"list_price":5299.90}]}

POST /products veya PUT /products — ürün içeriği (toplu) #

Stok/fiyata ek olarak ürün açmada kullanılan içerik alanları. Sadece gönderilen alanlar güncellenir.

{"items":[{
  "sku":"KOLTUK-01","barcode":"8680000000001","title":"3'lü Koltuk Antrasit",
  "description":"<p>Ahşap iskelet…</p>","brand":"Örnek Mobilya","category":"Mobilya > Koltuk",
  "images":["https://…/1.jpg","https://…/2.jpg"],
  "attributes":{"Renk":"Antrasit","Kişi Sayısı":"3"},
  "vat_rate":20,"weight":45.5,"desi":120,
  "parent_sku":"KOLTUK","variant_attrs":{"Renk":"Antrasit"},
  "status":"active","stock":12,"price":4599.90,"list_price":5299.90
}]}

• parent_sku + variant_attrs: aynı parent_sku değerine sahip SKU'lar pazaryerinde tek ürünün varyantları olarak açılır.
• images: en fazla 12 URL. attributes: pazaryeri özellik adı → değer (kategori özelliklerine otomatik eşlenir).

PUT /products/{sku} — tek ürün güncelle (aynı alanlar, items olmadan) #

Fiyat sahipliği: fiyatın kaynağı üyenin kendi sitesidir. POST /products / PUT /products/{sku} ile gelen price / list_price değeri katalogda değişirse, o ürünün aktif pazaryeri eşleşmelerinin tamamı otomatik olarak gönderim sırasına alınır (dirty); böylece sitede yapılan fiyat değişikliği ilk gönderimde bütün pazaryerlerine yansır. Stoğun kaynağı ise SaaS'tır: site stoğu GET /products ve GET /events ile okur.

GET /products?page=1&size=100&q=&updated_since= — katalog listesi #

GET /products/{sku} — ürün detayı #

Yanıtta image (pazaryerinden alınan ana görsel; panelde önbellekten servis edilir) ve marketplaces[] (bağlantı başına): remote_code, pushed_stock, pushed_price, state (ok|sent|queued|rate_limited|error|pending|unknown), error, rate_limit.

Liste ekranları için ek parametreler:

GET /products/issues?limit=20 — senkron sorunları özeti #

{"counts":{"error":3,"queued":12,"rate_limited":14,"unlinked":5,"mismatch":2,"products":410},"items":[{"sku","title","connection_id","marketplace","connection_label","remote_code","state","error","rate_limit","pushed_stock","pushed_price","pushed_at","check"}]} — hatalı eşleşmeler önce.

Pazaryeri istek sınırı (rate limit) hata değildir. Pazaryeri "şu kadar süre sonra tekrar deneyin" dediğinde kalem state="rate_limited" olur, error boş döner ve rate_limit{until, seconds, minutes, note} alanı ne zaman yeniden denendiğini söyler. Kalemler kuyrukta kalır, süre dolunca en güncel stok/fiyatla tek pakette kendiliğinden gönderilir; kullanıcının bir şey yapması gerekmez. Bekleme payı ve üst sınırı yönetici panelindeki Ayarlar ekranından değiştirilir.

POST /products/{sku}/resend — ürünü yeniden gönderime al #

Gövde isteğe bağlı: {"connection_id":3} (boşsa tüm aktif eşleşmeler). Değerler değişmemiş olsa bile gönderim kuyruğuna alır ve hata kaydını temizler. Yanıt: {"queued":n,"product":{…}}.

Görseller: ürün görselleri pazaryerlerinden otomatik toplanır (sipariş kalemlerindeki görsel alanları + günde bir pazaryeri ürün listesi), sunucuda küçültülerek önbelleğe alınır (storage/cache/img) ve panelde index.php?p=img&u=… adresinden anında servis edilir.

POST /products/{sku}/rename — ürün kodunu (SKU) değiştir (v1.23.1) #

{"sku":"YENI-KOD"} — ürün satırı aynı kalır: stok, raf kayıtları, pazaryeri eşleşmeleri ve sipariş geçmişi bu üründe kalır, yalnız kod değişir. Yeni kod başka bir üründe varsa 409 conflict (conflict_sku) döner — iki ürün birleştirilmez. Yalnız harf büyüklüğü / Türkçe harf farkı varsa (aynı kod sayılır) yazım güncellenir. Yanıt: {"renamed":true,"product":{…}}. Bağlı site, ürünün SKU'su sitede değiştirilince bunu çağırır.

Site yetkili katalog (e-ticaret sitesi 1.11.1): site ürün bilgilerini (ad, barkod, maliyet, KDV, desi, ağırlık, durum, fiyat, varyant) POST /products ile {"create":false,"depo":false,"items":[…]} gövdesiyle gönderir (stok alanı yok — stok ayrı yoldan gider); sitede olmayan ürünleri {"sku":…,"status":"passive"} ile pasife alır (silmez: stok, raf ve pazaryeri eşleşmeleri korunur; status yalnız bilgi amaçlıdır, pazaryeri gönderimini durdurmaz).

POST /products/delete — toplu silme (v1.23.2) #

{"skus":["ESKI-01","ESKI-02"],"ids":[15,16],"skip_linked":true,"dry_run":true}

Ürünleri katalogdan kalıcı olarak siler (tek istekte en çok 2000 kod; skus ve/veya ids). Pazaryerlerindeki ilanlar silinmez.

• Silinen ürünün pazaryeri eşleşmesi, aynı barkodlu (ya da ilan koduyla aynı kodlu) başka bir ürüne aktarılabiliyorsa aktarılır:

eşleşme satırı olduğu gibi (pazaryerine özel fiyatıyla) o ürüne geçer ve gönderim sırasına alınır — stok o üründen güncellenmeye devam eder (kodu değişen ürün grubunun eskisi silinirken ilan yenisine geçer). O üründe aynı ilan zaten varsa eşleşme silinir (already).

• Aktarılamayan ilan sahipsiz kalır (stoğu artık güncellenmez). skip_linked:true iken böyle ürünler silinmez (action:"skip").
• Açık (yeni / hazırlanıyor) siparişte kalemi olan ürün silinmez (action:"skip", reason sipariş numarasıyla) — kargoya verilince silinebilir.
• Raf kayıtları silinir; stok hareket geçmişi (SKU ile) ve sipariş geçmişi kalır. Pasif eşleşmeler ürünle birlikte silinir.
• dry_run:true: hiçbir şey değişmez, aynı rapor döner (onay penceresi için).

Yanıt: {"deleted":2,"relinked":1,"unmanaged":1,"skipped":0,"shelf_qty":7,"not_found":["YOK-1"],"dry_run":false, "items":[{"sku":"ESKI-01","title":"…","action":"delete|skip","reason":null,"shelf_qty":0,"links":[{"marketplace":"Hepsiburada","remote_code":"HB-1","to":"YENI-01","result":"moved|already|unmanaged"}]}]}. Boş liste ya da 2000'den fazla kod: 422. Panelde aynısı: Ürünler › seçim kutuları › "Seçilenleri sil" (aramaya uyan tümü de seçilebilir; önce önizleme). Web sitesi (e-ticaret sitesi 1.11.2) "Pazaryeri Merkezi'nden de sil" seçilerek silinen ürünleri bu uçla siler.

POST /products/verify — pazaryeri kontrolü #

{"connection_ids":[3,4]} (boşsa tüm bağlantılar). Pazaryerindeki ürün listesi çekilir, eşleşmiş ürünlerin stok/fiyatı bizimkiyle karşılaştırılır; sonuç GET /products/{sku} çıktısında marketplaces[].check (status: ok|stock|price|both|missing, note, checked_at).

PUT /products/{sku}/prices — pazaryerine özel fiyat #

{"trendyol":{"price":4799.00,"list_price":5299.00},"n11":4699,"3":null}

Anahtar: pazaryeri kodu veya bağlantı id'si; null özel fiyatı kaldırır (genel fiyat + bağlantı fiyat kuralı geçerli olur). POST /stock / POST /products kalemlerinde "marketplace_prices":{"trendyol":4799} ile de gönderilebilir. Ürün çıktısında marketplaces[].price_override görünür. v1.21.0: değerler burada da doğrulanır — negatif / sıfır / sayı olmayan girişler errors[] içinde Türkçe açıklamayla geri döner ve o bağlantı atlanır (eskiden sessizce 0 ₺ yazılıyordu). Tek bir pazaryerini kodu ile birlikte düzenlemek için PUT /products/{sku}/links daha uygundur.

Excel ile toplu ürün #

Panel › Ürünler › "Şablonu indir" (.xlsx) → doldur → yükle. Sütunlar: SKU*, Barkod, Ürün adı, Stok, Satış/Liste fiyatı, Marka, Kategori, KDV, Maliyet, Desi, Koli adedi, Ağırlık, Açıklama, Görsel 1–5, Ana ürün kodu, Varyant: Renk/Beden, Özellikler (Ad=Değer; …), Durum. API: GET /products/template.xlsx (şablon), POST /products/import (multipart file ya da {"file_base64":"…","file_name":"urunler.xlsx"}; xlsx/csv) → rows, parse_errors, result{created, updated, errors}. JSON karşılığı POST /products.

Diğer ürün işlemleri #

PUT /products/{sku}/links — manuel eşleştirme + pazaryerine özel fiyat #

{"connection_id":3,"remote_code":"8680000000001","active":true,"price_override":4799.90,"list_price_override":5299}

remote_code: pazaryerindeki tanımlayıcı (Trendyol/HB/Koçtaş: barkod; N11/Pazarama/Çiçeksepeti/İdefix/PttAVM: stok kodu ya da pazaryeri ürün id'si). Kaydedince eşleşme gönderim kuyruğuna alınır ve önceki hata kaydı temizlenir (state → pending, last_error → boş). active:false verilirse o pazaryerine stok / fiyat gönderilmez.

v1.21.0 — price_override / list_price_override (bu pazaryerine özel satış / liste fiyatı):

Doğrulama (hepsi 422 + error:"validation" + Türkçe message): negatif değer ("… negatif olamaz"), sıfır ("… sıfırdan büyük olmalı"), sayı olmayan değer ("… sayı olmalı: "abc" okunamadı"), sütuna sığmayan değer ("… çok büyük"). Reddedilen istek hiçbir alanı değiştirmez. Değer kabul edilince kalem gönderim sırasına alınır (dirty), böylece yeni fiyat ilk gönderimde pazaryerine gider. Aynı düzenleme toplu biçimde PUT /products/{sku}/prices ile de yapılabilir.

v1.23.8 — Sipariş: "teslim edilemedi" ve iade süreci iade değil #

• "Teslim edilemedi" ara durumu (Trendyol UnDelivered, Pazarama 14, İdefix shipment_undeliver, Çiçeksepeti / PttAVM "Teslim Edilemedi":

kargo müşteriye ulaşamadı, gönderi şubede / tekrar dağıtımda) artık status: "shipped", status_label: "Kargoda · teslim edilemedi", yeni alan undelivered: true. Paket satıcıya geri dönünce (Trendyol Returned, Çiçeksepeti "Firmaya İade Edildi") status: "returned".

• Hepsiburada Undelivered kesin iadedir (sipariş iptal / para iadesi): status: "returned", status_label: "İade · teslim edilemedi".
• Müşteri iade süreci / reddi / talep ("İade Talebi", "İade Süreci Başlatıldı", "İade Reddedildi", Hepsiburada ClaimCreated, Koçtaş

INCIDENT_OPEN …): status: "delivered", status_label "Teslim edildi · iade sürecinde" / "· iade reddedildi" / "· iade edildi" / "· talep açık". Sipariş düzeyinde stok oynamaz; iade ve stok kararı iade kaydında (/returns).

• Önceki sürümlerde returned / cancelled görünen bu siparişler güncellemede bir kez düzeltilir (sipariş geçmişinde action: "status_fix").

v1.23.7 — Eşleşme durumu: hangi ürün hangi pazaryerinde eşli / eşleşmemiş / hatalı #

Bağlantı kartındaki "eşli ürün" yalnız bir sayıydı ("Kimisinde 140, kimisinde 139 — aradaki fark hangisi?"). GET /links/matrix her ürünü × her bağlantıyı tek tabloda verir. Panel: Pazaryerleri / Ürünler › 🔀 Eşleşme durumu (?p=coverage); site (e-ticaret sitesi 1.11.7): Pazaryerleri › Eşleşme Durumu. Mantık tek yerde: App\LinkMatrix.

GET /links/matrix — parametreler:

Yanıt: connections[] {id, marketplace, marketplace_label, label, name, active, environment, auto_link, identifier, rate_limit, stats}, products_total, filter, connection_id, q, status, counts {all, differs, missing, error, waiting, check} (arama / ürün durumu / odak dikkate alınır), page, size, total, total_pages, labels (durumların Türkçe adları), items[] {id, sku, title, barcode, status, stock, price, image, linked (kaç bağlantıda aktif eşli), connections (kapsamdaki bağlantı sayısı), cells {"<bağlantı id>": hücre}}.

stats (katalogun tamamı üzerinden): products, linked (= kartın "eşli ürün"ü), missing (= products − linked), none (eşleşmesi hiç açılmamış), inactive (pasif eşleşme), error, queued, unknown, check. Aynı sayılar GET /connections/{id} → stats içinde de (links, missing, inactive, none, products, unknown, check).

Hücre: state = none (eşleşme yok) · inactive (pasif — bu pazaryerine gönderilmiyor) · queued · rate_limited · pending · sent · ok · error · unknown; label, code, active, error (pazaryerinin mesajı; hata sonrası yeniden sıraya girmişse "Önceki gönderim hatası: …"), check {status, label, note, at}, queue (v1.23.6 ile aynı), rate_limit, pushed_at, pushed_stock, pushed_price, price_override, list_price_override; none hücresinde suggest (bağlantının kimlik ayarına göre önerilen kod: barkod ya da SKU).

error sayımı: aktif eşleşme + state = error. Kullanıcı "yeniden gönder" dediyse (sırada, hata metni silinmiş) sonuç gelene kadar hatalı sayılmaz; stok / fiyat değiştiği için yeniden sıraya giren (hata metni duruyor) hatalı sayılır.

POST /links/cell — tek hücre: {"sku":"…","connection_id":3,"op":"link|code|activate|deactivate|resend","remote_code":"…"}

Kurallar POST /links/bulk ile aynı (aynı bağlantıda aynı kod iki aktif eşleşmede olamaz → 422 + neden). Yanıt: message, item (ürünün güncel satırı, GET /links/matrix biçiminde), summary.

Excel — GET /links/export.xlsx?filter=missing&connection_id=3 (ürün durumu için status_filter=active|passive, arama q): süzgeçteki ürünler; odak verilirse yalnız o bağlantının sütunları. filter verilmezse eski davranış.

"Ürünleri eşleştir" (POST /connections/{id}/match): pazaryerinin listesinde bulunamadığı için pasife alınan eşleşmelere neden yazılır (check.status = "missing", check.note = "Ürünleri eşleştir (tarih): ürün pazaryerinin ürün listesinde bulunamadı, eşleşme pasife alındı."); yanıtta deactivated (daha önce aktifken pasife alınan ürün sayısı) ve mesajda bu sayı.

v1.23.6 — Sıradaki eşleşmenin nedeni (queue) · sonucu bildirilmeyen kalemin doğrulanması #

queue alanı — GET /products/{sku}, GET /products?links=1 ve GET /products/issues yanıtlarındaki her marketplaces[] / items[] kaleminde. Eşleşme gönderim sırasında değilse null; sıradaysa:

GET /products/issues: 30 dakikadan uzun sırada bekleyen ve bağlantısı art arda hata alan (ya da durdurulmuş) eşleşmeler de listelenir; error = "Sırada bekliyor — <bağlantının son hatası>".

Sonuç gelmedi (state = "unknown") — pazaryeri partinin sonucunda kalemi anmadıysa. Pazarama'da (parti kimliği tanınmadı, BSK16) artık Pazarama'daki ürün okunur: stok ve satış fiyatı gönderilenle aynıysa kalem ok olur (check.status = "ok", check.note = "Pazarama sonucu bildirmedi; üründe stok … okundu, gönderilenle aynı"). Uyuşmuyorsa parti ilk 5 dakika açık tutulup yeniden bakılır; sonra unknown olur ve error Pazarama'da ne göründüğünü yazar ("Pazarama'da şu an stok 34 / 29.999,00 ₺ görünüyor (gönderilen: …)"), check.status = stock | price | both | missing.

Kod önerisi kaldırıldı — POST /connections/{id}/sku-index yanıtında suggestions artık boş (truncated sürer); POST /connections/{id}/match yanıtında by_name[].suggest boş. GET /links/export.xlsx: "Tiresiz kod" bilgi sütunu yalnız safe=1 ile gelir.

v1.23.5 — Pazaryeri kodları TOPLU (Excel ve JSON) #

Kodları ürün ürün girmek yerine: indir → Excel'de düzenle → yükle (önce önizleme) → uygula. Panel: Ürünler › 📑 Pazaryeri kodları (Excel) (?p=links); site: Pazaryerleri › Kodlar (Excel). Hepsi aynı mantıktan (App\LinkSheet) geçer.

Kurallar: dosyada boş hücre değiştirmez; özel fiyat hücresine - (ya da sil) → özel fiyat kaldırılır; aktif Evet/Hayır. SKU harf duyarsız bulunur. Bir bağlantıda aynı kod iki aktif eşleşmede olamaz (harf duyarsız; dosyanın SON durumuna bakılır, A↔B takası serbest) — çakışan satır uygulanmaz ve sebebi errors[]'da yazar. Kodu değişen eşleşme PUT /products/{sku}/links gibi gönderim sırasına alınır (eski hata / kontrol notu silinir). Eşleşmesi olmayan üründe özel fiyat / aktif için önce kod gerekir. Başlıktaki [#3] bağlantı numarasıdır; silinirse bağlantı adı / pazaryeri adı tek bağlantıya uyuyorsa sütun yine tanınır. Kod hücresi Excel'de sayıya dönmüşse (8.69E+12) satır reddedilir. Uygulamalar Kayıtlar'a (catalog) yazılır; uygulanmayan satırlar uyarı olarak da düşer.

POST /products/import (ürün Excel'i) ve panelin ürün Excel yüklemesi, dosyada aynı düzende pazaryeri sütunları varsa ürünleri ekledikten sonra kodları da eşler (yanıtta links).

Ürün içeriği hakkında #

Bu sürümde pazaryerine ürün açma / içerik güncelleme (kategori, özellik, açıklama gönderimi) kaldırılmıştır; sistem stok, fiyat, sipariş, kargo, fatura ve iade yönetimine odaklanır. Ürün kartındaki içerik alanları (POST /products ile gönderilen başlık, görsel, açıklama…) yalnızca kendi kayıtlarınız / irsaliye için saklanır.

Siparişler #

GET /orders #

Ek filtreler: cost_missing=1 (maliyeti girilmemiş kalemi olan siparişler), pack=unprinted|unchecked|checked (irsaliye basılmamış / paket kontrolü yapılmamış / yapılmış), local_status=carrier_set|delivery_reported|packed|shipped|…, parent_order_id= (bir siparişin ek gönderileri). Sipariş detayında children[] (bağlı manuel gönderiler), parent_order_id, user_fields[] (elle kilitlenmiş alıcı alanları), picked_at / picked_by (raflama: raftan toplandı) ve raflama açıksa pick{state, items[]} + her kalemde locations[] {location, quantity, status} (bkz. Raflama). Parametreler: status (virgülle: new,processing,shipped,delivered,cancelled,returned), marketplace, connection_id, updated_since, since, until (sipariş tarihi), order_number, q (sipariş no/müşteri/takip no/kargo barkodu/paket no), sort=order_date|updated_at, page, size (≤200), include=items.

Değişiklikleri düzenli almak için: GET /orders?updated_since=<son kontrol>&sort=updated_at&include=items.

Sipariş nesnesi:

{"id":15,"marketplace":"trendyol","connection_id":3,"order_number":"123456789","package_number":"98765",
 "status":"processing","status_label":"Hazırlanıyor","marketplace_status":"Picking","local_status":null,
 "order_date":"2026-09-10 14:22:00","customer":"A*** Y***","email":"…","phone":"…",
 "shipping_address":{"name":"…","address":"…","city":"İstanbul","district":"Kadıköy","postal_code":"…"},
 "billing_address":{…},"tax_number":null,"company":null,
 "cargo_company":"Yurtiçi","tracking_number":"…","tracking_url":"…","cargo_barcode":"…",
 "total":4599.90,"currency":"TRY","invoice_number":"","invoice_url":"","invoice_sent_at":null,"shipped_at":null,"local_status":"",
 "parcel_count":2,"desi":12.5,"note":"Kırılacak eşya","cargo_cost":null,"commission":null,"shipment_id":18,
 "shipment":{"id":18,"carrier":"yurtici","cargo_key":"YRK123456789","tracking_number":"1002131026","status":"in_transit",…},
 "items":[{"id":40,"line_id":"555","sku":"KOLTUK-01","catalog_sku":"KOLTUK-01","barcode":"…","name":"…","quantity":1,"unit_price":4599.90,"total":4599.90,"status":"Picking","stock_deducted":true}],
 "first_seen_at":"…","updated_at":"…"}

Takip no ve kargo barkodu (v1.23.3): tracking_number kargo firmasının TAKİP numarasıdır, cargo_barcode paketin KARGO BARKODUdur (etikete basılan kod; Hepsiburada'da "teslimat numarası"). Hepsiburada'da paket listeleri yalnız barkodu verir; takip numarası ve tracking_url paket sorgusundan (GET /packages/merchantid/{mid}/packagenumber/{no} → trackingInfoCode, trackingInfoUrl) kargo firması paketi teslim alınca gelir: işçi kargodaki siparişleri numara gelene kadar 30 dakikada bir sorar (kargoya verilişten 30 gün; teslim edilmiş ama numarası alınmamış sipariş bir kez). Numara gelince işlem geçmişine tracking ("Kargo takip numarası: …") yazılır. Paket bozulursa (Hepsiburada "Unpacked") sipariş "Yeni"ye döner; package_number, cargo_barcode, tracking_number temizlenir. İrsaliyedeki barkod cargo_barcode (yoksa takip no, o da yoksa sipariş no); paket kontrolü (POST /orders/pack-check) kargo barkoduyla da bulur.

Son kargo tarihi ve indirim (v1.26.0):

• ship_by ("Y-m-d H:i:s", Türkiye saati | null): siparişin en geç kargoya verilmesi gereken an.
• ship_by_source: mp (pazaryeri bildirdi) ya da calc (tahmin). Pazaryerlerinin bildirdiği alanlar:
• Koçtaş: shipping_deadline
• İdefix: kalemlerin en erken lastShipmentDate'i
• Trendyol: extendedAgreedDeliveryDate, yoksa agreedDeliveryDate
• Hepsiburada: kalem dueDate'i
• Tarih bildirmeyen pazaryerlerinde tahmin yapılır: bağlantı ayarındaki hazırlık süresi (iş günü) ve kesim saati. Bağlantı ayarı ship_days / ship_cutoff_hour; 0 = tahmin yok.
• ship_by_state: şu değerlerden biri; kargoya verilmiş, teslim, iptal ya da iade siparişte null.
• overdue: süresi geçti
• today: bugün son gün
• soon: uyarı süresi içinde. Varsayılan 24 saat; hesap profili orders.ship_warn_hours, PUT /profile → {"orders":{"ship_warn_hours":12}}.
• ok
• GET /orders?sort=ship_by: en acil önce, tarihsizler sonda.
• GET /orders?due=overdue|today|soon|open: open = geçen + bugün + yaklaşan.
• GET /dashboard sayaçları: orders_overdue, orders_due_today.
• discount_total: siparişin indirim toplamı (pazaryerinin bildirdiği). total artık müşterinin ödediği tutardır.
• Kalemlerde list_price (indirimsiz birim fiyat) ve discount (kalem indirimi) var; price / total ödenen tutardır.
• İdefix'te önceden indirimsiz fiyat yazılıyordu. 1.26.0 güncellemesi eski İdefix siparişlerini ham veriden yeniden hesaplar. Kesilmiş faturalara dokunulmaz; tutarı farklı olanlar panel › Faturalar'da listelenir.
• Trendyol orderDate "GMT +3 damgası" olarak geldiği için sipariş saati 3 saat ileri görünüyordu. Düzeltildi; eski siparişler de güncellemeyle düzeltilir.

İdefix kargo profili (v1.26.0): GET /connections/{id}/cargo-companies İdefix satıcı kargo profillerini döner. code = profil id; etikette "İdefix anlaşmalı / kendi anlaşmam / alternatif" yazar.

• POST /orders/{id}/cargo {"cargo_company":"<profil id>"}: kargo firmasını İdefix'te değiştirir. Yeni kargo kodu (cargo_barcode = İdefix cargoKey) hemen sorulup siparişe yazılır.
• ship işleminde İdefix anlaşmalı profil seçilir ve takip no boş bırakılırsa:
• taşıyıcı bildirilir (local_status=carrier_set);
• İdefix paketi kargoya verince sipariş kendiliğinden "Kargoda" olur.

Yalnız taşıyıcı bildirilen ship (Koçtaş, İdefix, Çiçeksepeti — v1.26.1): yanıtın data alanında pending: true ve status: "CARRIER_SET" gelir; sipariş henüz kargoya verilmemiştir. İstemciler "kargoya verildi" yazmamalı, "taşıyıcı bildirildi" yazmalıdır (panel mesajı: "Taşıyıcı bildirildi. Kargocu paketi okutunca sipariş otomatik 'Kargoda' olur."). Bu durumda webhook olarak order.updated (pending: true) gider; order.shipped yalnız pazaryeri siparişi gerçekten kargoya verilmiş yaptığında (çekim sonrası, source: auto) gider. POST /orders/bulk sonuçlarında aynı bilgi results[].pending (+ results[].note) olarak döner. GET /orders/{id}/actions kayıtlarında label bu aşamayı yansıtır ve phase alanı pending (taşıyıcı bildirildi) · cargo_code (pazaryeri kargo kodu üretti) · shipped (pazaryeri kargoya verildi yaptı) · cancelled (pazaryeri iptal etti) değerlerinden birini taşır. Koçtaş bağlantı ayarı mirakl_ship_mode=now seçilirse eski davranış (OR24 hemen) sürer.

• ship işleminde kendi anlaşmanız seçilir ve takip no girilirse takip linki profilden tamamlanır.

POST /orders/{id}/refresh — durumu pazaryerinden şimdi yenile (v1.23.2) #

Siparişin güncel durumu pazaryerinden okunur ve yazılır (Hepsiburada: sipariş + paket detayı; diğerleri: canlı sipariş taraması). Yanıt: {"changed":true,"from":"processing","to":"shipped","message":"Durum güncellendi: Hazırlanıyor → Kargoda.","warning":null,"order":{…}}. Web / manuel siparişte ve pasif bağlantıda 422. İşlem geçmişine refresh olarak yazılır. Panelde sipariş sayfasındaki "Pazaryerinden yenile". Hepsiburada'da açık siparişlerin durumu ayrıca kendiliğinden de kontrol edilir (45 dakikada bir, sipariş başına).

GET /orders/{id}?raw=1 — detay (+ pazaryerinden gelen ham veri) #

GET /orders/{id}/actions — bu sipariş için yapılmış işlemler (geçmiş) #

Sipariş kalemlerinde v1.23.0'dan itibaren product_id (katalogdaki ürün; ek gönderide kodu değil bunu gönderin), ek gönderide (marketplace=manual) siparişte manual {reason, charge_material, material_cost}.

PUT /orders/{id} — paket bilgisi / maliyet #

parcel_count / desi değişirse pazaryerine de iletilir (Trendyol box-info, Koçtaş ek alanlar); yanıtta box_info (ok, supported, note).

{"parcel_count":2,"desi":12.5,"note":"Kırılacak eşya","cargo_cost":89.90,"commission":null,"local_status":"packed"}

cargo_cost ve commission girilirse finans özetinde bağlantı ayarındaki oranlar yerine bu değerler kullanılır. Sipariş çıktısında komisyon alanları: commission (pazaryerinin bildirdiği tutar; Trendyol kalem oranından hesaplanır, Koçtaş commission_fee + vergiler), commission_rate (%), commission_source (marketplace = pazaryeri bildirdi ya da siparişe elle girildi | none = pazaryeri komisyon göndermedi; tahmin yoktur), commission_estimate (pazaryeri vermediyse bağlantı ayarındaki oranla tahmin), net_estimate (toplam − komisyon − kargo maliyeti).

Sipariş işlemleri #

POST /orders/{id}/{işlem} — Yanıt 200 {"action":"ship","action_id":77,"data":{…},"order":{…}}; pazaryeri kabul etmezse 422 {"error":"action_failed","message":"…"}. Pazaryeri o işlemi desteklemiyorsa mesajda belirtilir. Her işlem order_actions geçmişine yazılır (GET /orders/{id}/actions).

Ortak gövde alanı: items — sadece belirli kalemler için işlem yapılacaksa line_id listesi (boşsa tüm sipariş).

Yardımcı listeler: GET /connections/{id}/cargo-companies, GET /connections/{id}/cancel-reasons, GET /connections/{id}/return-reasons

Hakediş / ödeme hareketleri (pazaryeri finans servisi, şimdilik Pazarama paymentAgreement): GET /connections/{id}/settlements?from=YYYY-MM-DD&to=YYYY-MM-DD → items[]{order_id, order_number, code, amount, commission, coupon, allowance, installments, status, date, transferred_at}, totals{amount, commission, allowance}. Desteklemeyen pazaryerinde 502 marketplace_error. (yanıtta ayrıca supported_actions).

Pazaryeri desteği (resmi API'lerin izin verdiği işlemler) #

¹ N11 API'sinde takip numarası gönderme yok; N11 anlaşmalı kargo etiketiyle çalışır. ² Çiçeksepeti fatura linki değil, fatura e-postası (SendInvoiceMail) kabul eder; invoice işlemi o yolu kullanır. ³ Çiçeksepeti ve İdefix satıcı tarafı iptal API'si sağlamaz (pazaryeri panelinden). ⁴ PttAVM kargo bilgisi PTT paneli/kargo entegrasyonundan gelir; API yalnızca fatura yükleme sunar. ⁵ Koçtaş: ship işleminde cargo_company olarak SELLER (panelde "Satıcı kendi taşır") seçilirse takip numarası zorunlu değildir ("Kendi Aracımız" yazılır), sipariş "Gönderildi" yapılır ve Koçtaş ek alanı shipment-status = Yolda işlenir; deliver işlemi shipment-status = Tamamlandı + delivered-date gönderir (Yurtiçi hareketlerinden otomatik de tetiklenir).

Fatura — e-Fatura / e-Arşiv (Logo İşbaşı) ve PDF #

Sipariş içindeki fatura bilgileriyle (fatura adresi, VKN/TCKN, vergi dairesi — order.billing_address) fatura kesilir. billing_address.district faturaya giden ilçedir (v1.22.1: Hepsiburada'da ilçe town alanından okunur, mahalle adres satırında kalır; eski kayıtlı siparişlerde ham veriden düzeltilir). Logo İşbaşı ilçeyi tanımazsa ("District Not Found") düzeltilmiş fatura ilçesi, sonra teslimat ilçesi birer kez denenir; tutan değer faturanın customer bilgisine yazılır. Müşteri GİB'de e-Fatura mükellefiyse e-Fatura, değilse e-Arşiv düzenlenir; GİB'e gönderilir, PDF alınıp barındırılır, pazaryerine fatura bağlantısı iletilir ve istenirse müşteriye kurumsal şablonla e-postalanır (PDF ekli).

Gelen e-Faturalar (Logo İşbaşı gelen kutusu) #

Toplu işlem #

POST /orders/bulk {"ids":[15,16,17],"action":"pack","params":{}} — action: pack, ship (params: cargo_company, tracking_number…), ship_create (params: account_id, parcel_count, desi, phone; sipariş başına ezmek için rows: {"15": {"parcel_count": 2, "desi": 4.5, "phone": "05xx"}}), invoice, deliver, cancel (params: reason), accept. Yanıt: {"done":2,"failed":1,"results":[{"order_id":15,"ok":true},{"order_id":16,"ok":false,"error":"…"}]}.

Manuel gönderi / yedek parça #

POST /orders/manual — pazaryerinden bağımsız bir gönderi kaydı açar (marketplace = "manual", sipariş no M260912-001 biçiminde); isteğe bağlı olarak aynı anda Yurtiçi gönderisi oluşturur. Tipik kullanım: mevcut bir siparişin alıcısına yedek/eksik parça ya da değişim ürünü göndermek.

{"source_order_id": 12, "reason": "Yedek parça", "parcel_count": 2, "desi": 4,
 "items": [{"sku": "KOLTUK-01", "quantity": 1}, {"name": "Menteşe seti", "quantity": 2}],
 "cargo_account_id": 1, "deduct_stock": false, "note": "Kırılgan"}

• source_order_id verilirse alıcı ve fatura bilgileri o siparişten kopyalanır; customer/phone/address/city/district/bill_* alanlarıyla ezilebilir. Kaynak yoksa customer, address, city zorunludur.
• items boş olabilir (ürünsüz gönderi). product_id ya da sku/barkod ile katalog ürünü, name ile serbest kalem. deduct_stock=true ise katalog ürünleri stoktan düşülür (kalemde deduct_stock varsa o geçerli).
• v1.23.0 — maliyet: kalemde cost = birim maliyet (₺, KDV dahil; parça gönderiminde parçanın maliyeti). Verilmezse katalogdaki ürün maliyeti. cargo_cost = bu gönderinin kargo ücreti (KDV dahil, elle; tarife ezmez), verilmezse desi tarifesi. Malzeme varsayılan olarak gider yazılır (charge_material:false ile kapatılır); material_cost yalnız elle toplam girilecekse (kalemlerin yerine geçer). Kargo + malzeme ana siparişin kârından düşülür.
• v1.23.0 — kalem atlanmaz: katalogda bulunmayan sku, ad yazılmamışsa kalem adı olur (katalog dışı kalem) ve yanıtta warnings[] döner. (Eskiden sessizce atlanıyor, ek gönderi 0 kalemle açılıyordu.)
• Yanıt 201: order (tam sipariş nesnesi; ek gönderide manual {reason, charge_material, material_cost}), shipment (oluşturulduysa), shipment_error, warnings, packing_slip (HTML/PDF linkleri). Manuel siparişler GET /orders?marketplace=manual ile listelenir ve tüm kargo / irsaliye / fatura uç noktalarını kullanır.

Sonradan düzeltme (v1.23.0, yalnız manuel gönderi):

Kargo — kendi kargo anlaşmanızla gönderi (Yurtiçi Kargo) #

Pazaryerinin anlaşmalı kargosu yerine kendi Yurtiçi Kargo sözleşmenizle gönderi oluşturursunuz. Kargo anahtarı (prefix + sipariş numarası) irsaliyeye Code128 barkod olarak basılır; kurye barkodu okutunca Yurtiçi sisteminde takip numarası (docId) oluşur. İşçi 30 dakikada bir açık gönderileri sorgular, takip numarasını siparişe yazar ve hesap ayarı auto_notify açıksa pazaryerine "kargoya verildi" bildirimini otomatik yapar.

Takip sıklığı (v1.13.2): gönderiler kademeli sorgulanır — ilk 48 saat 5 dakikada bir, sonrasında 30 dakikada bir. Kargo hesabı ayarlarından değiştirilir: track_fast_minutes (5), track_slow_minutes (30), track_fresh_hours (48).

İrsaliye (sevk fişi) #

Barkod içeriği: kendi kargo gönderisi varsa kargo anahtarı, yoksa pazaryeri takip numarası, o da yoksa sipariş numarası. Barkod altındaki etiket siparişin geldiği pazaryerini belirtir: Yurtiçi Kargo Marketplace - Trendyol (takip no varsa ayrıca yazılır). Koli sayısı kadar sayfa üretilir; her sayfada barkodun altında büyük k / N (ör. 2 / 3) yazar — her koliye bir irsaliye yapıştırılır. Gönderici bilgileri, logo ve varsayılan görünüm PUT /profile ile (veya panel › Ayarlar) belirlenir.

GET /profile · PUT /profile #

Hesap profili. Siteye özel profil: ek API anahtarıyla (Panel › API › ek anahtar, ör. kanal woocommerce) GET /profile?scope=key o anahtarın profilini (key{id,label,channel,override,profile}) ve etkin profili (profile) verir; PUT /profile gövdesine "scope":"key" eklenirse yalnız o anahtarın profili yazılır ("clear":true kaldırır). Anahtar profili, o anahtarla açılan web / manuel siparişlerin irsaliyesinde hesap profilini ezer (dolu alanlar); pazaryeri siparişleri her zaman hesap profilini kullanır. Böylece aynı hesaba bağlı birden çok site kendi gönderici bilgisi ve logosuyla irsaliye basar.

{"company":"Örnek Mobilya","address":"…","district":"Konak","city":"İzmir","postal_code":"35160","phone":"…","email":"…","website":"https://…",
 "tax_office":"Konak","tax_number":"1234567890","logo":"data:image/png;base64,…",
 "slip":{"title":"İrsaliye","accent":"#f26522","note":"İade için 14 gün…","show_images":true,"show_prices":true,"show_barcode":true,"show_customer_phone":true,
         "show_customer":true,"hidden_show_city":false},
 "orders":{"ship_warn_hours":24}}

Anahtar profilinde boş bırakılan metin alanları hesap profilinden devralınır (irsaliye başlığı dâhil); onay kutuları her zaman anahtarın değerini kullanır. Yanıt yalnız gönderici / irsaliye alanlarını içerir — SMTP, Logo İşbaşı kimlikleri, bildirim tercihleri dönmez.

Finans #

v1.23.0 — işletme giderleri vergiden önce: giderin KDV'si indirilecek KDV'ye, tutarı kâr vergisi matrahına girer (opex, opex_vat, operating_profit = pretax_profit − expenses, tax_total = vat_payable + tax_due, net = operating_profit − vat_payable − tax_due). Pazaryeri seçilmiş gider (ör. reklam) by_marketplace[] satırında da o pazaryerinden düşülür (expenses). Ek gönderiler özet alanları: extras_count, extras_total, extras_cost_missing, extra_cargo, extra_cogs; ayrıca cargo_unknown (kargo maliyeti bilinmeyen sipariş), loss_orders, returns_count, cancels_count.

Komisyon = sipariş tutarı × bağlantı ayarındaki oran (veya siparişe PUT /orders/{id} ile girilen commission); kargo = siparişe girilen cargo_cost › gönderi maliyeti › bağlantı ayarındaki ortalama; iptal/iade siparişler ciroya dahil edilmez.

İadeler (iade / değişim / iptal talepleri) #

Talepler her bağlantı için periyodik çekilir (sync_returns ayarı).

GET /returns #

Parametreler: status (requested,review,approved,rejected,in_transit,received,completed,cancelled), type (return|change|cancel), marketplace, updated_since, order_number, return_code (v1.27.0: iade kodu, ör. YRKN000002), page, size, include=items.

GET /returns/{id}?raw=1 — detay (kalemler, neden, müşteri, kargo) #

items[]: id, line_id, order_line_id, order_item_id, product_id, catalog_sku (v1.23.3: bağlı katalog ürününün kodu — pazaryeri iade satırında kendi kodunu verebilir, ör. Hepsiburada HBV…), name, sku, barcode, image, quantity, amount, reason, status, restock_qty (karara bağlanan adet), restocked_ok (stoğa giren adet), restock_remaining (karar bekleyen adet), restock_state ('' bekliyor · partial · ok · damaged · mixed · none (v1.23.11: stok değişmesin)), restock_note, restocked_at. v1.23.11: raflama açıksa karar bekleyen kalemde suggestion (önerilen raf: {code, location_id, reason, label, quantity, alternatives[]} — bkz. Raflama › Ürün nerede?); iadede restock_due_at (stok kararının beklenmeye başladığı an), restock_pending ("Stok kararı bekleyen" listesinde mi), restock_age_days (kaç gündür). Pazaryeri iade satırında ürün vermese bile (Koçtaş, Hepsiburada, Trendyol çoğu zaman sadece sipariş kalem kimliği verir) kalem sipariş kaleminden tamamlanır: ad, SKU, barkod, katalog ürünü, görsel.

POST /returns/{id}/{karar} — approve | reject | receive | pending #

Gövde: {"reason":"…","note":"…","items":["line_id"],"days":3,"restock":"yes|no"}. Yanıt {"decision":"approve","data":{…},"return":{…}}. restock: ürün elinize ulaşınca stoğa eklensin mi (yes sağlam / no hasarlı). Verilmezse ürün geri geldiğinde (received/completed) return.restock boş kalır ve panelde "stoğa girsin mi?" sorulur.

POST /returns/{id}/receive — "Teslim aldım" (v1.26.0). Gövde (hepsi isteğe bağlı): {"restock":"yes|no","notify":true|false,"message":"…","by":"Depo"}.

• Teslim alma her zaman burada kaydedilir (received_at, received_by) — pazaryeri kabul etmese de; stok kararı (restock) eskisi gibi uygulanır.
• Pazaryerinin kendi "teslim alındı" ucu varsa denenir (Koçtaş RT25, yalnız gerçek iade kimliğinde) → receipt_sync: "sent".
• Koçtaş iadeyi kendisi yönetiyorsa / iade modülü kapalıysa / kayıt sipariş hareketinden (refund rf:, şikâyet inc:) türediyse ve notify doğruysa

(verilmezse bağlantı ayarı "İade teslim alınınca Koçtaş operatörüne mesaj gönder", varsayılan açık) sipariş üzerinden operatöre mesaj yazılır: varsa siparişin operatörlü görüşmesine (M12), yoksa yeni sipariş görüşmesi (OR43) → receipt_sync: "message_sent", receipt_ref: "M12:{thread}/{message}". message boşsa bağlantı ayarındaki şablon ({siparis_no}, {urun}, {adet}, {tarih}) doldurulur; return.receipt_message önceden doldurulmuş metni verir.

• Bildirim istenmediyse / yapılamıyorsa receipt_sync: "local" (+ receipt_error: pazaryerinin gerekçesi, Türkçe); mesaj gönderilemediyse "failed".
• İptal kayıtlarında (type: cancel) mesaj gönderilmez (can_notify: false).

Yanıt: {"ok":true,"decision":"receive","receipt_sync":"sent|message_sent|local|failed","note":"…","error":null|"…","data":{…},"return":{…}}. publicReturn yeni alanlar: received_at, received_by, receipt_sync, receipt_error, receipt_ref, receipt_message, can_notify.

POST /returns/{id}/restock — kalem bazlı, adetli stok kararı #

{"items":[{"id":12,"quantity":2,"state":"ok","note":"2'si sağlam"},{"id":12,"quantity":1,"state":"damaged"},{"line_id":"ci-9","state":"skip"}],"note":"…"}

state: ok → adet kadar katalog stoğuna eklenir ve tüm pazaryerlerine yayılır (olay kaynağı {pazaryeri}_iade); damaged → stoğa girmez, işaretlenir; none (v1.23.11) → stok ve raf değişmez, kalem kapanır (ürün elinize geçmedi — kayıp kargo, ürünsüz para iadesi — ya da stok daha önce elle düzeltildi; "hasarlı" sayılmaz); skip → sonra. Tanınmayan state artık ok sayılmaz: 422 (v1.23.11). Raflama açıksa location (kalemde ya da üstte): raf kodu, RAFSIZ ya da auto (v1.23.11: ürünün önerilen rafı — durduğu raf → bu siparişte toplandığı raf → en son rafı → çeşit / kategori rafı; hiçbiri yoksa rafsız). Sağlam ürün o rafa fiziksel giriş yapar (return_in hareketi, stock.moved olayı). location boşsa ürünün sipariş için toplandığı raf, o da yoksa RAFSIZ kullanılır; yanıttaki items[].location nereye alındığını söyler. quantity verilmezse kalemin kalan adedi; kalanı aşan adet kırpılır; kısmi girişler birikir (restock_qty, restocked_ok). items verilmezse {"state":"ok"|"damaged"} tüm kalemlere uygulanır (eski {"restock":true|false} de kabul edilir). Sipariş iptalinde stok zaten geri verilmiş kaleme (order_items.applied = 2) tekrar eklenmez, uyarı döner; siparişe bağsız kalem önce siparişin kalemine bağlanmaya çalışılır (sipariş numarası + SKU/barkod). Yanıt: {"restocked":2,"done":true|false,"items":[{"id","sku","product_id","state","quantity","restocked","warning"}],"return":{…}}. Kapı (panel ile aynı): stok kararı zaten verilmiş (restocked_at dolu) ya da durumu approved / in_transit / received / completed olmayan iadede istek action_failed (422) ile reddedilir; message Türkçe gerekçedir ("Bu iade "Reddedildi" durumunda — ürün geri gelmeden stoğa alınamaz…"). İstisna: sipariş kalemi bulunamayan type = cancel kayıtlar (karar sahibinin). type = cancel kayıtlarda (ürün müşteriye gitmemiş iptal) stok sipariş kaleminden geri verilir: iptal kesinleşince bağlı sipariş kalemi bulunursa kalem hemen iptal edilir ve stok bir kez geri gelir (kayıt restock: no ile kapanır); sipariş bulunamazsa kayıt açık kalır ve panelde "İptal — sipariş kalemi bulunamadı, stok kararı sizde" diye sorulur. Onaylandı'da kalan (pazaryerinin "ürün ulaştı" demediği) iadeler onaydan 3 gün sonra "stoğa girsin mi?" listesine düşer.

GET /returns/pending-restock?limit=200 — stok kararı bekleyen iadeler (v1.23.11) #

Ürünü geri gelmiş (received / completed, cancel kayıtlarda karar sahibine kalan) ya da onaylanıp 3 gün geçmiş, stok kararı verilmemiş iadeler, en eskiden (restock_due_at). Yanıt: summary{count, web, total, overdue, oldest_days, oldest_at} (count: kararı burada verilecek pazaryeri iadeleri; overdue: 2 günü geçen; web: kararı web sitesinde verilen web iadesi), returns_open (onay / ret bekleyen talep sayısı), items[]: GET /returns/{id} biçiminde iade + kalemler (kalemde suggestion) ve due_since, age_days, pending_note (neden soruluyor), site_managed (web iadesi), can_restock, actions[] (hızlı karar: ok, damaged, none; web iadesinde yalnız none). ?summary=1: yalnız summary ve returns_open (menü sayısı / uyarı için hafif çağrı).

POST /returns/restock-bulk — hızlı / toplu stok kararı (v1.23.11) #

{"ids":[12,13],"state":"ok","location":"auto","note":""}

Seçilen iadelerin kalan bütün kalemlerine tek karar: state ok | damaged | none; location auto (varsayılan; kalem başına önerilen raf) | RAFSIZ | raf kodu. Her iade restock ucunun kapısından geçer (kararı verilmiş / ürünü gelmemiş iade atlanır, gerekçesiyle). Katalogda karşılığı olmayan kalemde ok reddedilir (stok eklenmeden kapanırdı); kalem bilgisi olmayan iade yalnız none ile kapanır; web sitesi iadesinde yalnız none (kararı sitenin teslim alma ekranında verilir). Yanıt: {"done":1,"failed":1,"restocked":2,"results":[{"id":12,"ok":true,"label":"Trendyol #…","error":null,"restocked":2,"done":true,"items":[…]},{"id":13,"ok":false,"error":"…"}],"summary":{…}}.

POST /orders/{id}/reactivate — iptalden çıkarma #

Web sitesi iptal edilmiş siparişi yeniden aktif ederse çağrılır. İptal edilmiş kalemler açılır, iptalde geri verilen stok tekrar düşülür (olay kaynağı {kanal}_yeniden), sipariş processing olur. İkinci çağrı ve iptal edilmemiş siparişte no-op (data.reactivated: 0). Yanıt: {"action":"reactivate","data":{"reactivated":1,"deducted":2,"note":"…"},"order":{…}}.

İade kodları — Yurtiçi'de otomatik takip (v1.27.0; ortak sıra v1.28.0) #

Web sitesi iade onaylayınca müşteriye bir iade kodu verir (YRKN000002, YRKN000003, … — sıra sitede artar). Müşteri paketi Yurtiçi şubesinden gönderirken kargo fişine / gönderi referansına "Sabit Cari 990148039 - YRKN000002" yazdırır (adres yok: alıcı Yurtiçi'de bu sabit cari hesabınızdır). Pazaryeri Merkezi Yurtiçi'nin müşteri rapor servisini (WsReportWithReferenceServices) periyodik tarar, kodu taşıyan gönderiyi bulur, takip numarasını / bağlantısını / durumu çeker ve iadeye yazar. Ayrıntılı tasarım: IADE-KODU.md; Yurtiçi servis notları: api-ref/yurtici-rapor.md.

Önkoşul: Kargo sayfasında Yurtiçi hesabı + panel › İade kodları sayfasında izleme açık, kod ön eki (varsayılan YRKN) ve sabit cari numarası girili. Hesap yoksa kod yine iadede durur; izleme açılınca eski kodlar kendiliğinden kayıt defterine alınır.

item alanları: code, state, state_label, tracking_number, tracking_url, parcel_count, parcels[{tracking_number, tracking_url, status, status_text, created_at, delivered_at}], status_text, cargo_status, cargo_status_label, seen_at, delivered_at, last_check_at, checks, last_error, return_id, source (site|wp|api|manual|scan), note, return_ref, sender_hint (kısaltılmış), sender_city, match_field.

Webhook: takip no / durum değişince bağlı iade için return.updated (reason: "return_code") gider; yalnız değişiklikte, döngü olmaz. Bildirim olayı: return.cargo (bildirim türü ayarlanabilir). Gizlilik: Yurtiçi'den gelen alıcı / gönderici adı, adres ve telefon saklanmaz; tanılama örneklerinde de görünmez (gönderici adı yalnız kısaltılmış ipucu).

Raflama — depo yerleşimi (raflar, fiziksel stok, toplama) #

Hesap başına açılıp kapanan özellik (PUT /settings/features {"shelves": true} ya da Ayarlar › Özellikler). Kapalıyken hiçbir davranış değişmez; /locations, /stock/* ve /orders/{id}/pick uçları 400 feature_disabled döner.

İki stok kavramı

fiziksel − toplanmayı bekleyen = satılabilir beklenir; difference alanı sapmayı verir. v1.22.1'den beri toplanmayı bekleyenin yalnız satılabilirden düşülmüş kısmı sayılır (pending_deducted; stoktan düşülmemiş geçmiş / "düşüm kapalı" sipariş kaleminin adedi zaten satılabilirin içindedir): difference = physical − pending_deducted − stock. Depoda olan her ürün satışa açıktır (v1.22.1): satılabilir stok yazımları depo kaydını da taşır (POST /stock › depo), sapma ürün sayfasındaki "Depodakini satışa aç" / "Satılabilir doğru → depo kaydını düzelt" ile tek tıkla kapatılır. Özellik açıldığında raf kaydı olmayan ürünlerin satılabilir stoğu RAFSIZ olarak yazılır (init hareketi); yeni ürünlerde de ilk stok rafsız başlar.

Sipariş akışı: sipariş gelir → kataloğa bağlı her kaleme raf önerisi yazılır (items[].locations, status: suggested; strateji: most en çok stoklu raf, least en az stoklu, code raf sırası; rafın müsait adedi = raf stoğu − diğer açık siparişlerin önerileri; raflar yetmezse RAFSIZ) → irsaliyede görselin altına raf adresleri basılır (R00-001 ×1, R00-002 ×2) → depo toplar ve toplama onaylanır (POST /orders/{id}/pick; önerilen raftan ya da başka raftan, kısmi olabilir) → o rafın fiziksel stoğu düşer (pick hareketi). Paket kontrolde barkod okutulunca (POST /orders/pack-check) ve kargoya verildiğinde toplanmamışsa öneri otomatik uygulanır (ayarlar shelves_pick_on_check, shelves_auto_pick). Toplanmamış kalem iptal edilirse öneri silinir (raf değişmez); toplanmış kalem kargoya verilmeden iptal edilirse ürün alındığı rafa geri yazılır (cancel_restore; raf silinmişse RAFSIZ); kargoya verilmiş siparişin ürünü iade akışıyla döner: "stoğa girsin mi?" sorulur, sağlam adet POST /returns/{id}/restock ile seçilen rafa girer (return_in; raf verilmezse ürünün toplandığı raf, o da yoksa RAFSIZ).

Ayarlar #

Raflar #

Raf stokları #

Hareketler #

Satılabilir stoğu değiştiren hareketler (receipt, consume, loss, adjust, return_in) ayrıca GET /events'e (type: movement, kaynak mal_girisi | sarf | kayip | sayim | raf_iade) düşer ve tüm pazaryerlerine yeni stok gönderilir. Her hareket stock.moved webhook olayı üretir.

Ürün nerede? · raf önerisi (v1.23.11) #

suggestion = ürünün konacağı rafın önerisi (mal girişi, iade girişi, rafsızdan yerleştirme): {code, location_id, reason, label, quantity, alternatives[]}. Sıra (reason): same_shelf ürünün stoklu durduğu raf (birden çoksa en çok adetli) → picked_shelf (iade kalemi) bu siparişte toplandığı raf → previous_shelf en son durduğu raf → variant aynı modelin (parent_sku) diğer çeşitlerinin rafı → category aynı kategorinin en yoğun rafı → none (code: null). Yalnız aktif raflar önerilir; label Türkçe gerekçedir.

Sipariş toplama #

Raf ekranı (raf okut → ürün okut → adet gir → işlem) #

Depocunun raf ekranı: raf etiketi okutulur, rafın içindekiler listelenir, ürün okutulur ve adet girilip dört işlemden biri seçilir. Panelde Raflar, WooCommerce eklentisinde Pazaryeri Merkezi › Raflar bu uçları kullanır.

Raf stoğu değiştiğinde (yerleştirme, mal girişi, transfer, sayım, iade girişi) o ürünü bekleyen açık siparişlerin rafsız kalmış raf önerileri kendiliğinden yeniden hesaplanır: rafsızken satılan ürün sonradan raflanınca sipariş yeni rafa bağlanır. Gerçek bir rafa bağlanmış öneriye dokunulmaz.

Depodan toplama (sipariş seçmeden — raf okut, ürün okut, adet gir) #

Depocunun ekranı: sipariş seçilmez. Okutulan adet, o ürünü bekleyen açık siparişlere en eskiden yeniye (FIFO) dağıtılır. Panelde Toplama menüsü, WooCommerce eklentisinde Pazaryeri Merkezi › Toplama bu uçları kullanır.

POST /stock/pick her satır için pick hareketi (GET /stock/movements?type=pick), geri alma unpick hareketi yazar; ikisi de stock.moved webhook'u üretir.

Web sitesi siparişleri (marketplace=web) #

Kendi e-ticaret sitenizden (WooCommerce, OpenCart, Shopify eklentisi ya da özel yazılım) gelen siparişler pazaryeri gibi kaydedilir; paketleme, kargo, irsaliye, fatura, iade işlemlerinin tamamı panelden/API'den yapılır ve webhook ile sitenize geri bildirilir.

Sipariş ek maliyetleri ve gelirleri (v1.23.0 — web sitesinin bildiği kâr kalemleri) #

Siparişin kârına giren ama sipariş / pazaryeri verisinde olmayan tutarlar. Kaynak (source, ör. site) başına tutulur; kaynak her gönderdiğinde o kaynağın satırları tamamen yenilenir (listede olmayan tür silinir). Tutarlar KDV dahil; vat_rate > 0 ise içindeki KDV indirilecek KDV'ye (maliyette) ya da satış KDV'sine (gelirde) girer.

Dönem raporunda (GET /finance/summary): other_costs, other_costs_vat, other_costs_by_kind[] {kind, label, amount, vat, count}, income_by_kind[] {kind, label, amount, count} (iade / iptal payı düşülmüş), fee_lines[] içinde "Ödeme komisyonu (web sitesi)". Sipariş kârlılığında (/finance/orders) satırda payment_fee, other_costs; ürün kârlılığında ek maliyet kalemlere ciro payıyla dağıtılır.

Siparişi platformdan silme (iptal DEĞİL) #

DELETE /orders/{id}?purge=1 — sipariş hiç gelmemiş gibi silinir; pazaryerine hiçbir bildirim gönderilmez (iptal isteği yok). Yeniden test için ve yanlış düşen kayıtları temizlemek için.

• düşülen satılabilir stok geri yüklenir → tüm pazaryerlerine ve sitenize yeni stok gider (stock.changed, GET /events)
• toplanmışsa fiziksel adet alındığı rafa geri yazılır
• siparişin stok hareketleri (GET /stock/movements?order_id=), raf önerileri, kalemleri, işlem geçmişi ve faturaları silinir
• &ignore=1 → sipariş "yok say" listesine eklenir, bir daha çekilmez. Verilmezse sonraki senkronda pazaryerinden tekrar gelir: silme sırasında bağlantının senkron imleci (orders_cursor) siparişin tarihine geri sarılır ve orders_refresh_at temizlenir, böylece sonraki tur tam pencereyi tarar. Sipariş pazaryerinin geriye dönük penceresinden eskiyse yanıttaki reimport alanı bunu söyler (canlı çekim getiremez, "Geçmişi çek" gerekir).
• Yanıt: {deleted, stock_restored, shelf_restored, movements_deleted, ignored, reimport}. Kargoya verilmiş kendi gönderiniz varsa 422 (önce gönderiyi iptal edin). Webhook: order.deleted.
• purge verilmezse manuel gönderi / web siparişi için eski davranış (kargo iptali + stok iadesi) geçerlidir.

Giden webhook'lar (sitenize POST) #

Teslimat: POST {url} gövde {"event":"order.created","created_at":"…","account_id":1,"data":{"order_id":12,"order_number":"WC-1001","marketplace":"web","order":{…tam sipariş, items dahil…}}}; başlıklar Content-Type: application/json, X-Bayir-Event, X-Bayir-Delivery (teslimat id), X-Bayir-Signature: sha256=HMAC_SHA256(gövde, secret), User-Agent: {Marka}-Webhook/2.0 (marka adı Yönetim › Marka ve kimlik ekranından). 2xx dışı yanıt ya da zaman aşımında 60 sn, 5 dk, 15 dk, 1 sa, 2 sa, 6 sa, 12 sa, 24 sa sonra yeniden denenir (8 deneme); 50 ardışık hatada uç nokta pasife alınır. Aynı teslimat id tekrar gelebilir → sitenizde idempotent işleyin.

PHP doğrulama örneği:

$body = file_get_contents('php://input');
$sig  = $_SERVER['HTTP_X_BAYIR_SIGNATURE'] ?? '';
if (!hash_equals('sha256=' . hash_hmac('sha256', $body, $secret), $sig)) { http_response_code(401); exit; }
$evt = json_decode($body, true); // $evt['event'], $evt['data']['order']
http_response_code(200);

Hesap kullanıcıları ve roller #

Roller panel içindir; API anahtarları her zaman hesap sahibi yetkisiyle çalışır. Ek anahtarlar API sayfasından (kanal etiketiyle) üretilir.

Kârlılık: kesintiler, ürün maliyeti, desi tarifesi #

Kâr formülü (KDV dahil): payout = gross − commission_incl − fees_incl − stopaj → pretax_profit = payout − other − cargo − cogs (v1.23.0: other = sipariş ek maliyetleri, ör. satış ortaklığı; gross web siparişinde müşteriden alınan kargo ücreti ve kapıda ödeme bedelini de içerir) → (dönem raporunda) operating_profit = pretax_profit − opex → vat_payable = sale_vat − (commission_vat + fees_vat + other_vat + cargo_vat + cogs_vat + opex_vat) → profit_tax = max(0, operating_profit − vat_payable + stopaj) × oran → profit = operating_profit − vat_payable − (profit_tax − stopaj). Siparişte opex 0'dır. İade: ciro/KDV geri, komisyon (+KDV) + refund işaretli kalemler + stopaj geri, gidiş + dönüş kargosu maliyet, stoğa giren ürün gider değil, hasarlı ürün maliyeti gider; iptalde her şey geri (sonuç 0).

Hız sınırı #

Her API anahtarı için dakikalık limit (varsayılan 300, API sayfasından anahtar başına ayarlanır); yanıtta X-RateLimit-Limit, aşımda 429 + Retry-After. Pazaryeri tarafına giden istekler bağlantı başına pencerelenir (ör. Trendyol 40 istek / 10 sn) — limit dolunca istek reddedilmez, kısa süre bekletilir.

Kural bazlı fiyatlama #

Gelen webhook'lar (pazaryeri → biz) #

Adres {base}/hook/trendyol/{token} ya da {base}/hook/hepsiburada/{token}; Hepsiburada adresi Basic auth (kullanıcı = token, şifre = secret) ile HB destek ekibine "base URL" olarak verilir.

Bildirimler #

Tarayıcı push bildirimleri panelden (zil menüsü) açılır; olaylar ayrıca GET /orders?updated_since= ve webhook ile izlenebilir.

Müşteri soruları #

Okunmamış mesajlar (v1.26.0): her yeni GELEN mesaj (müşteri ya da Koçtaş operatörü — cevap gereksin gerekmesin, operatörün "bilgi" notu dahil) last_in_at yazar, read_at boşalır (unread: true), question.new bildirimi + question.created webhook'u üretir. reply_needed (yalnız Koçtaş): pazaryeri mağaza cevabı bekliyor mu (false = bilgi notu; status o zaman answered kalır, soru "Cevap bekleyen"de değil "Okunmamış" / "Koçtaş operatörü"nde görünür). last_from: son mesajı kim yazdı (customer | operator | shop). Diğer pazaryerlerinde yeni soru last_in_at = asked_at ile okunmamış başlar.

Pazaryerinde zaten cevaplanmış (v1.26.0): answer_state: "remote" — soru pazaryerinde (panel / uygulama / başka araç) cevaplanmıştı; pazaryerinin cevabı answera çekildi, answered_at pazaryerinin tarihi, answer_error boş. Hata değildir; gri not olarak gösterin. Bizim gönderemediğimiz metin Kayıtlar'da (answers kanalı) durur. Cevap gönderimi "zaten cevaplandı" hatası alınca (Trendyol business.rule.question.has.already.answered) ya da işçinin uzlaştırma adımı (takılı / 13 günden eski bekleyen sorular, 6 saatte bir, tek soru sorgusu: Trendyol GET …/questions/{id}, İdefix GET …/question/{id}, N11 GetProductQuestionDetail) pazaryerinin durumunu alır. Süresi dolan / reddedilen sorular status: closed olur.

Çiçeksepeti sipariş sohbetleri (v1.26.0): Çiçeksepeti'nin "satıcıya sor" sipariş soruları (GET /api/v1/chats) da soru listesine gelir: remote_id = oc:{chatId}, product_name = "Sipariş #… · ürün adı", customer = "Müşteri" ya da "Çiçeksepeti müşteri temsilcisi" (chatType 2). Görüşme alanları Koçtaş'taki gibi doludur (from, order_number/order_id, messages[], reply_to, recipients); cevap POST /questions/{id}/answer {"text":…} ile sohbete mesaj olarak gider (dosya eki henüz desteklenmez). Sohbet kapanmışsa (isActive=false) kayıt closed olur. Çiçeksepeti ürün sorusunda cevap türü: to=customer → cevap yalnız soran müşteriye gider, sitede yayınlanmaz (Çiçeksepeti branchActionId 2, alt tür "Diğer"); to boş → soru ve cevap sitede yayınlanır (1). "Uygunsuz içerik" (3) ve "başka satıcıya ait soru" (4) işlemleri Çiçeksepeti satıcı panelinden yapılır.

Koçtaş (Mirakl) görüşmeleri (v1.23.10): Koçtaş'ta "soru" bir görüşmedir — müşteri ve Koçtaş operatörü aynı konuya defalarca yazabilir. Konu başına tek kayıt vardır: question son gelen (müşteri / operatör) mesaj, answer mağazanın son mesajı. Görüşmeye yeni mesaj gelince kayıt yeniden status: waiting olur (önceki cevabımız gönderilmişse answer_state sıfırlanır) ve question.new bildirimi / question.created webhook'u yeniden gelir (followup: true). Ek alanlar (diğer pazaryerlerinde null / boş):

Bildirim / webhook verisi (question.new → question.created): marketplace, question, product, question_id + Koçtaş'ta from, order_number, customer_visible, yeni mesajda followup: true. Bildirim başlığı: "Koçtaş operatör mesajı · #sipariş", "Koçtaş müşteriden yeni mesaj", "Koçtaş yeni müşteri sorusu".

Soru desteği: Trendyol, Hepsiburada, N11, Çiçeksepeti, İdefix, Koçtaş (Mirakl mesajları). Pazarama ve PttAVM API'lerinde soru uç noktası yoktur.

Stok olayları (çift yönlü senkron) #

Pazaryerinde sipariş oluşunca stok düşülür, diğer pazaryerlerine yeni stok gönderilir ve üyeye olay üretilir.

Webhook alternatifi: Ayarlar › Webhook adresi. Olaylar X-Bayir-Signature: sha256=HMAC-SHA256(gövde, gizli anahtar) ile POST edilir; 2xx yanıt onay sayılır, başarısızlar artan aralıklarla yeniden denenir.

Satılabilir stoğu değiştiren her şey buradan akar: sipariş düşümleri, iptal / iade geri girişleri, raflama hareketleri (mal girişi, sarf, kayıp, sayım) ve "red → stok sıfırlama". Fiziksel (raf) hareketlerinin tamamı ise GET /stock/movements ve stock.moved webhook olayında.

WordPress eklentisi güncellemesi #

WooCommerce eklentisi kendi güncellemesini bu iki uçtan alır; WordPress'in Eklentiler sayfasında "Güncelleme var" uyarısı çıkar ve tek tıkla kurulur. Paketi WordPress.org değil, bu sunucu dağıtır.

GET /plugin/wordpress — yayındaki sürüm #

{"success":true,"plugin":{
  "slug":"bayir-pazaryeri","name":"Pazaryeri Merkezi","available":true,
  "version":"1.9.1","requires":"6.0","tested":"6.7","requires_php":"7.4","requires_wc":"7.0",
  "download_url":"https://app.bayircommunity.com/api/v1/plugin/wordpress/download",
  "changelog":"* ...","released_at":"2026-09-19 23:03:21",
  "sha256":"60db37d3…","size":375055,
  "homepage":"https://app.bayircommunity.com/docs","author":"Platformunuzun adı"}}

Yayında sürüm yoksa available:false ve version:"0.0.0" döner (kurulu her sürüm bundan büyüktür, yani güncelleme uyarısı çıkmaz).

GET /plugin/wordpress/download — paketi indir #

Content-Type: application/zip, Content-Disposition: attachment; filename="bayir-pazaryeri-1.9.1.zip", X-Checksum-SHA256 ve X-Plugin-Version başlıklarıyla döner. API anahtarı zorunludur; anahtarsız istek 401 alır. Sunucu, dosyayı göndermeden önce SHA-256 özetini yeniden hesaplar; tutmazsa 409 (corrupt_package) döner. Her başarılı indirme sayaca işlenir.

Her iki uç da salt okuma olduğu için aboneliği bitmiş hesaplarda da çalışır: güvenlik yaması kimseye kapatılmaz (yazma işlemleri zaten 402 ile kilitlidir).

Sürümleri panelden yönetirsiniz: Yönetim › WordPress eklentisi (?p=wpplugin).

Eski eklenti uyumluluğu #

/{pazaryeri}/status, /{pazaryeri}/sync/stock, /{pazaryeri}/questions, /{pazaryeri}/orders, /{pazaryeri}/returns (trendyol, hepsiburada, n11, pazarama, ciceksepeti, idefix, koctas, pttavm).

Entegrasyon örnekleri #

Kendi e-ticaret yazılımı (PHP) #

$api = fn(string $m, string $p, array $b = []) => json_decode(file_get_contents('https://app.bayircommunity.com/api/v1' . $p, false, stream_context_create(['http' => [
    'method' => $m, 'header' => "X-Api-Key: bc_live_XXX\r\nContent-Type: application/json\r\n", 'content' => $b ? json_encode($b) : null, 'ignore_errors' => true]])), true);

$api('POST', '/stock', ['items' => [['sku' => 'KOLTUK-01', 'stock' => 12, 'price' => 4599.90]]]);
$new = $api('GET', '/orders?status=new&include=items');
$api('POST', '/orders/15/shipment', ['account_id' => 1, 'parcel_count' => 2]);   // kendi Yurtiçi hesabınızla gönderi
file_put_contents('irsaliye.pdf', file_get_contents('https://app.bayircommunity.com/api/v1/orders/15/packing-slip.pdf', false, stream_context_create(['http' => ['header' => "X-Api-Key: bc_live_XXX\r\n"]])));
$api('POST', '/orders/16/ship', ['cargo_company' => 'Yurtiçi', 'tracking_number' => '1234567890']); // pazaryeri anlaşmalı kargo
$ev = $api('GET', '/events?unacked=1');           // pazaryeri satışlarını kendi stoğunuza uygulayın
$api('POST', '/events/ack', ['up_to_id' => $ev['last_id']]);

WooCommerce eklentisi (hazır): Pazaryeri Merkezi #

bayir-pazaryeri.zip — WordPress › Eklentiler › Yeni ekle › Eklenti yükle. Kurulunca Pazaryeri Merkezi › Ayarlar'a API anahtarı girilir; eklenti bağlantıyı test eder, webhook'u kaydeder (POST /webhooks tüm olaylar + PUT /settings/stock-webhook) ve ilk senkronu başlatır. v1.5.1: Sipariş kutusunda "Siparişi platformdan sil" (iptal değil — pazaryerine bildirilmez; stok ve raf adedi geri yüklenir, WooCommerce siparişi çöpe taşınır, isteğe bağlı "bir daha çekilmesin"). Raf ekranlarında "yine de düş" kaldırıldı (raf eksiye düşmez; yetersizse Sayım önerilir) ve eksiye düşmüş kayıtlar için Sıfırla düğmesi. Sipariş listesinde Trendyol "Onay bekliyor — işlem yapmayın" uyarısı.

v1.5.0: Raflar sayfası Toplama ile aynı mantıkta yeniden yazıldı (telefon için): raf okut → ürün okut → adet gir → Rafa koy / Mal girişi / Çıkar / Sayım; rafın içindekiler görselli listede, satırdan ürün seçme ve başka rafa taşı, her işlemde Geri al. Raf seçicilerinde ve ürün alanında kamera. Toplu stok işlemleri aynı telefon düzenine geçti (büyük alanlar, kamera, raf etiketini okutup raf seçme, satırlar kart görünümü). Düzeltmeler: "Rafa yerleştir" seçilince hedef raf alanının gizlenmesi (hareket hiç işlenmiyordu).

v1.4.0: Toplama ve Paket kontrol ayrı menüler oldu (telefon için tek sütun ekran). Toplama sipariş seçmez: raf okut → ürün okut → adet gir (GET /stock/pick/queue, POST /stock/pick, POST /stock/pick/undo); kısmi toplama, satır satır geri alma, raf seçili kalır. Paket kontrol artık toplama yapmaz (pack-check pick:false; eski davranış Ayarlar › Özellikler'den açılabilir). Sipariş ekranındaki toplama kutusu kaldırıldı, yerine durum rozeti + Toplama bağlantısı kondu. Ürün detayında 🏷 Barkod etiketi: adet + düzen seçip önizleme / yazdırma / PDF (GET /products/{sku}/labels(.pdf)).

v1.3.0: Siparişler sayfası panelin sipariş ekranıyla aynı güçte — kontrol kartları (hazırlanacak, ⚠ etiketi basılmamış, paketi kontrol edilmemiş, maliyeti eksik, kargoda), pazaryeri / tarih / arama / paket kontrol filtreleri, satıra tıklayınca sipariş içeriği (ürünler, kodlar, adet, fiyat, adet başına maliyet), teslimat ve fatura adresi, raftan toplama ve tüm işlem düğmeleri; satır içinde koli / desi ve irsaliye dağılımı (PUT /orders/{id}), barkodla paket kontrol (POST /orders/pack-check). Ürünler sayfasında pazaryerine özel kod / fiyat düzenleme (PUT /products/{sku}/links, PUT /products/{sku}/prices, POST /products/{sku}/resend). Paket kontrol, toplu stok işlemleri ve aramalarda kamerayla barkod okuma (harici kütüphane yok; BarcodeDetector yoksa yerleşik EAN-13 / EAN-8 / UPC-A / Code-128 çözücüsü). İrsaliyeler profile=key ile basılır: her site kendi logosuyla.

v1.1.0'dan itibaren panelde ne varsa eklentide de var ve hiçbir form sayfayı yenilemez (AJAX): Ayarlar sekmeleri — Bağlantı, Senkron, Siparişler & müşteriler, Gönderici & irsaliye (siteye özel profil + "WooCommerce'den doldur" + ortam kütüphanesinden logo), Kesintiler & vergi (/settings/tax, /settings/web-fees, /connections/{id}/fees), Kargo & desi (/settings/cargo-rates, /cargo/carriers, /cargo/accounts), e-Fatura & e-posta (/settings/invoicing + test düğmeleri), Özellikler & bildirimler, Webhook; ayrı sayfalar — Pazaryerleri (bağlantı ekle/düzenle/test/çek/teşhis/sil), Faturalar (/invoices, tekrar dene / iptal / e-postala + fatura kesilmemiş siparişlere toplu e-Fatura), Kargo gönderileri (/shipments, sorgula / iptal), Siparişler (toplu e-Fatura, toplu irsaliye, paketle, kargo gönderisi, teslim — POST /orders/bulk, GET /orders/packing-slips) ve WooCommerce sipariş listesi toplu işlemleri. Bu API'nin tamamını kullanır: ürün / stok / fiyat / içerik gönderimi (POST /products, WooCommerce'te stok değişince anında), pazaryeri siparişlerini WooCommerce siparişi olarak kaydetme (GET /orders, webhook), müşteri kaydı (isteğe bağlı, pazaryeri adıyla), sipariş işlemleri (paketle / kargo bildir / teslim / iptal / fatura / gönderi / irsaliye / paket kontrol / raftan toplama), site siparişlerini POST /orders/web ile gönderme, stok olayları (GET /events + POST /events/ack, stock.changed), raflama (raflar, mal girişi, rafa yerleştirme, transfer, sarf, kayıp, sayım, iade girişi; ürün sayfasında raf dağılımı ve tüm hareket geçmişi), iadeler (karar + kalem bazlı stoğa alma, raf seçimli), sorular (cevaplama), finans (dönem özeti, sipariş kârlılığı, giderler — WordPress veritabanında saklanır). Kurulum adımları eklenti içindeki KURULUM.md dosyasındadır.

Kendi eklentiniz (OpenCart / Shopify / özel yazılım) #

Eklenti tarafında yapılacaklar: ürün/stok değişince POST /stock (veya POST /products); sitede sipariş oluşunca POST /orders/web (external_id = site sipariş no); sipariş durumu/takip numarası için sitenin bir adresine giden webhook (POST /webhooks → order.shipped, order.delivered, order.cancelled) ya da periyodik GET /orders?updated_since=; pazaryeri satışlarının site stoğuna yansıması için GET /events → mağaza stoğu güncelleme → POST /events/ack (ya da stock.changed webhook'u). Her eklenti için API sayfasından kanal etiketli ayrı anahtar üretin.