DOCS

Australia Postのラベルとマニフェストを作成

GraphQL APIを使用して、Australia Post用のラベルを作成し、マニフェストを生成します。

GraphQL

Australia Postは、出荷をconsolidation(マニフェスト)として計上します。ラベルが単独のアクションとなる他の運送会社とは異なり、Australia Postの出荷はconsolidationグループに属している必要があり、Australia Postに提出されるのはこのグループです。

このフローは3つの部分で構成されています。

  1. consolidationグループを開く — 出荷が追加されるマニフェストです。
  2. グループにラベルを作成する — 各出荷がAustralia Postに登録され、ラベルが返されます。出荷はAustralia Postのバスケットに入り、未提出の状態になります。
  3. グループを閉じる — これによりオーダーがAustralia Postに提出され、ドロップオフ時に提示する**Order Summary(紙のマニフェスト)**が生成されます。

請求: 加盟店に請求が発生するのは、グループが**閉じられた(提出された)**時点であり、ラベルが作成された時点ではありません。グループが閉じられるまで、ラベルは自由に作成・無効化できます。

始める前に 

ステップ1: consolidationグループを開く 

carrierCode: AUSTRALIA_POSTを使用して、shipmentConsolidationCreateでグループを作成します。返されるidが、ラベルを追加する対象のグループになります。その日にすでに開いているグループがある場合は、新規作成する代わりにそれを再利用してください(下記の開いているグループを再利用するを参照)。

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

開いているグループを再利用する

新しいグループを作成する代わりに既存のグループにラベルを追加するには、開いているグループを問い合わせて、使用したいグループのidを使用します。

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}

ステップ2: グループにラベルを作成する 

グループのidshipmentConsolidationIdとして渡し、shipmentCreateWorkflowで出荷とそのラベルを作成します。このmutationは出荷をAustralia Postに登録し、ラベルのURLと追跡番号を返します。この時点では課金は発生しません — グループが閉じられるまで、出荷はAustralia Postのバスケットに保持されます。

Australia Post固有のフィールド:

  • shipmentConsolidationId — ステップ1のグループid。出荷をマニフェストに追加するために必須です。
  • serviceLevel — 出荷に対するAustralia Postのサービスレベル(例: International StandardやInternational Expressのサービスレベル)。
  • itnNumber — 輸出申告番号(EDN)。品物の合計価値がAUD 2,000を超える場合に必須です。

電話番号には数字のみを含める必要があります — Australia Postはスペースや句読点を拒否します。

フィールドの全リストはShipmentCreateWorkflowInputを、(Australia Post以外の)一般的な出荷mutationについては出荷を作成するを参照してください。

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}

同じマニフェストに載せたい荷物ごとにこのステップを繰り返します — 毎回同じshipmentConsolidationIdを渡してください。

ステップ3: グループを閉じてマニフェストを生成する 

出荷準備ができたら、shipmentConsolidationUpdatestatus: CLOSEDでグループを閉じます。これによりオーダーがAustralia Postに提出され、customsDocuments(Order Summary PDF)にマニフェストが返されます。**この時点で加盟店に請求が発生します。**マニフェストの差出人は各出荷の発送元住所から取得されるため、フルフィルメントセンターは不要です。

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}

customsDocuments.fileUrlからマニフェストをダウンロードし、ドロップオフまたは集荷時に提示してください。グループが閉じられると、その出荷は提出済みとなり、それ以降は変更できません。

提出前の無効化 

課金は閉じる時点で発生するため、グループが閉じられる前であれば、いつでもラベルを無効化することで出荷をグループから取り消すことができます。無効化するとAustralia Postのバスケットから出荷が削除されるため、提出されず、課金もされません。

このページは役に立ちましたか?