Created : 15 April 2015
Last Modified : 12 March 2021

***********************************************************************************
Contents:

A. SUMMARY
B. FILE STRUCTURE
C. INSTALLATION INSTRUCTION
D. CHANGES
E. CONFIGURATION SETTINGS
F. DATABASE TABLES MODIFIED
G. LANGUAGE SETTINGS CHANGED
H. CHANGE LOGS
I. TROUBLESHOOTING
J. FAQ
K. COPYRIGHT NOTICE
L. TERMS AND CONDITIONS
***********************************************************************************

A. SUMMARY
==========

This interface is for use with USPS Real Time Shipping module.

***********************************************************************************

B. FILE STRUCTURE
===================

Files included in the zip are:
- $readme_uspostal.txt
- shopajaxshippinguspostalsubs.asp
- uspostalconfig.asp
- uspostalinterface.asp
- uspostalrealtime.asp
- uspostaltransport.asp
- uspscountries.txt
- admin\uspostal_setup.asp
- admin\uspostal_setup_config.asp
- admin\uspostal_setup_process.asp
- admin\sqlscripts\uspostal\*

***********************************************************************************

C. INSTALLATION INSTRUCTION
============================

1. Upload all the files into your shopping cart folder.

2. Log into super admin and execute setup file, eg:

http://www.yourdomain.com/yourshoppingcartfolder/youradminfolder/uspostal_setup.asp

3. After setup the module, would be redirected Module configuration page for configure the module.

NOTE :
This US Postal shipping addon will display all of the USPS shipping methods and rates during checkout e.g :
USPS Priority Mail Express 2-Day™ [US$31.20]
USPS Priority Mail Express 2-Day™ Hold For Pickup [US$31.20]
USPS Priority Mail Express 2-Day™ Flat Rate Envelope [US$22.95]
USPS Priority Mail Express 2-Day™ Flat Rate Envelope Hold For Pickup [US$22.95]
USPS Priority Mail Express 2-Day™ Legal Flat Rate Envelope [US$22.95]
USPS Priority Mail Express 2-Day™ Legal Flat Rate Envelope Hold For Pickup [US$22.95]
USPS Priority Mail Express 2-Day™ Padded Flat Rate Envelope [US$22.95]
USPS Priority Mail Express 2-Day™ Padded Flat Rate Envelope Hold For Pickup [US$22.95]
USPS Priority Mail 2-Day™ [US$7.84]
USPS Priority Mail 2-Day™ Large Flat Rate Box [US$18.75]
USPS Priority Mail 2-Day™ Medium Flat Rate Box [US$13.44]
USPS Priority Mail 2-Day™ Flat Rate Envelope [US$6.44]
USPS Priority Mail 2-Day™ Legal Flat Rate Envelope [US$6.44]
USPS Priority Mail 2-Day™ Padded Flat Rate Envelope [US$6.80]
USPS Priority Mail 2-Day™ Gift Card Flat Rate Envelope [US$6.44]
USPS Priority Mail 2-Day™ Small Flat Rate Envelope [US$6.44]
USPS Priority Mail 2-Day™ Window Flat Rate Envelope [US$6.44]
USPS First-Class Mail® Parcel [US$3.40]
USPS First-Class Mail® Large Envelope [US$2.41]
USPS USPS Retail Ground™ [US$7.84]
USPS Media Mail Parcel [US$2.60]
USPS Library Mail Parcel [US$2.48]

HOW TO EXCLUDE CERTAIN USPS SHIPPING METHODS

If you need to remove certain USPS shipping methods that you do not want to show for your site, follow these :

1. Login to your administration : Modules > Modules Manager > uspostal > Edit

2. In the "Exclude Service Types" field, enter the methods you want to exclude from shipping list in separated commas.
For example, let's say you do not want to show all 'Envelope' and 'First-Class' related methods, then you can enter with value : Envelope,First-Class

Example of result after we exclude the above :
USPS Priority Mail Express 2-Day™ [US$31.20]
USPS Priority Mail Express 2-Day™ Hold For Pickup [US$31.20]
USPS Priority Mail 2-Day™ [US$7.84]
USPS Priority Mail 2-Day™ Large Flat Rate Box [US$18.75]
USPS Priority Mail 2-Day™ Medium Flat Rate Box [US$13.44]
USPS USPS Retail Ground™ [US$7.84]
USPS Media Mail Parcel [US$2.60]
USPS Library Mail Parcel [US$2.48]

HOW TO ENTER DIMENSIONS

1. Login to your administration : Modules > Modules Manager > uspostal > Edit

2. The below fields must be set correctly if you would like to set dimension:

Package Size: Must set at LARGE.
Width: Enter the value.
Length: Enter the value.
Height: Enter the value.
Girth: Enter the value.

NOTE: Currently it is not supporting the various dimension for each product to have it's own length, width, height and girth. All products currently will be treated as same global dimensions.
If you want to have each product it's own dimension then this will require customisation.

***********************************************************************************

D. CHANGES
===============

NONE

***********************************************************************************

E. CONFIGURATION SETTINGS
=================

NONE


F. DATABASE TABLES MODIFIED
===========================

NONE

***********************************************************************************

G. LANGUAGE SETTINGS CHANGED
============================

NONE

***********************************************************************************

H. CHANGE LOGS
============================

2015.05.08 - Enhancement: USPS: Auto convert from pounds to ounces if ounces field is emtpy
2015.05.08 - Bug Fix: USPS: Should include All service type
2015.09.10 - USPS: should always display the options even the product set to Free Shipping
2015.09.10 - USPS: Better handling on USPS and have extra options
2015.09.22 - USPS: Better handling on returned results
2015.10.29 - USPS: New options required if Package size is large
2015.10.29 - USPS: Normal Checkout: Pricing not display if xAjxshiping is set to No
2016.02.11 - USPostal: Better handling return result if contain [] characters
2016.02.01 - Enhancement: Better hanlding on openrecordset
2016.02.25 - XML: To support TLS1.2
2016.05.25 - Bug Fix: UsPostal: Possible variable error
2016.06.27 - Change default value of domestic service types from Express,Priority,Parcel,First Class to ALL.
2017.04.14 - USPS: Pass in country parameter to routine SendXml & AnalyzeXML
2017.04.14 - USPS: To include OriginZip to XML for International shipping
2017.04.14 - USPS: To make sure only take first 5 character from destination postal code for local shipping
2017.05.11 - International shipping : updated 40+ country names in uspscountries.txt
2017.06.17 - Bug Fix: Rounding issue for ounces
2019.05.06 - Bug Fix: USPostal: Shipping price incorrectly calculate if autoseparate features is activated
2019.08.27 - Compatible with v9
2020.08.07 - Updated country code for New Caledonia from NZ to NC in file uspscountries.txt
2021.03.12 - Support for secure HTTP endpoints.

***********************************************************************************

I. TROUBLESHOOTING
============================

Please submit a ticket to our helpdesk at https://helpdesk.vpcart.com and our support team will assist you.

***********************************************************************************

J. FAQ
============================

NONE

***********************************************************************************
K. COPYRIGHT NOTICE
============================

Copyright (c) 1999-2021 Rocksalt International Pty. Ltd.
All rights reserved.

This software and documentation constitute a published work and
contains valuable trade secrets and proprietary information
belonging to Rocksalt International Pty. Ltd. .
None of the foregoing material may be copied,
duplicated or disclosed without the express written permission
of Rocksalt International Pty. Ltd. .

LICENSEE ACCEPTS VP-ASP Shopping Cart "AS IS" "WITH ALL FAULTS",
Rocksalt International Pty. Ltd. accepts no responsibility for the
operation or performance of the VP-ASP Shopping Cart.
The entire risk of use and consequences of use of the
VP-ASP Shopping Cart falls completely on the Licensee
and Rocksalt International Pty. Ltd. shall not be liable in any respect
for any claims, loss or injury alleged to have resulted
from use of or in reliance on VP-ASP Shopping Cart.

Licensee acknowledges that it has read the foregoing
disclaimers of warranty and limitation of liability
and understands that Licensee assumes
the entire risk of using VP-ASP Shopping Cart.


***********************************************************************************

L. TERMS AND CONDITIONS
============================
ROCKSALT INTERNATIONAL GRANTS TO THE LICENSEE A NON-EXCLUSIVE,
NON-SUB LICENSABLE, NONTRANSFERABLE LICENSE
TO INSTALL AND USE THIS APPLICATION ON A SINGLE DOMAIN FOR
A SINGLE SHOP.

THE CODE IN THE APPLICATION MAY BE MODIFIED FOR USE IN
SETTING UP A SINGLE SHOPPING SITE ON THE WORLD WIDE WEB.

LICENSEE MAY MAKE A COPY OF THE APPLICATION FOR
BACK-UP AND ARCHIVAL PURPOSES, PROVIDED THAT ANY COPY
MUST CONTAIN ALL PROPRIETARY NOTICES INCLUDED
WITH THE APPLICATION.

LICENSEE IS PROHIBITED FROM SELLING OR DISTRIBUTING
THE APPLICATION IN ANY MANNER.

LIMITATION OF LIABILITY.

ROCKSALT INTERNATIONAL AND ITS LICENSORS SHALL
NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE OR ANY
THIRD PARTY AS A RESULT OF USING OR DISTRIBUTING THIS
APPLICATION.

IN NO EVENT WILL ROCKSALT INTERNATIONAL OR ITS LICENSORS
BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA,
OR FOR DIRECT, INDIRECT, SPECIAL,
CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES,
HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LI
ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE,
EVEN IF ROCKSALT INTERNATIONAL HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.