Sevkiyat statüleri
| Statü | Anlamı | Kim belirler |
|---|---|---|
| created | Ödeme alındı; henüz toplanmaya hazır değil | idefix |
| shipment_ready | Hazırlanmaya başlanabilir | idefix |
| shipment_picking | Toplama başladı; müşteri artık iptal edemez | Satıcı, update-shipment-status ile |
| shipment_invoiced | Fatura kesildi, kargoya hazır | Satıcı, update-shipment-status ile |
| shipment_in_cargo | Kargoya verildi | Kargo süreci ya da kargo kodu bildirimi |
| shipment_delivered | Müşteriye teslim edildi | Kargo süreci ya da teslim bildirimi |
| shipment_undeliver | Teslim edilemedi | Kargo süreci |
| shipment_cancelled | Müşteri iptal etti | Müşteri |
| shipment_unsupplied | Tedarik edilemedi bildirildi | Satıcı, unsupplied ile |
| shipment_split | Sevkiyat bölündü | Satıcı, split-package ile |
| shipment_approved | Süreç tamamlandı, hak ediş hesabına geçildi | idefix |
Güncel statüyü sevkiyat listesinin status alanından, Türkçe karşılığını statusDescription alanından okursunuz; örneğin shipment_in_cargo için Kargoya Verildi. Her sevkiyatın histories dizisi de geçtiği statüleri tarihleriyle listeler. Bu dizi, bir siparişin hangi adımda ne kadar beklediğini görmek için kullanışlıdır.
picking ve invoiced bildirimi
Gövde iki alan taşır: status ve invoiceNumber.
- Hazırlanıyor: status: picking.
- Faturalandı: status: invoiced, invoiceNumber: FATURA_NO.
picking'i paketlemeye başladığınız anda gönderin; bu andan sonra müşteri siparişi önyüzden iptal edemez. Geç gönderirseniz paketlediğiniz bir sipariş iptal edilebilir. invoiced'ı fatura numarası oluştuğunda gönderin; sevkiyat artık kargoya hazır sayılır.
İstek POST /oms/{vendorId}/{shipmentId}/update-shipment-status adresine gider. Yoldaki shipmentId, sevkiyat listesindeki id alanıdır; orderNumber değildir. Aynı siparişin birden çok sevkiyatı varsa her biri için ayrı bildirim yapılır.
Fatura linki gönderme
Kendi sisteminizde oluşturduğunuz e-Arşiv ya da e-Fatura'nın bağlantısı POST /oms/{vendorId}/{shipmentID}/invoice-link ile gönderilir. Gövde tek alan taşır: invoiceLink, yani faturanın adresi. idefix SSS faturanın üç yoldan iletilebileceğini söyler:
| Yol | Nasıl |
|---|---|
| API | invoice-link servisi, sevkiyat ID'siyle |
| Panel | Merchant Center, Siparişlerim, Fatura Yükle düğmesi |
| E-posta | Sevkiyat listesindeki maskeli e-posta adresine PDF ya da link göndermek |
Bireysel faturalarda SSS, platformun uyguladığı indirim ve kupon parametrelerinin yanıtta 0 döndüğünü belirtir. Kurumsal fatura bilgisi invoiceAddress alanındadır. e-Arşiv temelleri için e-ticarette fatura ve e-Arşiv yazısına bakabilirsiniz.
Sık hatalar ve çözümleri
- picking'i geç göndermek: müşteri bu arada siparişi iptal edebilir.
- orderNumber ile statü göndermek: yol sevkiyat ID'si (shipmentId) ister.
- invoiced'ı fatura numarası olmadan göndermek: invoiceNumber alanını doldurun.
- Bölünmüş sevkiyatta eski ID'ye bildirim yapmak: listeyi yeniden çekip yeni ID'leri kullanın.
- Statü değişikliklerini sırasız göndermek: önce picking, sonra invoiced; kargo bilgisi en son gelir.
Kargo bildirimi ve teslim adımları kargo ve teslimat bildirimi sayfasında, sevkiyatın bölünmesi ya da tedarik edilememesi tedarik edilemedi ve sipariş bölme sayfasında anlatılıyor.
Sık sorulanlar
idefix sipariş statüleri nelerdir?
created, shipment_ready, shipment_picking, shipment_invoiced, shipment_in_cargo, shipment_delivered, shipment_undeliver, shipment_cancelled, shipment_unsupplied, shipment_split ve shipment_approved.
picking statüsü ne zaman gönderilir?
Sevkiyatı toplamaya ya da paketlemeye başladığınızda. Bu bildirimden sonra müşteri siparişi önyüzden iptal edemez.
idefix'e fatura linki nasıl gönderilir?
POST /oms/{vendorId}/{shipmentID}/invoice-link servisine invoiceLink alanıyla. Panelden Fatura Yükle düğmesiyle de yüklenebilir.
shipment_approved ne demek?
Sevkiyatın tüm süreçleri tamamlandı ve satıcı hak ediş hesaplamasına geçildi demektir.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı