WooCommerce 통합

WooCommerce 통합을 통해 귀하의 WooCommerce 온라인 상점을 Gem Logic에 연결할 수 있습니다. 연결되면 Gem Logic에서 WooCommerce 상점으로 제품을 푸시하고 WooCommerce에서 Gem Logic으로 주문을 가져올 수 있습니다. 이를 통해 두 플랫폼 간 제품 카탈로그와 주문 관리가 동기화됩니다.

설정

WooCommerce에서 API 키 생성

WooCommerce를 Gem Logic에 연결하기 전에 WooCommerce 상점에서 API 키를 생성해야 합니다.

  1. **WordPress 관리자 패널**에 로그인하십시오.

  2. :menuselection:`WooCommerce –> Settings –> Advanced –> REST API`로 이동하십시오.

  3. **Add key**를 클릭하십시오.

  4. 세부 정보를 입력하십시오:

    • Description: 이 키를 식별할 이름을 입력하십시오 (예: Gem Logic Integration).

    • User: API 연결에 사용할 WordPress 사용자를 선택하십시오.

    • Permissions: **Read/Write**를 선택하십시오. 이는 Gem Logic이 주문을 읽고 상점의 제품을 생성/업데이트할 수 있도록 하는 데 필요합니다.

  5. **Generate API key**를 클릭하십시오.

  6. **Consumer key**와 **Consumer secret**을 복사하십시오. 이는 한 번만 표시되므로 안전한 위치에 저장하십시오.

중요

consumer secret은 한 번만 표시됩니다. 분실할 경우 키를 취소하고 새로 생성해야 합니다.

WooCommerce를 Gem Logic에 연결

  1. Gem Logic에서 :menuselection:`Configuration –> Sales channels`로 이동하십시오.

  2. WooCommerce에 연결하려는 판매 채널을 열거나 새 채널을 생성하십시오.

  3. WooCommerce 체크박스를 활성화하십시오.

  4. 다음 필드를 입력하십시오:

    • URL: WooCommerce 스토어의 전체 URL(예: https://www.yourstore.com). 후행 슬래시는 포함하지 마십시오.

    • WooCommerce Key: 앞서 생성한 **Consumer key**를 붙여넣으십시오.

    • WooCommerce Secret: 앞서 생성한 **Consumer secret**을 붙여넣으십시오.

  5. WooCommerce 스토어에서 Perfect WooCommerce Brands 플러그인을 사용하는 경우 WooCommerce brands plugin 체크박스를 활성화하십시오. 이를 통해 Gem Logic이 제품 브랜드를 WooCommerce와 동기화할 수 있습니다.

  6. 판매 채널을 저장하십시오.

팁

WooCommerce 스토어가 HTTPS를 사용하는지 확인하십시오. API 자격 증명은 암호화되어 Gem Logic에 안전하게 보관됩니다.

판매 채널에 제품 할당

제품을 WooCommerce로 푸시하려면 WooCommerce 판매 채널에 할당되어야 합니다.

  1. :menuselection:`Products`로 이동하십시오.

  2. 제품을 열고 sales channels 섹션으로 이동하십시오.

  3. 제품에 WooCommerce 판매 채널을 추가하십시오.

  4. 해당 판매 채널에 대한 **pricing rule**이 설정되어 있어 WooCommerce로 푸시될 때 가격이 있도록 하십시오.

제품 푸시하기

Gem Logic에서 WooCommerce 스토어로 제품을 푸시할 수 있습니다. 이는 Gem Logic의 데이터를 기반으로 WooCommerce에서 제품을 생성하거나 업데이트합니다.

단일 제품 푸시

단일 제품을 푸시하려면 Gem Logic에서 제품을 열고 제품 판매 채널 섹션에서 푸시 작업을 사용하십시오. 제품이 아직 존재하지 않으면 WooCommerce에 생성되고, 이미 WooCommerce ID가 있으면 업데이트됩니다.

모든 제품 푸시

WooCommerce 판매 채널에 할당된 모든 제품을 한 번에 푸시하려면:

  1. :menuselection:`Configuration –> Sales channels`로 이동하십시오.

  2. WooCommerce 판매 채널을 여십시오.

  3. **Push all products to WooCommerce**를 클릭하십시오.

백그라운드 작업으로 실행됩니다. push history 페이지에서 진행 상황을 추적할 수 있습니다.

푸시되는 내용

제품이 WooCommerce로 푸시되면 다음 데이터가 동기화됩니다:

  • **SKU**(두 시스템 간 제품 매칭에 사용됨)

  • 이름 및 **설명**(판매 채널 언어 기준)

  • 정상 가격 및 **할인 가격**(해당 판매 채널의 가격 규칙에서)

  • 이미지 (변경된 경우에만 재업로드됩니다)

  • 카테고리 및 컬렉션 (WooCommerce에 존재하지 않으면 생성됩니다)

  • 속성 (글로벌 WooCommerce 속성으로 생성됩니다)

  • 태그

  • 재고 수량

  • 브랜드 (WooCommerce brands 플러그인이 활성화된 경우)

  • 상품 유형: 단순 또는 가변 (변형 포함)

가변 상품 및 변형

Gem Logic에서 상품이 상위 상품**으로 표시되면 WooCommerce에서 **가변 상품으로 푸시됩니다. 모든 하위 상품(변형)은 상품 변형으로 푸시됩니다. 각 변형에는 고유한 가격, SKU, 이미지 및 속성 값(예: 사이즈, 색상)이 포함됩니다.

상품 비활성화

Gem Logic에서 WooCommerce의 상품을 비활성화할 수 있습니다. 이렇게 하면 WooCommerce에서 상품 상태가 **초안**으로 설정되어 삭제하지 않고 스토어프론트에서 보이지 않게 됩니다.

푸시 이력

모든 푸시 작업이 기록됩니다. 판매 채널 상세 페이지에서 푸시 이력을 확인하실 수 있습니다. 각 이력 기록에는 다음이 표시됩니다:

  • 시작 및 종료 시간

  • 상태 (시작됨, 완료됨, 실패, 또는 부분 성공)

  • 총 상품 수, 성공 및 실패 건수

  • 성공률 및 소요 시간

  • 상품별 상세 결과 (어떤 상품이 성공하거나 실패했는지 확인하려면 **세부 정보 보기**를 클릭하세요)

상품 가져오기

WooCommerce 스토어에서 Gem Logic으로 상품을 가져올 수 있습니다. 이는 스토어를 처음 연결할 때 초기 가져오기에 유용합니다.

  1. :menuselection:`Configuration –> Sales channels`로 이동하십시오.

  2. WooCommerce 판매 채널을 여십시오.

  3. **WooCommerce에서 상품 가져오기**를 클릭하세요.

이 작업은 백그라운드 작업으로 실행되며 각 상품에 대해 다음 데이터를 가져옵니다:

  • SKU, 이름 및 설명

  • 정상가 및 할인가

  • 카테고리 및 브랜드

  • 이미지 (다운로드되어 Gem Logic에 저장됩니다)

  • 태그

  • 재고 수량

  • 속성 및 금속

  • 상품 변형 (가변 상품의 경우)

참고

Gem Logic에 이미 존재하는 상품(WooCommerce ID 또는 SKU로 일치)은 가져오기 중 건너뜁니다. 새로운 상품만 생성됩니다.

주문 가져오기

WooCommerce에서 완료된 주문을 Gem Logic으로 가져올 수 있습니다.

수동으로 주문 가져오기

  1. :menuselection:`Configuration –> Sales channels`로 이동하십시오.

  2. WooCommerce 판매 채널을 여십시오.

  3. **WooCommerce에서 주문 가져오기**를 클릭합니다.

이 작업은 백그라운드 작업으로 실행됩니다. 출고 이력 페이지로 리다이렉트되며, 실시간으로 진행 상황을 모니터링할 수 있습니다.

자동 주문 가져오기

백그라운드 작업 시스템을 사용하여 일정에 따라 주문을 자동으로 가져올 수도 있습니다. 이를 통해 수동 작업 없이도 새로 완료된 주문이 정기적으로 가져와집니다.

가져오는 데이터

WooCommerce에서 주문을 가져올 때 다음 데이터가 가져와집니다:

  • 주문 키 (고유 주문 식별자로 사용됨)

  • 고객 연락처 정보 (이름, 주소, 이메일, 전화번호) — CRM에 연락처가 생성되거나 업데이트됩니다

  • 주문 날짜 및 통화

  • 품목 라인: 각 주문 라인에는 제품(WooCommerce ID 또는 SKU로 매칭됨), 수량, 가격(부가세 별도 및 포함), 부가세율이 포함됩니다

  • 재고 차감: 각 주문 라인 품목에 대해 재고가 자동으로 차감됩니다

참고

완료됨 상태인 주문만 가져와집니다. 다른 상태(예: 처리 중, 보류 중, 대기 중)의 주문은 건너뜁니다.

참고

이미 가져온 주문(주문 키로 매칭됨)은 중복을 방지하기 위해 건너뜁니다.

가져오기 이력

모든 가져오기 작업이 기록됩니다. 판매 채널 세부 정보 페이지에서 가져오기 이력을 확인할 수 있습니다. 각 이력 레코드는 다음을 표시합니다:

  • 시작 및 종료 시간

  • 상태 (시작됨, 완료됨, 실패, 또는 부분 성공)

  • 처리된 총 주문 수, 생성된 새 주문 수, 건너뛴 수, 실패한 수

  • 소요 시간 및 오류 메시지(있는 경우)