DOCS

Catalog API

자체 시스템에서 바로 Verified Account 카탈로그를 프로그래밍 방식으로 구축하세요.

Catalog API는 Verified Account 카탈로그를 구축하는 세 가지 방법 중 하나로, 개발 인력이 있고 이미 제품 데이터를 보유한 시스템(ERP, WMS, PIM 또는 배송 플랫폼)을 갖춘 배송업체를 위한 옵션입니다. 해당 시스템이 기준 데이터(source of truth)로 유지되며, 채널 연동에서 동기화하거나 CSV 파일을 업로드하는 대신 Zonos에 제품을 직접 기록합니다. 지원되는 채널을 통해 판매하거나 코드를 작성하고 싶지 않다면, 이 두 가지 옵션으로 더 적은 작업으로 동일한 카탈로그를 구축할 수 있습니다.

API로 생성한 품목은 다른 방식으로 추가한 품목과 완전히 동일하게 처리됩니다. 품목이 카탈로그에 들어오면 Zonos는 어떤 경로로 추가되었는지 구분하지 않습니다. HS 코드를 제공하지 않은 경우 각 품목은 통관을 위해 분류되고, 미국 PGA(Partner Government Agency) 요건에 대해 심사되며, 해당 품목이 포함된 배송물의 관세 및 세금 계산에 사용됩니다.

이 중 한 부분은 API 밖에서 처리됩니다. PGA 심사에서 품목에 조치 필요 플래그가 지정되면, 해당 플래그와 연결된 규정 준수 질문지는 Dashboard에서 답변하고 확인해야 합니다. 이를 위한 API는 없으며, Zonos가 가능한 항목을 미리 채워 두므로 대부분의 작업은 검토하고 확인하는 것입니다. 이 연동을 구축하는 사람과 해당 플래그를 처리하는 사람은 대개 다르므로, 카탈로그가 로드된 후 조직 내 누군가가 Dashboard에서 이를 처리하도록 계획하세요. 플래그가 지정된 품목도 배송이 차단되지는 않지만, 배송 전에 플래그를 해소해야 미국 국경에서 배송물이 보류되는 것을 막을 수 있습니다.

작동 방식 

  1. 배송하는 각 제품에 대해 카탈로그 품목을 생성합니다.

  2. 각 품목에 우편 운송사가 전달할 식별자가 포함되어 있는지 확인합니다.

  3. 배송 데이터가 Zonos에 도달하면 각 항목이 카탈로그 품목과 매칭되고, 해당 품목의 제품 데이터가 계산에 적용됩니다.

  • 채널 연동 — 지원되는 판매 채널에서 카탈로그를 자동으로 동기화합니다.
  • CSV 가져오기 — 코드를 작성하는 대신 스프레드시트로 카탈로그 품목을 업로드합니다.
  • PGA 심사 — 카탈로그 품목이 미국 정부 기관(PGA) 요건을 충족하는지 심사합니다.
  • Catalog 작동 방식 — Zonos가 제품 데이터를 어떻게 활용하는지 알아봅니다.
  • EU 제품 식별자 — 소액 B2C 배송에 대해 EU가 요구하는 사항을 알아봅니다.
GraphQL API ReferenceTypes, inputs, and operations used in this guide

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