DOCS

Bir gönderi oluşturun

Mevcut siparişler için bir gönderi oluşturun

Landed cost hesapladıktan ve siparişler oluşturduktan sonra Zonos API'si ile gönderiler ve etiketler oluşturun.

GraphQL

Bu kılavuz, Zonos API'si ile entegre olan ve sistemlerinde mevcut siparişler için gönderi oluşturması gereken kullanıcılar için tasarlanmıştır. Eğer bir gönderi platformuysanız ve müşterilerinize Zonos gönderi oluşturma hizmeti sunmak istiyorsanız, Gönderi API kılavuzumuza göz atın.

Eğer Zonos API'si ile entegre olduysanız ve Dashboard dışına gönderim yapmak için onay aldıysanız, gönderi oluşturmak ve takip bilgilerini sağlamak için shipmentCreateWorkflow mutasyonunu kullanın. Bu mutasyonlar ayrıca Zonos'a iç gönderimler hakkında bilgi vermenizi sağlar.

Not: Eğer bir Görev ve Vergi uygulaması kullanıyorsanız ve takip numaralarını otomatik olarak Zonos ile senkronize eden bir platformda iseniz veya doğrudan Dashboard üzerinden gönderim yapıyorsanız, bu mutasyonlar gerekli değildir.

API aracılığıyla gönderi oluşturun 

Landed Cost hesapladıktan ve bir sipariş oluşturduktan sonra, takip numaralarını ve diğer gönderi detaylarını Zonos'a API aracılığıyla gönderebilirsiniz.

Mevcut bir sipariş için bir 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ını, yerine getirme merkezlerini, hizmet seviyesi seçimlerini ve beyan edilen değer sigortasını destekler.

Mutasyon

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
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

1
2
3
4
5
6
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789abc"
  }
}

Tamamlayıcı Merkez ile

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789def",
    "fulfillmentCenter": "fulfillment_center_12345"
  }
}

Özel Takip ile

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": false,
    "orderId": "order_12345678-1234-1234-1234-123456789ghi",
    "trackingNumbers": ["tracking_example_1", "tracking_example_2"]
  }
}

Hizmet Seviyesi ile

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789jkl",
    "serviceLevel": "dhl.express_example"
  }
}

Beyan edilen değer sigortası ile

1
2
3
4
5
6
7
{
  "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 

Oluşturulmuş bir etiketi iptal etmek için, gönderimi iptal etmek üzere aşağıdaki mutasyonu kullanın. İlgili tüm etiketler de otomatik olarak iptal edilecektir. Bir gönderim iptal edildikten sonra, güncellenemez veya geri yüklenemez.

Mutasyon

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_12345678-1234-1234-1234-123456789stu"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

Bu sayfa faydalı mıydı?