USPS United States Postal Service

Average Rating: 5
Description
USPS - United States Postal Service module for Zen Cart
(Using latest rules: Domestic RateV4 and IntlRateV2)

Gives real-time rate quotes for allowing customers to choose a USPS service when selecting shipping options at checkout.
(It does not do anything with scheduling shipments or printing labels etc)

FIRST-TIME SETUP INSTRUCTIONS
--------------------------------------------
See this simple FAQ article for setup instructions:
https://docs.zen-cart.com/user/shipping/usps/


UPDATING
----------------
Installing the update is the same as installing any other USPS update:
- write down your current USPS settings from your admin modules screen (this is just so you can quickly reconfigure the module after updating)
- click Remove on the module, so that it no longer shows as installed.
- download the new module
- unzip (retaining the folder structure embedded in the zip)
- upload the 2 files to the correct locations on your server
- go to your Admin and click Install on the module
- configure with your USPS account number and reconfigure all your other settings


----------
TIP -- As with any module, you can of course refine your settings selections over time, so you might want to first enable just a couple service-names-checkboxes, then save your settings to that the module is live in your store. Then click Edit again and begin refining your settings even more as you take a few minutes to look at the features available. Keep saving your edits from time to time so they take effect in your store. And test it by putting some items in your cart and checking for rates etc until you're comfortable with the settings.
+ Download Latest

Forum Support Thread

Submit An Updated Version


Github Repository
Zen Cart® Versions v1.5.6, v1.5.7, v1.5.8, v2.0.0
Original Author Ajeh
Last Updated by lat9 - 15 Feb 2024
Downloads 26,770

Version History

USPS United States Postal Service   -   Version: 2024-02-14 K11j
USPS will require the PASSWORD field for Web Tools API requests sometime in 2024, see issue #41 for details.   + Download
Zen Cart® Versions v1.5.6, v1.5.7, v1.5.8, v2.0.0
Date Added 15 Feb 2024
Author lat9
File Size 711.7 KB
PHP 5.3 Safe? No
Downloads 96
 
USPS United States Postal Service   -   Version: 2023-07-12 K11i
NOTE: When going to this version (or higher) from a version prior to 2023-07-12 K11i, you must remove and reinstall the USPS module.


This release contains changes associated with the following GitHub issues:

#34, #37: Additional notifications for site-specific customizations.
#35: PHP Warning when MODULE_SHIPPING_USPS_TRANSIT_TIME_CALCULATION_MODE is set to OLD
#36: Remove problematic automatic updates when service names/methods change.
#38: Add support for USPS Ground Advantage and HAZMAT changes.
#39: Correct quotes for international countries for which only one service is available.
#40: Correct processing for "Priority Mail Express International"; quotes weren't being returned.
  + Download
Zen Cart® Versions v1.5.6, v1.5.7, v1.5.8
Date Added 12 Jul 2023
Author lat9
File Size 671.3 KB
PHP 5.3 Safe? No
Downloads 384
 
USPS United States Postal Service   -   Version: 2023-02-14 K11h
This version corrects the following GitHub issues:

#32: USPS 'cheapest' quotes aren't selected; quotes need to be public.
#31: K11g won't auto-update from K11f
  + Download
Zen Cart® Versions v1.5.6, v1.5.7, v1.5.8
Date Added 14 Feb 2023
Author lat9
File Size 673.7 KB
PHP 5.3 Safe? No
Downloads 289
 
USPS United States Postal Service   -   Version: 2023-01-30 K11g
This release makes the tax_class and tax_basis variables (again) public; causing errors with OPC.   + Download
Zen Cart® Versions v1.5.6, v1.5.7, v1.5.8
Date Added 30 Jan 2023
Author lat9
File Size 673.7 KB
PHP 5.3 Safe? No
Downloads 41
 
USPS United States Postal Service   -   Version: 2023-01-29 K11f
This release contains the following changes

Refactoring and declaring all class variables for use under PHP 7.4 and later (#27).
USPS interface changes (#28)
'Priority MailRM Regional Rate Box A' and 'Priority MailRM Regional Rate Box B' no longer supported
by USPS. Remove from current configuration on auto-update; don't include in initial configuration
on fresh install.
Country full-spelling name changed from 'Turkey' to 'Türkiye'.
Correct PHP Warning when US-destined USPS quote returns no values. (#26)
Add a notification to enable an observer to modify the overall handling fee for the current order. (#29)
  + Download
Zen Cart® Versions v1.5.6, v1.5.7, v1.5.8
Date Added 29 Jan 2023
Author lat9
File Size 673.6 KB
PHP 5.3 Safe? No
Downloads 23
 
USPS United States Postal Service   -   Version: 2022-08-07 K11e
Correcting the auto-update from 2022-07-12 K11c due to a misspelling (see GitHub issue #25)   + Download
Zen Cart® Versions v1.5.6, v1.5.7
Date Added 7 Aug 2022
Author lat9
File Size 45.0 KB
PHP 5.3 Safe? No
Downloads 315
 
USPS United States Postal Service   -   Version: 2022-07-30 K11d
This release contains the correction for GitHub issue #23 (CommitmentName coming back as an empty array).   + Download
Zen Cart® Versions v1.5.6, v1.5.7
Date Added 30 Jul 2022
Author lat9
File Size 44.9 KB
PHP 5.3 Safe? No
Downloads 50
 
USPS United States Postal Service   -   Version: 2022-07-12 K11c
This release corrects the quote-checking for "Priority Mail Express International" methods; see GitHub issue #22.   + Download
Zen Cart® Versions v1.5.6, v1.5.7
Date Added 12 Jul 2022
Author lat9
File Size 44.8 KB
PHP 5.3 Safe? No
Downloads 176
 
USPS United States Postal Service   -   Version: 2022-07-10 K11b
This version has changes associated with the following GitHub issues:

#17: Enable "Ground" shipping to be forced.
#19: Correct PHP warning when no quote is returned.
#20: Correct USPS branding change that results in no "Priority Mail" or "Priority Mail Express" methods returned.
#21: Automatically update the configuration if updating from '2021-05-05 K11a'.
  + Download
Zen Cart® Versions v1.5.6, v1.5.7
Date Added 10 Jul 2022
Author lat9
File Size 44.3 KB
PHP 5.3 Safe? No
Downloads 58
 
USPS United States Postal Service   -   Version: 2021-05-05 K11a
This release contains changes associated with the following GitHub issues:

#15: Correcting minimum International dimensions so that International Small F/R Box can be quoted.
#16: Add notification to enable site-specific customizations for configured shipping methods.
  + Download
Zen Cart® Versions v1.5.4, v1.5.5, v1.5.6, v1.5.7
Date Added 5 May 2021
Author lat9
File Size 43.5 KB
PHP 5.3 Safe? No
Downloads 612
 
USPS United States Postal Service   -   Version: 2020-09-24 K11
This version, now under GitHub control at https://github.com/lat9/usps, has been refactored to correct various PHP warnings and notices.

Support is dropped for Zen Cart versions prior to 1.5.4. The following issues were addressed:

- Restructuring to prevent PHP notices and warnings.
- Re-factored to use now-current code styling.
- Includes modifications to use stripos/strpos instead of preg_match for 'simple' string-in-string checks.
- Use foreach() instead of deprecated each()
- Use secure (https://secure.shippingapis.com/ShippingAPI.dll) endpoint for API requests; unsecure endpoint being retired.
- Simplifies debug handling, 'Screen' and 'Email' no longer supported.
- Debug filename changed to enable sort-by-name to mimic sort-by-date on the files.
- Restores the USPS icon to this shipping-method's distribution zip-file.
- Correct missing constant warning (MODULE_SHIPPING_USPS_REGULATIONS)
- That 'soft' configuration setting is now available in the usps.php language file.
- Additional, previously undefined language constants added in support of the display.
- 'Return Receipt for Merchandise [107]' retired and USPS will return an error if requested.
- Country name changes:
- Country ('MK') changed from 'Macedonia, Republic of' to 'North Macedonia, Republic of'.
- Country ('SZ') changed from 'Swaziland' to 'Eswatini'.
- Country ('SS') added (South Sudan); note that the country is not currently registered in the countries table.
- Add 'soft' configuration settings, present in the module's language file (refer to that file for additional information):
- MODULE_SHIPPING_USPS_SHIPPING_CUTOFF ... the shipping cut-off time, used to determine the delivery date.
- MODULE_SHIPPING_USPS_GROUNDONLY ... identifies whether the database field 'products->products_groundonly' should be interrogated.
- MODULE_SHIPPING_USPS_FRAGILE ... identifies whether the database field 'products->products_fragile' should be interrogated.
- Remove 'plugin_check_for_updates' function. It's now expected to be present as part of the base Zen Cart distribution (zc152+).
- Auto-disable on the storefront if no shipping services have been selected or if the store's country-of-origin isn't the US (country code 223).
  + Download
Zen Cart® Versions v1.5.4, v1.5.5, v1.5.6, v1.5.7
Date Added 21 Oct 2020
Author lat9
File Size 40.8 KB
PHP 5.3 Safe? No
Downloads 490
 
USPS United States Postal Service   -   Version: 2018-03-28 K10
Changed "USPS Retail GroundTM" -> "USPS Retail GroundRM" as it is now a registrered trademark otherwise it won't show the rates   + Download
Zen Cart® Versions v1.5.0, v1.5.1, v1.5.2, v1.5.3, v1.5.4, v1.5.5
Date Added 28 Mar 2018
Author bislewl
File Size 38.4 KB
PHP 5.3 Safe? No
Downloads 1,820
 
USPS United States Postal Service   -   Version: 2017-09-16 K10
In zen cart 1.5.1 the current version is not reporting correctly, In 1.5.2, 1.5.3, 1.5.4, 1.5.5 it was showing it as version 2017-09-04 this update corrects both of those problems. Nothing else was modified just dates and version id for the function that checks for current version in 1.5.1   + Download
Zen Cart® Versions v1.5.1, v1.5.2, v1.5.3, v1.5.4, v1.5.5
Date Added 16 Sep 2017
Author tflmike
File Size 39.3 KB
PHP 5.3 Safe? No
Downloads 678
 
USPS United States Postal Service   -   Version: USPS_2017_09_07_K10
This Update accounts for the new changes in the USPS API where the First-Class Shipping options were no longer showing due to a name change from First Class Mail Parcel or First Class Package Service to First Class Package Service -Retail for retail pricing. It also filters for the weight limits allowed by commercial vs retail on small packages and cleans up the admin listing or first class options. A complete uninstall and reinstall is needed   + Download
Zen Cart® Versions v1.5.1, v1.5.2, v1.5.3, v1.5.4, v1.5.5
Date Added 9 Sep 2017
Author tflmike
File Size 39.3 KB
PHP 5.3 Safe? No
Downloads 113
 
USPS United States Postal Service   -   Version: 2016-01-17 K8
USPS United States Postal Service - Version: 2016-01-17 K8 (Internal version: 15)
USPS RateV4 Intl RateV2 - Jan 17, 2016 Version K8

This update addresses the new and changed shipping methods, in addition to a few country changes for Zen Cart v1.5.5 for the USPS January 17, 2016
The additional country changes will not prevent this from working in older versions.

Without this update, after January 17, 2016 several shipping methods will work correctly, or will give incorrect shipping quotes.
This module also works with the new USPS rates.

It is important to note that Domestic Insurance now has 3 settings:
Insurance - (Any method not Priority Mail or Priority Mail Express)
Priority Mail Express Insurance - (Specific to Priority Mail Express)
Priority Mail Insurance - (Specific to Priority Mail)

Be sure to load the files to the server and UNINSTALL, REINSTALL and re-configure this module.
  + Download
Zen Cart® Versions v1.3.9, v1.5.0, v1.5.1, v1.5.2, v1.5.3, v1.5.4, v1.5.5
Date Added 17 Jan 2016
Author Ajeh
File Size 37.4 KB
PHP 5.3 Safe? Yes
Downloads 2,308
 
USPS United States Postal Service   -   Version: 2015-05-31 K7
USPS RateV4 Intl RateV2 - May 31, 2015 Version K7

This update addresses the new and change Special Services for the USPS May 31, 2015

Without this update, after May 31, 2015 none of the Special and Extra Services will work correctly, or will give incorrect shipping quotes.
This module also works with the new USPS rates.

It is important to note that Domestic Insurance now has 3 settings:
Insurance - (Any method not Priority Mail or Priority Mail Express)
Priority Mail Express Insurance - (Specific to Priority Mail Express)
Priority Mail Insurance - (Specific to Priority Mail)
  + Download
Zen Cart® Versions v1.3.8, v1.3.9, v1.5.0, v1.5.1, v1.5.2, v1.5.3, v1.5.4
Date Added 31 May 2015
Author Ajeh
File Size 37.2 KB
PHP 5.3 Safe? Yes
Downloads 1,466
 
USPS United States Postal Service   -   Version: 2014-10-30 K6
USPS October 30, 2014 K6 has updates for the November 2, 2014 changes that include previous updates for September 7, 2014

This module adds the ability to obtain the Online quote for First-ClassTM Package Service. First-ClassTM Package Service is not available for Retail.

Insurance is added to the:
$methods[] = array('id' => $type_rebuilt,
'title' => $title . $show_hiddenCost,
'cost' => $cost,
'insurance' => $usps_insurance_charge,
);

that can be used with an Order Totals module to make Insurance optional by customer choice. This would require additional customization to the:
/includes/modules/pages/checkout_shipping/header.php

November 16, 2014: First-Class Large Envelopes is now available on the USPS Production Server.
  + Download
Zen Cart® Versions v1.5.0, v1.5.1, v1.5.2, v1.5.3, v1.5.4
Date Added 1 Nov 2014
Author Ajeh
File Size 35.1 KB
PHP 5.3 Safe? Yes
Downloads 1,890
 
USPS United States Postal Service   -   Version: 2014-09-07 K5
Updates for USPS September 7, 2014 changes   + Download
Zen Cart® Versions v1.5.0, v1.5.1, v1.5.2, v1.5.3
Date Added 6 Sep 2014
Author Ajeh
File Size 34.6 KB
PHP 5.3 Safe? Yes
Downloads 1,244
 
USPS United States Postal Service   -   Version: 2014-03-07 K3
Updates for USPS March 7, 2014 changes   + Download
Zen Cart® Versions v1.3.9, v1.5.0, v1.5.1, v1.5.2, v1.5.3
Date Added 7 Mar 2014
Author Ajeh
File Size 32.4 KB
PHP 5.3 Safe? Yes
Downloads 1,752
 
USPS United States Postal Service   -   Version: 2014-01-26 K1
This USPS Update has the new January 26, 2014 changes   + Download
Zen Cart® Versions v1.3.9, v1.5.0, v1.5.1, v1.5.2, v1.5.3
Date Added 24 Jan 2014
Author Ajeh
File Size 31.7 KB
PHP 5.3 Safe? Yes
Downloads 910
 
USPS United States Postal Service   -   Version: 2013-07-28 J5
- Fixed CUSTOM transit times to always override whatever USPS returns. Added explanations of NEW/CUSTOM/OLD transit-time calculations into the readme.
- Now submits proper cart total when not logged in (was previously only submitting if logged in)
- Fixed GXG problems with too-large default dimensions
- Fix duplicate GXG results which could occur if Insurance not offered
  + Download
Zen Cart® Versions v1.3.8, v1.3.9, v1.5.0, v1.5.1
Date Added 30 Jul 2013
Author DrByte
File Size 31.4 KB
PHP 5.3 Safe? Yes
Downloads 2,702
 
USPS United States Postal Service   -   Version: 2013-07-28 J3
This USPS Update has the new July 28, 2013 changes
Updated July 29 to fix some issues with Intl quotes and some PHP warnings that were appearing in logs.

Follow the readme.txt file for setup instructions.
  + Download
Zen Cart® Versions v1.3.8, v1.3.9, v1.5.0, v1.5.1
Date Added 30 Jul 2013
Author DrByte
File Size 30.6 KB
PHP 5.3 Safe? Yes
Downloads 193
 
USPS United States Postal Service   -   Version: 2013-07-28 J
This USPS Update has the new July 28, 2013 changes, plus a small bugfix which was preventing First Class domestic choices from being selected for checkout.

Follow the readme.txt file for instructions.
  + Download
Zen Cart® Versions v1.3.9, v1.5.0, v1.5.1
Date Added 28 Jul 2013
Author DrByte
File Size 30.4 KB
PHP 5.3 Safe? Yes
Downloads 359
 
USPS United States Postal Service   -   Version: 2013-07-28 H
This USPS Update has the new July 28, 2013 changes.

Follow the readme.txt file for instructions.
  + Download
Zen Cart® Versions v1.3.8, v1.3.9, v1.5.0, v1.5.1
Date Added 28 Jul 2013
Author Ajeh
File Size 30.7 KB
PHP 5.3 Safe? Yes
Downloads 222
 
USPS United States Postal Service   -   Version: March 27, 2013 Ver C
US Domestic RateV4 Intl RateV2 - January 27, 2013 rates; Includes module-features to: March 27, 2013 Version C

This module provides US Domestic RateV4 and Intl RateV2 quotes (the previous module gave Domestic RateV3 quotes and Intl RateV2 quotes)
This module includes options for either Retail or Online Rate Quotes (the previous module only gave Online Rate quotes)

This module requires that you have CURL installed on your server.


NOTE: Compared to the prior version, the admin settings look different and have a few more options, so when installing it, plan a few minutes to set up the new options, and as always be sure to look at your checkout and see that the rates are coming through as you expected.
  + Download
Zen Cart® Versions v1.3.9, v1.5.0, v1.5.1
Date Added 27 Mar 2013
Author Ajeh
File Size 26.8 KB
PHP 5.3 Safe? Yes
Downloads 1,284
 
USPS United States Postal Service   -   Version: 2013-01-27G
USPS RateV3 January 27, 2013 - updated 11:45PM EST

This module requires that you have CURL installed on your server.

If you do not already have a USPS Web Tools account ...

Registering and Creating a customer account for USPS realtime shipping quotes ...

If you do not already have a USPS Web Tools account ...

1. Register and create a USPS Web Tools account:
https://www.usps.com/business/webtools.htm

2. Fill in your customer information details and click Submit

3. You will receive an email containing your USPS rate-quote Web Tools User ID

4. Insert the Web Tools User ID in the Zen Cart USPS shipping module.

5. Telephone USPS 1-800-344-7779 and ask them to move your account to the Production Server or email them at [email protected], quoting your Web Tools User ID.

6. They will send another confirmation email. Set the Zen Cart module into Production mode (instead of Test mode) to finish activation.

SEE: readme.txt for more details
  + Download
Zen Cart® Versions v1.3.9, v1.5.0, v1.5.1
Date Added 26 Jan 2013
Author Ajeh
File Size 21.9 KB
PHP 5.3 Safe? Yes
Downloads 1,289
 
USPS United States Postal Service   -   Version: v15 RateV3 B
Should work on older versions of Zen Cart

FAQs: Obtaining USPS WebTools user ID and Activating for Production Server:
http://www.zen-cart.com/content.php?284-how-do-i-set-up-the-usps-shipping-module

CHANGES: 2012_1021
Add additional warning for missing 5 Digit US Zip Code in debug log
Add additional stop on calls to USPS for quote when 5 Digit US Zip Code is not set
Add change for debug logs to be saved to /logs if it exists, otherwise use /cache
  + Download
Zen Cart® Versions v1.5.0, v1.5.1
Date Added 21 Oct 2012
Author Ajeh
File Size 20.6 KB
PHP 5.3 Safe? Yes
Downloads 1,067
 
USPS United States Postal Service   -   Version: January 22, 2012 Ver
This is the upgrade for USPS January 22, 2012

*** BE SURE TO READ THE INSTALL.TXT INSTALLATION INSTRUCTIONS!!!!!!!!
(you must write down your old settings, then remove the module from your admin, then upload the new files, then install the module in your admin and apply your settings to the module again)

In a clean Zen Cart v1.5, there will be no settings to save nor files to overwrite so the files can just be loaded to your server the the shipping module can be installed.
  + Download
Zen Cart® Versions v1.3.8, v1.3.9, v1.5.0
Date Added 22 Jan 2012
Author Zen Cart Team
File Size 20.3 KB
PHP 5.3 Safe? Yes
Downloads 4,055
 
USPS United States Postal Service   -   Version: v1.5
USPS - United States Postal Service for Zen Cart v1.5.0

Shipping module
  + Download
Zen Cart® Versions
Date Added 7 Jul 2011
Author Ajeh
File Size 18.4 KB
PHP 5.3 Safe? Yes
Downloads 884
 


disjunctive-egg
Zen-Cart, Internet Selling Services, Klamath Falls, OR