VibeFox 99Minutos for PrestaShop — 도움말

요구 사항

PrestaShop: 8.0 ~ 9.x.

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

99minutos API 키(배송 가능 여부 확인에만 필요): 99minutos 계정 담당자에게 요청하거나 99minutos 개발자 포털(developers.99minutos.com)에서 받으십시오. 샌드박스 키와 운영 키는 서로 다릅니다. 요금 매트릭스만 사용하는 경우 API 키는 필요하지 않습니다.

국가: 99minutos는 멕시코, 콜롬비아, 칠레, 페루로 배송합니다. 배송하려는 국가는 International > Locations에서 활성화되어 있어야 합니다.

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

설치

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

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

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

4. Price matrix를 작성하십시오(최소 한 행, 예: "* Default"). 필요하면 API 키와 배송 가능 여부 확인 모드도 입력하십시오(설정 참고). Save를 클릭하십시오.

설치 시 모듈은 배송 기간 텍스트 Courier delivery가 있는 99Minutos 운송업체를 생성합니다. 운송업체는 모든 지역과 모든 고객 그룹에 할당됩니다. 지역, 고객 그룹, 배송 기간, 로고, 크기 제한은 Shipping > Carriers에서 변경할 수 있습니다. 멕시코, 콜롬비아, 칠레, 페루의 지역은 운송업체에 대해 활성 상태를 유지해야 합니다. 그곳에서 요금을 설정하지 마십시오. 요금은 항상 모듈에서 가져옵니다.

설정

모든 설정은 모듈 페이지에 있습니다: Modules > Module Manager > VibeFox 99Minutos > Configure. 각 섹션에는 자체 Save 버튼이 있으며, 이 버튼은 페이지 전체를 저장합니다. 저장할 때마다 캐시된 배송 가능 여부 결과도 지워집니다. 저장 후 페이지는 가격 매트릭스가 비어 있는 경우, 99minutos가 서비스하지 않는 국가의 행이 있는 경우, API 키 없이 배송 가능 여부 확인 모드를 선택한 경우, 또는 모듈이 쇼핑몰의 무게 단위를 인식하지 못하는 경우(이때 무게는 킬로그램으로 간주됨)에 경고를 표시합니다. Method title이 64자를 넘거나, 무게 또는 금액 필드가 0 이상의 숫자가 아니거나, Min weight (kg)이 Max weight (kg)보다 크면 아무것도 저장되지 않으며 오류가 표시됩니다. 페이지에 The 99Minutos carrier was not found — reset the module to create it again.가 표시되면 문제 해결 섹션을 참고하십시오.

일반

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

Method title: 장바구니와 체크아웃에서 고객에게 표시되는 운송업체 이름입니다. 기본값: 99Minutos. 필수 항목이며 최대 64자입니다.

Tax: 운송업체의 세금 규칙 또는 No tax입니다. 세금 규칙이 있으면 PrestaShop은 매트릭스의 배송비에 세금을 추가합니다.

99minutos API(배송 가능 여부 확인)(선택 사항)

API는 99minutos가 고객의 우편번호로 배송하는지 확인하는 데만 사용됩니다. 요금은 항상 매트릭스에서 가져옵니다.

Coverage check: 우편번호를 확인할지 여부와 확인 방법입니다.

배송 가능 여부 확인을 켜면 고객이 우편번호를 입력한 후에만 운송업체가 나타납니다. 결과는 캐시됩니다: 배송 가능 6시간, 배송 불가 30분, API 오류 5분. 99minutos로는 우편번호만 전송되며, 대문자로 변환되고 문자와 숫자만 포함합니다.

API key: 99minutos API 키입니다. Bearer 토큰으로 99minutos 배송 가능 여부 확인 엔드포인트에 전송됩니다. 배송 가능 여부 확인이 켜져 있으면 필수입니다. 저장 후 이 필드는 비어 있으며 Saved — leave empty to keep it.가 표시됩니다. 값을 변경하려는 경우에만 새 값을 입력하십시오. 키는 입력한 그대로 저장되며, 앞뒤 공백만 제거됩니다.

Remove the saved API key: 저장된 키가 있을 때만 표시됩니다. 이 옵션을 켜고 Save를 클릭하면 키가 삭제됩니다.

Environment: Sandbox (test)(기본값) 또는 Production. 샌드박스와 운영 환경은 서로 다른 API 키를 사용하므로, 키에 맞는 환경을 선택하십시오.

요금

요금은 쇼핑몰의 기본 통화로, 세금 제외 금액으로 입력하며, 입력한 그대로 사용됩니다. 최종 요금은 고객의 장바구니 통화로 표시됩니다.

Price matrix: 배송지 국가와 요금의 표입니다. Add country를 클릭하면 행이 추가되고, 휴지통 아이콘을 클릭하면 행이 제거됩니다. 각 행에는 Country(* Default, 멕시코, 콜롬비아, 칠레 또는 페루), Base price, 그리고 XS(1kg 이하), S(2kg 이하), M(3kg 이하), L(5kg 이하), XL(5kg 초과) 크기별 요금이 있습니다. 크기 요금이 비어 있거나 0이면 Base price가 사용됩니다. * Default 행은 자체 행이 없는 국가에 적용됩니다. 한 국가에 여러 행이 있으면 첫 번째 행이 사용됩니다. 소수점 구분자로 점과 쉼표가 모두 허용됩니다. 비어 있거나, 잘못되었거나, 음수인 요금은 0으로 저장됩니다. 매트릭스에 행이 최소 하나 있어야 체크아웃에 운송업체가 표시됩니다.

Calculation: Per order — size by the total cart weight(기본값)은 장바구니 전체의 포장 크기에 대해 하나의 요금을 부과합니다. Per item — each unit priced by its own weight는 각 단위를 자체 무게의 크기에 따라 요금 책정하고 합산합니다.

Free shipping: 장바구니 소계 기준 무료 배송을 켭니다.

Free shipping from: 요금이 0이 되는 장바구니 소계(할인 후, 세금 제외)입니다. Free shipping이 켜져 있을 때만 사용됩니다.

제한

Min weight (kg): 장바구니가 이보다 가벼우면 운송업체를 숨깁니다. 0은 제한 없음을 뜻합니다. Max weight (kg)보다 클 수 없습니다. 상품 무게는 쇼핑몰의 무게 단위에서 변환됩니다.

Max weight (kg): 장바구니가 이보다 무거우면 운송업체를 숨깁니다. 기본값: 25. 0은 제한 없음을 뜻하며, 빈 필드는 25kg을 뜻합니다.

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

Restrict countries: 아래 국가에 대해서만 운송업체를 제공합니다. 운송업체 지역에 추가로 적용되는 필터입니다. 하나의 지역이 여러 국가를 포함할 때 유용합니다.

Countries: 99minutos 국가(멕시코, 콜롬비아, 칠레, 페루) 중에서 선택합니다. Ctrl(Cmd)을 누른 채로 여러 국가를 선택할 수 있습니다. Restrict countries가 켜져 있을 때만 사용됩니다. 비워 두면 99minutos의 모든 국가를 허용합니다.

고급

Debug log: 요금 계산 내용을 모듈 폴더의 logs/vfd_99m_debug.log.php에 기록합니다. 이 파일은 웹에서 열 수 없습니다. 이 옵션이 꺼져 있어도 API 오류는 기록됩니다. API 키와 고객 이름·주소는 절대 기록되지 않습니다. 작업이 끝나면 로그를 끄십시오.

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

Remove data on uninstall: 켜져 있으면 모듈을 제거할 때 설정, 운송업체, 배송 가능 여부 캐시, 로그가 삭제됩니다. 꺼져 있으면 재설치를 위해 모든 항목이 보존됩니다. 주문은 어떤 경우에도 보존됩니다.

체크아웃에서의 동작

배송 단계에서 PrestaShop은 모듈에 99Minutos 요금을 요청합니다. 실물 상품만 계산에 포함됩니다. 가상 상품은 무게를 더하지 않으며 장바구니 소계에도 포함되지 않습니다. 운송업체는 배송지 국가가 멕시코, 콜롬비아, 칠레 또는 페루인 경우에만 제공됩니다(Restrict countries가 켜져 있으면 Countries 목록에도 있어야 합니다). 그 다음 모듈은 무게 제한과 Minimum subtotal을 확인합니다.

배송 가능 여부 확인 모드가 켜져 있으면 모듈은 99minutos API에 우편번호가 배송 가능한지 문의합니다. 요청 제한 시간은 10초이며 응답은 캐시되므로, 같은 우편번호로는 새 요청이 발생하지 않습니다. API 오류는 고객에게 절대 표시되지 않습니다. Strict 모드에서는 운송업체가 숨겨지고, Soft 모드에서는 매트릭스 요금이 사용됩니다. 무료 배송은 배송 가능 여부 확인을 우회하지 않습니다.

요금은 배송지 국가의 매트릭스 행 또는 * Default 행에서 가져옵니다. 둘 다 없으면 운송업체가 숨겨집니다. Free shipping이 켜져 있고 장바구니 소계가 Free shipping from에 도달하면 요금은 0입니다. 요금은 쇼핑몰의 기본 통화로 계산된 후 고객의 장바구니 통화로 표시됩니다.

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

모듈은 99minutos에서 실시간 운임 견적을 받지 않습니다. 요금은 항상 쇼핑몰의 매트릭스에서 가져옵니다. 99minutos에서 배송 건이나 주문을 생성하지 않으며, 송장(guides)을 인쇄하지 않고, 택배를 추적하지 않으며, Punto99 픽업 포인트를 제공하지 않고, 착불 결제를 처리하지 않습니다. 평소와 같이 99minutos 계정에서 배송 건을 생성하십시오.

라이선스 키

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

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

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

문제 해결

체크아웃에 99Minutos가 나타나지 않습니다: 라이선스가 활성 상태이고 Enable 99Minutos가 켜져 있는지 확인하십시오. 배송지 국가는 멕시코, 콜롬비아, 칠레 또는 페루여야 하며 International > Locations에서 활성화되어 있어야 합니다. Shipping > Carriers에서 운송업체가 고객 국가의 지역과 고객의 그룹을 포함하는지 확인하십시오. Price matrix에 해당 국가의 행 또는 * Default 행이 있는지 확인하고, 무게 제한, Minimum subtotal, Restrict countries도 확인하십시오. 상품 페이지에서 상품이 특정 운송업체로만 제한되어 있을 수도 있습니다.

우편번호를 입력한 후에만 운송업체가 나타납니다: 배송 가능 여부 확인을 사용할 때는 정상적인 동작입니다. Strict 모드에서는 API가 배송 가능을 확인한 경우에만 나타납니다.

Strict 모드에서 운송업체가 항상 숨겨집니다: Debug log를 켜고, 체크아웃을 새로 고친 다음 모듈 페이지의 Log 필드를 확인하십시오. HTTP 401 또는 403 오류는 API 키가 거부되었다는 뜻입니다. 키와 Environment 설정이 일치하는지 확인하십시오(샌드박스 키와 운영 키는 다릅니다). API를 사용할 수 없는 동안에도 고객이 매트릭스 요금을 받아야 한다면 Soft 모드를 사용하십시오.

요금이 예상과 다릅니다: Calculation(주문 단위 또는 상품 단위), 상품 무게, 쇼핑몰의 무게 단위(International > Localization)를 확인하십시오. 크기 요금이 비어 있거나 0이면 Base price가 사용됩니다. Tax에 세금 규칙이 있으면 매트릭스 요금에 세금이 추가됩니다.

변경 후 배송 가능 여부 결과가 오래된 것 같습니다: 모듈 페이지에서 Save를 클릭하십시오. 이렇게 하면 캐시된 배송 가능 여부 결과가 지워집니다.

페이지에 99Minutos 운송업체를 찾을 수 없다고 표시됩니다: Shipping > Carriers에서 운송업체가 삭제되었습니다. Modules > Module Manager에서 모듈을 초기화하면 다시 생성됩니다. 메시지 The settings were saved, but the carrier could not be updated. Reset the module to create it again.에도 같은 방법이 적용됩니다.

제거

Modules > Module Manager로 이동하여 VibeFox 99Minutos 옆의 메뉴를 열고 Uninstall을 선택하십시오. 라이선스 키와 라이선스 상태는 항상 삭제됩니다. 배송 가능 여부 캐시도 항상 삭제됩니다. Remove data on uninstall이 켜져 있으면 운송업체가 삭제되고(주문은 기록을 유지합니다) 설정과 로그도 제거됩니다. 꺼져 있으면 운송업체는 비활성화만 되고 모든 설정이 유지됩니다. 모듈을 다시 설치하면 저장된 운송업체는 제거 전의 상태를 되찾습니다. 따라서 Reset은 비활성화된 운송업체를 켜지 않습니다.

99minutos는 해당 소유자의 상표입니다. 이 모듈은 99minutos와 제휴되어 있지 않으며 99minutos의 승인을 받지 않았습니다.