VibeFox Instabee for WooCommerce — 도움말

요구 사항

WordPress: 5.8 이상.

WooCommerce: 7.0 이상, 설치 및 활성화되어 있어야 합니다. WooCommerce가 없으면 플러그인을 활성화할 수 없습니다.

PHP: 8.0 이상.

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

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

설치

1. WordPress에서 Plugins > Add New > Upload Plugin으로 이동하여 플러그인 ZIP 파일을 선택하고 Install Now를 클릭하십시오. FTP로 vfd_instabee 폴더를 /wp-content/plugins/에 업로드할 수도 있습니다.

2. Activate를 클릭하십시오.

3. 설정을 여십시오: WooCommerce > Settings > Shipping > VibeFox Instabee. 또는 플러그인 페이지에서 플러그인 이름 아래의 Settings를 클릭하십시오.

4. 페이지 상단의 라이선스 블록에 VibeFox 라이선스 키를 입력하고 Activate를 클릭하십시오.

5. 가격 섹션을 작성하십시오. 택배 보관함 선택기를 쓰려면 Budbee API key와 API secret도 입력하십시오(설정 항목 참조).

6. WooCommerce > Settings > Shipping > Shipping zones에서 배송 국가(예: 스웨덴)의 배송 지역에 VibeFox Instabee를 추가하거나, Ignore shipping zones를 켜고 국가를 선택하십시오.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Shipping > VibeFox Instabee. 설정은 모든 배송 지역에 적용됩니다. 배송 지역에 방법을 추가하면 지역 창에는 필드가 하나만 표시됩니다:

Title: 이 지역 결제 시 표시되는 이 요금의 이름입니다. 비워 두면 전역 Method name을 사용합니다.

설정 위의 경고는 API 자격 증명 중 하나만 입력된 경우, 자격 증명이 없는 경우, 국가별 가격과 대체 요금이 없는 경우, 그리고 마지막 Budbee API 요청이 실패한 경우(날짜, 시간, 이유 포함)를 알려 줍니다. 설정을 저장할 때마다 캐시된 택배 보관함 목록과 마지막 API 오류가 삭제됩니다.

일반

Enable/Disable: 배송 지역을 포함하여 모든 곳에서 이 방법을 켜거나 끕니다. 기본값: 켜짐.

Method name: 장바구니와 결제 시 표시되는 배송 방법 이름입니다. 지역은 자체 Title로 이를 재정의할 수 있습니다. 기본값: Instabee parcel box.

Tax status: Taxable은 배송비에 WooCommerce 세금을 추가하고, None은 추가하지 않습니다.

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

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

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

API secret: Budbee API 시크릿(HTTP Basic 비밀번호)입니다.

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

가격(섹션 제목에 쇼핑몰의 통화가 표시됩니다)

모든 가격은 쇼핑몰 통화로 입력합니다. 소수점은 쉼표와 마침표 모두 허용됩니다(49,90 = 49.90). 숫자가 아닌 값은 저장되지 않으며, 오류 메시지에 해당 필드가 표시됩니다.

Calculation type: 가격 적용 방식입니다.

Per order (weight tier of the whole cart): 장바구니 전체 무게가 속하는 무게 구간의 가격이 한 번 청구됩니다. 기본값입니다.

Per item (price of each item's weight tier × quantity): 각 상품은 자체 무게 구간 가격으로 계산되며, 수량을 곱합니다.

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은 제한 없음을 의미합니다.

Minimum order amount: 장바구니 소계(할인 후, 세금 전)가 이 금액에 도달한 경우에만 이 방법을 표시합니다. 비워 두면 항상 표시합니다.

Free shipping from: 장바구니 소계(할인 후, 세금 전)가 이 금액 이상이면 이 방법이 무료입니다. 비워 두면 무료가 되지 않습니다.

Excluded shipping classes: 장바구니에 이 WooCommerce 배송 클래스 중 하나에 속한 상품이 있으면 이 방법을 숨깁니다.

배송 지역 없이 제공하기

보통은 VibeFox Instabee를 배송 지역에 추가합니다. 또는 여기에서 국가 목록에 대해 이 방법을 켤 수 있습니다.

Ignore shipping zones: 어떤 배송 지역에도 포함되어 있지 않더라도, 아래의 국가에서 이 방법을 제공합니다.

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

고급

Debug log: 디버그 메시지를 WooCommerce > Status > Logs에 기록합니다(소스 vfd-instabee). 이 옵션이 꺼져 있어도 API 오류는 항상 기록됩니다. API 키와 고객 데이터는 절대 기록되지 않습니다.

Remove data on uninstall: 켜져 있으면 플러그인을 삭제할 때 이 방법의 설정과 지역별 요금이 제거됩니다. 플러그인을 비활성화해도 설정은 절대 삭제되지 않습니다. 주문에 저장된 택배 보관함은 유지됩니다.

결제 시 작동 방식

고객이 배송 주소를 입력하면 WooCommerce는 플러그인에 요금을 요청합니다. 플러그인은 조건을 확인합니다: 장바구니 무게, 최소 주문 금액, 제외된 배송 클래스. 장바구니 소계가 Free shipping from에 도달하면 요금은 무료입니다. 그렇지 않으면 목적지 국가의 Country prices 행, * 행, 또는 Fallback cost에서 가격을 가져옵니다. 가격이 없으면 이 방법은 숨겨집니다.

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

택배 보관함 선택은 필수입니다. 주문이 완료되면 플러그인은 서버에서 선택한 보관함이 해당 우편번호의 Budbee 목록에 있는지 확인합니다. 그렇지 않으면 고객에게 Please choose an Instabee parcel box. 메시지가 표시됩니다. 보관함 이름은 브라우저가 아니라 Budbee 목록에서 가져옵니다.

플러그인은 Budbee에 목적지 국가와 우편번호만 전송하며, 이름, 주소, 이메일, 주문 데이터는 절대 전송하지 않습니다. 보관함 목록은 우편번호별로 12시간, 보관함이 없는 우편번호는 1시간, 실패한 요청은 5분 동안 캐시되므로, 느리거나 고장난 API가 결제 페이지 새로 고침마다 속도를 떨어뜨리지 않습니다. API 제한 시간은 10초입니다.

Budbee API에 연결할 수 없으면 고객에게 보관함을 선택하지 않고도 주문할 수 있다고 안내합니다. 이 경우 주문에 표시가 남고, 배송을 예약할 때 보관함을 선택하게 됩니다. 이전에 선택한 보관함이 그 시점에 확인되지 않으면 그대로 유지되며 미확인으로 표시됩니다.

선택기는 클래식 결제와 장바구니 및 결제 블록에서 작동합니다. 이 플러그인은 WooCommerce 고성능 주문 저장소(HPOS)와 호환됩니다.

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

수령 지점

선택한 택배 보관함은 주문에 저장되며 다음 위치에 표시됩니다:

관리자 주문 화면: 배송 주소 아래에 Instabee parcel box로 보관함 이름, 주소, Box ID와 함께 표시됩니다. 결제 시 보관함을 확인할 수 없었다면 not verified (Budbee API was unavailable at checkout)로 표시됩니다. API를 사용할 수 없어 보관함이 선택되지 않았다면 화면에 이를 알리고, 배송을 예약할 때 보관함을 선택하라고 알려 줍니다.

감사 페이지와 내 계정 주문 페이지: 보관함 이름과 주소.

주문 이메일: HTML 및 일반 텍스트. 쇼핑몰로 보내는 이메일에는 보관함 ID도 표시됩니다. API를 사용할 수 없어 보관함이 선택되지 않았다면 쇼핑몰로 보내는 이메일에만 이를 언급합니다.

라이선스 키

이 플러그인은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. 라이선스 블록은 WooCommerce > Settings > Shipping > VibeFox Instabee 페이지 상단에 있습니다. 키를 License key에 붙여 넣고 Activate를 클릭하십시오. 블록에는 상태(예: 라이선스 유효 기한)와 도메인이 표시됩니다. Check now로 상태를 다시 확인하고, Change key로 다른 키를 입력하고, Remove key로 이 사이트에서 키를 제거하십시오. Manage licenses and domains in your account 링크는 vibefox.net 계정을 엽니다.

키 하나는 도메인 하나에서만 사용할 수 있습니다. 사이트에서 키를 제거해도 도메인 슬롯은 확보되지 않습니다. vibefox.net 계정에서 슬롯을 확보하십시오.

활성 키가 없으면 Instabee는 결제 시 고객에게 표시되지 않습니다. 로그인한 쇼핑몰 관리자에게는 (unlicensed — visible to admins only)라고 표시되어 계속 보이므로, 키를 구매하기 전에 플러그인을 설정하고 테스트할 수 있습니다. 플러그인 페이지와 WooCommerce 페이지에 안내가 표시됩니다. 기존 주문에는 영향이 없습니다.

라이선스가 만료되어도 플러그인은 계속 작동하지만, 업데이트와 지원을 받으려면 갱신이 필요합니다. 상태는 백그라운드에서 자동으로 다시 확인됩니다.

문제 해결

결제 시 Instabee가 나타나지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 그리고 이 방법이 고객 국가의 배송 지역에 추가되어 있는지(또는 Ignore shipping zones가 켜져 있고 해당 국가가 허용되어 있는지) 확인하십시오. 해당 국가에 가격이 있는지, 또는 * 행이나 Fallback cost가 있는지 확인하십시오. 무게 제한, Minimum order amount, Excluded shipping classes를 확인하십시오. 가격이 설정되지 않은 경우 설정 위에 경고가 표시됩니다.

고객에게 택배 보관함 목록이 보이지 않음: 목록은 API key와 API secret이 모두 설정되어 있고, 스웨덴, 핀란드, 덴마크, 네덜란드, 벨기에 중 하나가 목적지이며, 우편번호가 입력된 후에만 나타납니다. 마지막 API 오류는 설정 위에 표시됩니다. 자세한 내용은 WooCommerce > Status > Logs(소스 vfd-instabee)에 있습니다. 더 자세한 내용이 필요하면 Debug log를 켜십시오.

로그에 HTTP 401 또는 403이 표시됨: Budbee가 API 키 또는 시크릿을 거부했습니다. 두 값을 확인하고, Test environment 설정이 자격 증명과 일치하는지 확인하십시오(스테이징 자격 증명은 테스트 환경을 켠 경우에만 사용합니다).

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

변경 후 이전 보관함 목록이 표시됨: 설정 페이지를 저장하십시오. 캐시된 보관함 목록이 지워집니다.

보관함 검색의 다른 국가: 개발자는 vfd_ibee_box_countries 필터로 국가 목록을 변경할 수 있습니다.

라이선스 블록에 오류가 표시됨: 블록에 표시된 메시지를 따르십시오. 예를 들어 키가 다른 도메인에서 이미 사용 중이라면 vibefox.net 계정에서 슬롯을 확보한 뒤 Check now를 클릭하십시오. 사이트 주소가 바뀌었다면 Check now를 클릭하여 새 도메인에 키를 활성화하십시오. 라이선스 서버에 연결할 수 없으면 플러그인은 마지막으로 확인된 상태로 계속 작동합니다.

제거

플러그인을 비활성화하면 캐시된 보관함 목록만 지워집니다. 완전히 제거하려면 비활성화한 후 Plugins 페이지에서 삭제하십시오. 이 플러그인의 라이선스 키와 라이선스 상태, 캐시된 보관함 목록, 마지막 API 오류는 항상 삭제됩니다. 설정, 지역별 배송 방법, 버전 데이터는 Remove data on uninstall이 켜져 있었을 때만 삭제됩니다. 그렇지 않으면 나중에 다시 설치할 수 있도록 유지됩니다. 주문에 저장된 택배 보관함은 항상 유지되며, 기존 주문은 배송 항목을 그대로 유지합니다.

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