Postie Changelog

Add support for enableRouteCheck and enableCaching to use .env variables.

Add support for markUpRate, markUpBase, restrictServices, and packingMethod provide settings to be .env variables.

Add support for legacy USPS API.

DHL Express Account Number is now required for rates and shipments.

Fix an error for DHL Express with Ship Time.

Fix “Markup Base” setting not saving correctly.

Fix an error with DHL Express and Ship Time in some locales.

Add support for tax-inclusive rates for UPS, where applicable.

Update USPS service codes for new API.

Improve USPS rates by not returning duplicate services (that have the same price, just different description).

Fix an error when fetching rates while restricting services, but no services are enabled.

Fix docs link for providers.

Fix USPS API type not being visible.

Fix multi-provider package duplication.

Add Add Declared Value setting for UPS.

Update English translations

Testing rates now set a $15 price on packages for testing with providers.

Fix rates testing not showing any feedback when no rates are returned.

Fix FedEx Freight rates testing to reflect a valid package by default.

Fix FedEx Freight not supply billing/shipping address info as configured.

Fix isProduction for providers set via config file not updating the provider setting in the control panel.

Fix shipment and label lodgement not factoring in the chosen line items when fetching rates.

Fix an error generating origin address for store, for some providers where name is required.

Fix lack of error-handling when creating shipments.

Fix missing before/after label creation events.

Improve error feedback when testing rates from the control panel.

Fix deprecation warning when testing rates from the control panel.

Fix restrictServices migration error from Postie 3.

Fix New Zealand Post migration error from Postie 3.

Fix UPS migration error from Postie 3.

Fix USPS migration error from Postie 3.

Add dimensions to packages for Bring.

Update Bring services to latest available (2023+).

Change minimum packed box weight to 1 gram (converted to the providers weight unit).

Fix an error with USPS international shipments.

The variants-shippable check now only queries 100 variants by default.

Add Declared Value Option to UPS. (thanks @bryanredeagle).

Add support for packed boxes to have their price correctly depending on their packed items.

Updated Royal Mail rates.

Fix an error when migrating from Craft 3.

Added “Pickup Type” for UPS, which was previously removed.

Fix an error when migrating UPS to new provider.

Removed “Use Negotiated Rates” for UPS (applied by default).

Add support for UPS negotiated freight rates.

Add “Use Test Endpoint” setting for UPS.

Only admins are now allowed to access plugin settings

Fix type check for PHP 7.x.

Fix a memory issue with UPS Freight services.

Fix FedEx freight not correctly setting 150lb minimum weight.

Fix an error with Royal Mail rates. (thanks @MadMikeyB).

Fix an issue for FedEx freight rates in some cases.

Fix an issue where shipping rates weren’t always available in checkout.

Fix an error when fetching UPS Freight rates.

Add more USPS rates and fix First-Class rates.

Revamp USPS services to better match their codes and available services.

Update some Royal Mail international rates.

Fix ModifyPayloadEvent typing

Fix an error when saving some providers and their boxSizes setting

Add support for UPS negotiated freight rates.

Add “Use Test Endpoint” setting for UPS.

Fix type check for PHP 7.x.

Fix a memory issue with UPS Freight services.

Fix FedEx freight not correctly setting 150lb minimum weight.

Fix an issue for FedEx freight rates in some cases.

Fix an issue where shipping rates weren’t always available in checkout.

Fix an error when fetching UPS Freight rates.

Add more USPS rates and fix First-Class rates.

Revamp USPS services to better match their codes and available services.

Update some Royal Mail international rates.

Fix an error with SinglePackageProvider and EVENT_BEFORE_FETCH_RATES incorrectly serializing packed boxes.

Update Royal Mail pricing to April 2022.

Improve memoization implementation for rate-fetching, when enableCaching is disabled.

Update EVENT_BEFORE_FETCH_RATES to use packedBoxes instead of dimensions. Refer to updated docs.

Fix box-packing line items that have no dimensions or weight.

Fix order totals used for insurance for multiple providers. Now only uses packed items for the insured total rather than the entire order total.

Fix lack of international shipping handling for Canada Post.

Fix an error for some providers when a country hasn't been set on the cart.

Add UPS Freight support.

Fix Australia Post international rates (from 2.4.13).

Remove testing shipping rates from RoyalMail.

Ensure packed boxes have a minimum weight, as 0 weighted boxes are issues for most providers.

Add Service::EVENT_BEFORE_REGISTER_SHIPPING_METHODS for modifying the master list of shipping methods before they get handed off to Commerce. (thanks @michaelrog).

Add Provider::EVENT_MODIFY_SHIPPING_METHODS.

Change product summary to limit to 20 variants for performance.

Fix Provider::EVENT_MODIFY_PAYLOAD not allowing payload to be overridden. (thanks @richrawlings).

Fix removing box sizes for disabled providers when saving.

Fix providers triggering validation when disabled.

All providers now round box dimensions and weights to 2 decimal places.

Improve project config storage for settings. Postie will now no longer save (some) settings for disabled providers.

Fix DHL Express throwing errors due to invalid weight/dimensions.

Fix in-memory caching not working correctly for providers. This meant potentially multiple requests for a single page request were being performed.

Fix error when calculating rates for Australia Post, New Zealand Post and Sendle.

Fix error introduced in 2.4.1 when saving settings form the control panel.

Add Sendle shipping provider.

Add Interparcel shipping provider.

Add New Zealand Post shipping provider.

Add Bring shipping provider.

Add Royal Mail shipping provider.

Add PostNL shipping provider.

Add Colissimo shipping provider.

Add new 4D bin-packing algorithm to more accurately pack your boxes.

Add ability to define box dimensions and weights for each provider, so you can better split order items into boxes.

Add "Packing Method" setting for all providers.

Add "Pack items individually" packing method, allowing all line items and quantities to be boxes individually.

Add "Pack items into boxes" packing method, allowing provider-supplied boxes, or user-created ones.

Add "Pack items into a single box" packing method - a slightly improved version of the box-packing algorithm in pre 2.4.0. This ensures a non-breaking change to box-packing behaviour to date.

Add EVENT_BEFORE_PACK_ORDER and EVENT_AFTER_PACK_ORDER events to all providers, allowing modification of the box-packing logic.

Add "Restrict Shipping Methods" setting for all providers. This allows opt-out of restricting to certain shipping services, and always use whatever is returned by the provider. This is particularly beneficial for some providers where services can't always be determined.

Add weightUnit and dimensionUnit to each provider for consistent use with boxes. These should always be provided in grams.

Add supportsDynamicServices() to providers whose list of services isn’t statically defined.

Add getMaxPackageWeight() to providers, to define what their maximum package weight is.

Add getIsInternational() to providers, to return whether an order is considered domestic or international.

Add provider setup instructions on connecting to the respective APIs.

Add ability for providers to define their own default boxes of dimensions and types that cannot be deleted, but still toggled enabled/disabled.

Add letter rates to Australia Post (domestic and international). Now fetches rates for letters, for applicable products, and as defined in the new box definitions.

Add some additional missing satchel rates for Australia Post.

Add “Residential Address” setting for UPS.

Add “Include Insurance” setting for UPS.

Add “Residential Address” setting for Fedex.

Add “Include Insurance” setting for Fedex.

Add “Fedex One Rate” setting for Fedex.

Add “Additional Options” to Canada Post.

Add SinglePackageProvider class for providers to extend from, if the API doesn't support sending multiple packages in one request. This class will fetch the first box, and add each subsequent (cached) response for all other boxes that are identical.

Add support for all providers to use env variables in their settings.

Add API connection testing for all providers, allowing you to troubleshoot API credentials before getting to shipping.

Add supportsConnection(), checkConnection() and getIsConnected() methods to providers.

Add testing classes for addresses and packages. Can be freely used to fetch a range of different values for testing responses.

Postie now requires PHP 7.1+.

Multiple packages are now possible for Australia Post, DHL Express and TNT Australia. This not only improves a "too large to ship" response, but should provide more accurate pricing overall. Previously, Postie bundled all items in a single package, which would often go over maximum dimensions/weights.

Existing providers now use the "Pack items into a single box" box packing algorithm. This is essentially the same as previous versions to prevent a breaking change.

Tidied up the shipping methods table for providers.

Some internal cleanup with providers (may affect custom providers). Refer to the updated docs.

Provide field instructions for a number of provider settings.

Visually highlight provider API instructions.

Fix settings sidebar overflow in some cases.

Removed Provider::getPackageDimensions().

Removed Provider::getDimensions().

Removed Provider::getSplitBoxWeights().

Add shipDate and shipTime for DHL Express.

Add modifyPayload event to allow modifying the payload before it’s sent to providers to fetch rates.

Add option to UPS to configure whether signatures are required.

Fix defining provider settings in both the control panel and config files.

Add DHL Express.

Add handling for Fedex/UPS/USPS for maximum package weights, splitting into multiple packages.

Add displayFlashErrors config setting. Allows errors from the provider APIs to be shown in checkout templates.

Allow orders created in the control panel to bypass the manualFetchRates config setting, so they can pick a shipping method.

Add EVENT_MODIFY_VARIANT_QUERY to modify the variants used to check weight and dimensions for in Postie's settings.

Fixed an error when viewing an order in the control panel, that used Postie-provided shipping method. (thanks @keyurshah).

Ensure the lowest amount is always used for Fedex amounts.

Fix UPS error for carts that have no shipping country selected.

Add special-case for completed orders, and fetching non-live-rate shipping methods. This allows the correct use of order.shippingMethod.name. Please note that calling this for completed orders will report all Postie-provided shipping method costs as 0. As such, use the shipping costs recorded on the order (order.totalShippingCost()).

Fix errors for console or queue requests.

Ensure we check for cached rates when manualFetchRates is turned on. Otherwise, the shipping method won't save on cart, or persist on page load.

Remove duplicate cakephp/utility composer package. (thanks @codebycliff).

Fix saving shipping method settings not working.

Fix logging error Call to undefined method setFileLogging().

Canada Post - Fix incorrect URL for live requests.

Fix styling issues for provider markup settings.

Add TNT Australia provider.

Add 2- and 3-day Priority options to USPS. (thanks @AugustMiller).

Add Order object to ModifyRatesEvent. (thanks @AugustMiller).

Add beforeFetchRates event.

Update FedEx for Ground Transit Time. FedEx handles the delivery date for Ground different than Express. For Ground, they use TransitTime. (thanks @keyurshah).

Fix provider icon error for custom provider.

Fix USPS/UPS handles, incorrectly being set as uSPS and uPS.

Fix incorrect caching of rates for multiple providers.

Fix zero-based rates not being shown to pick during checkout.

Fix AusPost and Canada post error handling.

Add support for Commerce 3.

Add more UPS services, and change the way UPS services match.

Add modifyRates providing access to the raw response from a provider and the extracted shipping rates. See docs.

All shipping rates now have additional options available on the shipping rule. See docs.

Add negotiated rate support for UPS.

Fix error with store location state for UPS.

Remove leftover debugging.

Swap XML parser for Canada Post.

Fix missing shipping description.

Craft 3/Commerce 2 support.

Add Canada Post provider.

Add Fastway provider.

Add initial TNT provider. Please contact us with API account details to finalise!

Add displayDebug config setting.

Add displayErrors config setting.

Add enableCaching config setting.

Add enabled config setting for each provider.

Add provider icons, and CP UI improvements.

Updated provider functions for easier/clearer extendability. See docs.

Updated cache mechanism for better performance.

Australia Post now fetches shipping rates in a single API call.

Removed originAddress config setting in favour of Commerce's Store Location.

Provider handles in config file are now required to be provided in camel case.

Add management of shipping category conditions for shipping methods.