개요
VibeFox Correos CityPaq는 스페인의 Correos CityPaq 스마트 택배 사물함으로의 배송을 PrestaShop 운송업체로 추가합니다. 고객은 체크아웃의 배송 단계에서 CityPaq 사물함을 선택하며, 선택한 사물함은 주문에 저장됩니다.
Correos가 CityPaq용 요금 API를 공개하지 않으므로, 요금은 포장 크기별로 직접 작성한 요금표에서 가져옵니다. 본 모듈은 배송을 미리 등록하거나, 송장을 인쇄하거나, 집화를 요청하거나, 택배를 추적하지 않습니다.
주요 기능
포장 크기별 요금: 기본 요금과, XS(1 kg 이하), S(2 kg 이하), M(3 kg 이하), L(5 kg 이하), XL(5 kg 초과)의 선택적 요금을 주문 단위 또는 상품 단위로 설정할 수 있습니다.
실시간 Correos 사물함 목록: Correos API 자격 증명을 입력하면, 고객은 자신의 우편번호에 있는 활성 CityPaq 사물함 중에서 선택하거나 다른 우편번호를 검색할 수 있습니다. 우편번호에 사물함이 없으면 인근 우편번호가 표시됩니다.
그 밖의 사물함 선택 방법: 고객은 Correos CityPaq 찾기 페이지에서 확인한 사물함 코드나 주소를 입력하거나, 쇼핑몰이 직접 만든 사물함 목록에서 선택할 수 있습니다.
체크아웃이 멈추지 않습니다: Correos 목록을 불러올 수 없으면 고객이 사물함을 직접 입력합니다. 목록은 12시간, 오류는 10분 동안 캐시됩니다. Correos에는 고객이 CityPaq를 선택했을 때만 요청합니다.
주문의 사물함: 배송 단계에서 필수 입력 항목이며 서버에서도 검증합니다. 주문 관리 화면(여기서 수정 가능), 주문 확인 페이지, 주문 내역 페이지, 주문 이메일에 표시됩니다.
배송 규칙: 장바구니의 최소 및 최대 무게(기본값 30 kg), 최소 주문 금액, 주문 금액 이상 무료 배송, 운송업체의 세금 규칙.
PrestaShop 기본 운송업체: 설치 시 스페인 지역에 운송업체가 생성됩니다. 지역, 고객 그룹, 크기 제한은 Shipping > Carriers에서 관리하거나, Ignore shipping zones을 사용해 스페인 내 모든 주소에 CityPaq를 제공할 수 있습니다.
백오피스 디버그 로그: 모듈 페이지에서 로그를 보고 지울 수 있습니다. 자격 증명과 개인정보는 로그에 기록되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 실시간 Correos 사물함 목록에는 "terminals" API용 Correos API 자격 증명이 필요합니다. 수동 입력과 쇼핑몰의 사물함 목록은 자격 증명 없이 사용할 수 있습니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 하나).