VibeFox DHL Africa for WooCommerce — 도움말

요구 사항

WordPress: 5.8 이상.

WooCommerce: 5.0 이상, 설치되어 있고 활성화되어 있어야 합니다. WooCommerce가 없으면 플러그인이 활성화되지 않습니다.

PHP: 8.0 이상.

DHL Express 계정(실시간 요금 전용): 실시간 요금은 MyDHL API를 사용합니다. DHL Express 계정 번호와 MyDHL API 자격 증명(API 키와 API 시크릿)이 필요합니다. DHL Developer Portal(MyDHL API, "Get access")에서 신청하거나 DHL Express 계정 담당자에게 요청하십시오. 아직 DHL XML Services 자격 증명(Site ID와 비밀번호)을 보유한 계정은 이를 대신 사용할 수 있습니다. 대체 가격만 사용하는 경우 DHL 자격 증명은 필요하지 않습니다.

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

설치

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

2. Activate를 클릭합니다.

3. 설정을 엽니다: WooCommerce > Settings > Shipping > DHL Express Africa, 또는 Plugins 페이지에서 플러그인 이름 아래의 Settings를 클릭합니다.

4. 페이지 상단의 라이선스 영역에 VibeFox 라이선스 키를 입력하고 Activate를 클릭합니다.

5. DHL API를 선택하고 API 키, API 시크릿, DHL 계정 번호를 입력합니다. 테스트 자격 증명을 사용하는 동안에는 Test mode를 켜 두십시오. Ship from 주소를 입력합니다. DHL 계정이 쇼핑몰 통화로 청구되지 않는다면 DHL quote currency와 Exchange rate를 설정합니다. 선택 사항으로 국가별 가격과 대체 비용을 설정할 수 있습니다(설정 항목 참조).

6. WooCommerce > Settings > Shipping > Shipping zones에서 배송 지역에 DHL Express Africa를 추가하거나, Ignore shipping zones를 켜고 국가를 선택합니다.

설정

모든 설정은 한 페이지에 있습니다: WooCommerce > Settings > Shipping > DHL Express Africa. 설정은 모든 배송 지역에 동일하게 적용됩니다. 지역에 이 방법을 추가하면 지역 창에는 입력 항목이 하나만 나타납니다:

Title (zone): 이 지역에서 체크아웃 시 표시되는 이 옵션의 이름입니다. 비워 두면 전역 Name을 사용합니다.

설정 위의 경고는 자격 증명이나 발송지가 없어 실시간 요금이 꺼져 있을 때, 그리고 견적 통화는 지정했지만 환율을 입력하지 않았을 때 알려 줍니다. 설정을 저장할 때마다 캐시된 DHL 견적이 삭제됩니다. 가격과 무게는 소수점 쉼표 또는 소수점 점으로 입력할 수 있습니다.

일반

Enable/Disable: 모든 지역에서 이 방법을 한 번에 켜거나 끕니다.

Name: 체크아웃에 표시되는 배송 방법 이름입니다. 기본값: DHL Express.

Tax status: Taxable(WooCommerce 세금이 활성화된 경우)을 선택하면 DHL 견적에 포함된 세금을 뺀 DHL 요금을 사용하고, WooCommerce가 자체 세금을 추가합니다. None을 선택하면 견적된 DHL 요금을 세금 포함 금액 그대로 청구합니다.

DHL Express 계정(실시간 요금에만 필요)

DHL API: 사용할 DHL 인터페이스입니다. 선택한 API의 항목만 표시됩니다.

MyDHL API (REST) — recommended: 현재의 DHL Express API입니다. DHL은 신규 고객에게 MyDHL API 자격 증명만 발급합니다.

XML Services (legacy): 아직 유효한 XML Site ID가 있는 경우에만 사용하십시오. DHL은 XML Services를 단계적으로 종료하고 있습니다.

API key: MyDHL API 사용자 이름(API 키)입니다.

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

XML Site ID: DHL XML Services Site ID입니다(레거시 API 전용).

XML password: DHL XML Services 비밀번호입니다(레거시 API 전용).

DHL account number: DHL Express 계정 번호(9자리)입니다. MyDHL API에 필요합니다. XML Services를 사용하는 경우 공시 요금 대신 계정 요금을 반환합니다.

Test mode: DHL 테스트 환경을 사용합니다. 기본값은 켜짐입니다. 테스트 자격 증명은 테스트 환경에서만, 운영 자격 증명은 운영 환경에서만 작동합니다. 실제 운영을 시작할 때 끄십시오.

발송지

DHL이 소포를 수거하는 주소입니다. 요금은 이 주소에 따라 달라집니다.

Origin country: 발송 국가입니다.

Origin city: 발송 도시입니다(예: Johannesburg). MyDHL API에 필요합니다.

Origin postcode: 우편번호가 없는 국가(예: 케냐, 나이지리아, 가나)는 비워 두십시오.

요금

모든 가격은 쇼핑몰 통화로 입력합니다. 실시간 요금은 소포에 대해 가장 저렴한 DHL Express 제품의 요금입니다. DHL이 설정되지 않았거나, 실패하거나, 해당 경로에 서비스가 없으면 국가별 가격을 사용하고, 그것도 없으면 대체 비용을 사용합니다. 둘 다 없으면 배송 방법이 숨겨집니다.

DHL quote currency: DHL은 DHL 계정 국가의 통화로 견적합니다(예: ZAR, NGN 또는 KES). DHL이 쇼핑몰 통화의 금액을 반환하지 않으면, 실시간 요금은 아래 환율을 사용해 이 통화에서 환산됩니다. 그렇지 않으면 사용되지 않습니다.

Exchange rate: DHL 견적 통화 1단위가 쇼핑몰 통화로 얼마인지 입력합니다(예: 1 ZAR = 0.05). 환산하지 않으려면 비워 두십시오. 이 환율은 수동으로 설정하는 값입니다.

Fallback cost: 실시간 요금도 국가별 가격도 없을 때 적용되는 정액 비용입니다. 배송 방법을 숨기려면 비워 두십시오.

Country prices: 목적지 국가별 대체 가격으로, 한 줄에 하나씩 CC:Price 형식으로 입력합니다(예: ZA:25.00). 실시간 요금이 없을 때 사용됩니다.

Fallback price basis: Per order는 가격을 한 번만 청구합니다. Per item (multiplied by the cart quantity)는 가격에 상품 수량을 곱합니다. 이는 국가별 가격과 대체 비용에만 적용됩니다. 실시간 DHL 요금은 항상 소포 전체에 대한 것입니다.

Free shipping from: 이 방법이 무료가 되는 장바구니 소계 금액입니다. 이 경우 DHL에 요금을 조회하지 않습니다. 절대 무료로 하지 않으려면 비워 두십시오.

조건

Minimum weight (kg): 장바구니 무게가 이 값보다 적으면 배송 방법을 숨깁니다. 0은 제한 없음을 뜻합니다.

Maximum weight (kg): 장바구니 무게가 이 값을 초과하면 배송 방법을 숨깁니다. 기본값: 70. 0은 제한 없음을 뜻합니다.

Minimum subtotal: 장바구니 소계가 이 금액 이상일 때만 배송 방법을 표시합니다. 항상 표시하려면 비워 두십시오.

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

배송 지역 없이 제공 여부

Ignore shipping zones: 일치하는 배송 지역에 이 배송 방법이 추가되어 있지 않더라도, 아래 국가에 대해 배송 방법을 제공합니다.

Countries: 이 모드의 목적지 국가입니다. 비워 두면 쇼핑몰이 배송하는 모든 국가를 사용합니다. Ignore shipping zones를 켠 경우에만 사용됩니다.

고급

Debug log: 요금 계산을 WooCommerce > Status > Logs에 기록합니다. 소스는 vfd-dhl-africa입니다. 이 옵션이 꺼져 있어도 DHL 오류는 항상 기록됩니다. 자격 증명과 고객 주소는 절대 기록되지 않습니다.

Remove data on uninstall: 켜 두면 플러그인을 삭제할 때 설정과 지역 배송 방법이 제거됩니다. 플러그인을 비활성화해도 데이터는 절대 삭제되지 않습니다.

체크아웃에서의 작동 방식

고객이 배송 주소를 입력하면 WooCommerce가 플러그인에 요금을 요청합니다. 플러그인은 먼저 장바구니 무게, 최소 소계, 제외 배송 클래스를 확인합니다. 무료 배송이 적용되면 고객은 무료 배송을 받으며 DHL에 요청을 보내지 않습니다.

그렇지 않으면 플러그인은 DHL에 출발지와 목적지(국가, 도시, 우편번호), kg으로 환산한 장바구니 무게(최소 0.5kg), 그리고 제품 치수(cm)로 만든 상자 하나를 보냅니다. 상자 치수는 가장 긴 길이, 가장 넓은 너비, 높이를 쌓아 합한 값입니다. 치수가 없는 제품은 아무것도 더하지 않습니다. 치수가 있는 제품이 하나도 없으면 10 x 10 x 10cm 상자를 사용합니다. 국제 배송은 장바구니 소계를 신고 가액으로 하여 상품으로 신고되므로, DHL이 소포 제품에 대해 견적합니다. 국내 배송은 신고하지 않습니다. 실시간 요금은 고객이 도시를 입력한 후에만 요청됩니다(XML Services의 경우 도시 또는 우편번호).

가장 저렴한 DHL Express 제품이 설정한 제목으로 하나의 요금으로 표시됩니다. 고객에게는 DHL 제품이나 배송 기간이 보이지 않습니다. 제품명(예: "EXPRESS WORLDWIDE (P)")은 주문의 배송 항목에 DHL product로 저장되므로, 예약할 제품을 확인할 수 있습니다.

각 견적은 소포와 경로별로 1시간 동안 캐시됩니다. 실패한 요청은 10분 동안 캐시되므로, 새로고침할 때마다 체크아웃이 DHL을 기다리지 않습니다. API 제한 시간은 12초입니다. DHL이 오류를 반환하거나 서비스가 없으면 고객에게 오류가 표시되지 않으며, 대체 가격을 사용하거나 배송 방법을 숨깁니다.

이 방법은 클래식 체크아웃과 장바구니 및 체크아웃 블록 모두에서 작동합니다. WooCommerce 고성능 주문 저장소(HPOS)와 호환됩니다.

플러그인은 요금만 계산합니다. DHL 배송 건 생성, 라벨이나 상업 송장 출력, 집하 예약, 소포 추적, DHL 서비스 포인트 제공, 고객이 DHL 제품을 선택하도록 하는 기능, 여러 상자로의 포장, 보험 추가, 관세 및 세금 견적은 제공하지 않습니다. 견적은 배송비에만 해당합니다. 관세와 수입 세금은 수취인이 부담합니다.

라이선스 키

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

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

유효한 키가 없으면 DHL Express는 체크아웃에서 고객에게 표시되지 않습니다. 로그인한 쇼핑몰 관리자에게는 (unlicensed — visible to admins only) 표시와 함께 계속 보이므로, 키를 구매하기 전에 플러그인을 설정하고 테스트할 수 있습니다. Plugins 페이지와 WooCommerce 페이지에 안내 메시지가 표시됩니다. 기존 주문은 영향을 받지 않습니다.

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

문제 해결

체크아웃에 DHL Express가 표시되지 않음: 라이선스가 활성 상태인지, Enable/Disable이 켜져 있는지, 고객 국가의 지역에 배송 방법이 추가되어 있는지(또는 Ignore shipping zones가 켜져 있고 해당 국가가 허용되어 있는지) 확인하십시오. 무게 제한, Minimum subtotal, Excluded shipping classes를 확인하십시오. 실시간 요금이 없으면 국가별 가격이나 대체 비용이 설정된 경우에만 배송 방법이 나타납니다.

실시간 요금이 표시되지 않음: 설정 페이지 상단의 경고(자격 증명 또는 발송지 누락)를 확인하십시오. Debug log를 켜고 WooCommerce > Status > Logs에서 소스 vfd-dhl-africa를 여십시오. 잘못된 자격 증명, 경로에 대한 서비스 없음, 통화 문제 같은 DHL 오류는 항상 기록됩니다. Test mode가 자격 증명과 일치하는지 확인하십시오.

DHL이 ZAR, NGN 또는 KES로 요금을 반환하지만 쇼핑몰은 다른 통화를 사용함: DHL quote currency를 해당 통화로 설정하고 Exchange rate를 입력하십시오. 그렇지 않으면 실시간 요금이 사용되지 않고 대체 가격이 적용됩니다.

기존 DHL XML Services 자격 증명이 있음: DHL API에서 XML Services (legacy)를 선택하십시오. MyDHL 자격 증명을 받으면 MyDHL API로 전환하십시오.

배송비에 세금이 두 번 부과됨: DHL의 부가세를 제외한 DHL 요금을 사용하도록 Tax status를 Taxable로 설정하거나, 견적된 DHL 금액을 그대로 청구하도록 None으로 설정하십시오.

변경 후 요금이 오래된 것처럼 보임: 설정 페이지를 저장하십시오. 이렇게 하면 캐시된 DHL 견적이 삭제됩니다.

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

제거

플러그인을 비활성화해도 모든 설정은 유지됩니다. 캐시된 DHL 견적만 삭제됩니다. 플러그인을 제거하려면 Plugins 페이지에서 비활성화한 후 삭제하십시오. 이 플러그인의 라이선스 키, 라이선스 상태, 캐시된 견적은 항상 제거됩니다. 설정과 지역 배송 방법은 Remove data on uninstall이 켜져 있을 때만 제거됩니다. 그렇지 않으면 나중에 재설치할 때를 위해 유지됩니다. 주문은 절대 변경되지 않으며, 기존 주문은 배송 항목을 그대로 유지합니다.

DHL은 해당 소유자의 상표입니다. 이 플러그인은 DHL과 제휴되어 있지 않으며 DHL의 승인을 받지 않았습니다.