Tedarikci API entegrasyonu

API-first tedarik modeli

Profesyonel tedarikci kendi sisteminden bize veri gonderir

Bu yontemde tedarikciye API anahtari verilir. Tedarikci kendi ERP, e-ticaret sitesi veya entegrasyon yazilimindan urunleri, stoklari, fiyatlari ve kargo durumlarini dogrudan Sosyal Tedarik sistemine aktarir.

Profesyonel kanal

API endpointleri

POST/api/v1/supplier/products

Urun olustur veya guncelle

SKU/barkod bazli urun, kategori, fiyat, minimum satis fiyati, gorsel ve varyant verisi gonderilir.

PATCH/api/v1/supplier/stock

Varyant stok guncelle

Renk, beden, SKU ve stok miktari ile merkezi stok anlik guncellenir.

PATCH/api/v1/supplier/prices

Tedarikci fiyatini guncelle

Ham tedarik bedeli ve minimum satis bariyeri guncellenir; satici fiyatlari bariyere gore kontrol edilir.

GET/api/v1/supplier/orders

Tedarikci siparislerini cek

Saticilarin onayladigi tedarik siparisleri tedarikcinin sistemine aktarilir.

PATCH/api/v1/supplier/orders/{orderId}/shipment

Kargo durumunu guncelle

Kargo firmasi, takip numarasi, sevk fotografi ve durum bilgisi satici paneline yansitilir.

Urun gonderme ornegi

{
  "externalProductId": "ML-10045",
  "sku": "ELBISE-EKRU-M",
  "barcode": "8680000001045",
  "title": "Cicek Desenli Poplin Elbise",
  "description": "Yazlik, hafif dokulu, astarli poplin elbise.",
  "categoryPath": ["Giyim", "Kadin Giyim", "Elbise"],
  "productType": "Yazlik elbise",
  "supplierPrice": 820,
  "minimumSalePrice": 1050,
  "currency": "TRY",
  "brandName": "",
  "brandUsageType": "unbranded",
  "isReplica": false,
  "images": [
    "https://tedarikci.com/images/elbisem.jpg"
  ],
  "variants": [
    {
      "sku": "ELBISE-EKRU-M",
      "barcode": "8680000001045",
      "color": "Ekru",
      "size": "M",
      "stockQuantity": 12
    }
  ],
  "deliveryRegions": ["TR"],
  "preparationTimeDays": 2
}

Stok guncelleme ornegi

{
  "sku": "ELBISE-EKRU-M",
  "barcode": "8680000001045",
  "stockQuantity": 8,
  "updatedAt": "2026-05-21T10:30:00+03:00"
}

CSV / Excel sablonu

Excel yuklemeleri bu basliklarla okunur. Ayni urunun farkli varyantlari ayri satir olarak gelir; sistem urunu externalProductId ile tek kartta toplar.

externalProductId,sku,barcode,title,description,category1,category2,category3,productType,supplierPrice,minimumSalePrice,currency,brandName,brandUsageType,isReplica,image1,image2,variantSku,variantBarcode,color,size,stockQuantity,preparationTimeDays
ML-10045,ELBISE-EKRU-M,8680000001045,Cicek Desenli Poplin Elbise,"Yazlik hafif dokulu astarli poplin elbise",Giyim,Kadin Giyim,Elbise,Yazlik elbise,820,1050,TRY,,unbranded,false,https://tedarikci.com/images/elbisem.jpg,,ELBISE-EKRU-M,8680000001045,Ekru,M,12,2
ML-10045,ELBISE-EKRU-L,8680000001046,Cicek Desenli Poplin Elbise,"Yazlik hafif dokulu astarli poplin elbise",Giyim,Kadin Giyim,Elbise,Yazlik elbise,820,1050,TRY,,unbranded,false,https://tedarikci.com/images/elbisem.jpg,,ELBISE-EKRU-L,8680000001046,Ekru,L,8,2

XML sablonu

XML baglantisinda da kategori yolu, marka durumu, fiyat bariyeri ve varyant stogu ayni standartla beklenir.

<products>
  <product>
    <externalProductId>ML-10045</externalProductId>
    <title>Cicek Desenli Poplin Elbise</title>
    <description>Yazlik hafif dokulu astarli poplin elbise.</description>
    <categoryPath>
      <level1>Giyim</level1>
      <level2>Kadin Giyim</level2>
      <level3>Elbise</level3>
    </categoryPath>
    <productType>Yazlik elbise</productType>
    <supplierPrice currency="TRY">820</supplierPrice>
    <minimumSalePrice currency="TRY">1050</minimumSalePrice>
    <brandName></brandName>
    <brandUsageType>unbranded</brandUsageType>
    <isReplica>false</isReplica>
    <images>
      <image>https://tedarikci.com/images/elbisem.jpg</image>
    </images>
    <variants>
      <variant>
        <sku>ELBISE-EKRU-M</sku>
        <barcode>8680000001045</barcode>
        <color>Ekru</color>
        <size>M</size>
        <stockQuantity>12</stockQuantity>
      </variant>
    </variants>
    <preparationTimeDays>2</preparationTimeDays>
  </product>
</products>

Marka, replika ve telif politikasi

Replika urun yasak

Tedarikci replika, cakma, muadil marka gibi telif riski tasiyan urunleri sisteme ekleyemez.

Marka yetkisi zorunlu

Markali urun ekleyen tedarikci fatura, distribitorluk veya satis yetki belgesi sunabilmelidir.

Riskli urun incelemeye duser

Marka adi, logo, lisansli karakter veya supheli ifade gecerse urun otomatik taslakta tutulur.

Siparis akisi API ile nasil calisir?

Satici siparisi onaylar

Merkezi stok atomik olarak rezerve edilir

Siparis tedarikci API kuyruguna duser

Tedarikci kargo durumunu API ile geri bildirir