Nevuto için Sendcloud entegrasyonu

Sendcloud nedir?

Sendcloud, Avrupa'nın çok-carrier kargo agregatörüdür — tek API üzerinden DHL, DPD, PostNL, UPS, GLS, Bpost ve daha pek çok carrier'a EU içi ve uluslararası gönderim yapabilirsiniz. EU + UK + İrlanda + İskandinavya'da satış yapan mağazalar için en hızlı çok-carrier çözümlerinden biridir ve çoklu para birimi destekler.

Nevuto, Sendcloud'u nasıl yönetir?

• Sendcloud HTTP Basic auth kullanır; Nevuto Public Key + Secret Key ile ikili kimlik doğrulama yapar.
• Submit anında Nevuto, Sendcloud hesabınıza webhook bağlantısını otomatik kurar — manuel adım gerekmez.
• Gönderim sırasında Nevuto, tercih ettiğiniz carrier'lar arasından en uygun fiyatlı seçeneği canlı olarak seçer.
• Etiket PDF olarak Nevuto admin'den tek tıkla yazdırılır; ücret Sendcloud cüzdanından otomatik düşer.
• EU dışı gönderilerde customs declaration otomatik eklenir (item value + origin country + currency).

1. Ön gereksinimler

• Aktif bir Sendcloud hesabı. Yoksa sendcloud.com üzerinden açın.
• En az bir gönderici (sender) adresi Sendcloud panelinde tanımlı olmalı. Settings → Shipping → Addresses.
• En az bir carrier sözleşmesi (Sendcloud broker veya kendi direct kontratınız). Settings → Carriers altından aktive edilir; broker kontratları anlık başlar, kendi DHL/UPS hesabınız varsa onu da bağlayabilirsiniz.
• Mağaza para biriminiz EUR/GBP/USD/DKK/NOK/SEK/CHF/PLN/CZK içinde olmalı — diğer para birimlerinde Sendcloud provider listesinde görünmez.
• Sender address ülkesi EU + UK + İrlanda + İskandinavya içinde olmalı (NL/BE/DE/FR/GB/AT/ES/IT/PT/CH/DK/SE/NO/PL/CZ/IE/FI).
• Wallet bakiyesi. Sendcloud her label için hesaptan otomatik düşer; sıfır bakiyeli hesap announce'da hata verir.

2. Sendcloud Public + Secret key

Sendcloud HTTP Basic auth kullanır ve iki parça key ister: Public Key + Secret Key.

1. Sendcloud panel'e giriş yapın.
2. Settings → Integrations → + Add integration → "Sendcloud API" seçin.
3. Integration için bir isim verin (örn. "Nevuto").
4. Submit'e basın → Sendcloud otomatik olarak bir Public Key ve Secret Key üretir.
5. Her ikisini de kopyalayın — bir sonraki adımda Nevuto'ya yapıştıracaksınız.

⚠️ Secret Key tek seferlik gösterilir. Kaçırırsanız integration'ı silip yeniden oluşturmanız gerekir.

3. Nevuto'da Sendcloud'ı bağlama

1. Nevuto admin panelinden Settings → Shipping → Shipping providers menüsüne gidin.
2. Listeden Sendcloud'u seçin.
3. Public key alanına Sendcloud'tan kopyaladığınız public key'i yapıştırın.
4. Secret key alanına secret key'i yapıştırın.
5. Enable shipping method toggle'ını açın.
6. Submit'e tıklayın.

Submit anında Nevuto:

• Public ve Secret anahtarlarınızı güvenli olarak kaydeder
• Sendcloud hesabınıza webhook bağlantısını otomatik kurar — manuel adım gerekmez
• Sipariş durum güncellemeleri buradan size ulaşır

4. Preferred carriers (tercih edilen carrier'lar)

Kaydettikten sonra altta Settings kartı açılır. Burası Sendcloud'a özel ayarlar:

1. Preferred carriers dropdown'ına Sendcloud hesabınızda aktif olan carrier kısa kodlarını girin (örn. dhl_de, dpd, postnl, ups, gls).
2. Submit edin.

Davranış:

• Sipariş gönderilirken Nevuto, tercih ettiğiniz carrier'lar arasından en uygun fiyatlı seçeneği seçer.
• Hiçbir carrier seçmezseniz, hesabınızdaki tüm aktif carrier'lar arasından en ucuzu seçilir.
• Tercih ettiğiniz carrier o güzergaha hizmet vermiyorsa diğer seçenekler arasından en ucuzu kullanılır (siparişiniz aksamaz).

💡 Liste otomatik güncellenir — Sendcloud hesabınızda yeni bir carrier sözleşmesi imzaladığınızda dropdown'da görünür.

5. Sender address (gönderici adresi)

Sender address Sendcloud panel'inde tanımlanır; Nevuto sender'ı otomatik resolve eder:

1. Sendcloud panel → Settings → Shipping → Addresses → en az bir sender ekleyin.
2. Birden fazla varsa Nevuto ilk sender'ı varsayılan olarak seçer.

Eğer farklı bir sender kullanmak isterseniz: Sendcloud panel'den default address'i değiştirin; Nevuto bir sonraki gönderimde yeni adresi kullanır.

6. Shipping packages (paket şablonları)

Sendcloud paket boyutlarını her gönderimde ister: length × width × height + ağırlık. Nevuto bu bilgileri üç farklı yerden alabilir, öncelik sırası:

1. Variant LWH bilgileri — ürün varyantında doğrudan girilmişse
2. ShippingPackage referansı — varyant bir paket şablonuna bağlıysa o şablonun ölçüleri
3. Mağaza varsayılan paketi — Settings → Shipping → Packages altında "Default" işaretli olan paket
4. Fallback: Sendcloud kendi tahmin algoritmasını kullanır (genelde under-quote eder)

Adımlar:

1. Settings → Shipping → Packages sayfasına gidin.
2. Add package → Ad, Tip (Box/Envelope/Soft pack), L/W/H/birim, ağırlık girin.
3. Set as default → mağaza-geneli fallback için bir paketi varsayılan yapın.

7. Variant LWH (varyant boyutları)

En doğru fiyat için her varyanta gerçek boyut girmenizi öneririz:

1. Products → ürün düzenle → Variants sekmesi.
2. Her satırda Length / Width / Height / Weight alanlarını doldurun.
3. Birim olarak cm veya in seçin.

8. Customs declaration (uluslararası gönderim)

EU dışına gönderim yaparken Sendcloud otomatik olarak customs declaration ekler:

• HS code: Nevuto'da ürün bazında saklanmıyor → boş gönderilir. Sendcloud panel'inde manuel ekleyebilirsiniz.
• Item value: order line item'ın fiyatından alınır.
• Origin country: sender'ın ülkesi.
• Currency: order currency code (Sendcloud çoklu para birimi destekler).
• Contents type: commercial_goods (1).

💡 Müşteriniz EU dışına regular gönderim yapıyorsa HS code'ları girmenizi öneririz — gümrük gecikmelerini minimize eder.

9. Sipariş gönderme

Müşteri ödemeyi yaptıktan sonra sipariş admin panelinizde "Mark as shipped" butonu ile gönderime hazır görünür.

1. Order detail sayfasını açın.
2. Mark as shipped butonuna basın.
3. Açılan modal'da provider olarak Sendcloud'u seçin ve Submit edin.
4. Birkaç saniye içinde sipariş satırında tracking numarası, tracking link ve "Print label" butonu belirir. Aynı anda Sendcloud cüzdanınızdan etiket ücreti düşer.
5. Print label'a tıklayarak etiketi PDF olarak açın, yazdırın ve pakete yapıştırın.
6. Paketi seçtiğiniz carrier'a teslim edin — gerisi otomatik takip edilir.

💡 Müşteri kendi sipariş sayfasından tracking link'i ile gönderiyi takip edebilir; ayrıca durum değiştikçe email bilgilendirmesi alır.

10. Status lifecycle (durum güncellemesi)

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← Etiket basıldı, parcel henüz handover edilmedi
    │
    ▼   Carrier paketi taradığında
[shipping_status: SHIPPED]         ← v3 event-subscriptions webhook tetiklenir
    │
    ▼   Müşteriye teslim
[shipping_status: DELIVERED]       ← Webhook

Nasıl çalışıyor:

1. Sendcloud ayarlarını kaydederken Nevuto, Sendcloud hesabınıza otomatik bir webhook bağlantısı kurar.
2. Carrier paketi taradığında Sendcloud Nevuto'ya bildirim gönderir.
3. Nevuto siparişi tracking number ile bulup durumunu otomatik günceller.

Manuel müdahale gerekmez — webhook bağlantısı kurulumda otomatik kurulmuştur.

11. Test modu

Sendcloud'un gerçek anlamda bir test ortamı yoktur — her gönderim gerçek bir etiket üretir ve cüzdandan ücret keser.

Pratik test yaklaşımı:

1. Üretim hesabınızla küçük tutarlı bir gönderim yapın (örn. en ucuz mailbox 1-2 € civarı)
2. Tracking number'ın geldiğini, "Print label" butonunun PDF açtığını, durum güncellemesinin otomatik geldiğini doğrulayın
3. Sonra normal akışa geçin

12. Sık karşılaşılan sorunlar

A. "User not allowed to announce" hatası

• Hesabınızda ödeme yöntemi ayarlanmamış veya cüzdanda bakiye yok. Sendcloud panel → Settings → Financial → cüzdanınıza top-up yapın.

B. Webhook gelmiyor / status güncellenmiyor

• Sendcloud panel → Settings → Integrations → integration'ınızda "Event subscriptions" sekmesini kontrol edin. En az bir "Parcels event" subscription olmalı.
• Nevuto admin'de Submit'e tekrar basın — webhook bağlantısı yeniden kurulur.

C. International order için customs warning

• HS code'ları Nevuto'da ürün bazında saklanmıyor → boş gönderilir. Sendcloud panel'inde manuel girip etiketi yeniden basabilirsiniz.

D. Provider listesinde görünmüyor

• Mağaza para biriminiz EUR/GBP/USD/… dışındaysa veya sender country EU/UK/İskandinavya dışındaysa Sendcloud "Not available" olarak görünür. Settings → General → Currency veya Settings → Locations → Country'i uygun değere değiştirin.

13. Sonraki adımlar

• Üretim siparişlerini ilk hafta izleyin — Sendcloud dashboard ile Nevuto arasında tutarlılık kontrolü yapın
• Shipping rate'lerinize kâr marjı ekleyin — Sendcloud'un dönen fiyatı maliyet; müşteriden almak istediğiniz tutara göre Settings → Shipping → Rates'i ayarlayın
• Tatil dönemlerinde Sendcloud dashboard'unu açık tutun — multi-carrier failover izlemek için faydalı

Soru / yardım

• Sendcloud tarafı: support@sendcloud.com veya panel chat
• Nevuto tarafı: support@nevuto.com