🛒 Hepsiburada Sipariş Entegrasyonu
SIT (test) ortamı · Basic Auth + User-Agent · groothevaletleri
Önerilen test akışı (otomatik paketleme açıkken):
Test siparişi oluştur
→ ~15 dakika sonra HB siparişi otomatik paketler
Paketleri listele
→ packageNumber ve lineItemId'leri al
Fatura linki gönder
(e-arşiv PDF URL)
(Opsiyonel)
Teslimat statüsü
ilet: intransit → delivered
Test sonrası
trackingId
ile HB'ye canlı geçiş ticket'ı aç
Not:
Otomatik paketleme kapalıysa: Open Orders → packageableWith → createPackage adımlarını ekle.
🔐 Kimlik bilgileri
Merchant ID (Username)
Secret Key (Password)
User-Agent (Developer)
Ortam
SIT (Test)
Canlı
1️⃣ Sipariş oluşturma & listeleme
Test sipariş payload (opsiyonel JSON)
Offset
Limit
Order Number (detay için)
➕ Test Siparişi Oluştur
📋 Ödemesi Tamamlanan (Paketlenecek)
⏳ Ödemesi Beklenen
❌ İptal Edilen
🔍 Sipariş Detayı
2️⃣ Paket listeleme (statü bazlı)
Offset/Limit yukarıdaki değerlerden alınır.
📦 Paketlenmiş (Tüm)
🚚 Kargoda
✅ Teslim Edildi
⚠️ Teslim Edilemedi
📭 Bozulmuş (Unpacked)
🧾 Faturası Eksik
3️⃣ Paketleme işlemleri
Manuel paketleme akışı
Package Number
Line Item Id (packageableWith)
Line Item Id'ler (virgüllü, createPackage)
Paket bölme body (JSON)
🔍 Paket Detayı
🔗 Aynı Pakete Konulabilecekler
📦 Paketle
📭 Paket Boz
✂️ Paket Böl
🏷️ Ortak Barkod
4️⃣ Fatura & teslimat statüsü
Invoice Link (e-arşiv PDF URL)
Warehouse Id (depo güncelleme)
Teslim edildi body (digital ürün için zorunlu)
Teslim edilemedi body (JSON, opsiyonel)
🧾 Fatura Linki Gönder
🚚 Kargoda
✅ Teslim Edildi
⚠️ Teslim Edilemedi
🏬 Depo Güncelle
5️⃣ İptal & işçilik maliyeti
Order Line Id
Labor Cost (işçilik)
İptal body (JSON)
❌ Kalem İptal (Paket önce bozulmalı)
💰 İşçilik Maliyeti Güncelle
6️⃣ Kargo firması değiştirme (opsiyonel)
Cargo Company Short Name
📋 Open: Değiştirilebilir Kargolar
🔄 Open: Kargo Değiştir
📋 Paketli: Değiştirilebilir Kargolar
🔄 Paketli: Kargo Değiştir