Salesforce Commerce Cloud용 Checkout

metadata.zip이 준비되면 SFCC sandbox로 가져옵니다.

1. Business Manager > Administration > Site Development > Site Import & Export로 이동합니다.
2. Local 업로드 옵션을 사용하여 metadata.zip을 업로드합니다.
3. 업로드 후 목록에서 아카이브를 찾아 Import를 클릭합니다.

이 단계는 Zonos 통합에 사용되는 필수 사이트 기본 설정, 서비스, 자격 증명 및 사용자 지정 객체를 생성합니다.

컨트롤러, 스크립트 및 템플릿을 활성화하려면 사이트의 cartridge path에 int_zonos cartridge를 추가하세요.

1. Administration > Sites > Manage Sites > [Your Target Site] > Settings로 이동합니다.
2. 기본 SFRA 스토어프론트 cartridge(app_storefront_base) 앞에 cartridge path에 int_zonos를 삽입합니다.

cartridge에 포함된 2개의 사용자 지정 Pipeline에 Business Manager 내 pipeline alias를 추가해야 합니다.

Zonos-OrderConfirmation

Zonos checkout에서 주문이 완료되면 SFCC 내 사용자 지정 주문 확인에 사용됩니다. 사용자가 여기로 리디렉션됩니다. 예를 들어 alias는 zonos-order-confirmation일 수 있습니다. 기본 SFCC/SFRA checkout 주문 확인 페이지(COSummary-Submit)에 사용하는 alias와 다른 적절한 alias를 선택하여 추가하세요.

Zonos-PlaceSFCCOrder

SFCC/SFRA 내에서 Zonos 주문을 생성하는 데 사용되는 사용자 지정 엔드포인트에 사용되며 alias는 zonos-placesfccorder로 가정됩니다. 다른 alias를 사용하면 서비스 설정 시 이를 기록해야 합니다. 공개 URL이 아니므로 이 cartridge를 계속 쉽게 사용할 수 있도록 초기 설정에서는 zonos-placesfccorder 사용을 권장합니다.

이 두 Alias를 구성하려면 Business Manager에서 Merchant Tools > URL Rules > Pipeline URLs로 이동합니다.

2단계의 사이트 가져오기로 두 SFCC 서비스(프로필 및 자격 증명 포함)가 생성되었습니다: zonos.api.graphql 및 create.order.api.sfra.

단일 사이트 설정

SFCC 조직 내에 단일 스토어프론트 사이트가 있으면 여기서 추가 작업 없이 다음 단계로 진행할 수 있습니다.

다중 사이트 설정

SFCC 조직 내에 여러 스토어프론트 사이트가 있거나 여러 스토어프론트 사이트를 계획하는 경우 SFCC 서비스를 업데이트/추가해야 합니다. Zonos 통합을 사용할 여러 SFCC 사이트가 있으면 각 사이트에 create order API 서비스가 필요합니다. 각 사이트에 대해 다음을 수행하세요.

1. create.order.api.[siteID] 이름으로 새 자격 증명을 생성합니다.
2. 자격 증명 URL을 https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder로 지정합니다(예: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. create.order.api.[siteID] 이름으로 새 서비스를 생성하고 create.order.api 프로필과 1단계에서 생성한 create.order.api.[siteID] 자격 증명을 할당합니다.

완료되면 각 사이트에 create order API 서비스가 있어야 합니다.

Note: 원본 create.order.api.sfra 서비스를 사이트 중 하나의 create order 서비스로 이름 변경하지 않았고 여전히 존재하면 삭제할 수 있습니다. zonos.api.graphql 서비스 이름은 그대로 두세요. 여러 사이트가 있어도 Zonos API 서비스는 하나만 필요합니다.

Business Manager에서 Merchant Tools > Site Preferences > Custom Preferences로 이동한 다음 zonos 기본 설정 그룹을 클릭하여 Zonos 사용자 지정 사이트 기본 설정에 액세스합니다.

사이트에 대해 다음 사이트 기본 설정을 지정합니다.

Zonos Modal Checkout 중 쇼퍼는 Zonos Dashboard에 정의된 배송 방법을 선택합니다. 이러한 주문이 SFCC로 가져와질 때 배송 방법은 유효한 SFCC 배송 방법과 일치해야 합니다. 이를 지원하려면:

1. Zonos 배송 방법을 매핑할 SFCC 배송 방법을 하나 이상 설정합니다.
2. 위에서 설명한 Zonos Ship Method Mapping 사용자 지정 사이트 기본 설정에서 Zonos 배송 방법과 SFCC 배송 방법 간 배송 방법 매핑을 하나 이상 설정합니다.

Ship Method Mapping

JSON 객체 형식으로 ship method mapping은 Zonos 배송 방법을 SFCC 배송 방법에 매핑합니다. 이 매핑에는 Zonos checkout에서 선택될 수 있는 모든 잠재적 Zonos 배송 방법(서비스 수준)에 대한 매핑 레코드가 있어야 합니다. SFCC 배송 방법에 대한 매핑이 없는 배송 방법으로 Zonos 주문이 이루어진 경우 사용될 default 매핑 레코드를 포함하는 것이 강력히 권장됩니다. 이렇게 하면 SFCC 주문에 배송 방법이 없어 발생하는 하류 실패를 방지할 수 있습니다.

JSON 객체 형식은 다음과 같습니다.

{
  "[Zonos Shipping Service Level Code]": "[SFCC Shipping Method ID]",
  ...
  "default": "[Default SFCC Shipping Method ID]"
}

예제

Zonos Dashboard에서 다음 서비스 수준을 활성화했다고 가정합니다.

이유(백오피스 요구 사항, 추가 타사 배송 서비스 통합 등)에 관계없이 사이트의 SFCC 배송 방법이 다음으로 제한될 수 있습니다.

새 Zonos 주문을 받아 SFCC에 배치할 때 배송 방법은 이 목록에 있어야 합니다.

매핑을 구축하려면 Zonos Dashboard에 로그인하여 Shipping > Manage Rates로 이동한 다음 표시된 각 Enabled service levels를 클릭하면 다음과 유사한 화면이 표시됩니다.

각각에서 Edit details를 클릭하여 Zonos 배송 서비스 수준 코드를 가져오거나(또는 설정) 설정합니다(아래 참조).

배송 서비스 수준 코드로 매핑 레코드를 생성하여 Zonos checkout에서 해당 배송 서비스 수준(Zonos 배송 방법)이 선택될 때 SFCC 주문에 표시할 SFCC 배송 방법에 매핑합니다.

활성화된 각 배송 서비스 수준 코드와 default 배송 방법 매핑에 대한 레코드를 추가하면 Zonos Ship Method Mapping JSON 객체는 다음과 유사해야 합니다.

{
  "ups.worldwide_saver": "004",
  "ups.standard": "002",
  "ups.worldwide_expedited": "012",
  "ups.worldwide_express": "012",
  "default": "001"
}

Note: Zonos 배송 방법을 SFCC 배송 방법에 매핑하는 것이므로 매핑에 모든 Zonos 배송 방법이 포함되는 것이 중요합니다. 각 SFCC 배송 방법을 매핑에 포함할 필요는 없습니다.

설치에 Zonos 통합을 지원하는 두 SFCC job이 포함됩니다.

CreateOrdersFromZonos

이 job은 zonosOrders 사용자 지정 객체 저장소에서 새로 생성된 Zonos 주문 참조를 찾고, Zonos에서 전체 주문 세부 정보를 가져와 SFCC에 해당 주문을 생성합니다.

Schedule: 비즈니스 요구에 맞게 이 job을 예약할 수 있지만, 일반적으로 상대적으로 자주(예: 5~10분마다) 간격으로 매일 실행되도록 구성해야 합니다.

Custom Parameters: CreateOrdersFromZonos job에는 사용자 지정 매개변수가 없습니다.

CreateMissingZonosOrders

드물어야 하지만 예상치 못한 상황으로 인해 Zonos에 배치된 주문이 일반 프로세스를 통해 SFCC 인스턴스에 들어가지 못할 수 있습니다. 이를 위해 CreateMissingZonosOrders job을 포함했습니다. 이 job은 Zonos 주문 기록과 SFCC 간 교차 확인을 수행하여 누락된 주문을 식별하고 가져옵니다.

Schedule: 비즈니스 요구에 맞게 이 job을 예약할 수 있지만 CreateOrdersFromZonos job보다 덜 자주 실행되도록 예약해야 합니다. 이 job 실행 빈도를 예약할 때 고려할 사항:

1. 모든 job과 마찬가지로 처리 부하/대역폭 및 비즈니스 요구를 포함한 모든 요소를 고려한 후 가능한 한 덜 자주 실행되도록 예약해야 합니다.
2. 이 job은 기간 내 모든 주문을 쿼리하므로 대량 사이트는 더 자주 실행해야 합니다(job 실행당 처리 주문 수 감소). 반면 소량 사이트는 덜 자주 실행해도 됩니다.
3. 대부분의 사이트에 적합할 것으로 생각하는 CreateMissingZonosOrders의 기본 권장 빈도는 90분마다 한 번입니다.

Custom Parameters: CreateMissingZonosOrders job 단계와 연결된 두 사용자 지정 매개변수를 설정해야 합니다.

1. LookBackHours: job 실행 시점부터 Zonos에서 누락된 주문을 쿼리해야 하는 과거 시간(시간)입니다. job 예약 빈도에 따라 이 값은 job 실행 간격 이상이어야 하며 이상적으로 겹쳐야 합니다. 예를 들어 job이 90분마다 실행되도록 예약되면 LookBackHours를 2(시간)로 설정합니다. 기본값(값이 설정되지 않은 경우): 2
2. OrderSize: Zonos 내부 쿼리당 검색할 최대 주문 수입니다. job이 Zonos에서 주문을 쿼리할 때 사용하는 페이지 크기로 생각하면 됩니다. 기본값(값이 설정되지 않은 경우): 20

Zonos Hello는 동적 언어 선택, 관세/세금 메시지 및 인라인 통화 변환과 같은 클라이언트 측 현지화 기능을 제공합니다. 사이트 기본 설정에서 Zonos가 활성화되면 Zonos 클라이언트 스크립트를 통해 스토어프론트에 Hello가 자동으로 로드됩니다.

Zonos 클라이언트 스크립트는 다음 오버레이 템플릿 하단에 있는 Zonos-ClientScriptInclude 엔드포인트의 SFCC remote include를 사용하여 추가됩니다.

• /cartridge/templates/default/common/layout/page.isml
• /cartridge/templates/default/common/layout/checkout.isml

프로젝트가 더 높은 우선순위 cartridge에서 이러한 템플릿을 재정의하는 경우 사용자 지정 버전에 remote include가 추가되었는지 확인하세요.

<isinclude url="${URLUtils.url('Zonos-ClientScriptInclude', 'pageType', pdict.action)}"/>

Zonos Hello에 대해 자세히 알아보기.

Zonos Hello는 스토어프론트에 표시된 가격 값을 쇼퍼의 현지 통화로 자동 변환합니다. 올바르게 작동하려면:

1. 가격 값은 jQuery로 선택할 수 있는 클래스 이름 또는 ID를 사용하는 HTML 요소로 래핑되어야 합니다. 예: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. 이러한 선택기 값은 Currency Element Selector 사이트 기본 설정(또는 Zonos Dashboard)에 포함되어야 합니다.

가격 표시 코드 변경

Zonos cartridge에는 참조 아키텍처 사이트 전체에서 가격이 렌더링되는 위치에 대한 다음 오버레이 템플릿이 포함되어 있으며, 다양한 가격을 포함하는 HTML 요소에 zonos-list-price, zonos-sales-price, zonos-price 클래스 이름이 할당됩니다.

• /cartridge/templates/default/cart/productCard/cartCouponDisplay.isml
• /cartridge/templates/default/cart/cartTotals.isml
• /cartridge/templates/default/checkout/billing/billingSummary.isml
• /cartridge/templates/default/checkout/cart/miniCart.isml
• /cartridge/templates/default/chackout/productCard/productCardProductTotalPrice.isml
• /cartridge/templates/default/product/components/pricing.isml
• /cartridge/templates/default/product/components/setPrice.isml

cartridge path에서 int_zonos보다 높게 구성된 이러한 템플릿을 포함하는 cartridge가 없으면 Zonos Hello가 사이트의 이러한 가격 렌더링 통화를 변환하는 데 코드 변경이 필요하지 않습니다. cartridge path에서 int_zonos보다 높은 하나 이상의 cartridge에 이러한 템플릿의 사용자 지정 버전이 있으면 해당 사용자 지정 템플릿의 가격 주변 HTML 래퍼에 고유 클래스 이름을 포함해야 합니다(위 예시 참조).

가격 요소 선택기 문자열 구성

통화 선택기 문자열은 Zonos 스크립트가 통화 변환 업데이트를 받아야 하는 가격 값을 포함하는 HTML 요소를 식별하는 데 사용하는 jQuery 스타일 선택기 문자열 값입니다. 이 값은 이전 단계에서 설명한 사이트 가격 표시를 래핑하는 HTML 요소에 할당된 CSS 클래스 이름 및/또는 ID의 공백으로 구분된 목록이어야 하며, 클래스 이름은 .로, ID는 #로 접두사를 붙입니다(따옴표 없음). 예를 들어 Zonos cartridge에 포함된 가격 표시 템플릿을 사용하면 선택기 문자열은 .zonos-list-price .zonos-sales-price .zonos-price(따옴표 없음)입니다.

통화 선택기 문자열은 Zonos Dashboard 또는 Business Manager의 Zonos 사용자 지정 사이트 기본 설정 Currency Element Selector 사이트 기본 설정에서 구성할 수 있습니다.

Note: 두 곳 모두에서 구성하면 Business Manager의 값이 우선합니다.

Zonos Hello 통화 변환에 대해 자세히 알아보기.

checkout 버튼 선택기 문자열은 Zonos 스크립트가 클릭 시 고객을 사이트 checkout 흐름으로 이동시키는 버튼 컨트롤 역할을 하는 HTML 요소를 식별하는 데 사용하는 jQuery 선택기 문자열 값입니다.

구성된 선택기 문자열과 일치하는 Checkout 버튼을 쇼퍼가 클릭하면 Zonos가 자동으로 동작을 가로채 modal checkout을 엽니다.

checkout 버튼 선택기 문자열은 Zonos Dashboard 또는 Business Manager의 Zonos 사용자 지정 사이트 기본 설정 Place Order (Checkout) Button Selector 사이트 기본 설정에서 구성할 수 있습니다.

사용자가 Zonos hosted checkout에서 주문을 완료하면 SFCC 내 주문 확인을 표시하는 사용자 지정 Pipeline(Zonos-OrderConfirmation)로 리디렉션됩니다. 이 주문 확인의 기본 렌더링 템플릿은 /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml입니다.

이 주문 확인 페이지는 기본 SFCC/SFRA 주문 확인 페이지와 동일한 스타일을 사용하며 기본 SFCC/SFRA 주문 확인 페이지와 일부 .isml 파일을 공유합니다. 사이트에 이미 적용된 사용자 지정 스타일 업데이트와 일치하도록 스타일 업데이트가 필요할 수 있습니다. Zonos 주문 확인 템플릿에서 사용하는 기본 렌더링 템플릿:

• app_storefront_base\cartridge\templates\default\checkout\confirmation\confirmationDetails.isml
• app_storefront_base\cartridge\templates\default\checkout\shipping\shippingSummary.isml
• int_zonos\cartridge\templates\default\checkout\billing\billingSummary.isml
• app_storefront_base\cartridge\templates\default\checkout\orderProductSummary.isml
• app_storefront_base\cartridge\templates\default\checkout\orderTotalSummary.isml

사용자에게 주문 확인을 표시하는 것 외에 이 사용자 지정 pipeline과 관련된 기본 기능은 데이터 가져오기에 포함된 새 사용자 지정 객체 유형 zonosOrders와 관련됩니다. 사용자에게 주문 확인이 표시되면 SFCC는 주문 확인 URL에 표시된 Zonos order id를 사용하고 Zonos order ID를 사용자 지정 객체의 Key Attribute로 하는 해당 사용자 지정 객체를 생성합니다. 그런 다음 job CreateOrdersFromZonos를 통해 SFCC 내에 주문을 배치하는 데 사용됩니다. 이 job은 createdStatus = - None -인 zonosOrders 유형의 모든 사용자 지정 객체를 반복합니다. job은 다음 작업을 수행합니다.

1. Zonos에서 주문 세부 정보를 쿼리합니다.
2. 이 응답을 사용하여 ship method 및 payment method에 대한 site prefs 내 구성 설정과 응답 내 품목, 배송, 청구 및 고객 세부 정보를 기반으로 SFCC 내에 주문을 생성합니다.
3. mutation을 통해 SFCC order number로 Zonos를 업데이트하여 Zonos Dashboard 내 Zonos order number와 연결합니다.

위 단계가 성공하면 사용자 지정 객체 속성 createdStatus가 created로 설정되어 향후 고려에서 객체가 제거됩니다. 위 단계가 성공하지 않으면 createdStatus가 failed로 설정되고 프로세스 중 오류를 응답한 시스템에 따라 객체의 errorResponse(Zonos) 또는 sfccErrorResponse(SFCC) 속성에 오류 메시지가 기록됩니다.

주문 배치를 다시 시도하려면 createdStatus를 - None -으로 다시 설정하면 다음 job 실행에서 고려됩니다.

선택 사항—다음 설정은 고급 설정입니다. 기본값이 설정되어 있으므로 조치가 필요하지 않습니다. 조정하려면 다음 지침을 따르세요.

Create invoice on import

기본값 Yes입니다. Zonos는 주문 가져오기 시 송장을 생성합니다. 이 기능을 비활성화하면 직접 송장을 생성해야 하며 Zonos는 사기 검토 보류를 zonos_hold 상태로 설정합니다. 사기가 해제되면 이전 상태로 되돌립니다.

Customer login

기본값 No입니다. Checkout에 계정을 요구하려면 Yes로 전환합니다. Customer configuration > Login options로 이동하여 Redirect Customer to Account Dashboard after Logging In을 No로 업데이트해야 합니다.

SFCC order export

SFCC Order Export를 사용하거나 사용할 계획이면 Order 및 Product 객체에 할당된 Zonos 사용자 지정 속성이 SFCC 주문 내보내기 파일에 포함되었는지 확인하세요. Merchant Tools > Site Preferences > Orders에서 주문 내보내기 스키마 버전을 최신 버전으로 설정합니다.

계정과 앱 설정을 완료했으므로 통합 테스트할 준비가 되었습니다. 테스트 중 SFCC에서 Checkout과 Hello를 활성화해야 합니다. 방법:

1. Merchant Tools > Site Preferences > Custom Preferences > zonos로 이동합니다.
2. Zonos Enabled를 Yes로 전환합니다.

사이트의 사용자 지정 사이트 기본 설정에 Zonos 계정 정보를 구성하고 Zonos Enabled 기능 스위치를 YES로 설정하면 사이트 URL에 다음 매개변수를 추가하여 스토어프론트에서 Zonos 기능을 테스트할 수 있습니다. zCountry=[Zonos Dashboard에서 활성화한 국가의 국가 코드]

예를 들어 Canada를 활성화한 경우: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA

Note: Zonos Public API Token이 테스트 credential token으로 구성된 비프로덕션 환경에서 테스트할 때만 필요합니다. 라이브/프로덕션 API token으로 구성하면 zCountry URL 매개변수는 필요하지 않습니다.

아직 라이브 준비가 되지 않았다면 테스트 완료 후 Zonos Enabled를 No로 되돌리세요. 테스트를 완료한 후 위와 동일한 단계로 Zonos를 활성화하세요.

제품 정보는 관세 및 세금 금액과 배송 비용에 영향을 줄 수 있습니다. Zonos에 제공하는 제품 정보가 많을수록 반환되는 견적이 더 정확해집니다. Zonos는 이 정보가 없어도 견적을 생성할 수 있지만, 정확도 향상을 위해 다음 핵심 제품 세부 정보 제공을 권장합니다.

• Weight: 무게는 배송 비용에 영향을 주며 관세 또는 세금에 영향을 줄 수 있습니다. SFCC 제품 목록의 무게는 있을 경우 Zonos에서 자동으로 사용됩니다.
• Dimensions: 치수는 배송 비용에 영향을 줄 수 있으며 관세 또는 세금에 영향을 줄 수 있습니다. Zonos는 SFCC의 각 제품에 설정된 제품 치수(길이, 너비, 높이)를 활용할 수 있지만, 올바른 통합을 위해 Zonos 사용자 지정 사이트 기본 설정에서 매핑해야 합니다.
• HS codes: HS code는 관세율에 영향을 주며 때로는 세금에 영향을 줄 수 있습니다. Zonos는 SFCC 제품 목록에 설정된 HS code를 사용할 수 있지만 Zonos 사용자 지정 사이트 기본 설정에서 HS code 필드를 매핑해야 합니다.
• Country of origin: 제품의 원산지 국가는 관세율에 영향을 주며 세금에 영향을 줄 수 있습니다. SFCC 제품 목록에 설정된 원산지 국가는 있을 경우 Zonos에서 자동으로 사용됩니다.

Note: 또는 Catalog에 정보를 입력하여 SFCC에서 저장 및 전달된 정보를 재정의할 수 있습니다.

플랫폼별 제품 정보에 대해 자세히 알아보기.