Ürün durumları
| Durum | Anlamı | Sizden beklenen |
|---|---|---|
| waiting_catalog_action | İnceleme sürüyor | Beklemek |
| waiting_vendor_approve | Ürün katalogda var; eşleşme onayınızı bekliyor | approve-item ya da decline-item |
| ready_for_sale | Satışa açılmaya hazır | Stok ve fiyat göndermek |
| auto_matched | Katalogdaki bir ürünle otomatik eşleştirildi | Bilgileri kontrol etmek |
| manual_matched | Manuel eşleştirildi | Bilgileri kontrol etmek |
| not_matched | Katalogla eşleşmedi; operatör inceliyor | Beklemek; gerekirse revize göndermek |
| missing_info | Eksik bilgi var | Eksiği tamamlayıp yeniden göndermek |
| platform_declined | idefix reddetti | failureReasons'a bakmak |
| vendor_declined | Eşleşmeyi siz reddettiniz | Gerekirse doğru bilgiyle yeniden göndermek |
Parti durumları
| Değer | Anlamı |
|---|---|
| created | Talep oluşturuldu |
| running | İşlem sürüyor |
| completed | İşlem tamamlandı |
| failed | İşlem başarısız oldu |
| cancelled | İstek iptal edildi |
Parti completed olsa bile tek tek ürünler reddedilmiş olabilir. Dokümandaki örnekte parti COMPLETED iken ürün durumu decline ve failureReasons CATEGORY_MANDATORY_ATTRIBUTE_MISSED görünür. decline değeri ürün durumu tablosunda yoktur; kodunuz tanımadığı değerleri kaydetmeli ve elle incelemeye ayırmalıdır.
Eşleşme onayı ve 24 saat kuralı
Onay ve red istekleri items dizisinde barkod taşır. Örnek gövde: items: [ { barcode: BARKOD } ].
| Durum | Sonuç |
|---|---|
| Gönderimden sonraki 24 saat içinde onay | Ürün ilk gönderdiğiniz satış bilgileriyle açılır, envanter listesinde görünür |
| 24 saatten sonra onay | Ürün envantere eklenir ama stok ve fiyat göndermeniz beklenir |
| Red (decline-item) | Eşleşme reddedilir, ürün vendor_declined olur |
Onaylamadan önce batch-result ya da fast-listing-result yanıtındaki matchedProduct alanını kendi ürününüzle karşılaştırın: barkod, marka, model ve görsel aynı mı? Yanlış eşleşmeyi onaylamak, ürününüzü başka bir ürünün sayfasında satmak demektir. Bu işlemi API yerine satıcı panelinden de yapabilirsiniz.
Eşleşme her zaman kötü bir şey değildir. Katalogda zaten olan bir ürünle eşleşmek, ürün sayfasının içeriğini, yorumlarını ve görsellerini hazır almanız demektir. Eşleşen üründe kategori ya da marka sizin gönderdiğinizden farklıysa idefix yanıtta doğru ID'yi verir (CATEGORY_FAILED_TO_MATCH, BRAND_FAILED_TO_MATCH); kendi kaydınızı bu ID'lerle düzeltmek sonraki gönderimleri kolaylaştırır.
Sık hatalar ve çözümleri
| Hata | Sonuç | Doğrusu |
|---|---|---|
| Partinin completed olmasını ürün onayı sanmak | Reddedilen ürün fark edilmez | Her ürünün status alanını okumak |
| waiting_vendor_approve'u beklemeye bırakmak | 24 saat sonra stok ve fiyat yeniden gerekir | Zamanında onaylamak |
| NO_BATCH_ID_EXIST | Yanlış batchId | create yanıtındaki batchRequestId'yi aynen kullanmak |
| matchedProduct'a bakmadan onaylamak | Yanlış ürün sayfası | Barkod, marka ve görseli karşılaştırmak |
| Sonucu saniyede bir sorgulamak | 429 | Birkaç saniye arayla, sınırlı sayıda sorgulamak |
not_matched durumundaki ürünün güncel hâlini ürün listesi servisinden de izleyebilirsiniz.
Sık sorulanlar
batchRequestId nereden gelir?
create ve fast-listing isteklerinin yanıtında döner. Bu değeri saklayın; batch-result ya da fast-listing-result sorgusunda batchId olarak kullanılır.
waiting_vendor_approve ne demek?
Gönderdiğiniz ürün idefix kataloğunda zaten var ve eşleşmeyi onaylamanız bekleniyor. approve-item ile onaylar, decline-item ile reddedersiniz.
Onayı geciktirirsem ne olur?
Gönderimden itibaren 24 saat geçtiyse ürün envantere eklenir ama ilk satış bilgileri kullanılmaz; stok ve fiyatı yeniden göndermeniz beklenir.
not_matched ürün için ne yapmalıyım?
Ürün katalogdaki hiçbir ürünle eşleşmedi ve idefix operatörlerinin incelemesinde. Onay, red ya da revize talebi gelebilir; durumunu ürün listesinden izleyin.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı