Filtreler
| Filtre | Tip | Örnek kullanım |
|---|---|---|
| orderedAt | Tarih (ms) | Son 7 günün siparişleri: gte ZAMAN_MS |
| updatedAt | Tarih (ms) | Son okumadan beri değişenler |
| status | Sipariş durumu | CREATED, CANCELLED gibi |
| orderPackageStatus | Paket durumu | READY_FOR_SHIPMENT, DELIVERED gibi |
| orderPaymentStatus | Ödeme durumu | PAID, WAITING gibi |
| salesChannelId, stockLocationId | Metin | Belirli kanal ya da depo |
| orderNumber, customerEmail | Metin | Tek sipariş ya da müşteri |
Sonuçlar page ve limit ile sayfalanır; limit en fazla 200'dür (ikas: Siparişler).
Sipariş ve satır alanları
- Sipariş: id, orderNumber (1001'den başlayan ardışık numara), orderedAt, status, orderPackageStatus, orderPaymentStatus, totalPrice, totalFinalPrice, currencyCode.
- Müşteri ve adres: customer (e-posta, ad, soyad, telefon) ve shippingAddress (adres satırları, şehir, ilçe, posta kodu). ikasPOS siparişlerinde müşteri bilgisi boş olabilir.
- Satır: quantity, price, finalPrice, status, stockLocationId ve variant.
totalFinalPrice, indirim, kargo ve hediye paketi satırları uygulandıktan sonraki nihai tutardır; totalPrice ise satırların net fiyat toplamıdır.
Stok düşümü için okuma düzeni
- Belirli aralıklarla orderedAt ya da updatedAt filtresiyle son siparişleri okuyun.
- Her siparişi kimliğiyle kaydedin; aynı siparişi iki kez işlemeyin.
- Satırdaki varyantı SKU ya da varyant kimliğiyle kendi ürününüze eşleyin.
- İptal ve iade durumlarını izleyip düşülen stoğu gerektiğinde geri ekleyin.
- Çok depolu mağazada satırın stockLocationId değerine bakın; satış o depodan düşer.
Pazaryerleri ile ikas'ın birlikte çalıştığı düzende okuma sıklığı fazla satış riskini doğrudan etkiler; bkz. ikas ve pazaryeri stok senkronu.
Sık sorunlar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Çok eski siparişler geliyor | orderedAt saniye cinsinden gönderildi | Değeri milisaniyeye çevirin |
| Bazı siparişler eksik | Sayfalama erken durdu | hasNext false olana kadar okuyun |
| Müşteri bilgisi boş | Sipariş ikasPOS ile oluşturuldu | Müşteri alanını isteğe bağlı işleyin |
| Aynı sipariş iki kez işlendi | Sipariş kimliği kaydedilmedi | id ile tekrar kontrolü yapın |
Sık sorulanlar
ikas siparişleri API ile nasıl çekilir?
listOrder sorgusunu read_orders izinli token ile çağırın. orderedAt: { gte: ZAMAN_MS } filtresi ve pagination ile sayfa sayfa okuyun.
ikas sipariş numarası nasıl oluşur?
ikas'a göre sipariş numaraları mağazanın sayacında 1001'den başlar ve ardışık ilerler.
Siparişin hangi depodan karşılanacağı nerede yazar?
Her sipariş satırının stockLocationId alanında. Farklı depolara atanmış satırları kargolarken fulfillOrder işlemine satır listesi verilmesi gerekir.
ikas siparişinde tutar hangi para biriminde?
Siparişin currencyCode alanında yazar. Satırlarda da ayrıca currencyCode bulunur.
Son okumadan beri değişen siparişleri nasıl alırım?
updatedAt: { gte: SON_OKUMA_MS } filtresiyle son okumadan sonra güncellenen siparişleri isteyin. İptal ve iade gibi durum değişiklikleri de böylece yakalanır.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı