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
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
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
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_12345678-1234-1234-1234-123456789stu"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
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
shipmentCreateWorkflowmutasyonunu 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.