Stokzone'a Kargonomi hesabınızı bağlarken aşağıdaki bilgiler istenir. Her birinin Kargonomi panelinde nerede bulunduğunu yanına yazdık.
- Bearer Token
- Kargonomi paneli > API/Entegrasyon bölümünden alınan sabit Bearer token. Her istekte Authorization: Bearer <token> olarak gönderilir (login/yenileme YOK).
- X-App-Key (partner, opsiyonel)opsiyonel
- Yalnızca PARTNER firmalar için: Bearer token'a ek olarak her istekte gönderilen X-App-Key değeri. Doğrudan müşteri token'ı kullanıyorsanız boş bırakın.
- Depo ID (warehouse_id, gönderici)opsiyonel
- Önerilen — Kargonomi panelinde tanımlı Depo (warehouse) id'si. Verilirse gönderici adres bilgisi depodan çekilir; boşsa aşağıdaki sender_* alanları zorunludur.
- Taşıyıcı ID (opsiyonel)opsiyonel
- Gönderiyi 'İşleme Hazır' yaparken seçilecek taşıyıcı id'si. -1 (varsayılan) → en düşük fiyat teklifini veren taşıyıcı otomatik seçilir (doc). Belirli taşıyıcı için fiyat karşılaştırma yanıtındaki id'yi girin.
- Gönderici Adı (warehouse_id yoksa)opsiyonel
- warehouse_id girilmediyse zorunlu (doc satır 230).
- Gönderici E-posta (opsiyonel)opsiyonel
- Gönderici VKN/TCKN (opsiyonel)opsiyonel
- Gönderici Vergi Dairesi (opsiyonel)opsiyonel
- Gönderici Telefon (opsiyonel)opsiyonel
- Gönderici Adres (opsiyonel)opsiyonel
- Gönderici Şehir ID (opsiyonel)opsiyonel
- warehouse_id yoksa zorunlu. Kargonomi /states ile eşleşen şehir id'si.
- Gönderici İlçe ID (opsiyonel)opsiyonel
- warehouse_id yoksa zorunlu. Kargonomi /cities ile eşleşen ilçe id'si.
- Webhook Gizli Anahtarı (secret_key, opsiyonel)opsiyonel
- Kargonomi 'shipment.updated' webhook'unu gönderirken X-Webhook-Signature başlığını HMAC-SHA256(gövde, secret_key) ile imzalar. Gerçek-zamanlı gönderi durumu güncellemesi için Kargonomi panelinde webhook oluşturunca verilen secret_key'i buraya girin. Boşsa gelen webhook'lar doğrulanamaz (reddedilir).
Kimlik bilgileriniz şifrelenerek saklanır ve yalnız bağlantıyı kurmak için kullanılır. Dilediğiniz zaman panelden bağlantıyı kaldırabilirsiniz.