Parametreler
| Parametre | Anlamı | Not |
|---|---|---|
| vendor | Satıcı ID | Zorunlu |
| ids | Sevkiyat numaraları | Birden çok değer virgülle |
| orderNumber | Ana sipariş numarası | Bir siparişin tüm sevkiyatları |
| state | Sevkiyat durumu | Değerler statü tablosunda |
| startDate, endDate | Tarih aralığı | Biçim: 2022/09/30 23:59:59 |
| lastUpdatedAt | Son durum değişikliği | Değişenleri çekmek için |
| page | Sayfa | Varsayılan 1 |
| limit | Sayfa başına kayıt | Varsayılan 10 |
| sortByField | Sıralama alanı | id, createAt, updateAt |
| sortDirection | Sıralama yönü | desc (varsayılan), asc |
orderNumber ve id farkı
Bir müşteri siparişi birden çok sevkiyata ayrılabilir. orderNumber, örneğin IDE ile başlayan kod, ana siparişin numarasıdır. id ise sevkiyatın numarasıdır. Statü, kargo, fatura ve tedarik edememe bildirimleri sevkiyat ID'siyle yapılır.
Sipariş bölündüğünde ya da bir kalem tedarik edilemedi olarak bildirildiğinde aynı orderNumber altında yeni id'ler oluşur. Eski sevkiyat shipment_split durumuna geçer. Bu yüzden siparişleri yalnız orderNumber ile tekilleştirmek, bölünmüş siparişlerde kalem kaybına ya da çift sayıma yol açabilir; sevkiyat ID'sini de saklayın.
Yanıttaki önemli alanlar
| Alan | Seviye | Anlamı |
|---|---|---|
| totalPrice | Sevkiyat | İndirimler düşülmeden toplam |
| discountedTotalPrice | Sevkiyat ve kalem | İndirimler düşüldükten sonra tutar |
| totalPlatformDiscount, totalVendorDiscount | Sevkiyat | Platform ve satıcı indirimi |
| commissionAmount | Kalem | Komisyon tutarı |
| earningAmount | Kalem | Satıcının hak ediş tutarı |
| status, statusDescription | Sevkiyat | Güncel durum ve Türkçe açıklaması |
| cargoCompany, cargoTrackingNumber, cargoProfileId | Sevkiyat | Kargo bilgileri |
| invoiceAddress, shippingAddress | Sevkiyat | Fatura ve teslimat adresi |
| customerContactMail | Sevkiyat | Maskeli müşteri e-postası |
| items[].barcode, merchantSku | Kalem | Ürün eşleştirme anahtarları |
Kurumsal fatura için invoiceAddress içindeki isCommercial değerine bakılır; şirket adı, vergi numarası ve vergi dairesi company, taxNumber ve taxOffice alanlarındadır (idefix SSS).
Adet bilgisi: list ve list-v2
idefix SSS'ye göre bu listede her ürün satırı en fazla 1 adet olarak döner ve quantity alanı yoktur. Aynı üründen 3 adet alınmışsa üç ayrı satır görürsünüz. Stok düşerken aynı barkodlu satırları toplamanız gerekir.
Toplam ürün adetleri için https://merchantapi.idefix.com/oms/{vendorId}/list-v2 servisi kullanılabilir. Bu servisin alanları dokümanda ayrıca anlatılmaz; geçmeden önce yanıtı test edin.
Sık hatalar ve çözümleri
- vendor parametresini unutmak: zorunludur, yoldaki Satıcı ID'ye ek olarak gönderilir.
- Tarihi ISO biçiminde göndermek: doküman 2022/09/30 23:59:59 biçimini gösterir.
- limit'i varsayılan 10'da bırakıp ilk sayfayla yetinmek: pageCount alanına göre tüm sayfaları gezin.
- Aynı barkodlu satırları ayrı ürün sanmak ya da tek adet saymak: satırları barkoda göre toplayın.
- Bölünmüş siparişte eski sevkiyatı işlemeye devam etmek: shipment_split olan kaydı değil, yeni sevkiyatları işleyin.
Siparişleri diğer kanallarla tek listede yönetmenin pratik yanı siparişleri tek listede yönetmek rehberinde.
Sık sorulanlar
idefix siparişleri hangi servisle çekilir?
GET https://merchantapi.idefix.com/oms/{vendorId}/list ile. Servis satıcıya ait, ödeme kontrolünden geçmiş sevkiyatları döndürür.
orderNumber ile id arasındaki fark nedir?
orderNumber ana sipariş numarasıdır; id o siparişe bağlı sevkiyatın numarasıdır. Bildirimler sevkiyat ID'siyle yapılır.
Siparişteki ürün adedini nasıl öğrenirim?
Bu listede her satır 1 adettir; aynı barkodlu satırları sayın. Toplam adetler için idefix list-v2 servisini önerir.
Tarih filtresi hangi biçimde gönderilir?
Yıl/ay/gün saat:dakika:saniye biçiminde, örneğin 2026/10/27 09:30:00.
Komisyon ve hak ediş bilgisi listede var mı?
Evet. Kalem seviyesinde commissionAmount komisyonu, earningAmount satıcının hak edişini gösterir.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı