Etiket yazdırmayı etkinleştirin
Müşterilerin platformunuzdan Zonos etiketlerini almasına izin vermek için aşağıdaki adımları izleyin.
API kimlik bilgilerine izin verin
Zonos API bir credentialToken ile erişilebilir. Platformunuz, müşterilerin Zonos Dashboard'dan credentialToken değerlerini platformunuza girme imkanı vermesi gerekir. Buradan, onlar adına Zonos'a istekler yapabileceksiniz.
Kargo oluşturun
label almak için, label'in ilişkilendirileceği bir shipment oluşturmanız gerekir. Zonos bu işlemi shipment ve label'leri aynı istekte oluşturan bir iş akışı ile yönetir. Bu mutasyonu gerçekleştirirken, shipment ile bağlantılı landedCost'tan kullanılan serviceLevel'i kullanacağımız için serviceLevel iletmenize gerek yoktur. orderId için, Zonos sipariş ID'sini veya muhtemelen sisteminizde zaten var olan accountOrderNumber'ı kullanabilirsiniz.
Kargo ve etiketler başarıyla oluşturulduğunda, etiketleri bir labelImage olarak döndüreceğiz ki bu bir BASE64_ENCODED_IMAGE'dır veya etiketin alınabileceği bir url olarak.
Mevcut bir sipariş için kargo oluştururken ve öğe veya taraf detaylarını değiştirmenize gerek olmadığında bu iş akışını kullanın. İsteğe bağlı izleme numaraları, yerine getirim merkezleri, hizmet seviyesi seçimi ve beyan edilen değer sigortasını destekler.
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) { shipmentCreateWorkflow(input: $input) { id status trackingDetails { number } serviceLevel { id name carrier { id name } } shipmentCartons { id carton { id width length height weight items { item id amount description label url trackingNumber id documentFilingDeğişken seçenekleri:
- Yerine Getirim Merkezi ile: Origin konumunu belirtmek için
"fulfillmentCenter": "fulfillment_center_12345"ekleyin - Özel İzleme ile:
"generateLabel": falseayarlayın ve"trackingNumbers": ["tracking_1", "tracking_2"]ekleyin - Hizmet Seviyesi ile: Belirli bir kargo şirketi hizmetini seçmek için
"serviceLevel": "dhl.express_example"ekleyin - Beyan Edilen Değer Sigortası ile: Beyan edilen değer kapsamını etkinleştirmek için
"isDeclaredValue": trueekleyin - Özel Hizmetler ile: Piller, kuru buz, tehlikeli mallar ve imza seçenekleri için özel hizmetler rehberine bakın.
Beyan edilen değer
Siparişinizdeki tüm öğeler için beyan edilen değer kapsamını etkinleştirmek için "isDeclaredValue": true ayarlayın. Zonos otomatik olarak siparişte gönderilen tüm öğelerin tam değerini talep eder; tüccarlar bu tutarı değiştiremezler. Bu, taşıyıcının transit sırasında kayıp, hasar veya hırsızlık durumunda kabul edeceği maksimum sorumluluğu belirler. Bu özellik yalnızca UPS, FedEx ve DHL kargolar için desteklenir. Zonos, bu kargo şirketlerine API çağrılarımızda uygun parametreler de dahil olmak üzere taşıyıcıya özel uygulamayı otomatik olarak işler, böylece farklı kargo şirketi gereksinimlerini yönetmenize gerek kalmaz.
UPS sınırlamaları: UPS yalnızca 100-50.000 USD arasındaki değerleri kapsar ve beyan edilen değeri karton seviyesinde işler. Çok kartonlu kargolar için, tüccarlar karton başına teminatı belirlemek için kargoyu bölmelidir. UPS ayrıca etiketlerle birlikte yazdırılması gereken ek bir sigorta formu oluşturur.
FedEx ve DHL: Kargo seviyesinde ek kısıtlamalar olmadan beyan edilen değeri işler.
Özel hizmetler
Piller, kuru buz, tehlikeli mallar veya imza gereksinimleri için özel kullanım gereksinimleri belirtmek için kartonlarda specialServices kullanın. Tam detaylar ve örnekler için özel hizmetler rehberine bakın.
ShipStation UPS Kilidini Aç: Çok parçalı kargolar desteklenmez. Bir sipariş birden fazla kutuda gönderildiğinde, referans alanı kopyalanarak backend'de sipariş numarası eşleştirmesi başarısız olur. Çok parçalı kargo gereken tüccarlar, bunun yerine Zonos Dashboard'da etiket oluşturmalıdır. Tek kutulu kargolar etkilenmez.
Kargoyu iptal edin
Müşteri bir shipment'i iptal etmek isterse, shipment ile bağlantılı tüm label'leri iptal edecek aşağıdaki mutasyonu kullanabilirsiniz.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
Platformunuzdan kargo oluşturun
Müşterilere platformunuzdan Zonos kargo ve etiketleri oluşturma imkanı verin.
Bu rehber, Zonos kargo oluşturma yeteneklerini platformlarına entegre etmek isteyen kargo platformu geliştiricileri için tasarlanmıştır. Eğer zaten Zonos API'yi kullanıyorsanız ve sadece mevcut siparişler için kargo oluşturmanız gerekiyorsa, kargo oluşturma rehberimize bakın.
Eğer siz Zonos müşterilerinin uluslararası kargo göndermesini destekleyen bir kargo platformu iseniz, Zonos ile entegrasyon yapmak kargo oluşturma için başlıca bir husus olmalıdır. Bu, platformunuzun mevcut özelliklerinden yararlanırken Zonos'un kargo, etiket ve destekleyici gümrük belgelerinin oluşturulmasını yönetmesine izin vererek, tüccarlarınız ve müşterileriniz için en sorunsuz deneyimi sağlamanıza olanak tanır.
Zonos'u kargo oluşturmak için kullanmanın avantajları:
Bu rehber, platformunuzdan Zonos'a kargo için çağrı yapmanıza olanak tanıyacak tam uçtan uca bir entegrasyonu uygulamak için adımlarında sizi yönlendireceğiz.