VibeFox Bob Go for PrestaShop — 도움말

요구 사항

PrestaShop: 8.0 ~ 9.x.

PHP: 8.0 이상. 모듈은 이전 PHP 버전에는 설치되지 않습니다.

Bob Go 계정(실시간 배송비에만 필요): Bob Go는 API 키를 사용하지 않습니다. Bob Go 계정(bobgo.co.za)이 필요하며, Bob Go 계정에서 쇼핑몰을 WooCommerce 판매 채널(Sales channels)로 설치하고 해당 채널에서 "Rates at checkout"을 활성화해야 합니다. 서비스, 요금, 규칙은 Bob Go에서 설정합니다. 고정 요금만 사용한다면 Bob Go 계정은 필요하지 않습니다.

VibeFox 라이선스 키: vibefox.net에서 구매합니다. 키 하나는 도메인 하나에서 사용할 수 있습니다.

설치

1. 백오피스에서 Modules > Module Manager로 이동하여 Upload a module을 클릭합니다. 모듈의 ZIP 파일을 선택합니다.

2. 업로드가 완료되면 Configure를 클릭하거나, 나중에 모듈 목록에서 VibeFox Bob Go를 찾아 Configure를 클릭합니다.

3. Configure 페이지 상단의 라이선스 블록에서 VibeFox 라이선스 키를 License key에 입력하고 Activate를 클릭합니다(라이선스 키 참조).

4. Bob Go 계정에서 쇼핑몰을 판매 채널로 설치합니다. 해당 채널에서 "Rates at checkout"을 활성화하고 서비스와 요금을 설정합니다.

5. Configure 페이지에서 쇼핑몰 도메인, 출발지 주소(발송지)를 확인합니다. 쇼핑몰 통화가 ZAR이 아니라면 ZAR 환율도 확인합니다(설정 참조). 쇼핑몰의 남아프리카 주소에 주(州)가 없다면 Add South African provinces를 클릭합니다. Save를 클릭합니다.

설치 시 모듈은 배송 기간 텍스트 Courier delivery (South Africa)와 함께 Bob Go 운송업체를 생성합니다. 운송업체는 활성 상태이며, 모든 지역과 모든 고객 그룹에 연결되고, 기본적으로 Bob Go 실시간 배송비를 사용합니다. 지역, 고객 그룹, 배송 기간, 로고, 크기 제한은 Shipping > Carriers에서 변경할 수 있습니다. 그곳에서 가격은 설정하지 마십시오. 가격은 항상 모듈에서 가져옵니다.

설정

모든 설정은 모듈 페이지에 있습니다: Modules > Module Manager > VibeFox Bob Go > Configure. 설정은 운송업체의 모든 지역에 적용됩니다. 각 섹션에는 전체 페이지를 저장하는 자체 Save 버튼이 있습니다. 저장할 때마다 캐시된 Bob Go 배송비도 지워집니다. 숫자는 소수점 또는 쉼표를 소수 구분자로 사용할 수 있습니다. 값이 잘못되면 페이지에 오류가 표시되고 아무것도 저장되지 않습니다: 숫자가 아닌 값("…" must be a number.), 음수 금액 또는 무게("…" must be a number of 0 or more.), 0 이하의 ZAR conversion rate, Maximum weight보다 큰 Minimum weight, 또는 64자를 초과하는 Method title.

양식 위에서 페이지는 실시간 배송비가 작동할 수 없는 경우 경고를 표시합니다: Live rates are not requested: your store currency is … — set the "ZAR conversion rate"., 남아프리카 주소에 주(州)가 없는 경우(아래 남아프리카 주(州) 참조), 또는 쇼핑몰의 무게 또는 치수 단위가 인식되지 않아 kg 또는 cm로 처리되는 경우. 단위는 International > Localization(Local units)에서 설정합니다.

일반

Enable Bob Go: 운송업체를 켜거나 끕니다. 이것은 Shipping > Carriers의 운송업체 상태와 같은 스위치입니다.

Method title: 고객에게 표시되는 운송업체 이름입니다. "The Courier Guy - Economy"와 같은 Bob Go 서비스는 체크아웃에서 Bob Go의 이름으로 이 아래에 표시됩니다. 기본값: Bob Go. 필수, 최대 64자.

Shipping cost: 가격이 계산되는 방식입니다.

실시간 배송비가 없는 이유는 로그에 기록됩니다. 고객에게는 절대 표시되지 않습니다.

Bob Go 계정

이 섹션에서는 Bob Go에서 필요한 사항을 설명하고, 쇼핑몰 도메인에 대한 Bob Go의 마지막 응답을 표시합니다: connected, the WooCommerce channel is not installed on Bob Go (HTTP 404), "Rates at checkout" is not enabled for this channel (HTTP 401), 또는 오류 코드와 함께 request failed, 또는 no connection.

Store domain: Bob Go는 도메인으로 쇼핑몰을 식별합니다. 비워 두면 플레이스홀더로 표시되는 쇼핑몰 도메인을 사용합니다. Bob Go의 채널이 다른 주소에 설치되어 있는 경우에만 다른 도메인을 입력하십시오. 예를 들어 하위 폴더에 있는 쇼핑몰이라면 example.co.za/shop입니다. 스킴과 끝의 슬래시는 제거됩니다.

ZAR conversion rate: Bob Go는 남아프리카공화국 랜드(ZAR)로 견적을 제공합니다. 쇼핑몰의 기본 통화가 ZAR이 아니라면, 1 ZAR이 귀하의 통화로 얼마인지 입력하십시오(예: 0.05). 배송비는 이 환율로 환산되며, 상품 가격은 ZAR로 Bob Go에 전송됩니다. 귀하의 통화에서 Bob Go 실시간 배송비를 사용하지 않으려면 비워 두십시오(고정 요금은 계속 작동합니다). 환율은 0보다 커야 합니다. 쇼핑몰 통화가 ZAR이라면 비워 두십시오.

Delivery dates: 체크아웃에서 각 서비스 옆에 Bob Go가 추정한 배송 예정 날짜 범위를 표시합니다. 추정값은 항상 주문과 함께 저장되며 주문 페이지에서 볼 수 있습니다.

발송지 (출발지 주소)

출발지 주소는 배송비 요청마다 Bob Go로 전송됩니다. Shop Parameters > Contact > Stores의 쇼핑몰 주소가 같은 국가에 있으면 빈 칸은 그 주소에서 채워집니다.

Origin country: 발송하는 국가입니다. 기본값: 남아프리카공화국. Bob Go는 남아프리카공화국 내에서만 배송합니다.

Origin province: 남아프리카 주(州) 또는 Store province (if in South Africa).

Origin city / suburb: 발송하는 도시 또는 지역입니다(예: 요하네스버그).

Origin postal code: 발송하는 우편번호입니다(예: 2001).

Origin street address: 발송하는 도로명 주소입니다.

남아프리카 주(州): PrestaShop에는 남아프리카공화국의 주(州)가 없으므로 그곳의 고객 주소에는 주(州)가 없지만, Bob Go는 주(州)를 요구합니다. Add South African provinces를 클릭하면 9개 주(州)(코드 EC, FS, GP, KZN, LP, MP, NC, NW, WC)가 남아프리카공화국의 주(州)로 추가되고, 남아프리카 주소에 주(州) 필드가 표시됩니다. 코드나 이름으로 이미 있는 주(州)는 다시 추가되지 않습니다. 버튼을 클릭하기 전까지는 아무것도 변경되지 않습니다. 주(州)가 설정되면 필드에 South African addresses have a province와 해당 개수가 표시됩니다.

고정 요금(Shipping cost가 Fixed prices (below)일 때 사용되며, Bob Go가 배송비를 반환하지 않을 때 대체 수단으로도 사용됩니다)

Price per country: 국가당 한 줄: 2자리 국가 코드, 등호, 쇼핑몰 기본 통화의 가격(세금 제외). 예: ZA=99.99. 그 밖의 모든 국가에는 *를 사용합니다. 예: 다음 줄에 *=199.99. 다른 형식의 줄은 저장할 때 삭제되며, 페이지는 경고에 이를 나열합니다.

Flat price: 위에 줄이 없는 국가에 적용되는 가격입니다. 해당 국가에서 운송업체를 숨기려면 비워 두십시오.

Fixed price applies: Per order는 가격을 한 번만 청구합니다. Per item (price × quantity)는 장바구니의 상품 수량을 곱합니다. Bob Go 실시간 배송비는 항상 전체 배송에 대한 것입니다.

조건

Minimum weight: 장바구니 무게가 이 값보다 낮으면 운송업체를 숨깁니다(kg 단위). 0은 제한 없음을 의미합니다(기본값).

Maximum weight: 장바구니 무게가 이 값보다 높으면 운송업체를 숨깁니다(kg 단위). 0은 제한 없음을 의미합니다(기본값). 두 제한을 모두 설정하면 최소값은 최대값보다 클 수 없습니다.

Minimum order amount: 장바구니 소계(배송이 필요한 상품, 할인 후, 세금 전)가 이 금액 이상일 때만 운송업체를 표시합니다. 항상 표시하려면 비워 두십시오.

Free shipping: 아래의 주문 금액에 도달하면 무료 배송을 켭니다.

Free shipping from: 무료 배송을 적용하는 장바구니 소계(할인 후, 세금 전)입니다. Free shipping이 켜져 있을 때만 사용됩니다. 이 경우 Bob Go에 배송비를 요청하지 않습니다.

Tax: 운송업체의 세금 규칙 또는 No tax(기본값). Bob Go 배송비에는 보통 이미 부가세가 포함되어 있습니다. 이 경우 세금이 두 번 부과되지 않도록 No tax를 유지하십시오.

배송 지역 없이 제공

Ignore shipping zones: 켜면 운송업체가 나중에 만든 지역을 포함한 모든 지역에 연결되고, 아래의 국가에 대해 제공됩니다. 끄면 Shipping > Carriers에서 운송업체의 지역에서만 제공되며, 이전에 가졌던 지역이 복원됩니다.

Countries: 이 모드의 배송 대상 국가입니다. 비워 두면 배송 가능한 모든 국가를 허용합니다. Ignore shipping zones가 켜져 있을 때만 사용됩니다.

고급

Debug log: 배송비 계산과 Bob Go 요청을 모듈 폴더의 logs/vfd_bobg_debug.log.php에 기록합니다. 이 파일은 웹에서 열 수 없습니다. 고객 주소는 기록되지 않습니다. 이 옵션이 꺼져 있어도 Bob Go 오류는 기록됩니다. 작업이 끝나면 끄십시오.

Log: 로그의 크기와 최신 항목을 표시합니다. Clear log를 클릭하면 로그가 비워집니다.

Remove data on uninstall: 켜면 모듈을 제거할 때 Bob Go 설정, 운송업체, 캐시된 배송비, 로그가 삭제됩니다. 주문과 함께 저장된 Bob Go 서비스는 유지됩니다. 끄면 다시 설치할 수 있도록 모든 것이 유지됩니다.

체크아웃에서의 작동 방식

배송 단계에서 PrestaShop은 모듈에 Bob Go 가격을 요청합니다. 실물 상품만 계산에 포함됩니다. 가상 상품은 무게를 더하지 않으며 주문 금액에도 포함되지 않습니다. 모듈은 먼저 배송 대상 국가(Ignore shipping zones 사용 시), 장바구니 무게, Minimum order amount를 확인합니다. 무료 배송이 적용되면 운송업체는 무료로 표시되며 Bob Go에 요청을 보내지 않습니다.

실시간 모드에서 모듈은 Bob Go에 쇼핑몰 도메인, 출발지 주소와 배송지 주소(주(州) 포함), 장바구니 상품을 보냅니다. 상품 가격은 ZAR로 보냅니다. 실시간 배송비는 고객이 도시 또는 우편번호를 입력한 후에만 요청됩니다. 쇼핑몰 통화가 ZAR이 아니면 ZAR 배송비는 ZAR conversion rate로 환산됩니다. 가격은 쇼핑몰의 기본 통화로 계산된 후 고객의 장바구니 통화로 표시됩니다.

Bob Go 운송업체 아래에서 고객은 Choose a delivery service:와 각 Bob Go 서비스에 대한 옵션 하나를 봅니다. 옵션에는 서비스 이름, 가격, 그리고 Delivery dates가 켜져 있으면 예상 배송 날짜가 포함됩니다. 첫 번째 서비스가 기본으로 선택됩니다. 고객이 다른 서비스를 선택하면 선택 내용이 즉시 저장되고, 운송업체 가격과 장바구니 합계가 업데이트됩니다. 운송업체 요금은 선택한 서비스의 요금과 같습니다. 해당 주소에 더 이상 제공되지 않는 서비스라면 고객에게 This service is not available for your address any more. Please choose another one.가 표시됩니다. 저장에 실패하면 메시지는 The service could not be saved. Please try again.입니다. 서비스 목록은 Classic 및 Hummingbird 테마에서 작동합니다.

배송비는 완전한 요청마다 1시간 동안 캐시되므로, 같은 장바구니가 새로운 요청을 일으키지 않습니다. 실패한 요청은 5분 동안 캐시되며, 제한 시간은 12초입니다. 따라서 Bob Go 장애가 체크아웃 업데이트마다 속도를 떨어뜨리지 않습니다. 실패한 요청이 체크아웃을 중단시키는 일은 없습니다. 운송업체가 숨겨지거나, 대체 모드에서는 고정 요금이 사용됩니다. 이유는 로그에 기록됩니다.

주문이 생긴 후 Shipping > Carriers에서 운송업체를 편집하면 PrestaShop은 이를 운송업체의 새 버전으로 저장합니다. 모듈은 새 버전을 자동으로 따릅니다.

모듈은 배송비만 표시합니다. 출고, 송장, 운송장 또는 라벨을 생성하지 않으며, 택배를 추적하지 않고, 주문을 Bob Go와 동기화하지 않거나 알림을 보내지 않습니다. 주문 처리에는 Bob Go 대시보드를 사용하십시오. 픽업 포인트나 사물함 선택 기능은 없습니다. Bob Go는 남아프리카공화국 내에서만 배송합니다.

주문

주문이 접수되면 선택한 Bob Go 서비스, 그 코드, 배송 추정치가 주문과 함께 저장됩니다. 이후 장바구니나 Bob Go 가격이 변경되더라도 이 정보는 바뀌지 않습니다.

백오피스의 주문 페이지에는 Bob Go service(이름과 코드)와 Estimated delivery가 포함된 Bob Go 블록이 표시됩니다. 고객은 계정의 주문 상세 페이지에서 Bob Go service와 Estimated delivery를 봅니다. 고정 요금이나 무료 배송 주문에는 Bob Go 서비스가 없습니다.

라이선스 키

이 모듈은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. 라이선스 블록 License — VibeFox Bob Go는 설정 위에 있는 Modules > Module Manager > VibeFox Bob Go > Configure의 첫 번째 블록입니다. 키를 License key에 입력하고 Activate를 클릭합니다. 그 후 블록에는 마스킹된 키, 상태(예: 라이선스 유효 기한과 도메인), 그리고 상태를 다시 확인하는 Check now, 다른 키를 입력하는 Change key, 이 쇼핑몰에서 키를 제거하는 Remove key 버튼이 표시됩니다. 그 아래에는 Product: presta-shipping-bob-go 줄과 vibefox.net 계정을 여는 Manage licenses and domains in your account 링크가 있습니다. 모듈의 Configure 권한이 있는 직원만 키를 변경할 수 있습니다. 블록의 텍스트는 백오피스 언어를 따릅니다(영어와 러시아어 포함).

키가 승인되지 않으면 블록에 이유가 표시됩니다(예: Key not found, This key belongs to another product, Domain limit reached, 날짜가 붙은 License expired on). 쇼핑몰 주소를 변경했거나 계정에서 도메인 슬롯을 해제한 후에는 Check now를 클릭하십시오. 라이선스 서버에 연결할 수 없으면 모듈은 마지막으로 확인된 상태로 계속 작동합니다.

키 하나는 도메인 하나에서 작동합니다. 메인 쇼핑몰의 도메인이며, 다중 쇼핑몰 설정에서도 마찬가지입니다. 쇼핑몰에서 키를 제거해도 도메인 슬롯은 해제되지 않습니다. vibefox.net 계정에서 슬롯을 해제하십시오.

활성 키가 없으면 Bob Go 운송업체는 체크아웃에서 고객에게 표시되지 않으며 배송비도 계산되지 않습니다. PrestaShop 프런트엔드는 백오피스에 로그인했는지 알지 못하므로, 운송업체는 관리자에게도 숨겨집니다. 키를 구매하기 전에 모듈을 설정할 수는 있지만, 체크아웃에서 테스트할 수는 없습니다. Modules > Module Manager의 Alerts 탭에 알림이 표시됩니다. 기존 주문은 영향을 받지 않습니다.

라이선스가 만료되어도 모듈은 계속 작동하지만, 업데이트와 지원에는 갱신이 필요합니다. 백오피스에서 작업하는 동안 상태는 자동으로 다시 확인됩니다. 키를 입력한 후 처음 14일 동안은 하루에 한 번, 그 이후에는 일주일에 한 번입니다. 크론 작업은 필요하지 않습니다. 모듈을 제거하거나 재설정하면 라이선스 키와 라이선스 상태는 항상 삭제됩니다.

문제 해결

체크아웃에 Bob Go가 나타나지 않음: 라이선스가 활성 상태인지, Enable Bob Go가 켜져 있는지 확인하십시오. Shipping > Carriers에서 운송업체가 고객 국가의 지역과 고객 그룹을 포함하는지 확인하거나, Ignore shipping zones를 켜고 Countries를 확인하십시오. 무게 제한과 Minimum order amount를 확인하십시오. 고정 요금 모드에서는 해당 국가, * 또는 Flat price에 가격이 있는지 확인하십시오. 상품 페이지에서 특정 운송업체로만 제한된 상품일 수도 있습니다.

Bob Go 실시간 배송비가 표시되지 않음: 모듈 페이지를 여십시오. Bob Go 계정 섹션에 Bob Go의 마지막 응답이 표시됩니다. "The WooCommerce channel is not installed on Bob Go"(HTTP 404)는 쇼핑몰 도메인이 Bob Go의 판매 채널이 아니라는 뜻입니다: Store domain을 확인하십시오. "Rates at checkout is not enabled"(HTTP 401)는 해당 채널에서 기능이 꺼져 있다는 뜻입니다. 또한 고객이 도시 또는 우편번호를 입력했는지, ZAR이 아닌 통화를 쓰는 쇼핑몰이라면 ZAR conversion rate가 설정되어 있는지 확인하십시오. Debug log를 켜고, 체크아웃을 새로 고침한 후 Log 항목을 확인하십시오. Bob Go live rates, fixed prices if Bob Go returns no rates를 사용하면 문제를 해결하는 동안에도 고객은 고정 요금을 받습니다.

쇼핑몰 통화가 ZAR이 아님: Bob Go는 ZAR로 견적을 제공합니다. 1 ZAR이 쇼핑몰 통화로 얼마인지 입력하십시오. 이것이 없으면 모듈은 Bob Go에 배송비를 요청하지 않습니다. 고정 요금은 계속 작동합니다.

페이지에 남아프리카 주소에 주(州)가 없다는 경고가 표시됨: 발송지 (출발지 주소) 섹션에서 Add South African provinces를 클릭하십시오. 기존 고객 주소는 편집될 때에만 주(州)를 받습니다.

배송비에 세금이 두 번 부과됨: Bob Go 배송비에는 보통 부가세가 포함되어 있습니다. Tax를 No tax로 설정하십시오.

변경 후 배송비가 오래된 것처럼 보임: 모듈 페이지에서 Save를 클릭하십시오. 이렇게 하면 캐시된 Bob Go 배송비가 지워집니다. Bob Go 계정의 변경 사항은 1시간 캐시가 만료된 후 또는 설정을 저장할 때 반영됩니다.

페이지에 Bob Go 운송업체를 찾을 수 없다고 표시됨: 운송업체가 Shipping > Carriers에서 삭제되었습니다. Modules > Module Manager에서 모듈을 재설정하면 다시 만들어집니다.

제거

Modules > Module Manager로 이동하여 VibeFox Bob Go 옆의 메뉴를 열고 Uninstall을 선택하십시오. 라이선스 키, 라이선스 상태, 캐시된 배송비는 항상 삭제됩니다. Remove data on uninstall이 켜져 있으면 운송업체가 삭제되고(주문은 기록을 유지합니다), 설정, 로그, 진행 중인 장바구니의 서비스 선택이 삭제됩니다. 꺼져 있으면 운송업체는 비활성화되기만 하며 모든 설정이 유지됩니다. 모듈을 다시 설치하거나 Reset을 하면 저장된 운송업체는 이전 상태를 되찾습니다. 활성 상태였던 운송업체는 다시 켜지고, 비활성 상태였던 운송업체는 비활성 상태로 남습니다. 주문과 함께 저장된 Bob Go 서비스는 항상 유지됩니다.

Bob Go는 각 소유자의 상표입니다. 이 모듈은 Bob Go와 제휴하거나 Bob Go의 승인을 받은 것이 아닙니다.