DOCS
Collect•
홈글로벌 이커머스 Fulfillment 운송사 계정 설정, 요금 조회 및 배송 라벨 라벨 및 매니페스트 생성 - GraphQL

Australia Post 라벨 및 매니페스트 생성

GraphQL API를 사용하여 Australia Post용 라벨을 생성하고 매니페스트를 생성합니다.

GraphQL

Australia Post는 배송을 통합(consolidation)(매니페스트) 단위로 접수합니다. 라벨이 단독 작업인 다른 캐리어와 달리, Australia Post 배송은 반드시 통합 그룹에 속해야 하며, Australia Post에 접수되는 대상은 바로 이 그룹입니다.

전체 흐름은 세 단계로 구성됩니다.

  1. 통합 그룹 열기 — 배송이 추가되는 매니페스트입니다.
  2. 그룹에 라벨 생성 — 각 배송이 Australia Post에 등록되고 라벨이 반환됩니다. 배송은 접수되지 않은 상태로 Australia Post의 대기 목록(basket)에 남아 있습니다.
  3. 그룹 마감 — 이 작업으로 주문이 Australia Post에 접수되며, 드롭오프 시 제출할 Order Summary(종이 매니페스트)가 생성됩니다.

결제: 판매자에게 요금이 청구되는 시점은 그룹이 마감(접수)될 때이며, 라벨이 생성될 때가 아닙니다. 그룹이 마감되기 전까지는 라벨을 자유롭게 생성하고 무효화할 수 있습니다.

시작하기 전에 

  • 계정 번호가 있는 연결된 Australia Post 계정이 필요합니다.
  • 배송 및 라벨을 생성할 수 있도록 승인된 API 액세스 권한이 필요합니다.

1단계: 통합 그룹 열기 

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단계: 그룹에 라벨 생성 

shipmentConsolidationId로 그룹 id를 전달하여 shipmentCreateWorkflow로 배송과 라벨을 생성합니다. 이 뮤테이션은 배송을 Australia Post에 등록하고 라벨 URL과 운송장 번호를 반환합니다. 아직 요금은 청구되지 않습니다 — 그룹이 마감될 때까지 배송은 Australia Post의 대기 목록(basket)에 보관됩니다.

Australia Post 전용 필드:

  • shipmentConsolidationId — 1단계에서 얻은 그룹 id입니다. 배송을 매니페스트에 추가하려면 필수입니다.
  • serviceLevel — 배송에 사용할 Australia Post 서비스 레벨입니다(예: International Standard 또는 International Express 서비스 레벨).
  • itnNumber — 수출 신고 번호(EDN)입니다. 물품 총 가치가 AUD 2,000을 초과하는 경우 필수입니다.

전화번호에는 숫자만 포함해야 합니다 — Australia Post는 공백과 문장 부호가 포함된 전화번호를 거부합니다.

전체 필드 목록은 ShipmentCreateWorkflowInput을, 일반(Australia Post가 아닌) 배송 뮤테이션은 배송 생성을 참고하세요.

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단계: 그룹을 마감하여 매니페스트 생성 

배송할 준비가 되면 shipmentConsolidationUpdate와 status: 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의 대기 목록(basket)에서 제거되어 접수되지 않으며 요금도 청구되지 않습니다.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ShipmentConsolidationCreateInput ShipmentConsolidationUpdateInput ShipmentCreateWorkflowInput

MUTATIONS

shipmentConsolidationCreate shipmentConsolidationUpdate shipmentCreateWorkflow

이 페이지가 도움이 되었나요?

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • Australia Post 라벨 및 매니페스트 생성
  • 1단계: 통합 그룹 열기
  • 2단계: 그룹에 라벨 생성
  • 3단계: 그룹을 마감하여 매니페스트 생성