DOCS

Australia Post etiketleri ve manifestoları oluşturma

GraphQL API'sini kullanarak Australia Post için etiketler oluşturun ve bir manifesto oluşturun.

GraphQL

Australia Post, gönderileri bir konsolidasyon (manifesto) olarak kaydeder. Etiketin bağımsız bir işlem olduğu taşıyıcıların aksine, bir Australia Post gönderisi bir konsolidasyon grubuna ait olmalıdır ve Australia Post'a kaydedilen şey bu gruptur.

Akış üç bölümden oluşur:

  1. Bir konsolidasyon grubu açın — gönderilerin ekleneceği manifesto.
  2. Gruba etiket oluşturun — her gönderi Australia Post'a kaydedilir ve bir etiket döndürülür. Gönderiler, Australia Post'un sepetinde kaydedilmemiş halde bekler.
  3. Grubu kapatın — bu, siparişi Australia Post'a kaydeder ve teslimat noktasında sunacağınız Sipariş Özeti'ni (kağıt manifesto) oluşturur.

Faturalandırma: tüccar, grup kapatıldığında (kaydedildiğinde) ücretlendirilir, bir etiket oluşturulduğunda değil. Grup kapatılana kadar etiketler serbestçe oluşturulabilir ve iptal edilebilir.

Başlamadan önce 

Adım 1: Bir konsolidasyon grubu açın 

carrierCode: AUSTRALIA_POST kullanarak shipmentConsolidationCreate ile bir grup oluşturun. Döndürülen id, etiket eklediğiniz gruptur. O gün için zaten açık bir grubunuz varsa, yeni bir tane oluşturmak yerine onu yeniden kullanın (aşağıdaki Açık bir grubu yeniden kullanma bölümüne bakın).

1mutation ShipmentConsolidationCreate(
2$input: ShipmentConsolidationCreateInput!
3) {
4 shipmentConsolidationCreate(input: $input) {
5 id
6 name
7 carrierCode
8 status
9 }
10}

Açık bir grubu yeniden kullanma

Yeni bir grup oluşturmak yerine mevcut bir gruba etiket eklemek için açık grupları sorgulayın ve kullanmak istediğiniz grubun id'sini kullanın.

1query ShipmentConsolidations {
2 shipmentConsolidations(filter: { status: OPEN }, first: 50) {
3 edges {
4 node {
5 id
6 name
7 carrierCode
8 status
9 }
10 }
11 }
12}

Adım 2: Gruba bir etiket oluşturma 

shipmentConsolidationId olarak grup id'sini geçirerek shipmentCreateWorkflow ile gönderiyi ve etiketini oluşturun. Bu mutasyon, gönderiyi Australia Post'a kaydeder ve bir etiket URL'si ile takip numarası döndürür. Henüz ücret alınmaz — grup kapatılana kadar gönderi, Australia Post'un sepetinde tutulur.

Australia Post'a özgü alanlar:

  • shipmentConsolidationId — Adım 1'deki grup id'si. Gönderiyi manifestoya eklemek için gereklidir.
  • serviceLevel — gönderi için Australia Post hizmet seviyesi (örneğin, bir Uluslararası Standart veya Uluslararası Ekspres hizmet seviyesi).
  • itnNumber — ihracat beyanname numarası (EDN). Toplam ürün değeri 2.000 AUD'yi aştığında gereklidir.

Telefon numaraları yalnızca rakam içermelidir — Australia Post boşlukları ve noktalama işaretlerini reddeder.

Alanların tam listesi için ShipmentCreateWorkflowInput sayfasına, genel (Australia Post olmayan) gönderi mutasyonu için ise Bir gönderi oluşturma sayfasına bakın.

1mutation ShipmentCreateWorkflow($input: ShipmentCreateWorkflowInput!) {
2 shipmentCreateWorkflow(input: $input) {
3 id
4 status
5 tracking {
6 number
7 }
8 shipmentCartons {
9 label {
10 url
11 trackingNumber
12 }
13 }
14 }
15}

Aynı manifestoda olmasını istediğiniz her parsel için bu adımı tekrarlayın — her seferinde aynı shipmentConsolidationId'yi geçirin.

Adım 3: Manifestoyu oluşturmak için grubu kapatma 

Göndermeye hazır olduğunuzda, shipmentConsolidationUpdate ve status: CLOSED kullanarak grubu kapatın. Bu, siparişi Australia Post'a kaydeder ve manifestoyu customsDocuments içinde (Sipariş Özeti PDF'i) döndürür. Tüccarın ücretlendirildiği nokta budur. Manifesto göndereni, her gönderideki menşe adresinden gelir, bu nedenle bir fulfillment merkezine gerek yoktur.

1mutation ShipmentConsolidationUpdate(
2$input: ShipmentConsolidationUpdateInput!
3) {
4 shipmentConsolidationUpdate(input: $input) {
5 id
6 status
7 customsDocuments {
8 id
9 fileUrl
10 fileName
11 documentType
12 fileType
13 }
14 }
15}

Manifestoyu customsDocuments.fileUrl adresinden indirin ve teslimat veya alım noktasında sunun. Grup kapatıldıktan sonra, gönderileri kaydedilmiş olur ve artık değiştirilemez.

Kaydetmeden önce iptal etme 

Ücretlendirme kapatma anında gerçekleştiğinden, etiketini iptal ederek bir gönderiyi kapatılmadan önce herhangi bir zamanda gruptan çıkarabilirsiniz. İptal etmek, gönderiyi Australia Post'un sepetinden kaldırır, böylece hiçbir zaman kaydedilmez ve ücretlendirilmez.

Bu sayfa faydalı mıydı?