카탈로그 관리

중요: 이미 존재하는 제품을 생성하려고 시도하면, 카탈로그는 SKU 및/또는 제품 ID를 기반으로 제품을 인식하고, 원래 제품의 세부정보를 새로운 세부정보로 덮어씁니다.

제품 편집을 통해 기존 제품을 추가 또는 업데이트된 정보로 효율적으로 업데이트할 수 있습니다. 제품을 삭제하고 다시 업로드할 필요 없이, 업데이트된 정보를 업로드하면 카탈로그가 SKU 또는 제품 ID를 사용하여 기존 제품과 일치시킵니다. 이를 통해 대시보드 또는 API를 사용하여 새로운 제품을 생성하거나 기존 제품을 편집할 때 최소한의 노력으로 카탈로그를 최신 상태로 유지할 수 있습니다.

카탈로그에 이미 존재하는 카탈로그 제품을 생성/편집하면 다음과 같은 결과가 발생합니다:

카탈로그는 기존 항목의 빈 필드를 덮어씁니다.

• 예를 들어, 기존 제품 SKU 321에 무게 값이 없고, 동일한 제품 SKU 321의 새로운 업로드에서 무게가 1.3 lbs인 경우, 1.3 lb 무게가 이전의 빈 필드를 덮어씁니다.

카탈로그는 기존 필드를 새로운 필드 값으로 덮어씁니다.

• 예를 들어, 기존 제품 SKU 123의 가격이 18.99 USD이고, 동일한 제품 SKU 123의 업데이트된 가격이 22.99 USD인 경우, 새로운 가격 22.99 USD가 이전 가격을 덮어씁니다.

카탈로그는 빈 필드로 기존 값을 덮어쓰지 않습니다.

• 예를 들어, 기존 제품 SKU 456의 HS 코드가 6109.10이고, 업데이트된 제품 SKU 456의 HS 코드가 비어 있는 경우, 기존 HS 코드는 그대로 유지됩니다.

특정 국가(또는 국가들)로의 배송을 방지하고 싶다면, 제품을 생성하거나 업데이트할 때 제한을 추가할 수 있습니다.

Checkout를 사용하는 경우, 고객의 국가에 제한된 제품이 있을 때 귀하의 checkout에 제한 메시지가 표시됩니다. 기본적으로 메시지는 "이 항목은 귀하의 국가로의 수입이 제한됩니다."라고 표시되지만, 국가 제한을 추가할 때 restrictedCountriesMessage 필드에 제공하여 자신만의 제한 메시지를 사용자 정의할 수 있습니다.

대시보드 또는 API를 통해 SKU 또는 제품 ID를 사용하여 카탈로그에서 제품을 검색할 수 있습니다. 정확한 일치만 결과를 반환하므로 부분 일치는 인식되지 않습니다.

대시보드

API

SKU 또는 제품 ID로 필터링하려면:

1. 제품 탭을 클릭합니다.
2. 카탈로그의 왼쪽 상단에서 SKU 또는 제품 ID를 선택합니다.
3. SKU 또는 제품 ID를 입력합니다.
4. 필터링된 제품을 보려면 적용을 클릭합니다.

카탈로그 테이블에서 50개 이하의 항목을 선택하면 카탈로그가 대시보드에서 직접 다운로드됩니다. 그러나 모두 내보내기 또는 50개 이상의 항목을 선택하면 CSV가 이메일을 통해 내보내집니다.

50개 이하의 항목을 내보내려면 다음 단계를 따르세요:

1. 카탈로그 테이블에서 50개 이하의 항목을 직접 선택합니다.
2. 오른쪽 상단의 내보내기를 클릭합니다.
3. 이메일 수신함에서 CSV 파일을 찾습니다.

모든 제품 내보내기:

이메일에서 다운로드 문제 발생?

이메일 링크에서 CSV를 다운로드하는 데 문제가 있는 경우, 이는 브라우저가 다운로드를 차단하고 있을 수 있습니다. 이 경우 다음 단계를 따르세요:

1. 이메일의 "다운로드" 버튼을 마우스 오른쪽 버튼으로 클릭합니다.
2. "링크 주소 복사"를 선택하여 다운로드 URL을 복사합니다.
3. 복사한 URL을 브라우저에 붙여넣고 Enter 키를 누릅니다.
4. 그러면 카탈로그가 브라우저에서 직접 다운로드됩니다.

API를 사용하여 ClassificationsCreateFromCatalog 변이를 통해 카탈로그에서 제품을 classify 할 수 있습니다.

카탈로그에서 제품을 classify 하려면 name이 필요합니다. 전체 카탈로그 및 분류 필드 목록은 GraphQL API 참조를 참조하세요.

카탈로그 제품을 동시에 생성하고 classify 하려면, 아래의 ClassificationsCreateFromCatalog 변이를 CatalogItemsCreate 변이에 추가하세요.

8자리 이상(국가별) HS 코드로 카탈로그 제품 Classify

shipToCountries 필드가 채워지면, 분류는 8자리 이상(국가별) HS 코드가 됩니다. shipToCountries가 제공되지 않으면, 분류는 기본적으로 6자리(보편적) HS 코드로 설정됩니다. 보편적 및 국가별 HS 코드 간의 차이에 대해 자세히 알아보세요.

아래 예제에서는 캐나다를 위한 국가별 코드를 생성하기 위해 shipToCountries 필드가 제공됩니다.

mutation ClassificationsCreateFromCatalog(
  $catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
  classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
    id
    configuration {
      shipToCountries
    }
    hsCode {
      code
    }
    name
  }
}

여기 요청의 예가 있습니다. Zonos Classify는 단지 name으로 분류를 생성하지만, 최고의 분류 결과를 위해 가능한 많은 세부 정보를 추가하는 것을 강력히 권장합니다.

{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

{
  "data": {
    "classificationsCreateFromCatalog": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "configuration": {
          "shipToCountries": ["CA"]
        },
        "countryOfOrigin": "US",
        "hsCode": {
          "code": "6116.10.0020"
        },
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
      }
    ]
  }
}

API 오류 및 해결 방법

* API 오류 전용