Ana içeriğe atla
nevuto.com'a git

Nevuto için MyParcel entegrasyonu

Yayın: 29 Nisan 20266 dk okuma1 hafta önce güncellendi

MyParcel nedir?

MyParcel, Hollanda merkezli çok-taşıyıcılı bir kargo agregatörüdür. Tek bir API üzerinden PostNL, DPD ve bpost'a hem NL/BE içinde hem de EU genelinde gönderim yapabilirsin. Her taşıyıcıyla ayrı sözleşme yönetmek yerine MyParcel üzerinden tek noktadan etiket basıp gönderim oluşturursun.

Nevuto MyParcel'ı nasıl yönetir?

  • API key girip Submit ettiğin anda Nevuto MyParcel webhook bağlantısını otomatik kurar — manuel adım gerekmez.
  • Sender adresi MyParcel panelindeki kayıttan çekilir (Nevuto custom sender override yapamaz — MyParcel API'si izin vermiyor).
  • Sipariş satırından Print label ile MyParcel etiketini PDF olarak yeni sekmede açıp basabilirsin.
  • Post-payment hesaplarda etiket anında üretilir, fatura dönem sonu kesilir. Pre-payment hesaplarda etiket ücreti MyParcel cüzdanından düşülür.
  • Carrier paketi taradığında webhook ile shipping_status ve gerçek carrier barcode'u Nevuto'da otomatik güncellenir.

1. Ön gereksinimler

  • Aktif bir MyParcel hesabı. Yoksa myparcel.nl üzerinden açın (NL business registration gerekli).
  • MyParcel hesabınızda kayıtlı bir sender address. Account → Settings → Sender address. Bu adres tüm gönderimler için kullanılır (Nevuto custom sender override yapamaz — MyParcel API'si izin vermiyor).
  • Sender adresi NL veya BE olmalı. MyParcel sadece Hollanda ve Belçika'dan gönderim yapar.
  • Mağaza para biriminiz EUR olmalı. MyParcel customs item value sadece EUR kabul eder; başka para birimindeki shop'larda provider listesinde "Not available" görünür.
  • Wallet bakiyesi (pre-payment hesaplarda zorunlu). Post-payment ise faturalandırma sonradan.

2. MyParcel API key

  1. MyParcel hesabınıza giriş yapın.
  2. Account → Settings → API bölümüne gidin.
  3. Generate API key ile yeni bir token üretin.
  4. Token'ı kopyalayın — bir sonraki adımda Nevuto'ya yapıştıracaksınız.

⚠️ Token'ı olduğu gibi yapıştırmanız yeterli — Nevuto MyParcel'ın özel auth formatını sizin için işler.

3. Nevuto'da MyParcel'ı bağlama

  1. Nevuto admin panelinden Settings → Shipping → Shipping providers menüsüne gidin.
  2. Listeden MyParcel'i seçin.
  3. API key alanına MyParcel'dan kopyaladığınız token'ı yapıştırın.
  4. Enable shipping method toggle'ını açın.
  5. Submit'e tıklayın.

Submit anında Nevuto:

  • API key'i güvenli olarak kaydeder
  • MyParcel hesabınıza webhook bağlantısını otomatik kurar — manuel adım gerekmez
  • Sipariş durum güncellemeleri buradan size ulaşır

4. Preferred carrier (tercih edilen carrier)

Kaydettikten sonra altta Settings kartı açılır:

  1. Preferred carrier dropdown'ından bir veya birden çok carrier seçin (PostNL / DPD / bpost).
  2. Submit edin.

Davranış:

  • Sipariş gönderilirken Nevuto, tercih ettiğiniz ilk carrier'ı kullanır (MyParcel her gönderim için tek carrier kabul eder).
  • Birden fazla seçerseniz tercih sıranızın en üstündeki carrier kullanılır.
  • Hiçbir seçmezseniz PostNL varsayılan olarak kullanılır (NL'in yerel carrier'ı, en geniş kapsama).

5. Sender address

MyParcel sender override'a izin vermez — sender adresinizi MyParcel panel'inde ayarlayın:

  1. MyParcel hesap → Account → Settings → Sender address
  2. Adres NL veya BE olmalı (zorunlu)
  3. Phone, email, company name eksiksiz olmalı (carrier reject etmez ama bazı edge case'lerde problem çıkar)

Nevuto bu adresi her shipment'ta otomatik olarak kullanır.

6. Shipping packages (paket şablonları)

MyParcel paket boyutlarını ve ağırlığını her gönderimde ister. Nevuto bu bilgiyi şu sırayla alır:

  1. Variant LWH bilgileri — ürün varyantında girilmişse (en doğru)
  2. ShippingPackage referansı
  3. Mağaza varsayılan paketi
  4. Son çare: boyutlar atlanır → MyParcel kendi tahminini kullanır (genelde olduğundan düşük fiyat alır)

Adımlar:

  1. Settings → Shipping → Packages sayfasına gidin.
  2. Add package → Ad, Tip, L/W/H/birim, ağırlık.
  3. Set as default → mağaza-geneli fallback.

7. Variant LWH

Her varyanta gerçek boyut girmenizi öneririz:

  1. Products → ürün düzenle → Variants sekmesi.
  2. Length / Width / Height / Weight alanlarını doldurun.
  3. Birim cm veya in, weight için g veya kg.

8. Customs declaration (uluslararası)

NL/BE → EU dışı gönderimlerde Nevuto otomatik gümrük bildirimi ekler:

  • Items: sipariş satırları (ürün açıklaması, adet, ağırlık, menşe ülke)
  • Item value: satır birim fiyatı
  • Currency: her zaman EUR olarak gönderilir

⚠️ MyParcel gümrük bildirimlerinde sadece EUR kabul eder. Mağaza para biriminiz USD/GBP olsa bile değer EUR olarak yazılır (rakamsal değer korunur, kur dönüşümü yapılmaz). Düşük değerli ürünlerde €22 gibi muafiyet eşikleri civarında dikkat etmenizi öneririz.

HS kodu: Nevuto'da ürün bazında saklanmıyor → boş gönderilir. MyParcel panel'inde manuel ekleyebilirsiniz.

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 MyParcel'i seçin ve Submit edin.
  4. Birkaç saniye içinde sipariş satırında geçici tracking referansı ve "Print label" butonu belirir. Gönderim MyParcel panel'inde önce "concept" (taslak) statüsünde oluşur.
  5. Print label'a tıklayın:
    • Post-payment hesap: PDF anında açılır, fatura dönem sonu kesilir.
    • Pre-payment hesap: Cüzdandan ücret düşer, sonra PDF açılır. Cüzdan boşsa "Label not available yet — wallet may need funding" uyarısı görürsünüz. Cüzdana fon yatırın, butona tekrar basın.
  6. Etiketi yazdırın, pakete yapıştırın ve seçtiğiniz carrier'a teslim edin.

💡 Etiket basıldıktan sonra geçici tracking referansı yerine gerçek carrier barcode'u otomatik olarak güncellenir. Müşteri de tracking link'i ile gönderiyi takip edebilir.

10. Status lifecycle (durum güncellemesi)

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← concept status, shipment_id geçici tracking
    │
    ▼   MyParcel label generate edilir (status ≥2)
[tracking_number = barcode]        ← webhook ile gerçek carrier barcode gelir, tracking number güncellenir
    │
    ▼   Carrier paketi taradığında (status ≥3)
[shipping_status: SHIPPED]         ← webhook
    │
    ▼   Müşteriye teslim (status ≥7)
[shipping_status: DELIVERED]       ← webhook

MyParcel durum eşleştirmesi (Nevuto):

  • Taslak / kayıtlı → Processing (değişiklik yok)
  • Carrier'a teslim, sıralama, dağıtım, gümrük → Shipped
  • Teslim edildi, pickup hazır, alındı, iade adımları → Delivered
  • Yazdırıldı, iptal vb. → yok sayılır

Webhook bağlantısı Nevuto tarafından otomatik kurulmuştur — manuel müdahale gerekmez.

11. Label download

"Print label" butonuna tıklayınca Nevuto, MyParcel'dan etiketi indirip yeni sekmede açar:

  • Sonradan ödeme hesabı: PDF anında açılır
  • Önceden ödeme hesabı (cüzdan boş): "Label not available yet — your shipping wallet may need funding" şeklinde bir bildirim gösterilir

Bu durumda MyParcel hesabınızdaki cüzdana fon yatırıp tekrar deneyin.

12. Test modu

MyParcel'in gerçek bir sandbox/test ortamı yoktur. Test stratejisi:

  • Concept stage'de bırak: shipment oluşur ama label basılmaz → maliyet sıfır. Sonra panel'den shipment'ı silip kaldırabilirsiniz.
  • Düşük tutarlı gerçek test: PostNL Pakketten Buitenland veya yurtiçi €4-5 deneme gönderimi.

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

A. "Label not available yet — wallet may need funding"

  • Hesabınız önceden ödeme modelindedir, cüzdanda bakiye yok. MyParcel hesabınıza giriş yapıp cüzdana fon yatırın, sonra "Print label"'a tekrar basın.

B. Tracking numarası değişti

  • Beklenen davranış. Nevuto önce geçici bir kimlik tracking olarak gösterir; carrier etiketi bastığında gerçek tracking barcode otomatik olarak güncellenir.

C. Provider listesinde görünmüyor

  • Mağaza para biriminiz EUR değil → "Not available in your store currency. Supports: EUR" uyarısı.
  • Mağaza adresinizin ülkesi NL/BE değil → "Doesn't ship from your shop location" uyarısı.
  • Settings → General → Currency veya Settings → Locations → Country alanlarını uygun değere getirin.

D. Webhook gelmiyor / durum güncellenmiyor

  • MyParcel hesabınızda Webhook subscriptions'da kayıt var mı kontrol edin. Nevuto'da MyParcel ayarlarına gidip Submit'e tekrar basın — webhook bağlantısı yeniden kurulur.

14. Sonraki adımlar

  • Üretim siparişlerini ilk hafta izleyin
  • HS code'ları MyParcel panel'inde ekleyin EU dışı gönderimler için
  • Shipping rate'lerinize kâr marjı ekleyin

Soru / yardım

İlgili makaleler