VibeFox Mondial Relay for PrestaShop — 도움말

요구 사항

PrestaShop: 8.0 ~ 9.x. 체크아웃은 Classic 및 Hummingbird 테마에서 작동합니다.

PHP: 8.0 이상. 이전 PHP 버전에서는 모듈 설치가 거부됩니다.

Mondial Relay 계정: 브랜드 코드(Enseigne)와 Private Key는 Mondial Relay 비즈니스 계정과 함께 제공됩니다. mondialrelay.fr의 전문가용 섹션, "Connect" 고객 영역 또는 영업 담당자에게 문의하세요. 지도 선택기에는 브랜드 코드만 필요합니다. 가까운 포인트 목록에는 둘 다 필요합니다. 테스트용으로 Mondial Relay는 브랜드 코드 BDTEST13과 Private Key PrivateK를 제공합니다.

VibeFox 라이선스 키: vibefox.net에서 구매합니다. 키 하나는 도메인 하나에서 작동합니다.

설치

1. 관리자 화면에서 Modules > Module Manager로 이동하고 Upload a module을 클릭합니다. 모듈 ZIP 파일을 선택합니다.

2. 업로드가 끝나면 Configure를 클릭하거나, 나중에 모듈 목록에서 VibeFox Mondial Relay를 찾아 Configure를 클릭합니다.

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

4. 브랜드 코드(Enseigne)를 입력하고, 목록 모드의 경우 Private Key를 입력합니다. Country prices를 작성한 다음 Save를 클릭합니다.

설치 시 모듈은 Mondial Relay Point Relais 운송업체를 만들며, 배송 시간 문구는 Delivery to a Mondial Relay Point Relais of your choice입니다. 이 운송업체는 모든 고객 그룹과 프랑스, 벨기에, 룩셈부르크, 스페인, 포르투갈, 네덜란드의 배송 지역에 할당됩니다. 배송 지역, 고객 그룹, 배송 시간, 로고, 크기 제한은 Shipping > Carriers에서 변경할 수 있습니다. 그곳에서 가격을 설정하지 마세요. 가격은 항상 모듈에서 가져옵니다.

설정

모든 설정은 모듈 페이지에 있습니다: Modules > Module Manager > VibeFox Mondial Relay > Configure. 각 섹션에는 자체 Save 버튼이 있으며, 이 버튼은 페이지 전체를 저장합니다. 저장할 때마다 캐시된 포인트 목록도 지워집니다.

페이지 상단의 경고는 운송업체를 숨기는 문제를 보여줍니다. 브랜드 코드 누락, 목록 모드에서 Private Key 누락, 프랑스, 벨기에, 스페인 요금 누락, 운송업체 삭제 등입니다. 저장할 수 없는 값은 Save 후에 보고됩니다. 숫자 필드에 숫자가 아닌 값(또는 음수)을 입력하면 이전 값이 유지됩니다. 64자를 넘는 이름이나 Min weight (kg)가 Max weight (kg)보다 큰 경우에는 거부되며 아무것도 저장되지 않습니다. 쇼핑몰의 무게 단위가 모듈이 지원하는 단위가 아니면, 상품 무게를 kg로 간주한다는 경고가 표시됩니다.

일반

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

Name: 체크아웃 시 고객에게 표시되는 운송업체 이름. 기본값: Mondial Relay Point Relais. 필수, 최대 64자.

Tax status: None은 표의 요금이 최종 금액임을 뜻합니다. 세금 규칙 이름과 함께 있는 Taxable 옵션은 PrestaShop이 해당 규칙의 배송세를 요금에 더한다는 뜻입니다.

Mondial Relay 계정

Brand code (Enseigne): 필수, 영문자와 숫자 최대 8자. 테스트용 예: BDTEST13. 포인트 지도와 Web Service에서 사용합니다. 이 값이 없으면 고객이 Point Relais를 선택할 수 없으므로 체크아웃에 운송업체가 표시되지 않습니다.

Private Key: List of nearest points 선택기에만 필요합니다. 저장 후 이 필드는 비어 있고 Saved - leave empty to keep it.를 표시합니다. 값을 바꾸고 싶을 때만 새 값을 입력하세요. 저장된 키를 삭제하려면 Remove the saved Private Key를 선택하고 Save를 클릭합니다. 브랜드 코드와 Private Key가 설정되어 있으면 설정을 저장할 때마다 Mondial Relay Web Service 연결을 테스트하고, 유효한지 여부를 메시지로 보여줍니다.

픽업 포인트 선택기

Selector: 고객이 Point Relais를 선택하는 방식.

요금(쇼핑몰 기본 통화, 세금 제외)

Country prices: 목적지 국가와 소포 무게별 요금. + Add country를 클릭하면 행이 추가되고, 휴지통 아이콘을 클릭하면 행이 삭제됩니다. 그 밖의 모든 국가에는 * Default를 국가로 선택합니다. 각 행에는 Price 열과 무게 열이 있습니다: XS 1kg 이하, S 1-2kg, M 2-3kg, L 3-5kg, XL 5kg 초과. 무게 열이 비어 있거나 0이면 Price 열을 사용합니다. Price도 비어 있으면 해당 무게의 배송은 무료이므로, 일부 무게 열만 사용할 때는 Price를 입력하세요. 소수점은 점 또는 쉼표를 사용합니다(4.90 또는 4,90). 가격이 전혀 없는 행은 저장할 때 삭제되며, 숫자가 아닌 값은 보고된 뒤 비워집니다.

Fallback cost: 표에 행이 없는 국가에 사용됩니다. 비워 두면 해당 국가에서는 운송업체가 숨겨집니다.

Calculation type: 요금이 계산되는 방식.

Free shipping from: 배송비가 무료가 되는 장바구니 소계(할인 후, 세금 제외). 무료 배송이 없으면 비워 두세요.

이용 가능 조건

Min weight (kg): 장바구니 무게가 이보다 가벼우면 운송업체를 숨깁니다. 0은 제한 없음을 뜻합니다.

Max weight (kg): 장바구니 무게가 이보다 무거우면 운송업체를 숨깁니다. Mondial Relay는 Points Relais에서 최대 30kg 소포를 받습니다. 기본값: 30. 0은 제한 없음을 뜻합니다. 빈 칸은 30kg를 뜻합니다. Min weight (kg)보다 작을 수 없습니다.

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

Ignore shipping zones: 아래 국가에 운송업체를 제공하며, 목록이 비어 있으면 운송업체의 배송 지역에 없더라도 지원되는 모든 국가에 제공합니다. 이 옵션이 켜져 있는 동안 운송업체는 나중에 만드는 지역을 포함하여 활성화된 모든 배송 지역에 연결됩니다. 끄면 운송업체는 이전에 가졌던 지역을 되돌려 받습니다.

Countries (ignore zones): 이 모드의 목적지 국가. 이 필드는 Ignore shipping zones가 켜져 있을 때만 사용됩니다. 목록에는 Points Relais가 있는 국가만 있습니다.

고급

Debug log: 요금 계산과 Web Service 호출을 모듈 폴더의 logs/vfd_mrel_debug.log.php에 기록합니다. 이 파일은 웹에서 열 수 없습니다. 이 옵션을 꺼도 오류는 항상 기록됩니다. 키와 고객 데이터는 절대 기록되지 않습니다.

Log: 로그의 크기와 최근 항목을 보여줍니다. Clear log를 클릭하면 비워집니다.

Remove data on uninstall: 켜져 있으면 모듈을 제거할 때 설정과 운송업체가 삭제됩니다. 꺼져 있으면 제거 시 운송업체만 꺼집니다. 주문에 저장된 포인트는 유지됩니다.

체크아웃에서의 동작

운송업체는 Points Relais가 있는 국가, 즉 프랑스, 벨기에, 룩셈부르크, 스페인, 포르투갈, 네덜란드에서만 제공됩니다. 고객이 포인트를 선택할 수 없는 경우에는 숨겨집니다. 브랜드 코드가 없거나, 목록 모드에서 Private Key가 없는 경우입니다.

배송 단계에서 PrestaShop은 모듈에 요금을 요청합니다. 실물 상품만 계산에 포함됩니다. 가상 상품은 무게를 더하지 않으며 소계에도 포함되지 않습니다. 모듈은 장바구니 무게와 최소 소계를 확인합니다. 요금은 해당 국가의 행(또는 * 행)에서 가져옵니다: 무게 열, 없으면 Price. 행이 없으면 대체 비용이 사용됩니다. 요금이 없으면 운송업체는 숨겨집니다. 소계가 Free shipping from에 도달하면 요금은 0이 됩니다. 요금은 쇼핑몰 기본 통화로 계산된 뒤, 고객의 장바구니 통화로 표시됩니다.

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

모듈은 실시간 요금을 요청하지 않습니다. Mondial Relay에는 공개 요금 API가 없습니다. 배송 건을 만들거나, 라벨을 출력하거나, 택배를 추적하지 않습니다. 주문에 표시된 Point Relais 번호를 사용하여 Mondial Relay "Connect" 공간에서 배송 건을 만드세요. 자택 배송(Domicile)은 제공되지 않습니다.

픽업 포인트

고객이 배송 단계에서 Mondial Relay 운송업체를 선택하면, 그 아래에 Mondial Relay pickup point 상자가 나타납니다.

지도 모드: Choose a Point Relais 버튼을 클릭하면, 배송 국가, 우편번호, 소포 무게에 맞는 공식 Mondial Relay 지도가 창에서 열립니다. 고객이 포인트를 선택하면 Selected:로 표시되고, 버튼은 Change Point Relais로 바뀝니다. 지도 위젯은 고객이 지도를 열 때에만 widget.mondialrelay.com에서, 지도 라이브러리는 unpkg.com에서 불러옵니다. 개인정보 처리방침에 이를 명시하세요.

목록 모드: 드롭다운 - Choose a Point Relais -는 배송 우편번호 기준 가까운 포인트 10곳을 거리와 함께 보여줍니다. 선택한 포인트는 영업시간과 함께 표시됩니다. 목록은 쇼핑몰 서버가 불러오므로 브라우저에서 제3자 스크립트가 실행되지 않습니다. 목록은 12시간, 빈 응답은 1시간 동안 캐시되며, 실패한 요청은 5분 동안 기억됩니다. Web Service 제한 시간은 10초입니다. 우편번호가 없으면 고객에게 Enter your postcode to see the nearest pickup points.가 보입니다. 포인트를 찾을 수 없거나 목록을 사용할 수 없으면, 고객에게 "현재 픽업 포인트 목록을 이용할 수 없습니다. 지도를 이용해 주세요." 같은 메시지가 보이고 지도가 제공됩니다.

선택한 포인트는 즉시 장바구니에 저장됩니다. 포인트는 필수입니다. 포인트가 없으면 고객에게 Please choose a Mondial Relay pickup point.가 표시되며 결제로 진행할 수 없습니다. 배송 주소와 다른 국가의 포인트는 거부됩니다. 목록 모드에서는 포인트가 주소에 맞는 목록과도 대조됩니다.

주문이 완료되면 포인트는 주문에 그대로 남습니다. 관리자 주문 페이지에는 포인트 이름, 주소, Point Relais number(예: FR-066974)가 있는 Mondial Relay pickup point 블록이 표시됩니다. 고객은 주문 확인 페이지와 계정의 주문 상세에서 포인트를 볼 수 있습니다. 주문 확인 이메일과 메일 알림 모듈의 새 주문 이메일에는 운송업체 이름 뒤에 포인트가 추가됩니다.

라이선스 키

모듈은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. 라이선스 블록 License — VibeFox Mondial Relay은 Modules > Module Manager > VibeFox Mondial Relay > Configure 페이지에서 설정 위에 있는 첫 번째 블록입니다. 키를 License key에 붙여 넣고 Activate를 클릭하세요. 그러면 블록에 마스킹된 키, 상태(예: 라이선스 유효 기간의 종료일과 도메인), 그리고 다음 버튼이 표시됩니다. Check now(상태 다시 확인), Change key(다른 키 입력), Remove key(이 쇼핑몰에서 키 제거). 그 아래에는 Product: presta-shipping-mondialrelay 줄과 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 계정에서 슬롯을 비우세요.

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

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

문제 해결

Mondial Relay가 체크아웃에 나타나지 않음: 라이선스가 활성 상태이고 Enable/Disable이 켜져 있는지 확인하세요. Shipping > Carriers에서 운송업체가 고객 국가의 지역과 고객 그룹을 포함하는지 확인하거나 Ignore shipping zones를 켜세요. 모듈 페이지 상단의 경고를 확인하세요. 운송업체는 브랜드 코드가 없을 때, 목록 모드에서 Private Key가 없을 때, 요금이 없는 국가일 때, 무게 및 소계 제한을 벗어날 때, 그리고 Points Relais가 없는 국가일 때 숨겨집니다. 상품 페이지에서 특정 운송업체로만 제한되어 있을 수도 있습니다.

저장 후 Web Service 테스트 실패: 메시지에 Mondial Relay 오류가 표시됩니다. 예를 들어 브랜드 코드나 보안 키가 잘못된 경우입니다. Mondial Relay에서 브랜드 코드와 Private Key를 확인하세요.

포인트 목록이 비어 있거나 사용할 수 없음: 고객이 먼저 배송 우편번호를 입력해야 합니다. Web Service가 실패하면 대신 지도가 제공됩니다. Debug log를 켜고 체크아웃을 새로고침한 다음, 모듈 페이지의 Log 필드에서 이유를 확인하세요.

지도가 열리지 않음: 지도는 widget.mondialrelay.com과 unpkg.com에서 불러옵니다. 개인정보 보호 또는 스크립트 차단 도구가 이를 막고 있지 않은지 확인하세요. 지도를 불러올 수 없으면 고객에게 "Mondial Relay 지도를 불러올 수 없습니다. 잠시 후 다시 시도하거나 다른 배송 방법을 선택해 주세요."가 표시됩니다.

주문 페이지에 No Point Relais was saved for this order가 표시됨: 배송 국가의 포인트 없이 주문이 이루어졌습니다. 이유는 로그에 기록됩니다. 배송 건을 만들기 전에 고객에게 Point Relais를 요청하세요.

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

제거

Modules > Module Manager로 이동하고, VibeFox Mondial Relay 옆의 메뉴를 열어 Uninstall을 선택합니다. 라이선스 키와 라이선스 상태는 항상 삭제됩니다. 캐시된 픽업 포인트 목록은 항상 삭제됩니다. Remove data on uninstall이 켜져 있으면 운송업체가 삭제됩니다(주문은 기록을 유지합니다). 설정, 로그, 주문이 없는 장바구니의 포인트도 삭제됩니다. 꺼져 있으면 운송업체만 꺼지고 모든 설정이 유지됩니다. 모듈을 다시 설치하면 운송업체의 이전 상태가 복원됩니다. 주문에 저장된 포인트는 항상 유지됩니다.

Mondial Relay는 해당 소유자의 상표입니다. 이 모듈은 Mondial Relay와 제휴하거나 Mondial Relay의 승인을 받지 않았습니다.