VibeFox Instabee for PrestaShop — 도움말

요구 사항

PrestaShop: 8.0 ~ 9.x.

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

Budbee API 자격 증명(택배 보관함 선택에만 필요): API 키와 API 시크릿. Instabee가 배송 계약이 있는 가맹점에 발급합니다. Instabee 담당자에게 문의하거나 Instabee 가맹점 포털을 이용하십시오. API 문서는 developer.budbee.com에 있습니다. 자격 증명이 없어도 운송업체는 고정 요금으로 작동하지만, 고객은 택배 보관함을 선택할 수 없습니다.

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

설치

1. 관리자 페이지에서 Modules > Module Manager로 이동하여 Upload a module을 클릭합니다. 모듈의 ZIP 파일을 선택하십시오.

2. 업로드가 끝나면 Configure를 클릭하거나, 나중에 모듈 목록에서 VibeFox Instabee를 찾아 Configure를 클릭하십시오.

3. Configure 페이지 상단의 라이선스 블록에 있는 License key에 VibeFox 라이선스 키를 입력하고 Activate를 클릭하십시오(라이선스 키 참조).

4. Prices 섹션을 작성하고, 택배 보관함 선택기를 위해 Budbee의 API key와 API secret을 입력하십시오(설정 참조). Save를 클릭합니다.

설치 시 모듈은 배송 시간 텍스트 Delivery to an Instabee parcel box와 함께 Instabee parcel box 운송업체를 생성합니다. 이 운송업체는 모든 고객 그룹과 스웨덴, 핀란드, 덴마크, 네덜란드, 벨기에의 배송 지역에 할당됩니다. 배송 지역, 고객 그룹, 배송 시간, 로고는 Shipping > Carriers에서 변경할 수 있습니다. 그곳에서 요금을 설정하지 마십시오. 요금은 항상 모듈에서 가져옵니다.

설정

모든 설정은 모듈 페이지에 있습니다: Modules > Module Manager > VibeFox Instabee > Configure. 각 섹션에는 별도의 Save 버튼이 있으며, 이 버튼은 페이지 전체를 저장합니다.

설정 위의 경고는 다음과 같은 경우 알려 줍니다. API 자격 증명 중 하나만 입력된 경우, API 자격 증명이 없는 경우, 국가별 요금과 대체 요금이 모두 없는 경우, 마지막 Budbee API 요청이 실패한 경우(날짜, 시간, 이유 표시), Instabee 운송업체를 찾을 수 없는 경우, 쇼핑몰의 무게 단위를 인식할 수 없는 경우(International > Localization의 Local units에서 kg, g, lb, oz 중 하나를 설정하십시오). 설정을 저장할 때마다 캐시된 택배 보관함 목록과 마지막 API 오류가 지워집니다. 메서드 이름이나 세금 상태가 올바르지 않거나 Min weight (kg)가 Max weight (kg)보다 크면 아무것도 저장되지 않고 오류가 표시됩니다.

General

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

Method name: 결제 시 고객에게 표시되는 운송업체 이름입니다. 기본값: Instabee parcel box. 필수 항목이며 최대 64자입니다.

Tax status: None은 아래 요금이 최종 금액임을 의미합니다. 세금 규칙과 함께 Taxable을 선택하면, PrestaShop이 아래 요금에 해당 규칙의 배송 세금을 더합니다.

택배 보관함 선택기(Budbee API)

API 자격 증명이 있으면 고객은 결제 시 우편번호 근처의 택배 보관함을 선택하고, 그 보관함이 주문에 저장됩니다. 두 항목 모두 필요합니다. 두 항목이 모두 설정될 때까지 선택기는 꺼진 상태로 유지됩니다.

API key: Budbee API 키(HTTP Basic 사용자 이름)입니다.

API secret: Budbee API 시크릿(HTTP Basic 비밀번호)입니다. 로그에는 절대 기록되지 않습니다.

저장한 후에는 두 항목이 비어 있고 Saved - leave empty to keep it.이 표시됩니다. 값을 바꾸고 싶을 때만 새 값을 입력하십시오. 저장된 자격 증명을 삭제하려면 Remove the saved API key and secret을 선택한 후 저장합니다. 저장된 항목이 없으면 페이지에 No credentials saved.가 표시됩니다.

Test environment: Budbee 스테이징 API(api.staging.budbee.com)를 사용합니다. Instabee에서 받은 스테이징 자격 증명이 있을 때만 켜십시오. 실제 운영 쇼핑몰은 꺼 두십시오(api.budbee.com). 기본값: 꺼짐.

요금(섹션 제목에는 쇼핑몰의 기본 통화가 표시됩니다)

모든 요금은 쇼핑몰의 기본 통화로, 세금 제외 금액으로 입력합니다. 소수점은 쉼표와 마침표 모두 허용됩니다(49,90 = 49.90). 고객에게는 요금이 장바구니 통화로 표시됩니다.

Calculation type: 요금이 적용되는 방식입니다.

Country prices: Country, Price, XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg, XL >5 kg 열로 이루어진 표입니다. 행을 추가하려면 Add country를, 행을 삭제하려면 휴지통 아이콘을 클릭합니다. 별도의 행이 없는 모든 국가에 적용되는 행은 * Any other country를 선택하여 만듭니다. 구간이 비어 있거나 0이면 Price 열을 사용합니다. Price가 0이면 무료 배송입니다. 국가 행에 장바구니 무게에 대한 요금이 없으면 * 행을 사용하고, 그것도 없으면 Fallback cost를 사용합니다. 숫자가 아닌 요금은 지워지며, 경고에 그 항목이 표시됩니다. 무게는 쇼핑몰의 무게 단위에서 kg으로 환산됩니다.

Fallback cost: 목적지 국가의 행과 * 행 모두에서 요금을 얻을 수 없을 때 사용합니다. 해당 국가에서 운송업체를 숨기려면 비워 두십시오.

조건

Min weight (kg): 장바구니 무게가 이 값보다 낮으면 운송업체를 숨깁니다. 기본값: 0(제한 없음).

Max weight (kg): 장바구니 무게가 이 값보다 높으면 운송업체를 숨깁니다. 택배 보관함은 약 20 kg까지 담을 수 있습니다. 기본값: 20. 0은 제한 없음을 의미합니다. Min weight (kg)보다 작을 수 없습니다.

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

Free shipping from: 운송업체가 무료가 되는 장바구니 소계(할인 후, 세금 전)입니다. 무료로 제공하지 않으려면 비워 두십시오.

이 항목들이나 Fallback cost의 값이 숫자가 아니면 저장되지 않고 이전 값이 유지되며, 경고에 해당 항목 이름이 표시됩니다.

배송 지역 없이 사용할 때의 제공 범위

보통 운송업체는 Shipping > Carriers에서 연결된 배송 지역에서 제공됩니다. 또는 여기에서 국가 목록에 대해 운송업체를 활성화할 수 있습니다.

Ignore shipping zones: 운송업체의 지역에 아래 국가가 포함되어 있지 않더라도, 아래 국가에서 운송업체를 제공합니다. 운송업체는 나중에 만든 지역을 포함하여 활성 상태인 모든 지역에 연결됩니다. 이 옵션을 다시 끄면 운송업체는 이전에 가지고 있던 지역을 되돌려 받습니다.

Countries: 이 모드에서의 목적지 국가입니다. 모든 국가를 허용하려면 비워 두십시오. 이 항목은 Ignore shipping zones가 켜져 있을 때만 사용됩니다.

고급

Debug log: 디버그 메시지를 모듈 폴더의 logs/vfd_ibee_debug.log.php에 씁니다. 이 파일은 웹에서 열 수 없습니다. 이 옵션이 꺼져 있어도 API 오류는 항상 기록됩니다. API 키와 고객 데이터는 절대 기록되지 않습니다.

Log: 로그의 크기와 최신 항목을 보여 줍니다. Clear log를 클릭하면 로그를 비울 수 있습니다.

Remove data on uninstall: 켜져 있으면 모듈을 제거할 때 설정과 운송업체가 삭제됩니다. 꺼져 있으면 제거 시 운송업체만 꺼집니다. 주문에 저장된 택배 보관함은 항상 유지됩니다.

결제 시 동작 방식

배송 단계에서 PrestaShop은 모듈에 Instabee 요금을 요청합니다. 실물 상품만 계산에 포함됩니다. 가상 상품은 무게를 더하지 않으며 주문 금액에도 포함되지 않습니다. 모듈은 장바구니 무게와 최소 주문 금액, 그리고 Ignore shipping zones를 사용하는 경우 허용된 국가 조건을 확인합니다. 장바구니 소계가 Free shipping from에 도달하면 요금은 0입니다. 그렇지 않으면 목적지 국가의 Country prices 행, * 행 또는 Fallback cost에서 요금을 가져옵니다. 요금이 없으면 운송업체가 숨겨집니다.

고객이 Instabee 운송업체를 선택하고 API 자격 증명이 설정되어 있으면, 스웨덴, 핀란드, 덴마크, 네덜란드, 벨기에의 경우 운송업체 아래에 Parcel box 블록이 나타납니다. 이 블록에는 배송 주소의 우편번호 근처 보관함이 거리순으로 이름, 주소, 거리와 함께 표시됩니다. 고객은 다른 우편번호를 입력하고 Search를 클릭하거나 Enter 키를 누를 수 있습니다. 우편번호를 입력하기 전까지 블록은 우편번호를 요청합니다. 보관함을 찾지 못하면 고객에게 다른 우편번호를 시도하거나 다른 배송 방법을 선택하라고 안내합니다. 다른 국가의 경우 운송업체는 보관함 없이 제공됩니다.

택배 보관함 선택은 필수입니다. 선택한 보관함은 해당 우편번호의 Budbee 목록에 있는 경우에만 장바구니에 저장됩니다. 고객이 배송 단계에서 Continue를 클릭하면 모듈이 서버에서 보관함을 다시 확인합니다. 확인되지 않으면 고객에게 Please choose an Instabee parcel box.가 표시됩니다. 보관함 이름은 브라우저가 아니라 Budbee 목록에서 가져옵니다. 고객이 주소의 배송 국가나 우편번호를 바꾸면 이전의 선택은 취소됩니다.

모듈은 Budbee에 목적지 국가와 우편번호만 보내며, 이름, 주소, 이메일, 주문 데이터는 절대 보내지 않습니다. 보관함 목록은 우편번호별로 12시간, 보관함이 없는 우편번호는 1시간, 실패한 요청은 5분 동안 캐시되므로, 느리거나 장애가 있는 API 때문에 결제 페이지 새로고침이 매번 느려지지 않습니다. 결제 페이지 자체는 Budbee를 기다리지 않습니다. 운송업체를 선택하는 순간 목록이 백그라운드에서 로드됩니다. API 제한 시간은 10초입니다.

Budbee API에 연결할 수 없으면 고객에게 Parcel boxes cannot be loaded right now. You can place the order without choosing a box - the shop will assign one.가 표시됩니다. 이 경우 주문에 표시가 남고, 배송을 예약할 때 쇼핑몰이 보관함을 선택합니다. 이전에 선택한 보관함이 그 시점에 확인되지 않으면 그대로 보존되며, 미확인으로 표시됩니다.

선택기는 Classic 및 Hummingbird 테마에서 작동합니다. 운송업체에 주문이 생긴 후 Shipping > Carriers에서 운송업체를 편집하면, PrestaShop은 이를 새 버전의 운송업체로 저장합니다. 모듈은 새 버전을 자동으로 따릅니다.

이 모듈은 실시간 요금 계산, 배송 예약, 송장 출력, 운송장 번호나 추적 이메일 제공, Budbee Home 배송 시간대 제공, 지도 표시를 하지 않습니다. 선택한 보관함으로 가는 소포는 Instabee / Budbee 가맹점 도구에서 예약하십시오.

수령 지점

주문이 생성되면 보관함이 한 번 더 확인되어 주문에 저장됩니다. 그 이후에는 스토어프론트에서 보관함을 바꿀 수 없습니다. 보관함은 다음 위치에 표시됩니다:

관리자 주문 페이지: 보관함 이름, 주소, Box ID가 포함된 Instabee parcel box 블록입니다. 결제 시 보관함을 확인하지 못했다면 not verified (Budbee API was unavailable at checkout)로 표시됩니다. API를 사용할 수 없어서 보관함이 선택되지 않았다면, 블록에 Not chosen - the Budbee API was unavailable at checkout. Choose the box when you book the shipment.가 표시됩니다.

주문 확인 페이지와 고객 계정의 주문 상세: Instabee parcel box:와 함께 보관함 이름과 주소가 표시됩니다.

주문 이메일: 고객에게 보내는 주문 확인 이메일에서는 운송업체 이름에 보관함이 추가됩니다. 쇼핑몰로 가는 신규 주문 이메일(PrestaShop Mail alerts 모듈)에도 보관함 ID가 표시됩니다. API를 사용할 수 없어서 보관함이 선택되지 않았다면, 쇼핑몰에 보내는 이메일만 이를 언급합니다.

라이선스 키

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

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

키 하나는 도메인 하나에서 작동합니다. 기본 쇼핑몰의 도메인이며, 멀티스토어 설정에서도 마찬가지입니다. 쇼핑몰에서 키를 제거해도 도메인 슬롯은 비워지지 않습니다. vibefox.net 계정에서 슬롯을 비우십시오.

활성 키가 없으면 결제 시 고객에게 Instabee 운송업체가 표시되지 않고 요금도 계산되지 않습니다. PrestaShop 스토어프론트는 관리자 페이지에 로그인되어 있는지 알지 못하므로, 운송업체는 관리자에게도 숨겨집니다. 키를 구매하기 전에 모듈을 설정할 수는 있지만, 결제 시 테스트할 수는 없습니다. Modules > Module Manager의 Alerts 탭에 알림이 표시됩니다. 기존 주문에는 영향이 없습니다.

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

문제 해결

결제 페이지에 Instabee가 나타나지 않습니다: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지 확인하십시오. Shipping > Carriers에서 운송업체가 고객 국가의 지역과 고객 그룹을 포함하는지, 또는 Ignore shipping zones가 켜져 있고 해당 국가가 허용되어 있는지 확인하십시오. 해당 국가에 요금이 있는지, 또는 * 행이나 Fallback cost가 있는지 확인하십시오. 무게 제한과 Minimum order amount를 확인하십시오. 설정 위의 경고는 요금이 설정되지 않은 경우를 알려 줍니다. 상품 페이지에서 특정 운송업체로 상품을 제한하고 있을 수도 있습니다. 이유를 Log 항목에서 확인하려면 Debug log를 켜십시오.

고객에게 택배 보관함 목록이 보이지 않습니다: 목록은 API key와 API secret이 모두 입력되어 있고, 국가가 스웨덴, 핀란드, 덴마크, 네덜란드, 벨기에 중 하나이며, 우편번호가 입력된 후에만 나타납니다. 마지막 API 오류는 설정 위에 표시됩니다. 자세한 내용은 모듈 페이지의 Log 항목에 있습니다. 더 자세한 내용을 보려면 Debug log를 켜십시오.

로그에 HTTP 401 또는 403이 표시됩니다: Budbee가 API 키 또는 시크릿을 거부했습니다. 키와 시크릿을 확인하고, Test environment가 자격 증명과 일치하는지 확인하십시오(스테이징 자격 증명은 테스트 환경이 켜져 있을 때만 사용할 수 있습니다).

우편번호에 대한 보관함이 없습니다: Budbee가 그 우편번호를 서비스하지 않습니다. 고객은 다른 우편번호를 검색하거나 다른 배송 방법을 선택할 수 있습니다.

고객이 배송 단계에서 진행할 수 없습니다: Budbee API에 연결할 수 없는 경우를 제외하면, 목록에서 택배 보관함을 선택해야 합니다. 검색한 우편번호의 목록에 없는 보관함은 저장되지 않으며, 고객에게 This parcel box is not in the Budbee list for the postal code. Please choose the parcel box again.가 표시됩니다.

변경 후 오래된 보관함 목록이 보입니다: 모듈 페이지에서 Save를 클릭하십시오. 캐시된 보관함 목록이 지워집니다.

페이지에 Instabee 운송업체를 찾을 수 없다고 표시됩니다: Shipping > Carriers에서 운송업체가 삭제되었습니다. Modules > Module Manager에서 모듈을 초기화하면 다시 생성됩니다. The settings were saved, but the carrier could not be updated. 메시지도 같은 방법으로 해결됩니다. 초기화해도 운송업체 상태는 유지됩니다. 꺼 둔 운송업체는 계속 꺼진 상태로 남습니다.

제거

Modules > Module Manager로 이동하여 VibeFox Instabee 옆의 메뉴를 열고 Uninstall을 선택하십시오. 라이선스 키와 라이선스 상태는 항상 삭제됩니다. 캐시된 보관함 목록은 항상 삭제됩니다. Remove data on uninstall이 켜져 있으면 운송업체가 삭제되고(주문은 기록을 유지합니다), 설정, 로그, 주문으로 이어지지 않은 장바구니에서 선택된 보관함도 삭제됩니다. 꺼져 있으면 운송업체만 꺼지고 모든 설정이 유지됩니다. 모듈을 다시 설치하면 저장된 운송업체는 이전 상태를 되찾습니다. 주문에 저장된 택배 보관함은 항상 유지됩니다.

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