Market API Entegrasyon Şablonu
Market işletmeleri, ürün kataloglarını aşağıdaki standart şablonla gönderebilir. Şablon farklı yazılımların (ERP, kasa, stok programı) farklı kod ve alan adlarını kabul edecek şekilde tasarlandı: her alan için alternatif adlar otomatik tanınır.
Uç nokta
POST https://paketpaket.base44.app/api/market/urunler
Kimlik doğrulama: her isteğe x-api-key başlığıyla entegrasyon anahtarınızı ekleyin. Anahtar, yöneticiden talep edin. Uç noktanın çalıştığını görmek için aynı adrese GET isteği gönderebilirsiniz.
curl -X POST https://paketpaket.base44.app/api/market/urunler \
-H "Content-Type: application/json" \
-H "x-api-key: <ANAHTARINIZ>" \
-d @urunler.json
Standart şablon
{
"market": { "kod": "MK-IST-001" },
"urunler": [
{
"ref": "STK-88123", // marketin kendi ürün kodu (zorunlu)
"barkod": "8690000000000", // EAN-13 / UPC barkod (opsiyonel)
"plu": "4011", // PLU kodu — taze ürün (opsiyonel)
"tedarikci_kod": "SUP-77", // tedarikçi / depo kodu (opsiyonel)
"ad": "Tam Yağlı Süt 1 L", // ürün adı (zorunlu)
"marka": "Pınar",
"kategori": "Süt & Kahvaltılık",
"birim": "adet", // adet | kg | gr | lt | paket
"gramaj": 1000, // net gramaj (gram)
"ambalaj": "şişe", // ambalaj tipi
"ambalaj_adet": 6, // ambalaj / koli içi adet
"fiyat": 32.5, // satış fiyatı ₺ (zorunlu)
"kdv": 1, // KDV oranı %: 1 | 8 | 10 | 20
"stok": 120,
"aktif": true
}
]
}
Şablon örnektir; yorumları (`//`) gönderilen gerçek istekte yer almaz. Zorunlu alanlar dışında istediğiniz alanı boş bırakabilir veya hiç göndermeyebilirsiniz.
Alan açıklamaları
| Alan | Zorunluluk | Açıklama | Kabul edilen alternatif adlar |
|---|---|---|---|
| market.kod | Zorunlu | Yöneticinin işletmenize atadığı entegrasyon kodu | code, market_kod, vendor_code |
| urunler | Zorunlu | En fazla 500 ürün içeren dizi; kalanı yeni istekle gönderilir | items, products |
| ref | Zorunlu | Marketin kendi ürün kodu — sistemde benzersiz kimlik olarak kullanılır | code, external_id, urun_kod, stok_kod, product_code, sku |
| ad | Zorunlu | Ürün adı (en fazla 120 karakter) | name, urun_adi, title |
| fiyat | Zorunlu | Satış fiyatı (₺) — 0'dan büyük | price, satis_fiyati, sale_price |
| barkod | Opsiyonel | EAN-13 / UPC barkod | barcode, ean, gtin |
| plu | Opsiyonel | PLU kodu — tartı/taze ürün kodları | plu_code |
| tedarikci_kod | Opsiyonel | Tedarikçi veya depo ürün kodu | supplier_code, supplier_ref |
| marka | Opsiyonel | Marka adı | brand |
| kategori | Opsiyonel | Marketin kendi kategori adı | category, category_name |
| birim | Opsiyonel | Satış birimi: adet, kg, gr, lt, paket (varsayılan: adet) | unit, sale_unit |
| gramaj | Opsiyonel | Net gramaj — gram cinsinden (1 kg = 1000) | net_weight_g, net_gram, weight |
| ambalaj | Opsiyonel | Ambalaj tipi — şişe, kutu, koli, doypack… | pack_type, packaging |
| ambalaj_adet | Opsiyonel | Ambalaj / koli içindeki ürün adedi | pack_count, pack_qty, pack_size |
| kdv | Opsiyonel | KDV oranı (%): 1, 8, 10 veya 20 (varsayılan: 1) | vat, vat_rate, kdv_orani |
| stok | Opsiyonel | Stok adedi (varsayılan: 0) | stock, quantity |
| aktif | Opsiyonel | Ürün satışta mı (varsayılan: true) — false gelen ürün vitrinden kalkar | active, on_sale |
Yanıt
{
"sonuc": "ok",
"market": "Örnek Market",
"kabul": 2,
"hatali": 0,
"hatalar": [],
"urun_yeni": 2,
"urun_guncellendi": 0
}
HTTP kodları: 200 işlem alındı · 401 geçersiz anahtar · 404 market kodu tanımlı değil · 400 şablon hatası.
Kurallar
- API'den gelen yeni ürünler yönetici onayından geçtikten sonra vitrinde yayınlanır.
- Mevcut ürünlerde fiyat, stok ve satış durumu güncellemeleri anında vitrine yansır.
aktif: falsegelen ürünler vitrinden kaldırılır, kaydı korunur.- Aynı
reftekrar gönderilirse ürün güncellenir — kopya oluşmaz. - İstek başına en fazla 500 ürün gönderin; daha büyük kataloglar parçalı gönderilir.