개요
VibeFox USPS는 PrestaShop에 USPS 운송업체를 추가합니다. OAuth 2.0을 사용해 현재 USPS API에서 국내 및 국제 소포의 실시간 요금을 가져오며, 고객에게는 선택한 서비스 중 가장 저렴한 하나를 담은 USPS 옵션 하나를 보여 줍니다. USPS가 요금을 제공하지 않으면 고정 요금이 적용됩니다.
미국에서 USPS로 소포를 발송하는 쇼핑몰에 적합합니다. USPS가 2026년 1월에 종료한 기존 Web Tools API는 사용하지 않습니다. 이 모듈은 요금만 계산합니다. 우편 요금이나 라벨을 구매하지 않으며, 집하 예약, 소포 추적, 우체국 또는 픽업 장소 선택 기능, 보험 및 기타 부가 서비스를 제공하지 않습니다.
주요 기능
현재 USPS API: OAuth 2.0을 사용하는 Domestic Prices 3.0 및 International Prices 3.0. 운영 환경과 USPS Testing Environment for Mailers.
서비스 선택: USPS Ground Advantage, Priority Mail, Priority Mail Express, First-Class Package International Service, Priority Mail (Express) International, Media Mail, Library Mail. 선택한 서비스 중 가장 저렴한 서비스가 표시되며 주문과 함께 저장됩니다.
정확한 요금: 소포에 맞는 일반 단품 요금만 사용합니다. Flat Rate, Cubic, Hold for Pickup, Sunday 요금은 더 저렴하다는 이유만으로 선택되지 않습니다. Retail 또는 Commercial 요금.
통화 처리: USPS 요금은 USD로 제공됩니다. 쇼핑몰의 다른 통화에서는 USD 환율을 적용해 환산하며, 유로로 표시되지 않습니다.
정확한 소포 정보: 쇼핑몰 단위로 입력된 무게와 치수를 파운드와 인치로 변환하고, 무게가 없는 상품에는 기본 무게를 적용하며, 소포 크기는 상자 크기 또는 상품 치수에서 결정합니다.
대체 수단인 고정 요금: 국가별 무게 구간과 대체 요금이 포함된 요금표입니다. 주문별 또는 상품별로 적용할 수 있으며, API 키가 없거나 USPS가 응답하지 않을 때 사용됩니다.
빠른 결제: 요금은 1시간 동안 캐시됩니다. 오류가 발생하면 USPS 호출을 5분 동안 일시 중지하여, 장애가 모든 체크아웃 업데이트를 느리게 만들지 않도록 합니다.
PrestaShop 표준 운송업체: Shipping > Carriers의 배송 구역과 고객 그룹, 또는 국가 목록. 소계 기준 무료 배송, 최소 소계, 무게 제한, 세금 규칙, 디버그 로그.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. USPS Developer Portal의 앱(Consumer Key 및 Consumer Secret)과 소포를 발송하는 미국 5자리 ZIP 코드. 고정 요금은 키 없이 사용할 수 있습니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).