WooCommerce Checkout용 제품 속성 매핑

개요 

WooCommerce 제품 속성(색상, 크기 및 기타 맞춤 옵션)을 Zonos 확장 프로그램에서 매핑하면 Zonos에서 WooCommerce로 주문을 가져올 때 올바른 속성으로 가져옵니다.

1단계: 제품 속성 찾기

1. WordPress Admin의 Products 탭으로 이동합니다.

2. 왼쪽 탐색에서 Attributes를 클릭하여 전역 제품 속성을 보거나 관리합니다. 새 제품 추가 시 속성을 설정할 수도 있습니다.

Product Add-Ons for WooCommerce와 같은 서드파티 앱으로 맞춤 속성을 사용하는 경우 앱 문서의 안내에 따라 속성 위치를 확인하세요.

2단계: Zonos에서 속성 경로 확인

Zonos 확장 프로그램에서 속성을 매핑하려면 먼저 속성이 Zonos로 전달되는 방식을 이해해야 합니다. 이 데이터를 확인하려면 다음 단계를 따르세요:

1. 매핑할 속성이 있는 제품에 대해 테스트 주문을 생성합니다.
2. Zonos Checkout을 진행하고 서비스 수준을 선택합니다. landed cost quote가 생성됩니다. (주문을 완료할 필요는 없습니다.)
3. Dashboard에서 Quotes로 이동합니다.
4. 테스트 주문의 견적을 찾아 Quote Details를 클릭합니다.
5. 오른쪽 API Details 섹션에서 루트 수준 드롭다운을 펼친 다음 다음을 펼칩니다.
   • items
   • metadata

이 metadata 블록은 WooCommerce에서 Zonos API 요청으로 제품 속성이 전달되는 방식을 보여 줍니다.

3단계: Zonos 확장 프로그램에서 속성 매핑

metadata JSON에서 속성을 찾았으면 WooCommerce 확장 프로그램의 Zonos Mapping 설정으로 돌아갑니다.

1. Attribute field에서 Custom Attribute를 선택합니다.
2. Alias 필드에 설명 레이블을 입력합니다(예: Color, Size, Custom Engraving).
3. Cart item path 필드에 metadata에서 확인한 구조에 따른 속성 값 경로를 입력합니다.

맞춤 속성 매핑 예시

맞춤 각인, 색상, 크기 속성이 있는 제품을 매핑하는 방법을 살펴봅니다.

WooCommerce Product Add-ons 플러그인을 사용하는 경우 속성이 addons 키 아래 배열로 전달되기도 합니다. 아래 JSON 블록은 Zonos로 전달된 속성을 보여 줍니다.

예시 JSON 블록:

{
  "addons": [
    {
      "name": "Custom Engraving",
      "value": "Built to last",
      "price": 0,
      "field_name": "1226-1748963436",
      "field_type": "custom_text",
      "id": 1748963436,
      "price_type": "flat_fee"
    }
  ],
  "variation": {
    "attribute_pa_color": "blue",
    "attribute_size": "Large"
  }
}

Mapping settings의 Attributes에서 각 속성은 다음과 같이 매핑해야 합니다.

참고: addons.0.value 경로 형식은 다음과 같습니다.

• addons는 addons 배열을 찾도록 지시합니다
• .0은 해당 배열의 첫 번째 객체를 가리킵니다
• .value는 해당 객체 value 필드의 값을 반환합니다
• attribute_pa_color와 attribute_size는 배열에 없는 객체이므로 직접 매핑할 수 있습니다.

제품 속성 매핑 테스트

속성을 매핑한 후 Zonos Checkout에서 완전한 테스트 주문을 진행합니다. 주문이 처리되면 WooCommerce 주문 세부 정보에서 제품 속성이 올바르게 가져와졌는지 확인합니다.