개요
VibeFox Melhor Envio는 PrestaShop에 Melhor Envio 운송사를 추가합니다. 체크아웃 시 고객의 장바구니와 CEP를 기준으로 Melhor Envio API에 실시간 배송비 견적을 요청하고, Melhor Envio 계정에 있는 Correios, Jadlog, Azul Cargo, LATAM Cargo, J&T 같은 운송사의 요금을 표시합니다. 견적을 받을 수 없을 때도 대체 요금표 덕분에 체크아웃이 계속 작동합니다.
Melhor Envio로 소포를 비교하고 발송하는 브라질 쇼핑몰에 적합합니다. 이 모듈은 체크아웃에서 배송비를 계산합니다. 라벨을 구매하거나 생성하지 않고, Melhor Envio 장바구니에 발송 건을 추가하지 않으며, 소포를 추적하거나 집하를 예약하지 않습니다. 또한 송장(NF-e) 데이터를 보내지 않으며, 고객이 운송사 지점을 선택하게 하지도 않습니다.
주요 기능
여러 운송사의 실시간 견적: Melhor Envio 계정의 모든 서비스, 또는 입력한 서비스 ID만 사용합니다(예: 1 = Correios PAC, 2 = Correios SEDEX).
가장 저렴한 서비스 또는 고객 선택: 운송사는 가장 저렴한 서비스의 요금을 적용하거나, 고객이 운송사 아래 목록에서 서비스를 선택합니다. 원한다면 배송 예상 기간도 함께 표시할 수 있습니다.
정확한 소포 정보: 상품의 무게와 크기를 kg과 cm로 환산하고, 각 상품의 수량과 선택적으로 신고 가액(보험)을 반영합니다. 무게나 크기가 없는 상품은 기본값을 사용합니다. 가상 상품은 건너뜁니다.
안전한 통화 처리: Melhor Envio는 브라질 헤알(BRL)로 견적을 냅니다. 기본 통화가 다른 쇼핑몰은 BRL 환율을 설정해야 합니다. 설정하지 않으면 실시간 견적은 사용되지 않습니다.
대체 요금: 국가와 장바구니 무게(XS~XL)별 요금표와 대체 배송비입니다. 토큰이 없거나, CEP가 올바르지 않거나, API가 실패하거나, 서비스 지역이 아닐 때 사용됩니다. 어떤 요금도 없으면 이 운송사는 숨겨집니다.
빠른 체크아웃: 견적은 1시간, 실패한 호출은 5분 동안 캐시됩니다. 설정을 저장하면 캐시가 지워집니다.
주문에 기록되는 서비스 정보: 선택된 서비스와 배송 예상 기간은 주문과 함께 저장되며, 백오피스의 주문 페이지, 고객의 주문 페이지, 주문 확인 이메일에 표시됩니다.
배송 규칙: 장바구니의 최소·최대 무게, 최소 소계, 소계 기준 무료 배송(가장 저렴한 서비스가 무료가 됨), 운송사의 세금 규칙, 배송 구역을 사용하지 않는 선택적 운영 방식.
요구 사항
PrestaShop 8.0~9.x, PHP 8.0 이상. 실시간 견적에는 Melhor Envio 계정과 “shipping-calculate” 권한이 있는 액세스 토큰이 필요합니다. 대체 요금은 토큰 없이도 작동합니다. vibefox.net에서 받은 VibeFox 라이선스 키도 필요합니다(도메인당 키 하나).
