Tek bir sevkiyat oluşturun

CreateDeclarationShipment, altı *Workflow mutasyonunu tek bir GraphQL isteğinde birleştirir. Her adım, önceki adımların sağladığı verilere dayanır ve tüm verileri birlikte gönderilir, böylece tam bir sevkiyat tek bir gidiş-dönüş içinde oluşturulabilir:

partyCreateWorkflow            → origin + destination taraflarını tanımla
itemCreateWorkflow             → satır öğelerini tanımla
cartonsCreateWorkflow          → fiziksel ambalajlamayı tanımla
shipmentRatingCreateWorkflow   → taşıyıcı oran teklifini kaydet
landedCostCalculateWorkflow    → gümrük vergileri ve ücretlerini hesapla
shipmentCreateWorkflow         → sevkiyat + etiket oluştur

Workflow mutasyonları zincirleme yapılmak üzere tasarlanmıştır: bir adımdan diğerine ID'leri iletmeniz gerekmez ve adım başına ayrı bir istek göndermeniz gerekmez. Tüm belgeyi gönderin, son Shipment'i geri alın.

Son adımdaki serviceLevel bir Japan Post hizmet seviyesi olduğunda (japan_post.*), Zonos sizin adınıza Japan Post Label API'sini (kod 52) çağırır ve Doğrulanmış Hesabınızın Later Pay Numaralarını kullanarak etiketi ve takip numarasını oluşturur, Declaration ID'sini oluşturur ve bunları bağlar — tümü bu son shipmentCreateWorkflow adımında.

Neden bir mutasyon? Her adım bir öncekisine bağlıdır (iniş maliyeti öğe + tarafları gerektirir; etiket her şeyi gerektirir). Bunları tek bir GraphQL belgesinde birleştirmek, veri tutarlılığını sağlar ve beş ekstra gidiş-dönüşü önler.

Endpoint ve kimlik doğrulama 

Bu zincirdeki isteklerin tümü aynı endpoint'i kullanır. Başlıklara ne koyacağınız kurulumunuza bağlıdır — sekmeinizi seçin.

URL:

https://api.zonos.com/graphql

Başlıklar:

credentialToken: {{YOUR_API_TOKEN}}

Örnek istek 

Kopyalayabileceğiniz ve uyarlayabileceğiniz tam bir CreateDeclarationShipment isteği — mutasyon, değişkenleri ve yanıt — tek bir Japan Post paketi ABD'ye DDP olarak gönderirken. Her giriş, aşağıdaki adım adım bölümünde açıklanmıştır.

Adım adım 

Aşağıdaki tablolarda Status sütunu bu terimleri kullanır:

• Gerekli — istek olmadan başarısız olur.
• Etiket için gerekli — GraphQL şemasında isteğe bağlı, ancak geçerli bir Japan Post ABD etiketi üretmek için gerekli.
• Koşullu — başka bir alana bağlı olarak gerekli (satır içinde belirtilmiştir).
• Önerilen — isteğe bağlı, ancak doğru vergileri ve vergileri yönlendirir.
• İsteğe bağlı — gerekli değildir.

1. partyCreateWorkflow

Sevkiyatla ilgili tarafları oluşturur — en azından bir ORIGIN (sevkiyatın nereden gönderileceği) ve bir DESTINATION (alıcı / konsinyatör).

Örnek yük:

[
  { "type": "DESTINATION", "location": { "countryCode": "US" }, "person": {} },
  { "type": "ORIGIN", "location": { "countryCode": "JP" }, "person": {} }
]

Yanıt, oluşturulan Party ID'lerini ve çözümlenen adres alanlarını döndürür.

2. itemCreateWorkflow

Sevkiyatı oluşturan satır öğelerini oluşturur. Bunlar, ticari faturada görünecek ve iniş maliyeti hesaplamasını yönlendirecek SKU'lardır.

HS kodu, menşe ülkesi ve tutar, 5. adımdaki vergi/vergi sonucunu en çok etkileyen üç alandır.

3. cartonsCreateWorkflow

Fiziksel paketleri — kutular, polybag'lar veya öğeleri tutacak mektupları oluşturur.

Her karton, 6. adımdaki taşıyıcı etikette bir parsel haline gelir. Birden fazla karton → bir takip numarası ile çok parçalı sevkiyat.

4. shipmentRatingCreateWorkflow

Oran teklifini kaydeder — satıcının alıcıya kargo için talep ettiği tutar.

Bu, alıcıya kasa sırasında teklif edilen orandır. Gümrük ve vergiler doğru CIF değerine karşı hesaplanacak şekilde iniş maliyeti hesaplamasına "kargo" alt toplamı olarak girer.

5. landedCostCalculateWorkflow

Hedef ülke için gümrük vergileri ve ücretler hesaplaması çalıştırır. Önceki adımlardan öğeleri, tarafları ve kargo maliyetini kullanır.

Yanıt, amountSubtotals (duties, taxes, fees, shipping, landedCostTotal) içerir — bunlar, alıcıya kasa sırasında göstereceğiniz ve ticari faturada basılacak sayılardır.

6. shipmentCreateWorkflow

Terminal adımı — Shipment varlığını oluşturur, taşıyıcı etiketi ve (isteğe bağlı olarak) ticari faturayı / paketleme taslağını oluşturur.

Japan Post Doğrulanmış Hesapları için, Zonos'un sizin adınıza Japan Post Label API'sini (kod 52) çağırdığı, Later Pay Numaralarınızı enjekte ettiği, Declaration ID'sini oluşturduğu ve bunları takip numarasına bağladığı yerdir.

Önemli alanlar:

references alt giriş

Bu alanlar taşıyıcı etiketinde ve/veya ticari faturada basılı. Konsinyatör veya gümrük otoritesinin görmesi gereken PO numaralarını, lisans numaralarını ve serbest metin açıklamalarını yüzeye çıkarmak için bunları kullanın.

Yanıt

Döndürülen Shipment'daki ilginç alanlar:

{
  id
  trackingDetails {
    number
  }
  shipmentCartons {
    label {
      url
      labelImage
    }
  }
}

trackingDetails.number Japan Post takip numarasıdır.

label nesnesi etiketi iki şekilde döndürebilir — iş akışınıza uyan şeyi isteyin (veya her ikisini):

Yalnızca gerekli alanları seçin. url istemek yanıtı küçük tutar; labelImage istemek tam etiketi satır içinde döndürür, böylece almak için ikinci bir gidiş-dönüş gerekmez. Yukarıdaki örnek url istemektedir.

Hata işleme 

• Doğrulama hataları (eksik gerekli alanlar, geçersiz ülke kodları, vb.) standart GraphQL errors dizisinde geri gelir ve zincirin geri kalanını durdurur.
• Japan Post hataları (etiket üretim hatası, geçersiz adres, vb.) shipmentCreateWorkflow üzerinde GraphQL hataları olarak yüzeye çıkar. Yeniden deneme gerekiyorsa, desteğe başvurun — önerilen yol, tam mutasyonu düzeltilmiş girdilerle yeniden göndermektir.

İzinler 

Her adım bağımsız olarak güvenliği sağlanır. API anahtarınız, zincirdeki her varlık için yazma kapsamını (ITEM_WRITE, CARTON_WRITE, SHIPMENT_RATING_WRITE, LANDED_COST_WRITE, SHIPMENT_WRITE) tutmalıdır. Doğrulanmış Hesaptaki standart satıcı rolü tümünü verir.

Sonraki adımlar 

• Batch dispatch (birleştirme) — günün paketlerini bir Japan Post ertelenmiş ödeme gönderim kaydına paketleyin.