DOCS
Landed Cost•
홈물류 제공업체용 계정 키 생성

계정 키 생성

우편 사업자와 배송 플랫폼을 위한 계정 키로 Declaration ID 생성

계정 키는 API 키와 유사한 고유 인증 자격 증명으로, 승인된 조직이 배송마다 개별 Declaration ID 없이도 사용자를 대신하여 관세를 징수할 수 있도록 합니다. 계정 키를 사용하면 수동 관세 징수가 필요 없어지고, 자동 청구와 우편 DDP 요건 준수가 가능해집니다.

계정 키는 관세 납부를 최종적으로 책임지는 당사자를 나타냅니다. 예를 들어 배송 플랫폼이 자체 계정 키를 발급받으려는 경우, 이 키를 사용하여 사용자를 대신해 Declaration ID를 생성할 수 있습니다. 이 경우 배송 플랫폼이 사용자로부터 관세를 징수하고, Zonos는 해당 계정 키로 생성된 Declaration ID를 기준으로 배송 플랫폼에 관세를 청구합니다.

계정 키 작동 방식 

계정 키를 보유한 Zonos 조직은 라벨 생성 중에 Declaration ID를 동적으로 생성하여 원활한 배송 경험을 제공하면서도 관세 납부 준수를 보장할 수 있습니다.

조직은 특정 사용 사례와 Zonos와의 관계에 따라 Zonos Dashboard를 통해 계정 키를 발급받을 수 있습니다.

계정 키로 Declaration ID 생성하기 

계정 키를 보유한 조직은 Zonos API를 통해 배송별 개별 Declaration ID를 동적으로 생성할 수 있습니다. 이 프로세스를 통해 사용자가 Declaration ID를 직접 입력하지 않아도 관세 징수를 자동화할 수 있습니다.

배송 자체에 대한 세부 정보 없이 배송용 Declaration ID를 생성하려면 다음 GraphQL mutation을 사용하세요.

1mutation DeclarationCreate($input: DeclarationCreateInput!) {
2 declarationCreate(input: $input) {
3 id
4 status
5 paymentStatus
6 source
7 organizationId
8 parties {
9 id
10 }
11 items {
12 id
13 }
14 landedCost {
15 id
16 currencyCode
17 }
18 }
19}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CartonCreateWorkflowInput DeclarationCreateInput DeclarationCreateWorkflowInput ItemCreateWorkflowInput LandedCostWorkFlowInput PartyCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow declarationCreate declarationCreateWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCreateWorkflow

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

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • 계정 키 생성
  • 계정 키 작동 방식
  • 계정 키로 Declaration ID 생성하기