Kargo servisleri
Hepsi POST isteğidir ve /oms/{vendorId}/{shipmentId}/ yolunun devamıdır.
Hangi servisi kullanacağınız kargo modelinize bağlıdır. Platform anlaşmalı kargoda takip bilgisi kargo firmasından gelir ve çoğu zaman ek bildirim gerekmez. Kendi anlaşmanızla gönderiyorsanız takip numarasını siz bildirirsiniz. Kendi aracınızla teslim ediyorsanız hem gönderimi hem teslimi siz bildirirsiniz.
| Servis | Yolun sonu | Ne için |
|---|---|---|
| update-tracking-number | /update-tracking-number | Kendi anlaşmanızla gönderimde takip numarası |
| alternative-cargo-tracking | /alternative-cargo-tracking | Kendi aracınız, servis ya da takip edilemeyen kargo |
| manual-deliver | /manual-deliver | Alternatif gönderimde teslim bildirimi |
| update-box-info | /update-box-info | Desi ve koli sayısı |
| change-cargo-provider | /change-cargo-provider/{vendorCargoProfile} | Gönderi kargosunu değiştirme |
Alanlar
| Servis | Alan | Not |
|---|---|---|
| update-tracking-number | trackingNumber, trackingUrl | İkisi zorunlu; adres kargo firmasıyla uyumlu olmalı |
| alternative-cargo-tracking | vendorCargoProfile | Zorunlu; uygun satıcı kargo profili |
| alternative-cargo-tracking | isPhoneNumber, trackingInfo.phoneNumber | isPhoneNumber true ise telefon numarası zorunlu |
| alternative-cargo-tracking | trackingInfo.trackingUrl | isPhoneNumber false ise zorunlu |
| alternative-cargo-tracking | trackingNumber, boxQuantity, desi | İsteğe bağlı |
| manual-deliver | deliverDocumentUrl, deliveryCode | Teslim belgesi adresi ve teslim kodu |
| update-box-info | boxQuantity, desi | Koli sayısı ve desi |
update-tracking-number, gönderimin platform anlaşması yerine kendi anlaşmanızla yapılacağını bildirir. Takip adresi ile siparişte seçili kargo profili uyuşmazsa idefix uyarı ya da hata verir; bu durumda önce change-cargo-provider ile doğru kargoyu tanımlayın. Desiyi hesaplamak için desi hesaplama aracını kullanabilirsiniz.
Kargo profilleri
Kargo seçimleri profil ID'leriyle yapılır. Platformda tanımlı profiller GET /pim/cargo-company/profile/list, size tanımlı profiller GET /pim/cargo-company/{vendorId}/profile/list, kargo firmaları GET /pim/cargo-company servisinden gelir. Sevkiyatın profili sipariş listesindeki cargoProfileId ve cargoProfileName alanlarındadır.
| Profil alanı | Anlamı |
|---|---|
| isPlatformAgreementSupport | Platform anlaşmalı kargo |
| isSellerAgreementSupport | Satıcı anlaşmalı kargo |
| isPlatformTrackingSupport | Platform öder modelde platform takip edebiliyor |
| isSellerTrackingSupport | Platform satıcı adına takip edebiliyor |
| acceptReturn, acceptHomeReturn | İadeyi ve evden iadeyi destekler |
| fullCoverage | Ulusal (tüm ülkede hizmet veren) kargo |
Kural: alternatif teslimatta isSellerTrackingSupport ve isPlatformAgreementSupport değerleri false olan profil gönderilir. Kargo değiştirmede ise bu ikisinden en az biri true olan profil gönderilir.
Sık hatalar ve çözümleri
- Takip adresinin kargo profiliyle uyuşmaması: change-cargo-provider ile doğru kargoyu tanımlayıp yeniden bildirin.
- Alternatif teslimatta teslim bildirimini unutmak: idefix SSS'ye göre satıcı entegrasyonlu kargoda teslim bilgisi manual-deliver ile gönderilir.
- Yolda sipariş numarası kullanmak: tüm kargo servisleri sevkiyat ID'si ister.
- Yanlış profil türü göndermek: alternatif teslimat ve kargo değiştirme için profil kuralları farklıdır.
- Bölünmüş sevkiyatın eski ID'sine takip numarası vermek: yeni sevkiyat ID'lerini kullanın.
Kargoya verdikten sonra siparişin statüsünü sevkiyat listesinden kontrol edin: takip numarası bildirimi başarılıysa statü shipment_in_cargo olur. Statü değişmediyse bildirim reddedilmiş olabilir; yanıt gövdesindeki mesajı kaydedin.
Sık sorulanlar
idefix'e kargo takip numarası nasıl bildirilir?
POST /oms/{vendorId}/{shipmentId}/update-tracking-number servisine trackingNumber ve trackingUrl gönderilir. Sevkiyat kendiliğinden shipment_in_cargo olur.
Kendi aracımla teslim ettiğim siparişi nasıl bildiririm?
Gönderimi alternative-cargo-tracking ile uygun satıcı kargo profili ve telefon ya da takip adresiyle bildirin; teslimden sonra manual-deliver ile teslim bilgisini gönderin.
Desi bilgisi hangi servisle gönderilir?
POST /oms/{vendorId}/{shipmentId}/update-box-info servisine boxQuantity ve desi alanlarıyla.
Kargo firmasını sonradan değiştirebilir miyim?
Platform öder anlaşmalı ya da platformun takip edebildiği sevkiyatlarda change-cargo-provider servisiyle, uygun kargo profil ID'sini yola ekleyerek değiştirebilirsiniz.
Kaynaklar
- idefix API Portal: Kargo Kodu Bildirme
- idefix API Portal: Alternatif Kargo Kodu Bildirme
- idefix API Portal: Teslim Edildi Bilgisi Gönderme
- idefix API Portal: Desi, Koli Bilgisi Gönderme
- idefix API Portal: Gönderi Bilgisi Değiştirme
- idefix API Portal: Satıcı Kargo Profil Listesi
- idefix API Portal: Platform Kargo Profil Listesi
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı