Kalem bazında mı paket bazında mı?
| Aşama | Değişiklik birimi | Gereken kimlik | Not |
|---|---|---|---|
| Paketlenmemiş (Open) | Kalem | Kalem kimliği (id) | Paketleme bu firmayla yapılır |
| Paketlenmiş, kargo almadı | Paket | Paket numarası | Paket etiketi yeniden alınır |
| Kargoya verildi | Bu çağrıların kapsamı dışında | — | Panelden ya da destekten bilgi alın |
Saystok'un kodunda iki ayrı çağrı tanımlıdır: biri kalem kimliğiyle, biri paket numarasıyla; ikisi de gövdede cargoCompanyShortName alanını gönderir. Bu çağrıların yolları canlıda doğrulanmadı; güncel yollar için resmî dokümana bakın.
Kısa ad nedir?
Kargo firması istekte tam adıyla değil, Hepsiburada'nın tanımladığı kısa adla belirtilir. Kısa adların güncel listesi resmî dokümanda yer alır. Listeyi koda gömmek yerine bir ayar olarak tutun; yeni bir firma eklendiğinde ya da bir ad değiştiğinde kod değişmesin.
Sipariş listesinde mevcut kargo firması cargoCompanyModel nesnesinde gelir; içinde firmanın adı ve takip adresi bulunur. Değişiklikten önce bu alanı okuyup mevcut firmayı gösterin; satıcı neyi neyle değiştirdiğini görsün.
Kısa adı elle yazmak sık görülen bir hata kaynağıdır. Harf ya da Türkçe karakter farkı isteğin reddedilmesine yol açabilir. Kısa adları dokümandan alın ve satıcıya serbest metin yerine bir seçim listesi olarak sunun.
Ne zaman kargo firması değiştirilir?
- Atanan firmanın bölgede şubesi yoksa ya da teslim süresi uzunsa.
- Ürünün desisi bir firmanın sınırını aşıyorsa. Desiyi önceden hesaplamak için desi hesaplama aracını kullanabilirsiniz.
- Kargo firmasında geçici bir aksama varsa.
- Anlaşmalı bir firmayla daha uygun fiyat varsa.
Kargo seçimi maliyeti doğrudan etkiler. Kâr hesabında kargo ücretini ürün bazında izlemek, hangi değişikliğin gerçekten kazandırdığını gösterir; yöntem pazaryeri kâr-zarar hesabı rehberinde.
Değişiklikten sonra
- Eski etiketi kullanmayın; yeni firma için yeni etiket alın. Akış kargo etiketi sayfasında.
- Sipariş detayını yeniden okuyun ve yeni firmanın cargoCompanyModel alanına yansıdığını doğrulayın.
- Hazırlama ekibine haber verin; kutu yanlış firmanın teslim alanına konmasın.
- E-arşiv faturada taşıyıcı bilgisi kullanıyorsanız yeni firmayla güncelleyin.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Değişiklik reddedildi | Tam ad gönderildi | Kısa adı kullanın |
| Paketli siparişte kalem bazlı istek hata verdi | Aşamaya uygun olmayan çağrı | Paketli siparişte paket numarasıyla değiştirin |
| Kargo eski firmayla geldi | Eski etiket kutuda kaldı | Yeni etiket alıp eskisini sökün |
| Değişiklik görünmüyor | Önbellekteki sipariş verisi | Detayı yeniden okuyun |
Sık sorulanlar
Hepsiburada'da kargo firmasını nasıl değiştiririm?
Paketlenmemiş siparişte kalem bazında, paketlenmiş siparişte paket bazında; yeni firmayı kısa adıyla belirterek.
Kargoya verilmiş paketin firması değişir mi?
Kodda tanımlı çağrılar yalnız paketlenmemiş ve paketlenmiş ama kargo almamış aşamaları kapsar. Kargoya verilmiş paket için panelden ya da destekten bilgi alın.
Kısa adların listesi nerede?
Hepsiburada'nın resmî dokümanında. Listeyi koda gömmek yerine ayar olarak tutun.
Kargo değişince etiket ne olur?
Eski etiket geçersiz olur. Yeni firma için yeni etiket alın.
Kargo firmasını paketlerken seçebilir miyim?
Kodda tanımlı paketleme isteğinde kargo firması isteğe bağlı bir alandır; resmî dokümanda doğrulayın. Paketlerken doğru firmayı seçmek, sonradan değiştirip etiketi yeniden almaktan daha az iş çıkarır.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı