Dashboard에서 Zonos Catalog CSV는 어떻게 성공적으로 작성하나요?

Catalog CSV 템플릿 작성 시 `itemKeyPreference`에 따라 필수 필드는 `sku` 또는 `productId`뿐입니다. item key preference 기준으로 동일 품목이 중복되면 처음에 품목을 생성하고, 해당되는 경우 새로운 또는 추가 product details로 업데이트합니다. 품목 세부 정보로 템플릿을 작성한 후 CSV를 Catalog에 업로드하세요.

Catalog CSV field descriptions란 무엇인가요?

Catalog CSV 필드에는 SKU, Product ID, Name, Description, Weight units, Weight, Dimensional units, Length, Width, Height, Restricted countries, Digital good, Country of origin, HS code, HS code ship-to country, Image URL, Material, Brand, Price, Currency가 포함됩니다.

catalog 품목 import 시 어떤 오류가 발생할 수 있나요?

파일 크기, 파일 형식, 누락되거나 인식되지 않는 열 헤더, SKU 또는 product ID 누락, 잘못된 weight 또는 dimensional unit, 잘못된 weight/length/width/height 값, weight 또는 dimensional 값 제공 시 unit 누락, country-specific HS code 제공 시 ship-to country 누락, 잘못된 ship-to country 또는 currency code, dimensional 필드 하나 제공 시 나머지 누락 등의 오류가 발생할 수 있습니다.

홈글로벌 이커머스 Catalog Product CSV import

Catalog CSV import

Catalog에 품목을 대량 import하세요.

Zonos Catalog의 bulk import를 사용하면 전체 카탈로그를 한 번에 import할 수 있습니다. Catalog CSV 템플릿을 작성할 때 각 품목에 필요한 유일한 필드는 SKU or product ID입니다. SKU 및 product ID 기준으로 동일 품목이 중복되면 Catalog는 처음에 품목을 생성한 후, 해당되는 경우 중복 품목의 새로운 또는 보충 정보로 업데이트합니다.

Import products

Dashboard -> Products -> Catalog로 이동합니다.
우측 상단 Manage Catalog를 클릭한 후 드롭다운에서 Import products를 선택합니다.
sample CSV template을 클릭하여 Catalog CSV 템플릿을 다운로드합니다.
product details를 Zonos CSV 템플릿 필드에 맞춥니다. 아래 표를 사용하여 올바른 값과 정보를 가장 적합한 필드에 사용하고 있는지 확인하세요.
1. 사용하지 않는 필드/열은 비워 두세요. 삭제해도 되지만 필수는 아닙니다.
파일을 CSV로 저장합니다.
파일을 드래그 앤 드롭하거나 browse를 클릭하여 Catalog CSV 파일을 업로드합니다. Catalog 업로드 최대 파일 크기는 50 MB입니다.
프롬프트에 따라 업로드한 품목을 검토하고 오류가 있으면 필드를 수정합니다.
Import를 클릭합니다.

Field requirements

품목을 import하려면 SKU 또는 product ID 중 하나만 있으면 되며, 어느 쪽을 사용할지는 item key preference에 따라 다릅니다. 그 외의 열은 모두 비워 둘 수 있습니다.

다만, 품목 세부 정보를 더 많이 제공할수록 결과가 좋아집니다. 완전한 품목 데이터는 landed cost 정확도, HS code 분류, 통관 처리를 개선하고, 고객에게 발생할 수 있는 지연이나 예상치 못한 비용 청구 가능성을 줄여줍니다. 식별자만 있으면 되지만, 보유한 데이터가 있는 모든 필드를 작성하는 것을 권장합니다.

Conditionally required fields

일부 필드는 단독으로는 선택 사항이지만, 관련 필드를 사용하는 즉시 필수가 됩니다.

If you provide↕	You must also provide↕
Weight	Weight unit
Weight unit	Weight
Length, width, or height	Length, width, height 3가지 모두와 dimensional unit
Dimensional unit	Length, width, height
Price	Currency
Volume or alcohol by volume	Volume과 volumetric unit
Country-specific HS code	해당 국가(`Country code=HS code` 형식)

참고: Weight는 기본값이 pound이고 dimension은 기본값이 inch이지만, 이 기본값은 값과 단위를 모두 비워 둔 경우에만 적용됩니다. weight나 dimension 값을 입력하면서 단위를 지정하지 않으면 import가 실패합니다.

참고: inclusive pricing을 사용하는 경우 모든 품목에 price와 currency가 필수이며, currency는 조직의 기본 통화(native currency)와 일치해야 합니다.

CSV fields descriptions

Required 열은 필드가 필수인지, 선택인지, 아니면 제공하는 다른 필드에 따라 조건부로 필수인지를 나타냅니다.

Column↕	Required↕	Description↕
SKU	필수*	비즈니스 내 품목을 식별하는 코드. 예: GRLS-GRPHC-BBT-T-S
Product ID	필수*	ecommerce 플랫폼 ID 등 품목 식별자. 예: 254678901
Name	선택	품목 이름. 예: Girls' graphic baby t-shirt
Description	선택	품목의 전체 상세 설명. 예: 프리미엄 폴리에스터 셔츠로 비교할 수 없는 편안함과 세련됨을 경험해 보세요. 필수 의류를 한층 업그레이드할 수 있도록 정성껏 제작되었습니다. 현대적인 감각에 맞춰 디자인되어 캐주얼부터 정장까지 두루 어울리는 세련되고 다재다능한 스타일을 자랑합니다.
Customs description	선택	commercial invoice용 간결한 품목 설명. 30자 제한. 예: Girls' Shirt, 100% Polyester
Weight unit	조건부	품목 weight unit. 단위가 없으면 `pound`가 기본값입니다. 유효 값: `gram`, `kilogram`, `pound`, `ounce`.
Weight	조건부	품목 weight. 양수여야 합니다.
Dimensional unit	조건부	품목 dimensional unit. 단위가 없으면 `inch`가 기본값입니다. 유효 값: `inch`, `foot`, `yard`, `millimeter`, `centimeter`, `meter`.
Length	조건부	품목 length. 양수여야 합니다.
Width	조건부	품목 width. 양수여야 합니다.
Height	조건부	품목 height. 양수여야 합니다.
Packing preference	선택	단독 배송(`ships_alone`) 또는 다른 품목과 consolidated(`consolidated`) 가능 여부. 다른 품목과 consolidated 가능하면(가장 흔함) 비워 둘 수 있습니다.
Restricted countries	선택	특정 국가 배송 제한. 값은 2-digit ISO codes를 vertical bar로 구분. 모든 국가 제한: `ALL`. 일부 국가만 제외: `ALL-CA\|AU\|US` 형식. 특정 국가만 제한: `AU\|KR\|MY\|SG`. 기존 restricted countries 모두 제거: `NONE`.
Product type	선택	품목 성격. 값: `physical_good`, `digital_good`, `service`, `subscription`, `bundle`, `partial_item`. physical good(가장 흔함)이면 비워 둘 수 있습니다.
Country of origin	선택	제조 국가. 2-digit ISO codes. 예: `JP, GB, KR`.
Universal HS code	선택	universal 6-digit HS code. 예: 9506.62
Country-specific HS codes	선택	country-specific HS codes. 여러 개일 때 vertical bar로 구분. 예: IT=6109.10.0010\|DE=6109.10.0010\|GB=6109.10.0010\|JP=6109.10.020
Image URL	선택	품목 image URL. 예: `https://www.exampleclothingstore.com/images/girls-graphic-baby-tee-pink-unicorn-001.jpg`
Material	선택	주요 material 또는 구성. 예: Polyester
Brand	선택	brand. 예: Nike
Price	선택	품목에 청구하는 가격.
Retail price	선택	할인 전 원래 가격. sale price와 함께 표시하면 절약액을 강조합니다. retail price는 기본 품목 가격(위)보다 높아야 합니다.
Currency	조건부	가격 통화. 3-digit currency code. 예: `USD`, `CAD`, `AUD`.

*SKU 또는 product ID 중 하나가 필수이며, 둘 다 필요하지는 않습니다. 어느 쪽이 적용되는지는 item key preference에 따라 다릅니다.

알코올 음료 판매자: Harmonized System Chapter 22(알코올 음료) 품목을 판매하는 경우 excise duty 계산에 추가 측정 필드가 필요합니다. excise duty documentation 및 specialized CSV template을 참조하세요.

Column↕	Required↕	Description↕
Volumetric unit	알코올 음료 필수	volume 측정 단위. 유효 값: milliliter, liter, fluid_ounce 등.
Volume	알코올 음료 필수	품목 volume. excise duty 계산에 사용됩니다.
Alcohol by volume	알코올 음료 필수	알코올 함량 비율. 백분율로 입력. 예: 12% ABV는 12.

CSV import errors

catalog 품목 import 시 오류가 발생할 수 있습니다. 다음은 import 오류와 해결 방법입니다. 오류를 해결한 후 CSV를 다시 import할 수 있습니다.

Import errors

Error↕	Description↕
File must be under 1 GB.	파일이 너무 큽니다. 1 GB 미만이어야 합니다.
File must be in CSV format.	Catalog는 CSV 형식만 지원합니다. 파일 형식이 CSV인지 확인하세요.
Missing column header(s).	Catalog는 Catalog 템플릿과 정확히 동일한 형식의 파일만 지원합니다. CSV 헤더가 CSV 템플릿 헤더와 일치하는지 확인하세요.
Unrecognized column header(s).	인식할 수 없는 열 헤더가 있습니다. Catalog는 Catalog 템플릿과 정확히 동일한 형식의 헤더만 지원합니다. 인식되지 않는 열 헤더를 제거하고 CSV 헤더가 템플릿과 일치하는지 다시 확인하세요.
You are missing a SKU or product ID. Ensure all of your products have a SKU or product ID.	catalog 품목 생성에는 식별자(SKU/product ID)가 필요합니다. 각 품목에 SKU 또는 product ID를 추가하세요.
Customs description exceeds character limit of 30 characters.	customs description은 기본 30자로 제한되며, commercial invoice의 가장 흔한 문자 제한과 일치합니다.
Product type invalid.	값: `physical_good`, `digital_good`, `service`, `subscription`, `bundle`, `partial_item`.
Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, leave blank.	Catalog packing preference: `ships_alone`, `consolidated`. 다른 품목과 consolidated 가능하면 비워 두면 기본값 `consolidated`입니다.
Weight unit invalid. Catalog only supports the following weight units: gram, kilogram, pound, and ounce.	지원 단위(약어 없음): `gram`, `kilogram`, `pound`, `ounce`.
Weight must be greater than zero and cannot include letters or symbols.	weight는 양수이며 기호나 문자를 포함할 수 없습니다. Catalog는 소수점 2자리까지 지원합니다. 예: 5.85
Dimensional unit invalid. Catalog supports the following dimensional units: inch, foot, yard, millimeter, centimeter, and meter.	지원 단위(약어 없음): `inch`, `foot`, `yard`, `millimeter`, `centimeter`, `meter`.
Length must be greater than zero and cannot include letters or symbols.	length는 양수이며 기호나 문자를 포함할 수 없습니다. Catalog는 소수점 2자리까지 지원합니다. 예: 5.29
Width must be greater than zero and cannot include letters or symbols.	width는 양수이며 기호나 문자를 포함할 수 없습니다. Catalog는 소수점 2자리까지 지원합니다. 예: 2.44
Height must be greater than zero and cannot include letters or symbols.	height는 양수이며 기호나 문자를 포함할 수 없습니다. Catalog는 소수점 2자리까지 지원합니다. 예: 8.02
A weight unit is required when you provide a weight value.	weight 값이 있는 품목에 weight unit을 제공하세요. 지원: `gram`, `kilogram`, `pound`, `ounce`.
A dimensional unit is required if you provide dimensional values.	dimensional 값이 있는 품목에 dimensional unit을 제공하세요. 지원: `inch`, `foot`, `yard`, `millimeter`, `centimeter`, `meter`.
HS code must be between 6 and 16 characters.	universal HS code는 6자리, 가장 긴 country-specific HS code는 16자리이므로 6~16자여야 합니다.
Country-specific HS codes must be in the format of 'Country code=HS Code`	형식: Country code=HS Code. 예: `KR=8518.30.9000`. 여러 HS code는 vertical bar로 구분. 예: `KR=8518.30.9000\|CA=8518.30.9010`.
[Country code] is not a valid country code.	ship-to country는 ISO 형식이어야 합니다. 예: `KR` 또는 `BR`. 2-digit ISO format를 확인하세요.
Country of origin values must be in ISO format.	country of origin은 2-digit ISO format이어야 합니다.
Price cannot include negative values, letters, or symbols.	price는 양수이며 유효한 값이어야 합니다. Catalog는 소수점 3자리까지 지원합니다. 예: 104.399
If you supply a price, a currency code is required.	product price가 있는 품목에 currency code를 제공하세요.
Currency codes must be in ISO format, e.g., AUD or THB.	currency code는 3-digit ISO format이어야 합니다.
If one dimensional field is provided, all three are required.	dimensional 값이 있는 품목에는 length, width, height 세 필드가 모두 필요합니다.

Failed import example

데모 예약하기