Overview
VibeFox Correos CityPaq adds delivery to Correos CityPaq smart parcel lockers in Spain as a shipping method for Magento Open Source and Adobe Commerce. The customer chooses the CityPaq locker at the shipping step of checkout, and the locker is saved in the order.
Prices come from your own price table by parcel size, because Correos publishes no rate API for CityPaq. The module does not pre-register shipments, print labels, request pickups or track parcels.
Key features
Prices by parcel size: a base price and optional prices for XS (up to 1 kg), S (up to 2 kg), M (up to 3 kg), L (up to 5 kg) and XL (above 5 kg), per order or per item, in the base currency of your store.
Live Correos locker list: with your Correos API credentials, the customer chooses from the active CityPaq lockers of their postal code or searches another one. Nearby postal codes are listed when a code has no locker.
Other ways to choose a locker: the customer enters the locker code or address found on the Correos CityPaq finder, or chooses from your own list of lockers.
Checkout never gets stuck: if the Correos list cannot be loaded, the customer enters the locker instead. Lists are cached for 12 hours, errors for 10 minutes. Correos is asked only when the customer selects CityPaq.
Locker in the order: required at the shipping step and checked on the server, added to the shipping description of the order (order e-mails, the order in the customer account, invoices), shown in a block on the admin order page and editable there.
Shipping rules: minimum and maximum cart weight (30 kg by default), minimum order amount and free shipping from an order amount. Magento cart price rules with free shipping work as usual.
Standard Magento settings: all settings are on the standard Delivery Methods configuration page, with sections for prices, conditions, free shipping, locker selection, the Correos API and availability, settings per website, encrypted API credentials and a debug log viewer.
Requirements
Magento Open Source or Adobe Commerce 2.4.6 to 2.4.9 (your own server or Adobe Commerce on cloud infrastructure; not Adobe Commerce as a Cloud Service), PHP 8.1 to 8.4. The live Correos locker list needs Correos API credentials for the "terminals" API. Manual entry and your own locker list work without them. A VibeFox license key from vibefox.net (one key per domain).