GraphQL APIを使用して、Australia Post用のラベルを作成し、マニフェストを生成します。
GraphQL
Australia Postは、出荷をconsolidation(マニフェスト)として計上します。ラベルが単独のアクションとなる他の運送会社とは異なり、Australia Postの出荷はconsolidationグループに属している必要があり、Australia Postに提出されるのはこのグループです。
このフローは3つの部分で構成されています。
請求: 加盟店に請求が発生するのは、グループが**閉じられた(提出された)**時点であり、ラベルが作成された時点ではありません。グループが閉じられるまで、ラベルは自由に作成・無効化できます。
carrierCode: AUSTRALIA_POSTを使用して、shipmentConsolidationCreateでグループを作成します。返されるidが、ラベルを追加する対象のグループになります。その日にすでに開いているグループがある場合は、新規作成する代わりにそれを再利用してください(下記の開いているグループを再利用するを参照)。
carrierCode: AUSTRALIA_POST
shipmentConsolidationCreate
id
mutation ShipmentConsolidationCreate(
$input: ShipmentConsolidationCreateInput!
) {
shipmentConsolidationCreate(input: $input) {
name
carrierCode
status
}
新しいグループを作成する代わりに既存のグループにラベルを追加するには、開いているグループを問い合わせて、使用したいグループのidを使用します。
query ShipmentConsolidations {
shipmentConsolidations(filter: { status: OPEN }, first: 50) {
edges {
node {
グループのidをshipmentConsolidationIdとして渡し、shipmentCreateWorkflowで出荷とそのラベルを作成します。このmutationは出荷をAustralia Postに登録し、ラベルのURLと追跡番号を返します。この時点では課金は発生しません — グループが閉じられるまで、出荷はAustralia Postのバスケットに保持されます。
shipmentConsolidationId
shipmentCreateWorkflow
Australia Post固有のフィールド:
serviceLevel
itnNumber
電話番号には数字のみを含める必要があります — Australia Postはスペースや句読点を拒否します。
フィールドの全リストはShipmentCreateWorkflowInputを、(Australia Post以外の)一般的な出荷mutationについては出荷を作成するを参照してください。
ShipmentCreateWorkflowInput
mutation ShipmentCreateWorkflow($input: ShipmentCreateWorkflowInput!) {
shipmentCreateWorkflow(input: $input) {
tracking {
number
shipmentCartons {
label {
url
trackingNumber
同じマニフェストに載せたい荷物ごとにこのステップを繰り返します — 毎回同じshipmentConsolidationIdを渡してください。
出荷準備ができたら、shipmentConsolidationUpdateとstatus: CLOSEDでグループを閉じます。これによりオーダーがAustralia Postに提出され、customsDocuments(Order Summary PDF)にマニフェストが返されます。**この時点で加盟店に請求が発生します。**マニフェストの差出人は各出荷の発送元住所から取得されるため、フルフィルメントセンターは不要です。
shipmentConsolidationUpdate
status: CLOSED
customsDocuments
mutation ShipmentConsolidationUpdate(
$input: ShipmentConsolidationUpdateInput!
shipmentConsolidationUpdate(input: $input) {
customsDocuments {
fileUrl
fileName
documentType
fileType
customsDocuments.fileUrlからマニフェストをダウンロードし、ドロップオフまたは集荷時に提示してください。グループが閉じられると、その出荷は提出済みとなり、それ以降は変更できません。
customsDocuments.fileUrl
課金は閉じる時点で発生するため、グループが閉じられる前であれば、いつでもラベルを無効化することで出荷をグループから取り消すことができます。無効化するとAustralia Postのバスケットから出荷が削除されるため、提出されず、課金もされません。
ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput
shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow
ラベルとマニフェストを作成 - GraphQL
Australia Postのラベルとマニフェストを作成
GraphQL APIを使用して、Australia Post用のラベルを作成し、マニフェストを生成します。
GraphQL
Australia Postは、出荷をconsolidation(マニフェスト)として計上します。ラベルが単独のアクションとなる他の運送会社とは異なり、Australia Postの出荷はconsolidationグループに属している必要があり、Australia Postに提出されるのはこのグループです。
このフローは3つの部分で構成されています。
始める前に
ステップ1: consolidationグループを開く
carrierCode: AUSTRALIA_POSTを使用して、shipmentConsolidationCreateでグループを作成します。返されるidが、ラベルを追加する対象のグループになります。その日にすでに開いているグループがある場合は、新規作成する代わりにそれを再利用してください(下記の開いているグループを再利用するを参照)。mutation ShipmentConsolidationCreate($input: ShipmentConsolidationCreateInput!) {shipmentConsolidationCreate(input: $input) {idnamecarrierCodestatus}}開いているグループを再利用する
新しいグループを作成する代わりに既存のグループにラベルを追加するには、開いているグループを問い合わせて、使用したいグループの
idを使用します。query ShipmentConsolidations {shipmentConsolidations(filter: { status: OPEN }, first: 50) {edges {node {idnamecarrierCodestatus}}}}ステップ2: グループにラベルを作成する
グループの
idをshipmentConsolidationIdとして渡し、shipmentCreateWorkflowで出荷とそのラベルを作成します。このmutationは出荷をAustralia Postに登録し、ラベルのURLと追跡番号を返します。この時点では課金は発生しません — グループが閉じられるまで、出荷はAustralia Postのバスケットに保持されます。Australia Post固有のフィールド:
shipmentConsolidationId— ステップ1のグループid。出荷をマニフェストに追加するために必須です。serviceLevel— 出荷に対するAustralia Postのサービスレベル(例: International StandardやInternational Expressのサービスレベル)。itnNumber— 輸出申告番号(EDN)。品物の合計価値がAUD 2,000を超える場合に必須です。フィールドの全リストは
ShipmentCreateWorkflowInputを、(Australia Post以外の)一般的な出荷mutationについては出荷を作成するを参照してください。mutation ShipmentCreateWorkflow($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustracking {number}shipmentCartons {label {urltrackingNumber}}}}同じマニフェストに載せたい荷物ごとにこのステップを繰り返します — 毎回同じ
shipmentConsolidationIdを渡してください。ステップ3: グループを閉じてマニフェストを生成する
出荷準備ができたら、
shipmentConsolidationUpdateとstatus: CLOSEDでグループを閉じます。これによりオーダーがAustralia Postに提出され、customsDocuments(Order Summary PDF)にマニフェストが返されます。**この時点で加盟店に請求が発生します。**マニフェストの差出人は各出荷の発送元住所から取得されるため、フルフィルメントセンターは不要です。mutation ShipmentConsolidationUpdate($input: ShipmentConsolidationUpdateInput!) {shipmentConsolidationUpdate(input: $input) {idstatuscustomsDocuments {idfileUrlfileNamedocumentTypefileType}}}customsDocuments.fileUrlからマニフェストをダウンロードし、ドロップオフまたは集荷時に提示してください。グループが閉じられると、その出荷は提出済みとなり、それ以降は変更できません。提出前の無効化
課金は閉じる時点で発生するため、グループが閉じられる前であれば、いつでもラベルを無効化することで出荷をグループから取り消すことができます。無効化するとAustralia Postのバスケットから出荷が削除されるため、提出されず、課金もされません。
ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput
shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow
このページは役に立ちましたか?