Tedarik edilemedi bildirimi
Gövde, tedarik edilemeyen kalemleri items dizisinde taşır. Örnek: items: [ { id: KALEM_ID, reasonId: 502 } ].
| Alan | Yer | Anlamı |
|---|---|---|
| shipmentId | Yol | Kalemin bulunduğu sevkiyat |
| id | Gövde | Sevkiyattaki kalemin ID'si (items[].id) |
| reasonId | Gövde | Tedarik edememe sebebinin ID'si |
Bildirimden sonra o kalem iptal olur. Sevkiyatta başka ürün kaldıysa idefix kalanlar için aynı orderNumber üzerinde yeni ID'li bir sevkiyat açar. Bağlı olduğu eski sevkiyat bilgisi de listede döner; bu yüzden bildirimden sonra güncel sevkiyatları yeniden çekin.
Sebep listesi
Sebepler GET /oms/{vendorId}/reasons/noship servisinden gelir. Dokümandaki örnek değerler:
| ID | Sebep | Ne zaman seçilir |
|---|---|---|
| 500 | Stok tükendi | Stok bittiği ya da gönderim geciktiği için tedarik edilemiyorsa |
| 501 | Kusurlu, defolu ya da bozuk ürün | Ürün kusurlu olduğu için gönderilemiyorsa |
| 502 | Hatalı fiyat | Yanlış fiyat girildiyse |
| 504 | Entegrasyon hatası | Entegrasyon kaynaklı hatalı fiyat ya da stok aktarımında |
Bu ID'leri koda gömmeyin; güncel listeyi servisten okuyun. Müşteri iptallerinin sebep listesi ayrıca GET /oms/{vendorId}/reasons/cancel adresindedir.
Müşteri iptal sebeplerine örnek olarak dokümanda 607 Teslimat tarihi gecikti, 608 Vazgeçtim, 609 Yanlış kartla ödeme yaptım, 610 Fiyat sebebiyle vazgeçtim ve 611 Adreste bulunmayacağım geçer. Bu liste müşterinin seçtiği sebepleri yorumlamak içindir; tedarik edememe bildiriminde kullanılmaz.
Sipariş bölme
split-package gövdesi splitPackageDetails dizisi taşır; her öğe bir paketin items listesidir ve kalem ID'lerinden oluşur. Gönderdiğiniz kalemler bir paket olur; gönderilmeyen kalemler otomatik olarak başka yeni bir sevkiyata alınır.
| Adım | Sonuç |
|---|---|
| split-package çağrısı | Eski sevkiyat shipment_split olur |
| Gönderilen kalemler | Yeni bir sevkiyatta toplanır |
| Gönderilmeyen kalemler | Başka bir yeni sevkiyata alınır |
| list servisini yeniden çağırma | Yeni sevkiyat ID'leri görünür |
Ne zaman hangisi?
| Durum | Servis |
|---|---|
| Ürün stokta yok, gönderilmeyecek | unsupplied, sebep 500 |
| Ürünlerin bir kısmı bugün, kalanı sonra gidecek | split-package |
| Fiyat yanlış girilmiş | unsupplied, sebep 502 |
| Müşteri iptal etti | İşlem gerekmez; statü shipment_cancelled olur |
Tedarik edilemedi bildirimlerinin çoğu stok farkından doğar: ürün başka kanalda satılmış ama idefix'te stok düşmemiştir. Bunu önlemenin yolu stoğu kanallar arasında hızlı eşitlemektir; ayrıntı stok bitmiş ürün satışı ve iptal rehberinde.
Sık hatalar ve çözümleri
- Sevkiyat ID'si yerine kalem ID'sini yola yazmak ya da tersini yapmak: yol shipmentId, gövde kalem id ister.
- Bildirimden sonra eski sevkiyat ID'siyle kargo bildirmek: yeni ID'leri listeden alın.
- Sebep ID'sini tahmin etmek: reasons/noship servisinden okuyun.
- Bölmede tüm kalemleri tek pakete koymak: bölme anlamını yitirir; gönderilecek kalemleri ayırın.
Sık sorulanlar
idefix'te tedarik edemediğim kalemi nasıl iptal ederim?
POST /oms/{vendorId}/{shipmentId}/unsupplied servisine kalemin id'si ve reasonId ile istek atın. Kalem iptal olur, kalan ürünler için yeni sevkiyat açılabilir.
Tedarik edememe sebep ID'leri nereden alınır?
GET /oms/{vendorId}/reasons/noship servisinden. Dokümandaki örnekte 500 stok tükendi, 502 hatalı fiyat anlamına gelir.
Siparişi bölünce eski sevkiyata ne olur?
Eski sevkiyat shipment_split durumuna geçer. Kalemler aynı orderNumber altında yeni sevkiyatlara dağılır.
Bölme sonrası yeni sevkiyatları nasıl bulurum?
Sevkiyat listesini orderNumber filtresiyle yeniden çekin. Yeni sevkiyat ID'leri listede döner.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı