ikas API · Sipariş

ikas sipariş, paket ve ödeme durumları

ikas'ta bir siparişin durumu tek bir alanla anlatılmaz. status siparişin genel hâlini, orderPackageStatus paketlerin hazırlık, kargo, iptal ve iade aşamasını, orderPaymentStatus ise ödemenin durumunu gösterir. Sipariş satırlarının da kendi status alanı vardır. Stok entegrasyonu için iptal ve iade durumlarını doğru yakalamak, düşülen stoğun geri eklenmesi açısından önemlidir.

Sipariş durumu (status)

DeğerAnlamı
DRAFTTaslak sipariş
CREATEDOluşturuldu
WAITING_UPSELL_ACTIONEk satış adımı bekleniyor
CANCELLED, PARTIALLY_CANCELLEDTamamen ya da kısmen iptal
REFUND_REQUESTED, REFUND_REJECTEDİade talep edildi ya da reddedildi
REFUNDED, PARTIALLY_REFUNDEDTamamen ya da kısmen iade edildi

Değerler ikas'ın OrderStatusEnum tanımından alındı (ikas: Siparişler). İptal edilen siparişte cancelledAt alanı iptal zamanını, cancelReason alanı nedeni verir: CUSTOMER, DECLINED, INVENTORY ya da OTHER. INVENTORY nedeni stok sorunlarını izlemek için ayrıca değerlidir.

Paket durumu (orderPackageStatus)

Paket durumu 24 değer alır. Adlarına göre gruplandığında şöyle okunur:

AşamaDeğerler
HazırlıkUNFULFILLED, PLANNED, WAITING_FOR_PACKAGING, READY_FOR_SHIPMENT, PARTIALLY_READY_FOR_SHIPMENT, READY_FOR_PICK_UP
Gönderim ve teslimFULFILLED, PARTIALLY_FULFILLED, DELIVERED, PARTIALLY_DELIVERED, UNABLE_TO_DELIVER
İptalCANCEL_REQUESTED, CANCEL_REJECTED, CANCELLED, PARTIALLY_CANCELLED
İadeREFUND_REQUESTED, REFUND_REQUEST_ACCEPTED, REFUND_REJECTED, REFUNDED, PARTIALLY_REFUNDED
İade kargosuRETURN_PARCEL_WAITING, RETURN_IN_TRANSIT, RETURN_DELIVERED, RETURN_REJECTED

ikas'ın fulfillOrder açıklamasına göre bu işlem sipariş satırlarını kargoya hazırlar ya da gönderildi olarak işaretler.

Ödeme durumu (orderPaymentStatus)

DeğerAnlamı
WAITINGÖdeme bekleniyor
PAIDÖdendi
PARTIALLY_PAIDKısmen ödendi
OVER_PAIDFazla ödendi
FAILEDÖdeme başarısız
REFUNDEDÖdeme iade edildi

Kapıda ödeme ya da havale gibi yöntemlerde sipariş oluşmuş ama ödeme beklemede olabilir. Stok ayırmayı ödeme durumuna mı, sipariş oluşmasına mı bağlayacağınıza baştan karar verin. Ödeme durumu filtre olarak da kullanılır: listOrder sorgusuna orderPaymentStatus: { eq: PAID } vermek yalnız ödenmiş siparişleri getirir.

Stok entegrasyonunda yorum

  • Yeni siparişte stoğu düşün; iptal (CANCELLED) ve iade (REFUNDED) durumlarında geri ekleyin.
  • Kısmi iptal ve iadelerde sipariş düzeyine değil, satırların status alanına bakın.
  • İade talebi (REFUND_REQUESTED) ürünün depoya döndüğü anlamına gelmez; ikas'ta iade satırı refundOrderLine ile işlendiğinde ürün stoğa geri eklenir.
  • Durum alanları arasında çelişki görürseniz satır durumunu esas alın.

Sipariş satırlarının status alanı 16 değer alır. Paket durumundaki hazırlık, gönderim, iptal, iade ve iade kargosu aşamalarının satır karşılıklarıdır; ör. UNFULFILLED, WAITING_FOR_PACKAGING, FULFILLED, DELIVERED, CANCEL_REQUESTED, CANCELLED, REFUND_REQUESTED, REFUNDED ve RETURN_IN_TRANSIT. Kısmi iptal ve iadede hangi ürünün etkilendiğini bu alan söyler.

Sık sorulanlar

ikas sipariş durumları nelerdir?

Genel status alanı DRAFT, CREATED, CANCELLED, PARTIALLY_CANCELLED, REFUND_REQUESTED, REFUND_REJECTED, REFUNDED, PARTIALLY_REFUNDED ve WAITING_UPSELL_ACTION değerlerini alır. Paket ve ödeme için ayrı alanlar vardır.

ikas'ta kargolanan sipariş hangi durumda görünür?

Paket durumunda FULFILLED ya da PARTIALLY_FULFILLED, teslimden sonra DELIVERED olarak görünür. Teslim edilemeyen paket UNABLE_TO_DELIVER değerini alır; bu durumdaki siparişleri ayrıca izlemek iyi olur.

İptal edilen siparişte stok geri gelir mi?

ikas'ın kendi stok hareketleri platformun kurallarına bağlıdır. Dışarıdan stok yöneten bir entegrasyon, iptal ve iade durumlarını izleyip kendi düştüğü stoğu geri eklemelidir.

Kaynaklar

İlgili ikas API konuları

Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı

ikas entegrasyonunu kod yazmadan kurun

Saystok bu API'lerle stok, sipariş ve fiyatı sizin yerinize eşitler. 30 gün ücretsiz.