Pazarama entegrasyonu, Pazarama'da satış yapan mağazanın ürün, stok, fiyat, sipariş, kargo, iade, fatura ve soru-cevap işlemlerini Pazarama İş Ortağım API'siyle yazılımdan yönetmesidir. Belgeler, giriş gerektirmeyen resmî entegrasyon portalında yayımlanıyor.
İlgili içerikler: Pazaryeri entegrasyonu rehberi · Çiçeksepeti entegrasyonu · n11 entegrasyonu
API Bilgileri ve Token
- Bilgilerin yeri: Satıcı panelinde Hesap Bilgileri, Entegrasyon Bilgileri.
- Yenileme: "Yeni API Key Üret" ile yeni anahtar alınır; bilgi ekranda yalnızca bir kez gösterilir ve eski anahtar anında iptal olur.
- Token:
POST https://isortagimgiris.pazarama.com/connect/tokenadresine form verisiylegrant_type=client_credentialsvescope=merchantgatewayapi.fullaccessgönderilir; clientId ve clientSecret Basic Auth ile iletilir. - Geçerlilik: Token 1 saat geçerlidir. Servis adresi
https://isortagimapi.pazarama.com.
curl -X POST https://isortagimgiris.pazarama.com/connect/token \
-u "CLIENT_ID:CLIENT_SECRET" \
-d grant_type=client_credentials \
-d scope=merchantgatewayapi.fullaccessServis Sınırları
| İşlem | İstekler arası süre | İstek başına |
|---|---|---|
| Stok ve fiyat | 10 saniye | En çok 3.000 ürün; sonuç en geç 4 saatte yansır |
| Ürün ekleme | 10 saniye | En çok 500 ürün |
| Fiyat kilitleme | En çok 1.000 ürün |
Ürün Servisleri
| İşlem | Uç nokta |
|---|---|
| Markalar | GET /brand/getBrands |
| Kategori ağacı | GET /category/getCategoryTree (ürün yalnızca son seviye kategoriye açılır) |
| Kategori özellikleri | GET /category/getCategoryWithAttributes?Id= |
| Ürün ekleme | POST /product/create |
| Toplu işlem sonucu | GET /product/getProductBatchResult?BatchRequestId= |
| Fiyat güncelleme | POST /product/updatePrice-v2 |
| Stok güncelleme | POST /product/updateStock-v2 |
| Onaylı ve onaysız ürünler | GET /product/products/approved, /unapproved |
Ürün eklemede zorunlu alanlar: Name (en çok 100 karakter), DisplayName (en çok 250), Description, BrandId, Desi, Code (barkod), GroupCode, StockCount, StockCode, VatRate, ListPrice, SalePrice, CategoryId, Attributes ve görsel adresleri.
Toplu işlem sonucu 1 (devam ediyor), 2 (tamamlandı) veya 3 (hata) döner ve 4 saate kadar sorgulanabilir; hata nedeni başarısız ürünler listesinde yer alır. Belgeye göre yüzde 70'lik indirimlerde fiyat önce onaya düşer.
Sipariş Akışı
| Kod | Durum |
|---|---|
| 3 | Alındı |
| 12 | Hazırlanıyor |
| 5 | Kargoya Verildi |
| 11 | Teslim Edildi |
| 14 | Teslim Edilemedi |
| 13 | Tedarik Edilemedi |
| 6 | İptal |
| 7-10 | İade süreci, onay, ret ve iade edildi |
- Siparişler
POST /order/getOrdersForApiile çekilir; tarih aralığı en çok 1 ay. - Durum ve kargo takip bilgisi
PUT /order/updateOrderStatusile bildirilir. - Sipariş önce 12 (Hazırlanıyor) durumuna alınmadan kargo kaydı açılamaz.
- Pazarama anlaşmalı kargoda sonraki durumlar otomatik ilerler; anlaşma yoksa satıcı durumu 5'e kendisi çeker.
İade, İptal, Fatura ve Sorular
| İşlem | Uç nokta |
|---|---|
| İade listeleme ve güncelleme | POST /order/getRefund, POST /order/updateRefund (2 onay, 3 ret) |
| İptal talepleri | POST /order/api/cancel/items, PUT /order/api/cancel |
| Fatura bağlantısı | POST /order/invoice-link |
| Soru yanıtlama | PUT /QuestionAnswer/sellerAnswer |
Sık Sorulan Sorular
Pazarama token ne kadar geçerli?
1 saat. Scope değeri merchantgatewayapi.fullaccess.
Ürünün eklendiğini nasıl anlarım?
Dönen toplu işlem numarasıyla sonuç servisini sorgulayın; hata nedenleri başarısız ürünler listesinde yer alır.
Pazarama'da test ortamı var mı?
Entegrasyon portalında bir test ortamı tanımı bulunamadı. Test imkânını Pazarama'ya sorun.
Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.