İstek gövdesi
| Alan | Anlamı | Örnek |
|---|---|---|
| startDate | Başlangıç, Türkiye saati | 2026-10-20T00:00 |
| endDate | Bitiş; bitiş günü hariç tutulur, bir gün ileri verin | 2026-10-28T00:00 |
| pageNumber | Sayfa numarası | 1 |
| pageSize | Sayfa başına sipariş | 100 |
Ürün ve marka listesindeki Page ve Size adları burada pageNumber ve pageSize olur. Adları karıştırmak sayfalamanın çalışmamasına yol açar.
Yanıttaki sipariş alanları
| Bilgi | Önce bakılan alan | Yedek adlar |
|---|---|---|
| Sipariş numarası | orderNumber | orderId |
| Sipariş tarihi | orderDate | createdDate |
| Toplam tutar | totalAmount | totalPrice |
| Durum | orderStatus | status, statusText |
| Kalemler | items | orderItems |
| Teslimat adresi | shippingAddress | deliveryAddress |
| Müşteri | customer | customerName |
| Kargo firması | cargoCompany | cargoCompanyName |
| Takip numarası | cargoTrackingNumber | trackingNumber |
| Sipariş notu | note | - |
Yedek adların bulunması, alanların resmî dokümanla doğrulanamadığını gösterir. İlk entegrasyonda ham yanıtı kaydedip gerçek adlara bakın. Durum alanı çoğunlukla sayısal koddur; anlamları sipariş statü kodları sayfasında.
Kalem alanları
| Bilgi | Alanlar |
|---|---|
| Ürün kodu | code, productCode |
| Ürün adı | productName, name |
| Adet | quantity |
| Birim fiyat | price, unitPrice |
| Toplam | totalPrice |
| Barkod ve stok kodu | barcode, stockCode |
| Görsel | imageUrl |
Birim fiyat gelmezse toplam tutar adede bölünerek bulunur. Kalemi ürüne bağlarken önce ürün koduna, yoksa barkoda bakın.
Kalemdeki adet bilgisi stok düşümünün temelidir. Adet alanı boş ya da sıfır gelirse kalemi 1 adet saymak güvenli varsayımdır; ama bu durumu kaydedin ve siparişi panelden kontrol edin. Teslimat adresi ve müşteri bilgisi e-Arşiv fatura kesmek için gereklidir; bu alanları da yedek adlarıyla birlikte okuyun.
Sayfalama ve tekrarlar
- pageNumber'ı 1'den artırın.
- Boş sayfa ya da pageSize'dan az kayıt gelirse liste bitmiştir.
- Aynı sipariş iki sayfada görünürse orderNumber ile tekilleştirin.
- Geniş tarih aralıkları yerine son birkaç günü sık sorgulamak daha hafiftir.
- Saat dilimini sabitleyin: sunucunuz UTC'de çalışıyorsa tarihi Türkiye saatine çevirerek gönderin.
- Sipariş okumasını düzenli aralıklarla yapın; her turda son birkaç günü yeniden okumak, statüsü değişen siparişleri de yakalamanızı sağlar.
Siparişleri diğer kanallarla tek listede yönetmenin pratik yanı siparişleri tek listede yönetmek rehberinde.
Sık hatalar ve çözümleri
- Tarihi UTC göndermek: Türkiye saati beklenir; aralık üç saat kayar.
- endDate'i bugünün tarihi vermek: bitiş günü hariç tutulduğu için bugünün siparişleri gelmeyebilir.
- Servisi GET ile çağırmak: POST ve JSON gövde kullanılır.
- Tek sayfayla yetinmek: yoğun günlerde sipariş sayısı pageSize'ı aşar.
- Saniye eklemek ya da farklı biçim kullanmak: canlıda doğrulanan biçim yıl-ay-günTsaat:dakikadır.
Sık sorulanlar
Pazarama siparişleri hangi servisle çekilir?
POST /order/getOrdersForApi ile; gövdede startDate, endDate, pageNumber ve pageSize gönderilir.
Tarih hangi biçimde gönderilir?
Türkiye saatiyle yıl-ay-gün, T harfi ve saat:dakika; örneğin 2026-10-27T09:30.
Bugünün siparişleri neden gelmiyor?
Canlı kullanımda bitiş gününün aralığa dahil edilmediği görüldü. endDate'i bir gün ileri verin.
Pazarama'ya kargo takip numarasını API ile bildirebilir miyim?
Kargo, statü ve fatura bildirimi servisleri bu rehberde doğrulanamadı. Bu bilgileri entegrasyon dokümanından kontrol edin ya da İş Ortağım panelinden yapın.
Kaynaklar
İlgili Pazarama API konuları
Son güncelleme: 27.10.2026 · Pazarama API rehberinin tamamı