Etiket yazdırmayı etkinleştir
Müşterilerinizin platformunuzdan Zonos etiketlerini alabilmesi için aşağıdaki adımları izleyin.
API kimlik bilgilerini izin verin
Zonos API'si bir credentialToken ile erişilebilir. Platformunuz, müşterilerin Zonos Dashboard üzerinden credentialToken'larını girme imkanı sağlamalıdır. Buradan, onların adına Zonos'a isteklerde bulunabileceksiniz.
Bir gönderi oluşturun
Bir label almak için, label ile ilişkilendirilecek bir shipment oluşturmanız gerekmektedir. Zonos bu süreci, aynı istekte shipments ve labels oluşturan bir iş akışı ile yönetir. Bu mutasyonu gerçekleştirirken, order ile bağlantılı olan landedCost'tan kullanılan serviceLevel'i geçmenize gerek yoktur. orderId için, Zonos sipariş kimliğini veya sisteminizde muhtemelen zaten bulunan accountOrderNumber'ı kullanabilirsiniz.
Bir gönderi ve etiketler başarıyla oluşturulduğunda, etiketleri BASE64_ENCODED_IMAGE olan bir labelImage olarak veya etiketin alınabileceği bir url olarak döndüreceğiz.
Mevcut bir sipariş için gönderi oluşturduğunuzda ve ürün veya taraf detaylarını değiştirmeye ihtiyacınız olmadığında bu iş akışını kullanın. Opsiyonel takip numaraları, yerine getirme merkezleri, hizmet seviyesi seçimi ve beyan değeri sigortasını destekler.
Mutation
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
documentFiling
}
}
}
}
Temel Değişkenler
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
Tamamlayıcı Merkez ile
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
Özel Takip ile
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
Hizmet Seviyesi ile
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
Beyan edilen değer sigortası ile
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789mno",
"isDeclaredValue": true
}
}
Beyan edilen değer
Beyan edilen değer kapsamını tüm gönderi öğeleri için etkinleştirmek üzere "isDeclaredValue": true ayarını yapın. Zonos siparişte sunulan tüm öğelerin tam değerini otomatik olarak talep eder; satıcılar bu miktarı değiştiremez. Bu, taşıyıcının kayıp, hasar veya hırsızlık durumunda kabul edeceği maksimum sorumluluğu belirler. Bu özellik yalnızca UPS, FedEx ve DHL gönderileri için desteklenmektedir. Zonos beyan edilen değeri etkinleştirdiğinizde, taşıyıcıya özgü uygulamayı otomatik olarak yönetir; bu taşıyıcılara yapılan API çağrılarında uygun parametreleri içerir, böylece farklı taşıyıcı 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 düzeyinde işler. Çoklu karton gönderileri için, satıcılar her karton için kapsam belirlemek üzere gönderiyi bölmelidir. UPS ayrıca etiketlerle birlikte basılması gereken ek bir sigorta formu oluşturur.
FedEx ve DHL: Ek kısıtlama olmaksızın gönderi düzeyinde beyan edilen değeri işler.
Bir gönderimi iptal etme
Bir müşterinin bir gönderimi iptal etmek istemesi durumunda, gönderim ile bağlantılı tüm etiketleri iptal edecek olan aşağıdaki mutasyonu kullanabilirsiniz.
Talep
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
Platformunuzdan gönderi oluşturun
Müşterilere platformunuzdan Zonos gönderileri ve etiketleri oluşturma imkanı verin.
Bu kılavuz, müşterileri için Zonos gönderi oluşturma yeteneklerini platformlarına entegre etmek isteyen gönderim platformu geliştiricileri için tasarlanmıştır. Eğer zaten Zonos API'sini kullanıyorsanız ve yalnızca mevcut siparişler için gönderi oluşturmanız gerekiyorsa, gönderi oluşturma kılavuzumuza göz atın.
Eğer uluslararası gönderim yapan Zonos müşterilerini destekleyen bir gönderim platformuysanız, gönderi oluşturma için Zonos ile entegrasyon en önemli önceliklerinizden biri olmalıdır. Bu, platformunuzun mevcut özelliklerini kullanarak tüccarlarınıza ve onların müşterilerine en sorunsuz deneyimi sunmanızı sağlayacak, aynı zamanda Zonos'un gönderi, etiket ve destekleyici gümrük belgelerinin oluşturulmasını yönetmesine izin verecektir.
Zonos kullanarak gönderi oluşturmanın avantajları şunlardır:
Bu kılavuz, platformunuzdan gönderiler için Zonos'u çağırmanıza olanak tanıyan tam bir uçtan uca entegrasyonun adımlarını size gösterecektir.